https://github.com/guhan-sensam/cardstack
A KivyMD Extension widget for adding a stack of cards that can be animated
https://github.com/guhan-sensam/cardstack
Last synced: 11 months ago
JSON representation
A KivyMD Extension widget for adding a stack of cards that can be animated
- Host: GitHub
- URL: https://github.com/guhan-sensam/cardstack
- Owner: Guhan-SenSam
- License: mit
- Created: 2021-04-26T16:54:51.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-09-05T07:19:19.000Z (over 4 years ago)
- Last Synced: 2025-01-02T18:49:13.671Z (about 1 year ago)
- Language: Python
- Size: 873 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Example Extension
This extension adds a beautiful Card Stack Widget. The Widget enables you to create a stack of three cards that can be animated to move to the next card infinetly. The widget is designed in a way that three `MDCards` get reused infinetly to give the impression of an infinte stack of cards. You can add your own widgets to the front most card.
### Dependencies:
- [KivyMD](https://github.com/kivymd/KivyMD) >= 0.104.1
- [Kivy](https://github.com/kivy/kivy) >= 2.0.0 ([Installation](https://kivy.org/doc/stable/gettingstarted/installation.html))
- [Python 3.6+](https://www.python.org/)
## Documentation
* `Radius`: Accepts a list and sets the radius of all cards in the stack
* `first_color`: Accepts a list and sets the color for the front most card(Defaults to `primary_light_color` of theme class)
* `second_color`: Accepts a list and sets the color for the middle card(Defaults to `primary_color` of theme class)
* `third_color`: Accepts a list and sets the color for the last card(Defaults to `primary_dark` of theme class)
* `current_card`: Returns the front most card object. This can be used to add widgets to the front most card. The value is returned before the animation starts to allow the user to load new widgets before they are seen and thus make the transition fluent.
* `transition`: Accepts a string and sets the transition interpolation type to use for animations.
* `card_out_direction` : The Direction the fron tmost cards exists the screen. The availbale options are `down`, `up`, `left` and `right`. This property defaults to `down`
* `card_in_direction` : The direction in which the new card comes in on the screen. The available options are `side`, `bottom` and `top`. This property defaults to `side`
* `elevation` : The elevation of the front most card. This property defaults to `0`
## Examples
Check the `example.py` on how to use this Kivy Widget
### Pictures
This is the widget using default app theme colors.
