src/controls.6/SectionHeader.qml

0001 import QtQuick
0002 import QtQuick.Controls
0003
0004 import org.mauikit.controls 1.3 as Maui
0005
0006 /**
0007  * @inherit QtQuick.Controls.Pane
0008  * @since org.mauikit.controls
0009  *
0010  * @brief A control for dividing sections with a title label and a message body.
0011  * <a href="https://doc.qt.io/qt-6/qml-qtquick-controls-pane.html">This controls inherits from QQC2 Pane, to checkout its inherited properties refer to the Qt Docs.</a>
0012  *
0013  * The most common use for this control is to set it as the title of a section. For a more complete implementation of such use case refer to the SectionGroup, which uses this control as the section header.
0014  *  @see SectionGroup
0015  */
0016
0017 Pane
0018 {
0019   id: control
0020
0021   /**
0022    * @brief An alias to the ListItemTemplate handling the information labels, etc.
0023    * Exposed for fine tuning more of its properties.
0024    * @property ListItemtemplate SectionHeader::template
0025    */
0026   readonly property alias template : _template
0027
0028   /**
0029    * @see ListItemTemplate::text1
0030    */
0031   property alias text1 : _template.text1
0032
0033   /**
0034    * @see ListItemTemplate::text2
0035    */
0036   property alias text2 : _template.text2
0037
0038   /**
0039    * @see ListItemTemplate::label1
0040    */
0041   readonly property alias label1 : _template.label1
0042
0043   /**
0044    * @see ListItemTemplate::label2
0045    */
0046   readonly property alias label2 : _template.label2
0047
0048   implicitHeight: _template.implicitHeight + topPadding + bottomPadding
0049
0050   padding: Maui.Style.defaultPadding
0051   spacing: Maui.Style.space.small
0052
0053   contentItem: Maui.ListItemTemplate
0054   {
0055     id: _template
0056
0057     label1.font: Maui.Style.h2Font
0058     label2.wrapMode: Text.WordWrap
0059     label1.color: Maui.Theme.textColor
0060     isMask: iconSizeHint <= 22
0061     spacing: control.spacing
0062   }
0063
0064   background: null
0065 }