跳到主要内容

Tabs 标签页

页面内分类切换 · 两种风格:下划线 Tabs(页面级)/ 分段控件 Segmented(局部分组)。

Tabs 与 Segmented 默认使用系统玻璃表面。Segmented 采用内外胶囊、r(4) 留边与无阴影的中性选中底;需要实色正文控件时显式设置 surface="solid"。选项、选中与整体/单项禁用的状态和事件规则保持。

代码演示​

下划线 Tabs · 页面级
分段控件 · 局部 · md(默认)
分段控件 · sm(紧凑,模型下拉等局促位)
分段控件 · 禁用(保留当前选中项)

下划线 Tabs​

页面级分类切换,全宽分布。来源:src/components/ui/Tabs/styles.ts、Tabs.tsx。

元素规则
容器高 44px(fixed.hitTarget),系统玻璃表面,底部 hairline c.outline
Tab 项flex: 1 平分,14px(type.sm),激活态 c.primary + 字重 600(非激活 c.foregroundMuted + 500)
下划线2px c.primary,宽 36px(icon.xl,居中、非随 label),底对齐

分段控件​

局部分组(如 Filter "全部 / 已完成 / 待跟进")。来源:src/components/ui/Segmented/styles.ts、Segmented.tsx。

元素规则
容器alignSelf: 'flex-start' 内容自适应宽,默认玻璃胶囊 radius.pill、内 padding r(4);显式 solid 保留 c.surfaceContainerHigh、圆角 8、内 padding 2
项内容宽(非平分);minHeight / 水平 padding / 基准字号随 size:md 44 / 16 / 13(fixed.hitTarget·space[7]·type.xs,默认、触控达标)· sm 28 / 12 / 12(高 28pt 物理常量·space[5]·type.xxs,紧凑、触控 < 44px)
激活默认 c.glassSeparator 中性选中胶囊,无阴影;solid 保留主题实色选中底、圆角 6 与原阴影规则

禁用项采用与 Tabs 一致的 0.4 透明度,仅前景选项及选中块淡化,共享玻璃保持不透明,当前选中标记仍保留;点击不交付 onChange,禁用时也不改变按压透明度。整体 disabled 与单项 item.disabled 使用同一规则。

ThemeProvider fontScale 只把 Segmented label 的基准字号缩放一次。track、item minHeight、水平 padding、内外圆角和阴影均保持原几何,不随字号档位放大。

用法​

import { Tabs, Segmented } from '@unif/react-native-design';

{
/* 页面级 */
}
<Tabs
value={tab}
onChange={setTab}
items={[
{ id: 'all', label: '全部' },
{ id: 'pending', label: '待跟进' },
{ id: 'done', label: '已完成' },
]}
/>;

{
/* 局部分段 */
}
<Segmented
value={range}
onChange={setRange}
items={[
{ id: 'day', label: '日' },
{ id: 'week', label: '周' },
{ id: 'month', label: '月' },
]}
/>;

API​

来源:src/components/ui/Tabs/types.ts、src/components/ui/Segmented/types.ts。Tabs 与 Segmented 共用 TabItem;surface 和 size 仅属于 Segmented。

TabsProps / SegmentedProps:

参数类型默认值说明
valuestring—当前选中项的 id(必填)
onChange(id: string) => void—切换回调,回传点中项的 id(必填)
itemsTabItem[]—列表项(Tabs ≥2 项才有意义;必填)
surfacesolid | glassglass仅 Segmented:默认玻璃,可显式采用正文实色
size'sm' | 'md''md'仅 Segmented;'md' 默认(高 44px / 基准字号 13,触控达标),'sm' 紧凑(高 28px / 基准字号 12,给模型下拉等局促位用,触控 < 44px);fontScale 只缩放文字
disabledbooleanfalse整体禁用;所有项淡化且不可切换,保留当前选中值
testIDstring?—容器 testID;item testID 自动派生为 ${testID}-${id}

TabItem:

字段类型默认值说明
idstring—唯一标识,用作 key 与选中判定
labelstring—显示文本(同时作 accessibilityLabel)
disabledbooleanfalse仅禁用并淡化该项
testIDstring?—单 item testID(默认 ${tabsTestID}-${id})

无障碍(a11y)​

来源:src/components/ui/Tabs/Tabs.tsx、src/components/ui/Segmented/Segmented.tsx、types.ts(两者 a11y 实现一致,共用 TabItem 形状)。

  • 默认 accessibilityRole:Tabs 与 Segmented 的每个项 <Pressable> 上都硬编码 'tab'。外层容器设置 tablist role。
  • a11y props:每个项的 accessibilityLabel 取自 item.label,而 label 在 TabItem 中是必填的——每个 tab 默认都有朗读文案。
  • 状态语义:selected 由 item.id === value 派生;disabled 由整体 disabled 或单项 item.disabled 决定。禁用不会清空选中状态。
// 每个 tab 自动 role=tab、label=item.label、selected 由 value 决定
<Tabs
value={tab}
onChange={setTab}
items={[
{ id: 'all', label: '全部' },
{ id: 'pending', label: '待跟进' },
]}
/>