跳到主要内容

Tag 标签

纯展示状态标签 · 6 种配色变体 · 2 种尺寸。

需要为不支持原生玻璃的浅色 iOS/Android 指定标签配色时,可传 fallbackPalette={{ backgroundColor, color, borderColor }}。字段均可省略,未指定的颜色沿用 variant;Web、深色与支持原生玻璃的 iOS(含减少透明度)保留原配色。该参数不改变尺寸或边宽,outline 仍有 1pt 边框,其他变体仍无边框;显式容器 style 继续优先。

代码演示​

VIP 客户
已完成
已取消
新单
待跟进
描边
Lg
Md

用法​

import { Tag } from '@unif/react-native-design';

<Tag label="VIP 客户" variant="brand" />
<Tag label="已完成" variant="success" />
<Tag label="已取消" variant="error" />
<Tag label="新单" variant="info" />
<Tag label="待跟进" variant="neutral" />

API​

来源:src/components/ui/Tag/types.ts、Tag.tsx。

参数类型默认值说明
labelstring—标签文字(必填)
variant'neutral' | 'brand' | 'success' | 'error' | 'info' | 'outline''neutral'配色变体
size'md' | 'lg''md'高度 22 / 26
fallbackPalette{ backgroundColor?: ColorValue; color?: ColorValue; borderColor?: ColorValue }—仅浅色原生无玻璃时覆盖颜色;不改变边宽或尺寸
numberOfLinesnumber?1文本行数(超长 ellipsis)
styleStyleProp<ViewStyle>?—额外样式覆盖
testIDstring?—E2E / 测试定位

配色(Tokens)​

来源:src/components/ui/Tag/styles.ts(paletteFor / sizingFor)。

variant底色文字边框
neutral(默认)c.surfaceContainerHighc.foregroundMuted—
brandc.primaryContainerc.primary—
successc.successContainerc.success—
errorc.errorContainerc.error—
infoc.infoContainerc.info—
outline透明c.foregroundMutedc.outline(1px)

尺寸:md = 高 22 / 横向 padding 8 / 基准字号 12;lg = 高 26 / padding 10 / 基准字号 13。圆角统一 radius.sm(6)。

ThemeProvider fontScale 只把 label 字号缩放一次。Tag 的固定高度、水平 padding、边框和圆角保持原值,不随字号档位放大。

无障碍(a11y)​

来源:src/components/ui/Tag/Tag.tsx、types.ts。

Tag 是纯展示标签,源码是 <View> + <Text>(无 onPress、无交互变体),未设置任何 accessibilityRole,也没有可传的 a11y prop(无 accessibilityLabel)。底层 <Text> 默认对 screen reader 可读,会朗读必填的 label;variant 只是配色语义,不会被读出(如需把"成功 / 失败"读给 SR,应在 label 文字本身体现,例如 label="已完成")。无受控状态(checked / selected / disabled 均不适用)。