Form QML Type

The base class for Form conforming to the Kirigami Human Interface Guidelines. More...

Import Statement: import org.kde.kirigami.forms
Since: 6.24
Inherits:

Item

Properties

Detailed Description

This is the base element for forms, used for instance in settings pages. We usually have a Page that contains a single Form, which in turn contains one or more FormGroup, each formGroup containing one or more FormEntry.

Example usage:

import QtQuick.Controls as QQC
import org.kde.kirigami as Kirigami

Kirigami.Form {
  Kirigami.FormGroup {
      title: "Global Settings"
      Kirigami.FormEntry {
          contentItem: QQC.CheckBox {
              text: "Show Sidebar"
          }
      }
      Kirigami.FormEntry {
          contentItem: QQC.CheckBox {
              text: "Auto Save"
          }
      }
  }
  Kirigami.FormGroup {
      title: "Theme Options"
      Kirigami.FormEntry {
          title: "Colors"
          contentItem: QQC.CheckBox {
              text: "Dark Theme"
          }
      }
      Kirigami.FormSeparator {}
      Kirigami.FormEntry {
          contentItem: QQC.CheckBox {
              text: "High Contrast"
          }
      }
      ...
  }
}

See also FormGroup and FormEntry.

Property Documentation

wideMode : bool [read-only, since 6.33]

true if this Form is using a 'wide screen' layout.

If the width of this Form is not sufficient to display each FormEntry title and contentItem together on a single line, then this property will be false and the title (if one is set) will be displayed above the contentItem as if the FormEntry fullWidth property was set for all entries in the Form.

This property was introduced in 6.33.