Logo FluentUI

FlipView QML Type

A flip-style items control that displays one item at a time. More...

Import Statement: import FluentUI.Controls 1.0

Properties

Signals

Detailed Description

FlipView is a data-driven control that displays one item at a time and enables "flip" behavior for traversing its collection of items. It supports both direct children and model-delegate binding.

 // Direct children mode
 FlipView {
     width: 480
     height: 300
     Image { source: "banner_1.webp" }
     Image { source: "banner_2.webp" }
 }
 // Model-delegate mode
 FlipView {
     width: 480
     height: 300
     model: myListModel
     delegate: Image { source: model.url }
 }

Property Documentation

count : int

The number of items in the FlipView. Read-only.

currentIndex : int

The index of the currently visible item. Corresponds to WinUI SelectedIndex.

currentItem : Item

The currently visible Item instance. Read-only. Corresponds to WinUI SelectedItem.

delegate : Component

The delegate component used to render each item when model is set.

items : list<Item>

The default property. Holds the list of child items that serve as pages. Use this when declaring pages directly in QML.

model : var

The data model for the FlipView. Supports ListModel, JS Array, int, or any model that can be consumed by a Repeater. When set, items are created using the delegate component.

Whether the previous/next navigation buttons are visible. Default is true.

orientation : enumeration

The orientation of the flip navigation.

  • Qt.Horizontal - horizontal flipping (default)
  • Qt.Vertical - vertical flipping

useTouchAnimationsForAllNavigation : bool

Whether transition animations are used for all navigation types. When true (default), animations play for touch, button, and programmatic navigation. When false, only touch navigation uses animation.

Signal Documentation

selectionChanged()

Emitted when the currentIndex changes.

Note: The corresponding handler is onSelectionChanged.