AdwNavigationSplitView

A sidebar and content side by side, or a navigation view when collapsed.

Preview

Inbox
InboxResize the view to collapse it

CSS Node Tree

navigation-split-view
├── widget.sidebar-pane[.end]
│   ╰── navigation-view-page
╰── widget.content-pane
    ╰── navigation-view-page

When collapsed:

navigation-split-view
╰── navigation-view
    ├── navigation-view-page
    ╰── navigation-view-page

Props

Prop

Type

The sidebar and content pages:

Prop

Type

Behavior

  • Uncollapsed, the sidebar takes sidebarWidthFraction of the width, between minSidebarWidth and maxSidebarWidth.
  • Collapsed, the panes become the pages of a navigation view: the sidebar is the root page and the content is pushed over it, with a back button, Escape and Alt+← to go back. With sidebarPosition="end" it's the other way around.
  • useNavigation().push(content.tag) shows the content, collapsed or not. showContent is kept across collapsing, and onShowContentChanged reports changes.
  • Collapsing an uncollapsed view keeps the pages' state and focus.
  • Uncollapsed, header bars hide the window buttons facing the other pane.
  • Collapse it with an AdwBreakpointBin, as in the preview.

Adwaita Documentation →

On this page