AdwNavigationView

A stack-based navigation container.

Preview

Home
Home Page

CSS Node Tree

navigation-view
  ├── navigation-view-page…
  ├── dimming.left|.right   (during transitions)
  ├── shadow.left|.right    (during transitions)
  └── widget                (during transitions)

Props

Prop

Type

Pages

Prop

Type

Behavior

  • Pages are pushed and popped from a navigation stack. Call useNavigation() inside a page for push and pop; pushing a tag the view doesn't have pushes it onto the enclosing navigation view.
  • An AdwHeaderBar in a page shows the page's title, and a back button when there is a page to go back to. Right-click, long press, Shift+F10 or Menu on the back button opens a menu of the pages below.
  • Pages stay mounted once shown, so they keep their state when popped and pushed again.
  • A page with canPop: false has no back button, and the shortcuts and gestures below don't pop it.

Keyboard and Gestures

  • Escape — Pops the visible page (unless popOnEscape is false)
  • Alt+← and the back mouse button — Pop the visible page
  • Swipe right on a touchscreen, or scroll right on a touchpad — Pops the visible page, following the fingers

In right-to-left text, the arrow key and the gestures are mirrored.

Adwaita Documentation →

On this page