跳转至

状态公告投递系统规范

{
  "scope": "global",
  "concerns": {
    "announcements": {
      "names": [
        "useAnnounce",
        "useAnnounceRenderedText",
        "useBusyAnnouncement"
      ],
      "patterns": ["aria-live", "role=[\"'{](?:status|alert|log)\\b"],
      "claims": ["FR1", "FR2", "FR3", "FR12"]
    }
  }
}

意图

屏幕阅读器用户在每次状态变化发生时,以正确的紧急程度恰好听到一次。消息不会因为其活动区域与文本同时出现而丢失,也不会因为页面两个部分都声称拥有这条消息而被听到两次。

构建者为每个报告状态的组件得到一条规则:指定消息的唯一拥有者,并通过共享公告通道投递瞬时消息。

非目标

  • 组件报告哪些事件。组件与组件族记录决定什么是状态消息;本记录决定其投递方式。
  • 具体措辞。文本来自 architecture:internationalization。
  • 焦点移动。状态消息从不移动焦点;焦点规则保留在 architecture:interaction-modality 与组件记录中。
  • 抢占焦点的模态警报,例如 AlertDialog。它们不是状态消息。
  • 特定屏幕阅读器上的语音输出。该证据由 spec:AST-009 负责。
  • 当原生模态使页面其余部分失效时,通道托管于何处。托管由 spec:AST-003(FR15、FR18、FR20)负责。
  • 满足本契约的等效内部实现仍然有效。

