Skip to content

Custom

A widget which which takes in a custom function to display text

Key
Default
Description
apiThe api object provided within the function
functionFunction top poll the value from, events and intervals can be set with @subscribe and @timer
fmt" {} "Specify how the text should be formatted, {} represents the value that'll be displayed
fgtheme.foreground1Color to show the text in, defaults to theme.foreground1 or white based on theme
bgtheme.primaryColor to show the background in, defaults to theme.primary or accent based on theme
python
from dooit_extras.bar_widgets import Custom
from dooit.ui.api.events import subscribe, timer, Startup, TodoEvent
from dooit.ui.api import DooitAPI

@subscribe(TodoEvent)
def alert_todo_event(api: DooitAPI, event: TodoEvent):
    # ...

@timer(1)
def my_timer(api: DooitAPI, _):
    # ...

@subscribe(Startup)
def setup(api, _):
    api.bar.set( 
        [
            # ....
            Custom(api, function = alert_todo_event),
            Custom(api, function = my_timer),
            # ....
        ]
    )