FormGroup QML Type

The container class that identifies a container of related controls in a form. More...

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

Properties

Detailed Description

This element should always be positioned in a Form. It is used to group together related form controls, to separate different settings categories. Every form should always have at least one FormGroup.

A FormGroup should contain only elements of type FormEntry or FormSeparator (or derivates)

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 Form and FormEntry.

Property Documentation

title : string

Group title.

If set, a title will be displayed on top of the form section, useful for semantically group different settings categories