需求

  • FR1 — 每条消息只有一个拥有者。 Astryx 公告的每条状态消息都恰好有一个公告拥有者。显示相同文字的其他任何元素都不得携带活动角色(status、alert、log)或 aria-live。
  • FR2 — 瞬时消息使用共享通道。 当显示消息的元素与文本一同挂载、卸载或被替换时,拥有者通过共享公告通道进行公告,但 FR3(紧急 Banner 的 role="alert" 消息)、FR4、FR10、FR11 和 FR14 规定的情形除外。新元素不得(MUST NOT)携带活动角色或 aria-live,紧急 Banner 的 role="alert" 消息(FR3)除外。
  • FR3 — 活动角色仅存在于持久容器上。 组件只可(MAY)在内容变化时保持挂载的元素上拥有活动角色。它不得(MUST NOT)在挂载该元素时已携带要公告的文本,但紧急 Banner 的 role="alert" 消息除外,该消息以 FR5 的断言式紧急程度投递。
  • FR4 — 活动容器拥有在其内部添加的内容。 在已挂载活动容器内部添加的内容由该容器按其紧急程度投递。随该内容添加的元素不得(MUST NOT)携带自身的活动角色或通过通道公告相同内容。FR3 允许的持久组件区域,如 Button 的加载区域或输入的无效输入区域,保留其自身角色并以自身紧急程度投递自身内容。
  • FR5 — 紧急程度。 在活动容器之外,错误和时效关键性故障使用断言式通道。所有其他状态消息使用礼貌式通道。在已挂载的活动容器内部,适用 FR4。在打开的原生模态内部,FR14 的容器承载相同的两种紧急程度。
  • FR6 — 每次场合仅一次。 一次场合是一次状态转换或一次用户操作。拥有者每次场合公告一次。重渲染、StrictMode 重放以及对同一值的更新不会重复公告。具有相同文字的新场合会再次公告。
  • FR7 — 显示的文字保持可读。 通过通道投递不会向辅助技术隐藏可见消息。可见元素仍可用于浏览模式和 aria-describedby。公告的文字与显示的文字一致。
  • FR8 — 拥有者内部的指示器保持静默。 在拥有任务的组件内部组合的可视指示器,如忙碌控件中的 Spinner,不公告任何内容且不携带活动角色。拥有组件在每次忙碌开始时(FR6)通过通道或 FR3 允许的持久区域公告一次其忙碌状态。同一操作的结果已公告后,忙碌开始不再被公告;当结果先公告时,挂起的忙碌公告被丢弃。独立指示器是自身的拥有者,并遵循 FR2。
  • FR9 — 每个文档一个共享通道。 通道是每个文档的一个礼貌式区域和一个断言式区域。它们以空状态创建,在文档生命周期内保持挂载,并在每次公告后不久清除其文本,以免过时文本残留。在前一条消息被暴露之前写入区域的各消息按顺序合并为一次公告;任何消息都不会被丢弃,除非 hasReplace 实例撤回某条消息。以 hasReplace 创建的 useAnnounce 实例陈述其拥有者的一个当前状态,例如搜索的结果计数:它写入的每条消息在该实例前一条消息尚未暴露时将其撤回,无论各自的紧急程度如何,并在其自身紧急程度的区域中被说出;已暴露的消息已被听到并保留。来自其他实例以及来自不带 hasReplace 的实例的消息仍然合并。useAnnounce 接受一个可选的 options 对象,含一个字段 hasReplace(默认 false),提供给每个调用者,Astryx 的组件和应用都一样(spec:AST-075 DEC-2): useAnnounce({hasReplace: true});它返回的 announce(message, politeness) 不变。FR13 说明来自此类实例的自身内容消息何时出现。同一帧内重复的相同消息视为一条消息(FR6)。空消息清除区域,包括已合并但尚未暴露的消息。 useAnnounce 是访问它的公开方式。当打开的原生模态包围调用者时,它改而遵循 FR14。
  • FR10 — 重新托管的拥有者通过其所在的模态发声。 当共享通道未被允许进入模态托管时,spec:AST-003 重新托管到原生模态上方(FR16、FR18)的全局托管拥有者通过其宿主所在的模态的容器(FR14)进行公告,否则通过共享通道。它不添加自身的活动容器。
  • FR11 — 页面加载后出现时消息才公告。 页面加载涵盖直到文档完成加载为止的所有已提交内容,包括服务端或客户端的页面首次渲染。页面加载期间存在的消息不会被公告。文档完成加载后插入的消息,或其文本在此之后发生变化的消息,会被公告一次。这包括客户端渲染的路由变更带来的消息,以及客户端导航插入的服务端渲染消息。仅通过其公告才能到达辅助技术的消息,例如 spec:AST-056 FR3 下选择器的空面板消息,即使在页面加载期间也会公告。FR4 适用于已挂载的活动容器内部,FR6 管理重复。FR11 涵盖公告自身渲染内容的组件;component:FieldStatus、分组字段的状态消息(如输入组内的 TimeInput)以及 component:Banner 保留各自的公告规则。
  • FR12 — 自身内容公告在任何地方行为一致。 FR11 涵盖的每个组件都公告元素的渲染文本,或在其不渲染文本时公告其可访问名称,排除 aria-hidden 内容。对于页面加载期间存在的文本保持静默(FR11 为仅公告消息规定的情形除外),在每次后续出现或文本变化时公告一次,并在元素被隐藏时重新武装。拥有者未为其重新渲染的出现将在拥有者的下一次渲染时被公告(FR13)。在服务端渲染期间它不公告任何内容且不添加活动角色,并且可服务端渲染的采用者保持可服务端渲染并通过服务端安全组件边界检查。任何满足此要求的机制都是有效的;architecture:react-component-runtime INV10 对其进行定位。
  • FR13 — 自身内容公告行为良好。 公告组件自身的渲染内容(FR11)在重渲染、依赖变化和 StrictMode 重放下每次场合发生一次,在元素隐藏时不执行任何工作,并且卸载后不留下任何痕迹。操作公告,例如查询处理程序的结果计数或 FR8 忙碌开始,保留其自身拥有者。选择器自身的空面板消息(FR11)来自其搜索的 hasReplace 实例(FR9),因此它替换搜索尚未暴露的结果计数,而搜索的下一个计数在尚未暴露时替换它。在拥有者未重新渲染的情况下被揭示的内容,例如在 React 外部移除了祖先的 hidden 属性时,将在拥有者的下一次渲染时被公告,并且在内容隐藏期间没有任何东西监视该揭示(architecture:react-component-runtime INV5、INV10)。architecture:react-component-runtime INV10 负责此工作的位置。
  • FR14 — 打开模态内部的拥有者在其中投递。 当共享通道在原生模态内部未暴露时(平台支持),拥有者本会通过共享通道发送的消息——FR2 消息或操作公告,如结果计数、选择变化或忙碌开始——遵循包围其拥有者的最近打开原生模态。当 Astryx 渲染该模态(如 Dialog、模态 BottomSheet、模态 Drawer、Lightbox 或 CommandPalette)时,消息通过其中的持久礼貌式容器和持久断言式容器投递。当应用在无 Astryx 的情况下渲染该模态时,适用 FR14 的最后一句话。当没有打开的原生模态包围拥有者时,消息使用共享通道。公开的 useAnnounce 走此路线:从这样的模态内部由组件或应用代码发送的消息,通过该模态的容器投递,没有单独路径。路线跟随拥有者公告时所处的位置,因此一个有时在模态内、有时不在的拥有者无需第二条公告路径。渲染 Astryx 模态并就模态内容进行公告的 Astryx 组件,如 CommandPalette 的结果计数或 Lightbox 的位置,在该模态打开时对于此路线而言处于该模态内部。应用代码通过在模态内部渲染的组件调用 useAnnounce 来访问模态的容器;在模态外部进行的调用,即使由渲染该模态的组件进行,也走该调用所在位置的路线。当模态在其容器中的消息尚未暴露时关闭,该消息通过关闭后暴露的通道投递——当 Astryx 渲染它时,即当时位于顶部的原生模态的容器;当没有原生模态打开时,即共享通道——因此在其模态即将关闭前发送的消息,如"已保存"后跟关闭 Dialog,不会丢失。当当时位于顶部的模态是应用在无 Astryx 情况下渲染的模态时,该消息的投递超出本记录范围。FR14 为每条此类消息在每个模态中添加一个每种紧急程度的容器;拥有者自身的持久 FR3 区域——Button 的加载区域、输入的无效输入区域——如 FR4 所述在模态内保留其角色和紧急程度,spec:AST-003 重新托管到模态上方的拥有者写入这些容器(FR10)。FR14 的容器是模态 dialog 元素的直接子元素,首次使用时以空状态创建(FR3),分别携带 status 和 alert(FR5),并在每次公告后不久清除;在前一条被暴露之前写入某一容器的消息按顺序合并,但 hasReplace 实例的消息会撤回该实例尚未暴露的前一条消息,无论在哪一个容器中,如 FR9 所述。同一帧内重复的相同消息视为一条消息,空消息清除它,包括已合并但尚未暴露的消息,如 FR9 对

