ironbar/docs/modules/Workspaces.md

> ⚠ **This module is currently only supported on Sway**

Shows all current Sway workspaces. Clicking a workspace changes focus to it.

![Screenshot showing workspaces widget using custom icons with browser workspace focused](https://user-images.githubusercontent.com/5057870/184540156-26cfe4ec-ab8d-4e0f-a883-8b641025366b.png)

## Configuration

> Type: `workspaces`

| Name           | Type                  | Default | Description                                                                                                          |
|----------------|-----------------------|---------|----------------------------------------------------------------------------------------------------------------------|
| `name_map`     | `Map<string, string>` | `{}`    | A map of actual workspace names to their display labels. Workspaces use their actual name if not present in the map. |
| `all_monitors` | `boolean`             | `false` | Whether to display workspaces from all monitors. When `false`, only shows workspaces on the current monitor.         |

<details>
<summary>JSON</summary>

```json
{
  "end": [
    {
      "type": "workspaces",
      "name_map": {
        "1": "",
        "2": "",
        "3": ""
      },
      "all_monitors": false
    }
  ]
}
```

</details>

<details>
<summary>TOML</summary>

```toml
[[end]]
type = "workspaces"
all_monitors = false

[[end.name_map]]
1 = ""
2 = ""
3 = ""

```

</details>

<details>
<summary>YAML</summary>

```yaml
end:
  - type: "workspaces"
    name_map:
      1: ""
      2: ""
      3: ""
    all_monitors: false
```

</details>

<details>
<summary>Corn</summary>

```corn
{
  end = [
    {
      type = "workspaces",
      name_map.1 = ""
      name_map.2 = ""
      name_map.3 = ""
      all_monitors = false
    }
  ]
}
```

</details>

## Styling

| Selector                    | Description                          |
|-----------------------------|--------------------------------------|
| `#workspaces`               | Workspaces widget box                |
| `#workspaces .item`         | Workspace button                     |
| `#workspaces .item.focused` | Workspace button (workspace focused) |