> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAG 113：UI 焦点处理

> 始终展示高度可见的焦点指示器，且不会消失或跳到屏幕外的元素上，让玩家清楚知道哪个 UI 元素处于输入焦点状态。

## 目标

确保玩家（包括低视力玩家）始终清楚哪一个 UI 元素处于焦点状态。

## 概述

焦点指示器是显示当前哪个 UI 元素处于输入焦点的视觉标记。任何交互输入（例如“按 A 选择”）都作用于当前处于焦点的元素。指示器过于微弱或时隐时现，会成为低视力玩家、认知障碍玩家、辅助技术使用者以及新手玩家的障碍。若焦点跳到隐藏或屏幕外的元素上，玩家将无法继续操作。

## 范围界定问题

* 用什么方式表示焦点（颜色、描边，还是两者兼有）？
* 该方式对低视力或色盲玩家是否可见？
* 是否始终显示哪个控件处于焦点？
* 该指示器在游戏中**所有** UI 背景（颜色、图像、动画）上都可见吗？
* 您的游戏是否包含覆盖在其他 UI 之上的对话框（这是焦点指示器常见的“丢失点”）？

## 实施指南

### 高度可见的焦点指示器

所有 UI 元素在获取焦点时都应显示高度可见的焦点指示器。方式包括：

* 在聚焦元素周围绘制边框
* 聚焦时增加元素大小或字重
* 在元素后加入高对比度的填充块
* 组合多种方式以形成冗余

**示例：**

* *The Outer Worlds* — 焦点指示器同时绘制描边、高对比度填充块，并改变字重和颜色。
* *Fallout 76* — 暂停菜单以高对比度黄色背景高亮当前项，并在其左侧显示一个小型动画角色。

### 始终可见，绝不出界

* 视觉焦点指示器应始终在屏幕上可见。
* 任何可聚焦元素上的焦点指示器都不应变得不可见。
* 焦点不应移动到不可见或屏幕外的元素上。
* 出现对话框时（例如《Forza Horizon 4》的“未保存更改”警告），焦点应移动到对话框中第一个可交互控件，并且在对话框打开期间，不应允许将焦点移出对话框。

## 潜在的玩家影响

| 玩家           | 受影响 |
| :----------- | :-: |
| 无视觉的玩家       |  ✓  |
| 低视力玩家        |  ✓  |
| 有认知或学习障碍的玩家  |  ✓  |
| 触及范围和力量有限的玩家 |  ✓  |
| 精细动作能力有限的玩家  |  ✓  |
| 使用假肢装置的玩家    |  ✓  |
| 休闲玩家、低龄玩家    |  ✓  |

## 资源

* [Designing for Accessibility: Focus States — DockYard](https://dockyard.com/blog/2020/04/28/designing-for-accessibility-focus-states)
* [WCAG 2.2 SC 2.4.11: Focus Appearance (Minimum)](https://www.w3.org/WAI/WCAG22/Understanding/focus-appearance-minimum.html)


## Related topics

- [XBOX Accessibility Guidelines（XAG）](/zh-CN/build/game-principles/accessibility/xbox-accessibility-guidelines.md)
- [PlayFab Party 发行说明](/zh-CN/services/playfab/multiplayer/networking/release-notes.md)
- [XAG 112：UI 导航](/zh-CN/build/game-principles/accessibility/xag-deep-dives/xag-112-ui-navigation.md)
- [XAG 114：UI 上下文](/zh-CN/build/game-principles/accessibility/xag-deep-dives/xag-114-ui-context.md)
- [窗口显示模式与 title-callable UI 对话框](/zh-CN/build/gdk-and-engines/guides/window-display-modes-tcui.md)