Exploring Custom Widgets with KivyMD Extensions
KivyMD Extensions offers a collection of customized and non-material widgets for KivyMD, enabling developers to create unique and visually appealing user interfaces. In this article, we will explore the features of KivyMD Extensions, learn how to install and use these widgets, and discover additional resources for support and documentation.
Installation
To get started with KivyMD Extensions, simply run the following command:
bash
pip install kivymd_extensions.akivymd
Alternatively, you can install directly from the GitHub repository:
bash
pip install https://github.com/kivymd-extensions/akivymd/archive/main.zip
Usage
KivyMD Extensions integrates seamlessly with KivyMD, allowing you to use custom widgets in your applications. To import and utilize these widgets, follow the example below:
“`python
from kivy.lang import Builder
from kivymd.app import MDApp
import kivymd_extensions.akivymd
KV = “””
NavigationButton@Button_Item
icon_color: app.theme_cls.text_color
text_color: app.theme_cls.text_color
button_bg_color: app.theme_cls.primary_color
mode: ‘color_on_active’
badge_disabled: True
MDScreen:
AKBottomNavigation2:
bg_color: app.theme_cls.bg_darkest
NavigationButton:
text: 'Alert'
icon: 'bell-outline'
NavigationButton:
text: 'Bank'
icon: 'bank-outline'
NavigationButton:
text: 'Download'
icon: 'arrow-down-bold-outline'
“””
class Test(MDApp):
def build(self):
return Builder.load_string(KV)
Test().run()
“`
Examples
To gain a deeper understanding of how to use KivyMD Extensions, you can explore the provided examples. Clone the repository and navigate to the “full_example” directory:
bash
git clone https://github.com/kivymd-extensions/akivymd.git
cd akivymd/examples/full_example
python main.py
The examples will demonstrate various use cases and help you grasp the potential of these custom widgets.
Documentation
Comprehensive documentation is available to guide you through the installation, usage, and customization of KivyMD Extensions. To learn more, follow these steps:
bash
git clone https://github.com/kivymd-extensions/akivymd.git
cd docs
sphinx-build -b html sources ./_build
The documentation provides detailed instructions, code samples, and explanations to help you make the most of KivyMD Extensions.
Support
If you encounter any issues or have questions, the KivyMD community is ready to assist you. Here are two ways to seek support:
- Discord server: Join the KivyMD Discord server at https://discord.gg/wu3qBST to connect with experts and fellow developers.
- Email: Reach out to kivydevelopment@gmail.com to receive direct support.
Conclusion
KivyMD Extensions opens up a world of possibilities for creating captivating user interfaces with custom widgets. By following the installation and usage instructions, exploring the examples, and referring to the comprehensive documentation, you can harness the full potential of KivyMD Extensions. Join the thriving KivyMD community and elevate your application development with these powerful tools.
References:
– KivyMD: https://github.com/kivymd/KivyMD
– Kivy: https://github.com/kivy/kivy
– Python: https://www.python.org/
– License: MIT License
Leave a Reply