KivyToast#

Implementation of toasts for desktop.

from kivy.lang import Builder

from kivymd.app import MDApp
from kivymd.toast import toast

KV = '''
MDScreen:

    MDTopAppBar:
        title: 'Test Toast'
        pos_hint: {'top': 1}
        left_action_items: [['menu', lambda x: x]]

    MDRaisedButton:
        text: 'TEST KIVY TOAST'
        pos_hint: {'center_x': .5, 'center_y': .5}
        on_release: app.show_toast()
'''


class Test(MDApp):
    def show_toast(self):
        '''Displays a toast on the screen.'''

        toast('Test Kivy Toast')

    def build(self):
        return Builder.load_string(KV)

Test().run()

API - `kivymd.toast.kivytoast.kivytoast`#

class kivymd.toast.kivytoast.kivytoast.Toast(**kwargs)#

ModalView class. See module documentation for more information.

Events:

on_pre_open:: Fired before the ModalView is opened. When this event is fired ModalView is not yet added to window.
on_open:: Fired when the ModalView is opened.
on_pre_dismiss:: Fired before the ModalView is closed.
on_dismiss:: Fired when the ModalView is closed. If the callback returns True, the dismiss will be canceled.

Changed in version 1.11.0: Added events on_pre_open and on_pre_dismiss.

Changed in version 2.0.0: Added property ‘overlay_color’.

Changed in version 2.1.0: Marked attach_to property as deprecated.

duration#

The amount of time (in seconds) that the toast is visible on the screen.

duration is an NumericProperty and defaults to 2.5.

label_check_texture_size(self, instance_label: Label, texture_size: List[int])#: Resizes the text if the text texture is larger than the screen size. Sets the size of the toast according to the texture size of the toast text.

toast(self, text_toast: str)#: Displays a toast.

on_open(self)#: Default open event handler.

fade_in(self)#: Animation of opening toast on the screen.

fade_out(self, *args)#: Animation of hiding toast on the screen.

on_touch_down(self, touch)#: touch down event handler.

kivymd.toast.kivytoast.kivytoast.toast(text: str = '', background: list = None, duration: float = 2.5) → None#

Displays a toast.

Parameters:

text – text to be displayed in the toast;
duration – the amount of time (in seconds) that the toast is visible on the screen
background – toast background color in rgba format;

KivyToast#

API - kivymd.toast.kivytoast.kivytoast#

API - `kivymd.toast.kivytoast.kivytoast`#