add quicklaunch (Dolphin, Firefox)
This commit is contained in:
@@ -5,7 +5,7 @@ A bottom desktop-environment panel for wlroots-based compositors, built on
|
||||
|
||||
| Section | Contents |
|
||||
| ------- | ----------------------------------------------------------------- |
|
||||
| Left | Application menu built from `.desktop` entries, with search |
|
||||
| Left | Application menu built from `.desktop` entries, with search, and pinned quick-launch icons |
|
||||
| Middle | Open windows (task list), click to focus, middle-click to close |
|
||||
| Right | On-screen keyboard, wifi, bluetooth, and a session menu: log out, suspend, restart, shut down |
|
||||
|
||||
@@ -122,6 +122,12 @@ The launcher is a full-screen overlay layer surface rather than an
|
||||
`xdg-popup`, which is what makes click-away dismissal and keyboard focus work on
|
||||
any wlroots compositor without compositor-specific focus grabs.
|
||||
|
||||
**Quick launch.** The ids in `quickLaunch` are pinned as icons next to the app
|
||||
menu, in the order listed, and clicking one launches that entry exactly as the
|
||||
menu would — field codes stripped, `Terminal=true` honoured, and its own systemd
|
||||
scope when the panel is a unit. An id that is not installed is skipped rather
|
||||
than left as a dead button, so the same list can be carried between machines.
|
||||
|
||||
**On-screen keyboard.** One button shows squeekboard, another click hides it,
|
||||
and the button is accented while the keyboard is up. squeekboard runs as a
|
||||
systemd user unit (`oskUnit`, `squeekboard.service` by default): showing starts
|
||||
@@ -196,6 +202,9 @@ running with `qs --path .`).
|
||||
small output still gets a usable menu.
|
||||
- `terminal` — argv prefix for entries with `Terminal=true`. Honours
|
||||
`$TERMINAL`; otherwise change the `["foot"]` fallback to your terminal.
|
||||
- `quickLaunch` — desktop entry ids pinned next to the app menu, in order.
|
||||
Defaults to `["firefox", "org.kde.dolphin"]`; set `[]` for none. The ids are
|
||||
desktop file names without the extension (`ls /usr/share/applications`).
|
||||
- `showOsk` — set `false` to drop the on-screen keyboard button entirely.
|
||||
- `oskUnit` — the systemd user unit squeekboard runs as.
|
||||
- `showWifi` — set `false` to drop the wifi button entirely.
|
||||
@@ -223,6 +232,7 @@ modules/Bar.qml The panel window and its three sections
|
||||
modules/AppMenu.qml Left: launcher button
|
||||
modules/Launcher.qml The application menu overlay
|
||||
modules/AppEntry.qml One row in the menu
|
||||
modules/QuickLaunch.qml Left: pinned app icons
|
||||
modules/WindowList.qml Middle: task list
|
||||
modules/WindowButton.qml One task button
|
||||
modules/OskMenu.qml Right: on-screen keyboard button
|
||||
@@ -287,6 +297,11 @@ components/ToggleSwitch.qml On/off switch
|
||||
how the panel notices squeekboard going away, since it does not announce that
|
||||
itself — would never arrive. Showing retries the call for a few seconds
|
||||
because the unit goes active a moment before squeekboard claims its name.
|
||||
- The quick-launch icons resolve their ids by scanning `DesktopEntries` rather
|
||||
than calling `byId`. A function call in a binding creates no dependency on the
|
||||
model, so it would be evaluated once against a still-empty entry list and stay
|
||||
empty; scanning `applications.values` makes the binding re-run when the scan
|
||||
finishes, and when an app is installed or removed later.
|
||||
- `qs ipc call` cannot reach a handler function named `show`: the name collides
|
||||
with the `ipc show` subcommand and the call silently turns into a listing. The
|
||||
`osk` target uses `open` and `close` instead, which matches the menu targets
|
||||
|
||||
Reference in New Issue
Block a user