分段控件

带有滑动白色拇指的第三轨道上的单选开关 - 来自图表卡的每周/每月/每年切换器。基于 React Aria ToggleButtonGroup 构建:箭头键移动,空格键选择。

安装

您可以使用我们的 CLI 或手动添加此分段控件:

已支持深色模式,此 组件 会自动使用 BoardUI 的语义设计变量。 设置主题切换.

CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。

npx boardui@latest add segmented-control

使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。

受控选择

选择使用 React Aria 的键集 API:pass selectedKeys + onSelectionChange 来控制它,或者 defaultSelectedKeys 对于不受控制的。防止空集以保持一个段始终处于活动状态。

const [period, setPeriod] = useState(new Set(["weekly"])); <SegmentedControl selectedKeys={period} onSelectionChange={(keys) => keys.size > 0 && setPeriod(new Set(keys))} aria-label="Period"> <SegmentedControlItem id="weekly">Weekly</SegmentedControlItem> <SegmentedControlItem id="monthly">Monthly</SegmentedControlItem></SegmentedControl>