1// Copyright (C) 2017 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
5 \page qtquickcontrols-navigation.html
6 \title Navigation Controls
7 \ingroup qtquickcontrols-guidelines
8 \brief Guidelines for navigation controls
10 Qt Quick Controls offers a selection of navigation models.
12 \annotatedlist qtquickcontrols-navigation
14 The following sections offer guidelines for choosing the appropriate type
15 of navigation model, depending on the use case.
17 \section1 StackView Control
19 \image qtquickcontrols-stackview-wireframe.png
21 \l StackView provides a stack-based navigation model which can be used
22 with a set of interlinked pages. StackView works according to a last-in
23 first-out principle: the page pushed last on the stack is the one visible.
24 Popping a page removes the last page and makes the previous one visible.
26 \section1 SwipeView Control
28 \image qtquickcontrols-swipeview-wireframe.png
30 \l SwipeView provides a navigation model that simplifies horizontal paged
31 scrolling. The page indicator on the bottom shows which is the presently
34 \section1 TabBar Control
36 \image qtquickcontrols-tabbar-wireframe.png
38 \l TabBar is a bar with icons or text that allows the user to switch
39 between different subtasks, views, or modes.
41 \section1 TabButton Control
43 \image qtquickcontrols-tabbutton.png
45 \l TabButton is a button with a layout suitable for a TabBar control.