textual-slidecontainer¶

This is a library that provides a custom container (widget) called the SlideContainer.

It is designed to make it extremely simple to implement sliding menu bars in your Textual apps.

Features¶

Usage is a single line of code with the default settings. Everything is handled automatically.
Set a precise dock position - The dock position argument adds topleft, topright, bottomleft, and bottomright to Textual's 4 arguments of top, bottom, left, and right for 8 dock positions total.
Set the slide direction - Containers can slide to the left, right, top, or bottom. This can be changed or tweaked independently of the dock position (For example, dock to bottom right, then you can slide down or slide right.)
Enable or disable Floating mode - With a boolean, containers can switch between floating on top of your app, or being a part of it and affecting the layout.
Set the default state - Containers can be set to start in closed mode.
Set the container to dock as an initialization argument.
Floating containers automatically dock to the edge they move towards (this can be changed).
Change how the animation looks with the duration, fade, and easing_function arguments.
Included demo application which has comments in the code.

If you have uv or pipx, you can immediately try the demo app:

uvx textual-slidecontainer

pipx run textual-slidecontainer

Use the issues section for bugs or problems, and post ideas or feature requests on the TTY group discussion board.