AtlasColorField
A colour chooser: a swatch and hex field that opens a palette, a hex field and the system colour dialog.
Since 1.4.0
AtlasColorField shows a swatch and the colour as hex text (a colour with alpha shows as RGBA instead, such as rgba(104, 88, 226, 0.5)). Clicking it opens a card with a palette of swatches (the current colour first when it is not one of them), a hex field and, with showMore, a "More..." button for the system colour dialog.
The hex field takes #rgb and #rrggbb (and #aarrggbb with showAlpha; the # may be left out) and applies the colour as soon as what is typed is complete. rgb(104, 88, 226) and rgba(104, 88, 226, 0.5) are accepted too (alpha 0 to 1; the alpha form needs showAlpha).
AtlasColorField is a Qt Quick Templates AbstractButton; its inherited properties work as usual. See https://doc.qt.io/qt-6/qml-qtquick-controls-abstractbutton.html.
Example
AtlasColorField {
color: "#3daee9"
onEdited: settings.accent = color
Accessible.name: qsTr("Accent colour")
}Accessibility
Name it with Accessible.name (what the colour is for). The default name is "Colour". The hex value is spoken as the description.
Properties
| Name | Type | Default | Description |
|---|---|---|---|
color |
color |
"#3daee9" |
The colour. |
hex |
string (read-only) |
— | The colour as #rrggbb, or #aarrggbb when showAlpha is on and it is not opaque. |
showAlpha |
bool |
false |
Accept and show an alpha channel. |
showMore |
bool |
true |
Shows the "More..." button that opens the system colour dialog. |
Signals
| Name | Description |
|---|---|
edited() |
The user changed the colour. Not emitted when the app sets color. |