跳到主要内容

组件概览

按场景查找组件,进入对应页面查看示例、API 和注意事项。Design 公开组件从 @unif/react-native-design 包根导入;独立图标从 @unif/react-native-icons 导入。

消息、聊天输入和附件展示见独立的 Chat 库。页面预览运行于 React Native Web,原生行为按各组件的平台说明验证。

品牌​

组件说明
Logo品牌标识容器;图片 source 由消费端持有并必传
独立图标@unif/react-native-icons 命名组件

通用​

组件说明
Button主操作按钮,8 variant × 3 size,可 block
IconGroup多个独立图标操作共用一个玻璃胶囊
IconButton纯图标按钮,accessibilityLabel 类型必填
InlineConfirm图标原位切换确认文字,同一区域互斥与点外取消
Avatarcircle/square monogram 头像,variant brand/info/soft/neutral
AvatarGroup重叠头像组,统一形态与尺寸,支持 max 溢出及可选 action
Tag状态徽章,5 语义 × 2 尺寸
Chip胶囊形可选中 pill(Suggestion 底层)
Confirm命令式 confirm() + <ConfirmHost /> 高风险二次确认
Thumbnail缩略图,支持尺寸档位、尺寸对象和失败占位
LoadingSpinner 未知时长加载;CircularProgress 确定进度与可选百分比
PulseusePulse + <Pulse> + <PulseDot>,通用脉冲底座
ShimmerText文字每四秒一次白色扫光,支持停用与减少动态效果
Reveal淡入容器:native Reanimated 入/退场 / Web CSS 入场
StatusDotdone/error/active/pending 圆点,flat/soft 双 tone

表单​

组件说明
Input单行输入,idle / focus / filled / error
PasswordInput密码输入与显示切换
Textarea多行输入,支持内容增长与最大高度
Search搜索输入与清除操作
Checkbox复选
Radio单选选项与 Radio.Group
Switch开关:native Reanimated / Web CSS transition
Stepper[−] N [+] 步进;xs 是横向触控 < 44pt 的紧凑档,支持 formatValue 文案格式化
FormForm / FormGroup / FormRow(行间 hairline)

Input、Textarea、Search 和 PasswordInput 共用内部 TextField 内核。包根不导出 TextField 组件,使用者应选择上表中的公开输入组件。

导航​

组件说明
NavBar固定顶部头,44px,default / brand / transparent variant
DrawerHeader抽屉顶部品牌面板 + 图片头像失败回退
TabBar固定底部 tab,50px,带 badge
Tabs页级下划线 tabs(局部分段用 Segmented)

反馈​

组件说明
Toast命令式 toast() + <ToastHost /> 全局轻提示
Empty空状态
Skeleton骨架占位,shape='line'/'rect'/'circle'(走 usePulse)
CircularProgress0..1 确定圆形进度,可选中央百分比文字
LinearProgress0..1 横向进度,默认 2pt,支持主题与读屏百分比

数据展示​

组件说明
Cell · List列表行 + List 容器,grouped(白卡 + gap)/ flush(hairline)两模式
Card内容卡,支持 default/plain/glass
Ribbon包裹内容的右上缎带,brand/danger 语义色与可选读屏文案
Grid九宫格图标网格
Carousel轮播(包装 reanimated-carousel v5)

业务复合​

@unif/react-native-design 暴露的通用组合组件;应用自行维护导航与业务状态:

组件说明
AvatarWithRing圆形头像 + ring + 品牌 shadow
GlassStats玻璃数据条(GlassLayer + N 列)
DecorationsGradientWash + RadialHalo + ScreenBackdrop(整屏沉浸渐变,暖橙 preset + 暗色自适配)
VersionPill版本号药丸

其他​

组件说明
GlassLayer主题玻璃层,clear / regular 材质与平台降级
EntryCard横向小卡入口(Me 屏"设置 / 关于"双列)

基础令牌​

颜色 / 字体 / 间距 / 圆角 / 阴影 / 动效 / 图标 → 设计令牌。

内容组合​

组件说明
ImagePreview稳定身份、图片翻页与删除请求
Sheet固定头尾及三种有界内容布局
ActionMenuContent操作、禁用加载与可选确认
TextEntryContent受控编辑、说明和提交事件
SmsField受控短信输入,发送文案和冷却由调用方提供