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
Inherits:

Item

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