按场景查找组件,进入对应页面查看示例、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 | 图标原位切换确认文字,同一区域互斥与点外取消 |
| Avatar | circle/square monogram 头像,variant brand/info/soft/neutral |
| AvatarGroup | 重叠头像组,统一形态与尺寸,支持 max 溢出及可选 action |
| Tag | 状态徽章,5 语义 × 2 尺寸 |
| Chip | 胶囊形可选中 pill(Suggestion 底层) |
| Confirm | 命令式 confirm() + <ConfirmHost /> 高风险二次确认 |
| Thumbnail | 缩略图,支持尺寸档位、尺寸对象和失败占位 |
| Loading | Spinner 未知时长加载;CircularProgress 确定进度与可选百分比 |
| Pulse | usePulse + <Pulse> + <PulseDot>,通用脉冲底座 |
| ShimmerText | 文字每四秒一次白色扫光,支持停用与减少动态效果 |
| Reveal | 淡入容器:native Reanimated 入/退场 / Web CSS 入场 |
| StatusDot | done/error/active/pending 圆点,flat/soft 双 tone |
Input、Textarea、Search 和 PasswordInput 共用内部 TextField 内核。包根不导出 TextField 组件,使用者应选择上表中的公开输入组件。
| 组件 | 说明 |
|---|
| NavBar | 固定顶部头,44px,default / brand / transparent variant |
| DrawerHeader | 抽屉顶部品牌面板 + 图片头像失败回退 |
| TabBar | 固定底部 tab,50px,带 badge |
| Tabs | 页级下划线 tabs(局部分段用 Segmented) |
数据展示
| 组件 | 说明 |
|---|
| Cell · List | 列表行 + List 容器,grouped(白卡 + gap)/ flush(hairline)两模式 |
| Card | 内容卡,支持 default/plain/glass |
| Ribbon | 包裹内容的右上缎带,brand/danger 语义色与可选读屏文案 |
| Grid | 九宫格图标网格 |
| Carousel | 轮播(包装 reanimated-carousel v5) |
业务复合
@unif/react-native-design 暴露的通用组合组件;应用自行维护导航与业务状态:
基础令牌
颜色 / 字体 / 间距 / 圆角 / 阴影 / 动效 / 图标 → 设计令牌。
内容组合