共享通道。FR6 适用于每个所有者的消息。一个忙碌所有者在模态框内的 FR8 区域,就是 FR14 的礼貌容器。当另一个模态框在该所有者的模态框上方打开时(spec:AST-003 FR17),所有者的容器随其模态框一起处于 inert 状态,而它在被遮挡期间播报的消息不会被听到——容器会在模态框重新置于顶部之前清除该消息——因为所有者本身在此之前也不可操作。当包围忙碌所有者的最近打开的原生模态框,是由应用在未使用 Astryx 的情况下渲染时,所有者通过该模态框内的持久区域播报其忙碌开始(FR3、FR8),包括当该模态框本身处于一个已打开的 Astryx 模态框内部时;位于此类模态框内的所有者产生的其他投递不在本记录范围内。

平台支持

  • 支持的特性/引擎基线:包支持的浏览器。
  • 不支持的行为:在没有 document 的情况下(服务端渲染),播报是空操作,且不渲染任何内容。
  • 当原生模态对话框打开时,页面 body 上的共享通道不会暴露给辅助技术,直到 spec:AST-003 将其接纳为模态宿主。被重新托管到模态框上方的所有者使用该模态框的容器(FR10),而渲染在模态框内部的所有者——一个忙碌控件(FR8)、选择器的选中和结果消息、面板的搜索结果——通过该模态框内部的持久容器播报(FR14)。既不在模态框内部、也未重新托管到其上方的所有者的投递不在本记录范围内。在 Astryx 未渲染的原生模态框内,忙碌所有者通过该模态框内的持久区域播报其忙碌开始(FR3、FR8),其他投递不在本记录范围内。
  • 浏览器证据:DOM 与无障碍树检查证明了路由(FR1–FR5、FR7–FR10、FR14)。在真实 AT 上的播报时机、顺序和重复是建议的 spec:AST-009 后续事项,而非合并或发布要求。

