GPUI Deck

Button

指针与键盘激活、禁用状态、焦点、无障碍名称与角色,以及可选的当前页面元数据。

由 GPUI 的 Web 后端渲染的真实组件。需要支持 WebGPU 的浏览器。

Button 是其他控件所依赖的激活基础元素。它负责 指针和 Enter/Space 激活、焦点、禁用状态以及原生 Button 角色;其内容、间距、形状和状态样式由 应用负责。

将预览使用的浅色和深色按钮样式复制到应用中。

cargo run -p gpui-deck-cli --locked -- add button --to ../my-app/src/ui
use ui::{Appearance, recipes::ButtonVariant};

let palette = Appearance::Settings.palette();
ButtonVariant::Primary
    .apply(Button::new("save").accessibility_label("保存会话"), palette)
    .on_click(|_, window, cx| {
        // The application decides what activation does.
    })
    .child("保存")

激活与焦点

点击、Enter 或 Space 会激活按钮一次。.disabled(true) 会忽略 激活并移除 Tab 停靠点;在拥有焦点时被禁用的按钮会保留其 焦点绑定,直到焦点离开,因此 Tab 可以向任一方向继续。 .track_focus(&handle) 使用应用持有的焦点句柄,例如用于在 对话框关闭后恢复焦点。.tab_index(...) 和 .tab_stop(...) 用于调整遍历顺序。

无障碍

当按钮的子元素不是纯文本(例如仅有图标的按钮)时,请使用 .accessibility_label(...) 为其命名。.selected(true) 仅驱动选中 样式;.current(true) 则单独为导航条目输出 aria-current="page", 因此选中的外观绝不会暗示当前页面。

Toggle、Collapsible 与 Tooltip 的触发器、CarouselControl 以及菜单 触发器都组合了 Button,因此它们共享这套激活和焦点约定。