Skip to content

Tuner.Group

Tuner.Group groups settings rows on a page and becomes an Adw.PreferencesGroup in the interface. Groups can only contain widgets (Tuner.Switch, Tuner.Entry, etc.).

PropertyTypeDescription
titlestringGroup title
descriptionstringText shown under the title
priorityintOrder on the page — the lower the value, the higher the group
show-emptyboolShow the group even when it has no visible rows
blp
Tuner.Group {
    title: _("Mouse");
    id: "mouse";

    Tuner.Switch {
        title: _("Middle Click to Paste Text");

        binding: Tuner.Setting {
            schema-id: "org.gnome.desktop.interface";
            schema-key: "gtk-enable-primary-paste";
        };
    }
}

TIP

A group is hidden automatically if none of its rows were created (for example, when all bindings point to missing GSettings schemas) — unless show-empty is set.

Groups with the same id from different plugins are merged — see Architecture.

Released under the GPL-3.0+ License. The content is available under CC BY-SA 4.0, unless stated otherwise.