当前状态影响

  • component:FieldStatus AR1 和 component:Banner FR8 在已挂载的实时容器内遵循 FR4;在其他地方它们已经符合 FR2、FR5 和 FR7。
  • architecture:react-component-runtime INV5 获得了其所需的、对 document 所属通道的权限(FR9)。INV2 和 INV3 已经要求 FR6。
  • Switch:忙碌状态通过通道播报,同时 thumb Spinner 也以 role="status" 挂载。在 FR8 下,thumb Spinner 静默。在 FR6 下,StrictMode 重放不会重复忙碌播报。
  • Spinner(独立使用):以 role="status" 及其名称挂载。在 FR2 和 FR11 下,当它在页面加载后出现时,通过通道播报其标签;在页面加载时已存在则保持静默。它在没有 live role 的情况下暴露的角色和名称不在本记录范围内。
  • family:input-fields 成员及其他忙碌控件(TextInput、TextArea、Selector、MultiSelector、ComplexSelector、Typeahead、Tokenizer、日期和时间输入、FileInput、CheckboxInput、CommandPaletteInput、DropdownMenuSubMenu、Thumbnail,以及 lab 中的 EmojiPicker、Schedule 和 Comments 历史加载器):每个都在忙碌控件内部组合了一个带 role="status" 的 Spinner。在 FR8 下,该 Spinner 静默,每个控件通过通道播报自己的忙碌状态。Switch 已经是这样做的。CommandPalette 以原生模态框形式打开,因此它通过对话框内的持久区域播报每次忙碌开始,包括打开或清除查询时的加载(FR3);在 FR14 下,该区域是对话框的礼貌容器。
  • Astryx 模态框内的所有者(FR14):useAnnounce 只写入页面 body 的通道。在 FR14 下,它跟随包含调用方的最近打开的原生模态框;当 Astryx 渲染该模态框时,投递到该模态框的容器中,因此渲染在模态框内的所有者和应用代码不需要单独的路径。那些在模态框内未暴露、随后才变得可听的通道消息,包括使用 useAnnounce 发送的应用消息:渲染在 Dialog、模态 BottomSheet、模态 Drawer 或 Lightbox 内的 Selector、MultiSelector、Typeahead、Tokenizer、日期或时间输入,或任何其他通道调用方。模态框内的忙碌所有者已经在对话框内播报其忙碌开始;其区域是 FR14 的礼貌容器,因此在前一条尚未暴露时写入的忙碌开始会被合并,而不是最后一条替换其他条;嵌套在打开模态框内的非模态 sheet 或 drawer 中的忙碌所有者,会在该模态框内播报,而不是在页面 body 上。CommandPalette 的结果计数和空结果(其忙碌开始已经使用对话框内区域),以及 Lightbox 的位置和缩放消息,都是从各自渲染的模态框上方发送的,因此按调用方所在位置路由无法到达模态框;在 FR14 下,每个组件都将它们投递到自己打开的模态框中,这是除 useAnnounce 之外每个组件中的变更。当模态框关闭时仍待处理的消息,会被写入对话框内或惰性页面 body 上;在 FR14 下,它会移动到关闭后暴露的通道。
  • ChatMessageList:其顶部加载 Spinner 是日志中 role="status" 的子节点。在 FR4 和 FR8 下它保持静默,ChatMessageList 通过通道播报其加载状态。
  • EmptyState:其根节点与文本一起挂载 live role。在 FR2、FR11 和 FR12 下,它不携带 live role,并在页面加载后出现时播报。EmptyState 保持可服务端渲染。
  • ChatComposer 状态栏不携带 live role,并从自身的 Effect 播报调用方的状态消息。这是自有内容,因此在 architecture:react-component-runtime INV10 下,它移到共享模块上。
  • 聊天触发菜单的加载行不携带 live role。其“Searching…”播报是菜单在 FR8 下的忙碌开始,并保留其自己的所有者。
  • Button:其持久加载区域符合 FR3,但当 Button 首次渲染加载且该区域挂载并持有其文本时除外。在实时容器内,它保持其角色和紧迫性(FR4)。
  • DateInput、DateTimeInput、TimeInput 和 NumberInput:它们持久、断言式的无效输入区域符合 FR3,并且在实时容器内保持其角色和紧迫性(FR4)。
  • ChatSystemMessage:在 role="log" 列表内强制使用 role="status"。在 FR4 下,日志投递它;分隔线和日期是普通日志内容。
  • ChatTypingIndicator(lab):从自身 Effect 播报其标签。在实时日志内遵循 FR4;否则遵循 FR11 到 FR13。它保留自己的 Effect,因为核心模块未发布到 lab(INV10)。
  • Comments(lab):其错误横幅和进度标签与文本一起挂载 live role。在实时日志内遵循 FR4;否则遵循 FR2。
  • Selector 和 MultiSelector 将其空面板消息渲染为 role="presentation",因此它只能通过播报到达辅助技术,并且在页面加载时也会播报(FR11、spec:AST-056 FR3)。Typeahead 和 CommandPalette 在页面加载后播报其空状态,其余不变。
  • component:FieldStatus AR1 不变:字段消息在首次挂载时播报,因为它报告字段出现时的字段状态。
  • component:Banner FR8:调用方从其过渡处理器播报异步结果,因为只有调用方知道 Banner 是新结果还是持久内容;紧急消息可以改为携带 role="alert",Banner 会将其放在消息元素上(FR2、FR3)。FR11 和 FR12 涵盖播报自身内容的组件。
  • useAnnounce:在同一帧中写入的消息会被合并,而不是后一条替换前几条,但来自 hasReplace 实例的消息除外(FR9)。
  • useAnnounce 将同一帧中重复的相同消息折叠为一条(FR9);一旦同一操作的结果已播报,忙碌所有者会丢弃待处理的忙碌播报(FR8)。
  • Selector、MultiSelector、Typeahead、Tokenizer 的 sheet、CommandPalette 和 PowerSearch 在每次查询变化时播报结果计数,MultiSelector 还播报其创建行。当条码扫描器、听写或自动化在同一帧内输入时,一个所有者被取代的计数会被合并(1 result Create "Urg" Create "Urge" …),并且计数后跟空面板消息时会同时说出两者。在 FR9、FR13 和 FR14 下,每个组件都通过一个单独的 useAnnounce({hasReplace: true}) 实例发送其结果计数,MultiSelector 通过该实例发送其创建行,因此只有当前一条会被说出;选择消息则保留自己普通的实例。useAnnounce 新增了该可选选项;Astryx 自己的结果计数使用它,包括 spec:AST-075 DEC-2 组合的 combobox(其 FR7)以及 Tokenizer 的 sheet。没有该选项的实例继续合并。
  • spec:AST-037 FR9(Timer 不添加未经请求的 live region)已经符合要求。
  • 按 status 或 alert 角色查询这些元素的消费者测试需要变更。发布说明中会列出每个受影响的组件。
