Waybar项目中的wlr-workspaces模块详解

郦添楠Joey

于 2025-06-05 09:08:42 发布

阅读量269

点赞数 3

本文链接：https://blog.youkuaiyun.com/gitblog_00550/article/details/148441473

版权

Waybar项目中的wlr-workspaces模块详解

Waybar Highly customizable Wayland bar for Sway and Wlroots based compositors. :v: :tada: 项目地址: https://gitcode.com/gh_mirrors/wa/Waybar

概述

Waybar是一款现代化的Wayland状态栏工具，其中的wlr-workspaces模块专门用于显示和管理Wayland合成器中的工作区(workspaces)。这个模块为使用wlroots基础的Wayland合成器(如Sway、River等)提供了工作区可视化功能，让用户可以直观地查看和切换不同的工作区。

核心功能

wlr-workspaces模块主要提供以下功能：

显示当前可用的工作区列表
标识活动工作区和紧急工作区
支持通过点击切换工作区
提供丰富的工作区排序选项
允许自定义工作区显示格式和图标

配置详解

基础配置

要启用wlr-workspaces模块，需要在配置文件中添加以下内容：

"wlr/workspaces": {
    // 配置项将在这里添加
}

主要配置项

format (字符串类型，默认值："{name}")
- 定义工作区的显示格式
- 可用变量：{name}表示工作区名称，{icon}表示图标
format-icons (数组类型)
- 基于工作区名称和状态显示对应图标
- 支持为特定工作区名称设置图标
- 特殊图标：
  - "default"：无匹配时的默认图标
  - "active"：活动工作区图标
排序选项
- sort-by-name (布尔类型，默认true)：按名称排序
- sort-by-coordinates (布尔类型，默认true)：按坐标排序
- sort-by-number (布尔类型，默认false)：按数字排序(优先级最高)
显示选项
- all-outputs (布尔类型，默认false)：是否在所有输出显示工作区
- active-only (布尔类型，默认false)：是否只显示活动/紧急工作区

使用技巧

图标自定义

通过format-icons可以创建直观的工作区标识系统。例如，可以为不同工作区分配不同的图标：

"format-icons": {
    "1": "",  // 终端
    "2": "",  // 浏览器
    "3": "",  // 代码编辑器
    "active": "",  // 活动状态
    "default": ""  // 默认状态
}

排序策略

当同时启用多种排序方式时，优先级如下：

sort-by-number (如果启用)
sort-by-name (如果启用)
sort-by-coordinates (如果启用)
工作区ID (如果所有排序都禁用)

点击操作

模块支持以下点击操作：

左键点击：默认激活(activate)工作区
其他点击行为可通过配置实现，如关闭(close)工作区

样式定制

可以通过CSS为工作区模块添加个性化样式，主要支持的CSS选择器包括：

#workspaces { /* 整个工作区容器样式 */ }
#workspaces button { /* 所有工作区按钮基础样式 */ }
#workspaces button.active { /* 活动工作区样式 */ }
#workspaces button.urgent { /* 紧急工作区样式 */ }
#workspaces button.hidden { /* 隐藏工作区样式 */ }

实际应用示例

以下是一个完整的配置示例，展示了如何将工作区按数字排序并分配特定图标：

"wlr/workspaces": {
    "format": "{icon}",
    "format-icons": {
        "1": "一",
        "2": "二",
        "3": "三",
        "4": "四",
        "5": "五",
        "active": "★",
        "default": "○"
    },
    "sort-by-number": true,
    "on-click": "activate"
}

这个配置会：