Skip to content

App Drawer

Source: ui/app_drawer.py

Shared navigation drawer for Shell destinations. Tile list and route indices come from the route registry; selection navigates through Navigation. See Chrome and wrappers and App chrome.

Shared navigation drawer for Shell destinations.

AppDrawer

Bases: NavigationDrawer

Navigation drawer built from DRAWER_ROUTES / build_drawer_controls.

On selection, closes the drawer and navigates to the matching Shell route unless that route is already active. Honors AppSession.is_navigation_disabled so import/export and similar flows can lock drawer navigation. Registered on AppChrome at startup.

Source code in src/learning_app/ui/app_drawer.py 
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
class AppDrawer(ft.NavigationDrawer):
    """Navigation drawer built from ``DRAWER_ROUTES`` / ``build_drawer_controls``.

    On selection, closes the drawer and navigates to the matching Shell route
    unless that route is already active. Honors
    ``AppSession.is_navigation_disabled`` so import/export and similar flows
    can lock drawer navigation. Registered on ``AppChrome`` at startup.
    """

    def __init__(self, host_page: ft.Page):
        """Create the drawer bound to the application page.

        Args:
            host_page: Page used for close-drawer and navigation calls.
        """
        self._host_page = host_page
        super().__init__(
            tile_padding=ft.Padding(top=10),
            on_change=self.__handle_change,
            controls=build_drawer_controls(),
        )

    async def __handle_change(self, e: ft.ControlEvent):
        if AppSession.is_navigation_disabled():
            return

        page = self._host_page
        target_route = DRAWER_ROUTES[self.selected_index]

        if route_path(page.route) == target_route:
            await page.close_drawer()
            return

        await page.close_drawer()
        await navigate_to_async(page, target_route)