契约 验证 代表性状态 变更或失败预期
FR1, FR4 共享测试:每条播报消息只有一个 live 所有者 显示 Toast;忙碌的 Switch;聊天记录中的系统通知、FieldStatus 错误和失败 Banner;聊天记录中的忙碌 Button 和无效 DateInput(通过) 第二个元素上的 live 角色,或对 live 容器内新增内容的频道播报,会失败
FR2, FR3 共享测试:没有持有其文本的活动元素被挂载 条件状态、toast 卡片、独立 Spinner 挂载带文本的 role="status" 会失败
FR5 通道路由测试 错误、警告、成功、加载 将错误路由到 polite(礼貌)区域,或将成功路由到 assertive(主动)区域,会失败
FR6 针对 channel spy 的 StrictMode 和重渲染测试 繁忙启动、重复重渲染、相同值更新、新事件 同一事件出现两次公告,或新事件没有公告,则失败
FR7 可见消息的无障碍树检查 FieldStatus 已挂载/已卸载、toast 卡片 隐藏可见文本或词语不匹配则失败
FR8 共享测试:繁忙的所有者内部不得包含 live role;在所有者上使用 channel spy 繁忙的 TextInput、Selector、Switch 滑块、ChatMessageList 加载器、繁忙的 CommandPalette(其对话框内部的区域)、在其繁忙公告暴露之前就已结束的操作 带有 live role 或自身独立公告的组合指示器会失败;未发出任何公告的繁忙所有者会失败;在结果公布之后才公布繁忙开始的会失败
FR9 useAnnounce 测试 首次使用、多个组件、区域被移除、服务端渲染、同一帧内的两条消息、在合并消息之后进行清除、同一帧内两条相同的消息、某个 hasReplace 实例的消息在同一帧内写入、同一帧内两个选择器的结果计数、一条结果计数消息后跟其选择器的空面板消息及相反顺序、下一条消息写入时已有 hasReplace 消息被暴露、同一帧内来自无 hasReplace 实例的消息、同一帧内一个选择器的结果计数和选择消息(分属不同实例)、同一 hasReplace 实例中礼貌消息后跟强势消息 第二个文档级区域对、清除延迟后残留的过时文本、来自另一实例或无 hasReplace 实例的同帧消息被丢弃、某 hasReplace 实例的已被取代消息与其下一条消息同时播报、其礼貌消息在其强势消息之后仍被播报、较新的消息按较旧消息的紧急程度播报、已暴露的消息被收回,或者已合并的消息在清除后依然存在,或者完全相同的同帧重复消息被播报两次,则视为失败
FR10 打开 Dialog 时的无障碍树检查 信息和错误 toast 显示在打开的 Dialog 上方 一个 toast 若仅到达 body 级通道、没有暴露的实时容器,或实时容器由视口自行添加,则视为失败
FR14 Hook 测试与 Astryx 模态框打开时的无障碍树检查 Owner 位于任意模态框之外、位于打开的非模态对话框内、位于打开的模态框内(polite 与 assertive、重复相同词语、空消息)、模态框内的 busy 开始、应用在没有 Astryx 的情况下渲染的原生模态框内的 busy 开始、单独存在以及在 Astryx Dialog 内打开;真实引擎中 modal sheet 的行切换、应用代码在 Dialog 内调用 useAnnounce、CommandPalette 结果计数和 Lightbox 位置消息在各自打开时、一条消息在其被暴露前随之关闭其 Dialog(在另一个打开的模态框内以及在页面上)、当覆盖在 Dialog 上方的 CommandPalette 关闭时有一条待处理消息、应用代码在其渲染的 Dialog 之外调用 useAnnounce(body 级通道);搜索的结果计数在 modal sheet 内的一帧中写入;模态框内来自一个 hasReplace 实例的 polite 消息后接 assertive 消息;modal sheet 内结果计数后接其选择器的空面板消息 来自打开的模态框内部、仅到达 body 级通道的通道消息,挂载后仍持有其文本的 FR14 容器,同一对话框中同一紧急程度的第二个 FR14 容器,引擎的无障碍树遗漏的 FR14 容器,来自不同实例的两条消息在第一条被暴露前写入而其中一条丢失,从 FR14 容器播报的 hasReplace 实例的已被取代的消息,在其 assertive 消息之后其 polite 消息仍从模态框的 polite 容器播报,或从 FR14 容器连同其选择器的空面板消息一起播报的计数,在模态框的 FR14 容器中留下文本的空消息,来自 Astryx 模态框内部、仅到达 body 级通道的应用 useAnnounce 消息,关于其打开的模态框、仅到达 body 级通道的 CommandPalette 或 Lightbox 消息,消息在其暴露前因模态框关闭而丢失,或关闭后仍处于 inert 状态的通道收到待处理消息,在应用渲染的原生模态框内、仅到达 body 级通道的 busy 开始,或嵌套在 Astryx Dialog 内的应用渲染的原生模态框中的 busy 开始被传递到 Dialog 的 FR14 容器,则失败
FR11, FR12 辅助函数与组件测试 页面加载时存在 EmptyState、服务器渲染、稍后插入、文本更改、隐藏后再次显示、通过客户端渲染的路由变更引入、在聊天日志中、页面加载时打开空的 Selector 面板、通过客户端导航插入的服务器渲染消息、在首次渲染之后但文档加载完成之前插入的消息(静默) 在页面加载或服务器渲染期间进行通告(仅通告消息除外)、漏掉稍后插入或通过客户端导航插入的服务器渲染消息、客户端渲染的路由变更、页面加载时出现空的 Selector 面板、重复同一场景、或在实时容器内使用该通道,均视为失败。
FR12 (server) 服务端安全的组件边界检查,以及对每个采用者的服务端渲染 EmptyState 在服务端渲染并完成水合 任何未通过边界检查的采用者,或在服务端渲染中产生公告或 live role 的采用者,均失败
FR13 在每个采用者上对 Helper StrictMode、隐藏/显示和卸载进行测试 EmptyState、Spinner、ChatComposer 状态栏、ChatTypingIndicator;在 React 外部移除祖先元素的 hidden 属性 在 StrictMode 下出现重复公告、在隐藏时工作、或卸载后遗留资源,则失败;在所有者下一次渲染时未宣布已揭示的内容,或在内容隐藏时观察者、监听器或计时器仍在运行,则失败
FR6 (AT) 推荐通过 spec:AST-009 进行真实 AT 后续验证 Toast、忙碌状态的 Switch、聊天通知 缺少、重复或顺序错乱的语音播报将被判定为失败

