261 lines
10 KiB
QML
261 lines
10 KiB
QML
// Accessibility.
|
||
//
|
||
// Organized by what a person came here unable to do -- see it, tolerate the
|
||
// motion, hear it, reach it from the keyboard, have it read aloud -- rather
|
||
// than by which subsystem happens to implement each control. The old page was
|
||
// grouped by mechanism (Pointer / Text / Motion / Magnifier / Contrast), which
|
||
// is the shape of the code and not the shape of the question.
|
||
//
|
||
// Everything on this page acts on this session. Two things deliberately do not
|
||
// ship as switches -- mono audio, and sticky/slow/bounce keys -- and both say
|
||
// why in place instead of being quietly absent or, worse, present and dead.
|
||
//
|
||
// Pointer size and text scale have to agree across three consumers that share
|
||
// no configuration system -- the compositor, GTK applications, and the shell.
|
||
// Panama's store is the source of truth and services/Accessibility.qml pushes
|
||
// the value to the other two.
|
||
|
||
import QtQuick
|
||
import qs.config
|
||
import qs.services
|
||
|
||
SettingsPage {
|
||
id: root
|
||
|
||
title: "Accessibility"
|
||
lede: "Every switch on this page does something on this desktop — and the ones that cannot yet say why."
|
||
|
||
// The zoom chords come from the compositor's live keymap, matched on the
|
||
// descriptions hypr/keybinds.lua gives them, so rebinding a zoom key
|
||
// changes what this page says instead of quietly making it wrong. The
|
||
// literals are the shipped chords, standing in only until the keymap has
|
||
// loaded -- not a second source of truth.
|
||
function chordFor(needle: string, fallback: string): string {
|
||
for (const bind of Keybinds.binds) {
|
||
if (String(bind.description).toLowerCase().indexOf(needle) >= 0)
|
||
return String(bind.chord);
|
||
}
|
||
return fallback;
|
||
}
|
||
|
||
readonly property string zoomInChord: root.chordFor("zoom in", "Super + Alt + =")
|
||
readonly property string zoomOutChord: root.chordFor("zoom out", "Super + Alt + -")
|
||
readonly property string zoomResetChord: root.chordFor("reset zoom", "Super + Alt + 0")
|
||
|
||
// Probed when the page opens rather than polled all session: nothing else
|
||
// on this desktop needs to know whether Orca is running.
|
||
Component.onCompleted: Accessibility.refreshScreenReader()
|
||
|
||
readonly property string screenReaderDetail: {
|
||
if (Accessibility.orcaRunning)
|
||
return "Running — reading the focused application";
|
||
if (Accessibility.accessibilityBusRunning)
|
||
return "Not running · the accessibility bus is up, so applications are ready to be read";
|
||
return "Not running · the accessibility bus is not up, so Orca would start and read nothing";
|
||
}
|
||
|
||
SettingsCard {
|
||
title: "Vision"
|
||
subtitle: "Magnification is the compositor's own, so it follows the pointer across every window and every screen."
|
||
|
||
SliderRow { setting: "magnifierFactor" }
|
||
|
||
// One row per chord rather than three chords crammed into one row's
|
||
// trailing slot: three keycap chords side by side are wider than the
|
||
// control column, and squeezing them there costs the label its line.
|
||
SettingRow {
|
||
label: "Zoom in"
|
||
detail: "Works from anywhere — the OSD shows the magnification you land on"
|
||
controlWidth: 210
|
||
|
||
KeycapChord {
|
||
anchors.right: parent.right
|
||
anchors.verticalCenter: parent.verticalCenter
|
||
chord: root.zoomInChord
|
||
}
|
||
}
|
||
|
||
SettingRow {
|
||
label: "Zoom out"
|
||
controlWidth: 210
|
||
|
||
KeycapChord {
|
||
anchors.right: parent.right
|
||
anchors.verticalCenter: parent.verticalCenter
|
||
chord: root.zoomOutChord
|
||
}
|
||
}
|
||
|
||
SettingRow {
|
||
label: "Back to 1.00 ×"
|
||
detail: "Turns the magnifier off without coming back to Settings for it"
|
||
controlWidth: 210
|
||
|
||
KeycapChord {
|
||
anchors.right: parent.right
|
||
anchors.verticalCenter: parent.verticalCenter
|
||
chord: root.zoomResetChord
|
||
}
|
||
}
|
||
|
||
ToggleRow { setting: "magnifierRigid" }
|
||
SliderRow { setting: "textScale" }
|
||
SliderRow { setting: "cursorSize" }
|
||
ToggleRow { setting: "highContrast" }
|
||
|
||
// The stored value is the enum; what the compositor wants is a shader
|
||
// path. SystemSettings owns that mapping and applies it live, and
|
||
// hypr/looks.lua does the same lookup at config time -- so the filter
|
||
// survives a reload without this page having to reload anything.
|
||
//
|
||
// Applied on change rather than on load: the compositor already read
|
||
// the preference at launch, and re-applying the value it is already
|
||
// running would be a hyprctl call for nothing every time this page
|
||
// opens.
|
||
//
|
||
// A picker rather than a segmented control: five options with a
|
||
// sentence under each get ninety pixels apiece in a strip, which is
|
||
// room for neither.
|
||
OptionPickerRow {
|
||
id: colorFilterRow
|
||
|
||
property string appliedFilter: ""
|
||
|
||
setting: "colorFilter"
|
||
divider: false
|
||
|
||
Component.onCompleted: colorFilterRow.appliedFilter = String(colorFilterRow.current)
|
||
|
||
onCurrentChanged: {
|
||
const next = String(colorFilterRow.current);
|
||
if (next === colorFilterRow.appliedFilter)
|
||
return;
|
||
colorFilterRow.appliedFilter = next;
|
||
SystemSettings.applyColorFilter(next);
|
||
}
|
||
}
|
||
}
|
||
|
||
SettingsCard {
|
||
title: "Motion"
|
||
subtitle: "Nothing animates while idle. This is the motion you asked for — windows opening, workspaces sliding, panels appearing."
|
||
|
||
// The detail says more than the schema's does because on this page the
|
||
// claim is the point: the shell's own durations now collapse to zero
|
||
// when this is off, so the bar, the dock and the panels genuinely stop
|
||
// moving. Until that landed, this switch reached the compositor and
|
||
// left the shell animating over the top of it.
|
||
ToggleRow {
|
||
setting: "animationsEnabled"
|
||
detail: "Window, workspace and panel motion — including the shell's own bar, dock and panels, which now stop with everything else"
|
||
}
|
||
|
||
ToggleRow { setting: "dimInactive" }
|
||
|
||
// The amount only means anything while dimming is on, so it goes quiet
|
||
// rather than disappearing: a row that vanishes takes the explanation
|
||
// of what the switch above it does with it.
|
||
SliderRow {
|
||
setting: "dimStrength"
|
||
enabled: DesktopPreferences.get("dimInactive") === true
|
||
opacity: enabled ? 1 : 0.4
|
||
}
|
||
|
||
SliderRow { setting: "inactiveOpacity"; divider: false }
|
||
}
|
||
|
||
SettingsCard {
|
||
title: "Hearing"
|
||
subtitle: "What the desktop does instead of making a sound."
|
||
|
||
ToggleRow { setting: "visualAlerts"; divider: false }
|
||
|
||
Item { width: 1; height: 10 }
|
||
|
||
// Said the same way the keyboard card says its absence, rather than as
|
||
// a row wearing a badge that stands for a control it never had.
|
||
SettingsNote {
|
||
headline: "Mono audio is not offered yet"
|
||
body: "Folding stereo into one channel is a real change to the PipeWire graph, and a switch that only looked like it did that would be worse than its absence. Balance lives on the Sound page meanwhile."
|
||
}
|
||
}
|
||
|
||
SettingsCard {
|
||
title: "Keyboard & pointer"
|
||
subtitle: "Key behavior lives with the Keyboard settings; what the pointer does when you stop moving it lives here."
|
||
|
||
ActionRow {
|
||
label: "Key repeat"
|
||
detail: "Delay and speed are on the Keyboard page, with the rest of the keymap"
|
||
action: "Open Keyboard"
|
||
onTriggered: ShellState.openSettings("shortcuts")
|
||
}
|
||
|
||
SliderRow { setting: "cursorInactiveTimeout"; zeroLabel: "Never"; divider: false }
|
||
|
||
// The card's rows sit flush against each other; the note is a
|
||
// separate thing and needs the gap to read as one.
|
||
Item { width: 1; height: 10 }
|
||
|
||
// The receipts, not a warning. See SettingsNote for why this is quiet.
|
||
SettingsNote {
|
||
headline: "Sticky, slow and bounce keys are not offered"
|
||
body: "Hyprland has no such options — asked of the running compositor rather than assumed — and GNOME's switches for them are applied by a daemon this session does not run, so a switch here would be wired to nothing. On Wayland each compositor implements these for itself; if Hyprland grows them, they land on this page."
|
||
}
|
||
}
|
||
|
||
SettingsCard {
|
||
title: "Screen reader"
|
||
subtitle: "Orca is a separate application and is reported as one: either its process is running or it is not."
|
||
|
||
SettingRow {
|
||
label: "Orca"
|
||
detail: root.screenReaderDetail
|
||
controlWidth: 200
|
||
|
||
Row {
|
||
anchors.right: parent.right
|
||
anchors.verticalCenter: parent.verticalCenter
|
||
spacing: 9
|
||
|
||
StatusBadge {
|
||
anchors.verticalCenter: parent.verticalCenter
|
||
text: Accessibility.orcaRunning ? "Running" : "Stopped"
|
||
tone: Accessibility.orcaRunning ? Theme.ok : Theme.fgMuted
|
||
}
|
||
|
||
SettingsButton {
|
||
anchors.verticalCenter: parent.verticalCenter
|
||
text: Accessibility.orcaRunning ? "Stop" : "Start"
|
||
onClicked: {
|
||
if (Accessibility.orcaRunning)
|
||
Accessibility.stopOrca();
|
||
else
|
||
Accessibility.startOrca();
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
SettingRow {
|
||
label: "This application, read aloud"
|
||
detail: "Every settings row carries a spoken name and takes keyboard focus — Tab walks the page, Space flips a switch, the arrows move a slider or step a choice"
|
||
controlWidth: 90
|
||
divider: false
|
||
|
||
StatusBadge {
|
||
anchors.right: parent.right
|
||
anchors.verticalCenter: parent.verticalCenter
|
||
text: "Built in"
|
||
tone: Theme.ok
|
||
}
|
||
}
|
||
}
|
||
|
||
SettingsCard {
|
||
visible: Accessibility.lastError !== ""
|
||
title: "Could not apply"
|
||
subtitle: Accessibility.lastError
|
||
}
|
||
}
|