跳到主要内容

IconGroup 图标组

把导航栏内的多个图标操作放入同一玻璃胶囊,各按钮保持独立点击、名称与禁用状态。组件只组合展示,不接管导航或业务状态。

<IconGroup>
<IconButton
icon={SearchOutlined}
variant="neutral"
surfaceSize={fixed.hitTarget}
accessibilityLabel="搜索"
onPress={openSearch}
/>
<IconButton
icon={PlusOutlined}
variant="neutral"
surfaceSize={fixed.hitTarget}
accessibilityLabel="新增"
onPress={createItem}
/>
</IconGroup>

使用 neutral 按钮避免每项重复绘制玻璃表面;surfaceSize={fixed.hitTarget} 为每个操作保留 44 逻辑点命中区。也可放入具有独立命中区的自定义内容。

属性类型说明
childrenReactNode图标按钮或其它独立操作内容
testIDstring可选测试标识

玻璃直接复用 GlassLayer。原生玻璃可用时采用系统材质;旧 iOS、Android 或减少透明度时使用主题 surfaceContainerHigh,与独立 IconButton 的控件底色一致,避免在白色导航栏上失去分组轮廓。组内 neutral 按钮共用这一层背景。Web 继续沿用现有材质规则,组件不增加版本判断或单独的降级实现。