Skip to content

Commit

Permalink
Add "Keyboard navigation" system preference
Browse files Browse the repository at this point in the history
  • Loading branch information
TrevorBurnham committed Nov 16, 2024
1 parent ae7b6b9 commit 45a44c6
Show file tree
Hide file tree
Showing 4 changed files with 64 additions and 0 deletions.
1 change: 1 addition & 0 deletions docs/.vitepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -246,6 +246,7 @@ export default defineConfig({
'applepressandholdenabled.md',
'applefnusagetype.md',
'applekeyboardfnstate.md',
'applekeyboarduimode.md',

'mission-control',
'mru-spaces.md',
Expand Down
63 changes: 63 additions & 0 deletions docs/keyboard/applekeyboarduimode.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: Keyboard navigation | Keyboard
description: Choose whether to enable moving focus with Tab and Shift Tab.
head:
- - meta
- property: 'og:title'
content: macOS defaults > Keyboard navigation
- - meta
- property: 'og:description'
content: Choose whether to enable moving focus with Tab and Shift Tab.
---

# Keyboard navigation

Choose whether to enable moving focus with Tab and Shift Tab.

- **Tested on macOS**:
- Sonoma
- Sequoia
- **Parameter type**: int
- 0
- 2

## Set to: Disabled (default)

```bash
defaults write NSGlobalDomain AppleKeyboardUIMode -int "0"
```

<img
src="./images/AppleKeyboardUIMode/disabled.png"
alt="Save changes dialog with keyboard navigation disabled"
width="574" height="674" style="height: auto"
/>

## Set to: Enabled

```bash
defaults write NSGlobalDomain AppleKeyboardUIMode -int "2"
```

<img
src="./images/AppleKeyboardUIMode/enabled.png"
alt="Save changes dialog with keyboard navigation enabled, showing focus ring on Don't Save"
width="574" height="674" style="height: auto"
/>

## Read current value

```bash
defaults read NSGlobalDomain AppleKeyboardUIMode
```

## Reset to default value

```bash
defaults delete NSGlobalDomain AppleKeyboardUIMode
```

## Set value from UI

1. <a href="x-apple.systempreferences:com.apple.preference.keyboard">Open the Keyboard preference pane in System Preferences</a>
2. Toggle "Keyboard navigation"
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 45a44c6

Please sign in to comment.