决策日志

DEC-1 — 每条消息只有一个所有者,并通过共享通道传递

参考: spec:AST-086/DEC-1 决策者: cixzhang, 2026-10-15

多个组件在显示状态的同时,还在第二个位置声明该状态,或者挂载了一个已经包含其文本的实时区域。屏幕阅读器用户因此会听到两次消息,或根本听不到。一个所有者加一个共享且始终挂载的通道,用一条规则就消除了这两种失败,并与 component:FieldStatus 已使用的投递方式保持一致。 被 spec:AST-003 重新托管到原生模态框上方的所有者,会写入它们所处模态框的容器(FR10, FR14),因此不会有页面携带第二组空的实时容器。

已否决:通过每个组件自身的实时区域来投递瞬时消息——页面会新增许多相互竞争的实时区域,且两个所有者的重复问题会再次出现。

DEC-2 — 消息在页面加载后出现时进行播报

参考: spec:AST-086/DEC-2 决策者: cixzhang, 2026-10-22

页面加载时已在页面上的消息会随页面一起被读取。播报它会用用户即将阅读的内容打断他们。之后才出现的消息是新消息,只会播报一次。页面加载是分界点,因为它是每个应用无需额外代码即可共有的时刻。 每个自我播报的组件都以相同方式运行(FR12)。

