AdwViewStack

A view container for AdwViewSwitcher.

AdwViewStack is a container which only shows one page at a time. It is typically used to hold an application’s main views.

It doesn’t provide a way to transition between pages. Instead, a separate widget such as AdwViewSwitcher can be used with AdwViewStack to provide this functionality.

AdwViewStack pages can have a title, an icon, an attention request, and a numbered badge that AdwViewSwitcher will use to let users identify which page is which. Set them using the AdwViewStackPage:title, AdwViewStackPage:icon-name, AdwViewStackPage:needs-attention, and AdwViewStackPage:badge-number properties.

Unlike GtkStack, transitions between views are not animated.

AdwViewStack maintains a AdwViewStackPage object for each added child, which holds additional per-child properties. You obtain the AdwViewStackPage for a child with adw_view_stack_get_page() and you can obtain a GtkSelectionModel containing all the pages with adw_view_stack_get_pages().

AdwViewStack as GtkBuildable

To set child-specific properties in a .ui file, create AdwViewStackPage objects explicitly, and set the child widget as a property on it:

  <object class="AdwViewStack" id="stack">
    <child>
      <object class="AdwViewStackPage">
        <property name="name">overview</property>
        <property name="title">Overview</property>
        <property name="child">
          <object class="AdwStatusPage">
            <property name="title">Welcome!</property>
          </object>
        </property>
      </object>
    </child>
  </object>

CSS nodes

AdwViewStack has a single CSS node named stack.

Accessibility

AdwViewStack uses the GTK_ACCESSIBLE_ROLE_TAB_PANEL for the stack pages which are the accessible parent objects of the child widgets.