Pages

API Documentation

• User Documentation
• Developer Documentation
• API Documentation

Search API documentation

On this page

FormGroup QML Type

The container class that identifies a container of related controls in a form. This type was introduced in Qt 6.24. More...

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

#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, 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