已否决:在每次挂载时都进行播报——页面加载会读出屏幕上的每个空状态和加载指示器。

DEC-3 — Astryx 模态框内的所有者在其内部播报

参考: spec:AST-086/DEC-3 决策者: cixzhang, 2026-10-23

渲染在打开的 Astryx 模态框内的控件——模态面板的复选框行、其搜索框、一个忙碌状态控件——只能通过该对话框内部的容器被听到,因为页面主体通道位于模态框暴露的子树之外。 忙碌状态开始的播报已经采用了这条路径(FR8);FR14 让来自此类所有者的每条状态消息都走同一条路径,并依据每次播报时所有者所在的位置进行选择,因此,一个有时由模态框托管、有时以内联方式出现的组件仍保持一条播报路径。每个对话框按紧迫程度各设一个 FR14 容器,将 FR1 的单所有者以及 FR9 的拼接与清除逻辑保留在模态框内部,并置于所有者自身的 FR3 区域旁边,而 FR4 已允许这些区域继续存在。公开的 useAnnounce 遵循相同路径,因此应用从模态框内部发送的消息与组件发送的消息一样能被听到。

拒绝的方案:每个组件采用内部路由,而公开的 useAnnounce 持续写入页面主体——模态框内的应用消息保持静默;将共享通道引入模态框宿主——spec:AST-003 拥有宿主权且尚未接纳该通道;为每条消息设置组件级区域——同一对话框内出现相互竞争的区域和双所有者重复。

DEC-4 — 一个 hasReplace 实例替换其自身待处理的消息

参考: spec:AST-086/DEC-4 决策者: 待定(负责审批的工程所有者)

FR9 会合并在上一条消息暴露之前写入的消息,因此同一帧内发言的两个组件都能被听到。声明单一当前状态的消息则不同:每条都取代前一条,因此合并它们会说出不再适用的状态,而输入速度快于一帧的搜索会说出其间每个计数。使用 hasReplace 创建的实例会撤回其自身待处理的消息,这使每个所有者都能被听到,并且在共享通道以及 FR14 的容器中同样只说当前为真的内容。理由与 architecture:interaction-modality INV8 相同——在该规则下,已被取代的工作不会改变当前状态或公告;也与 FR8 相同——FR8 会丢弃被其自身结果超越的繁忙启动。实例即单元,因此组件为其报告的每个状态提供自己的实例,而 useAnnounce 向每个调用者提供该选项,因为 Astryx 的组合框与产品组合的是同一个 hook(spec:AST-075 DEC-2);没有该选项的实例继续合并。

拒绝的方案:每个所有者自行对消息做防抖——每次公告都要等待,且每个所有者都要重复该规则。

开放问题

无。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx