跳到主要内容

Grid 九宫格

以网格排列图标和文字入口。

代码演示​

4 列
拜访
订单
商品
报表
消息
团队
设置
更多
3 列
拜访
订单
商品
报表
消息
团队
2 列 · 大图标卡片入口
拜访
订单
商品
报表
6 列 · 紧凑入口
拜访
订单
商品
报表
消息
团队
card={false} · 嵌套已有卡片,去掉外层背景
拜访
订单
商品
报表

API​

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

<Grid>​

参数类型默认值说明
itemsGridItem[]—入口列表(见下)
columns1 | 2 | 3 | 4 | 5 | 64列数;类型外的值(如 7)会静默回退到 4 列并打 warn
onPress(item: GridItem) => void—点击某格回调;提供时每格是 button,缺省时保持展示 View
cardbooleantrue是否套玻璃卡片;false 则背景透明(嵌进已有卡片时用)
testIDstring?—容器 testID;每格自动派生为 ${testID}-${item.id}

GridItem​

字段类型默认值说明
idstring—唯一键,也用于派生 testID
iconComponentType<IconProps>—图标组件(图标 catalog)
labelstring—格子文字,同时作为该格 accessibilityLabel
accessibilityLabelstring?—trim 后非空时覆盖名称;空白值回退到默认名称
badgenumber | string?—icon 右上角标(用 string 才能写 '99+')
testIDstring?—单格 testID(不传则自动用 ${gridTestID}-${id})

视觉规范​

来源:src/components/ui/Grid/styles.ts(值取自 src/theme/tokens.ts)。

元素规则
容器(card)主题 GlassLayer 材质,radius.xl(12)圆角,paddingVertical: space[5](12)/ paddingHorizontal: space[3](8),1px c.outline 边框
列宽等宽,按 columns 取 100% / 50% / 33.3% / 25% / 20% / 16.7%(StyleSheet 预生成)
单格paddingVertical: space[5](12),居中 icon + label,gap: space[2](6)
Iconsize=28(介于 icon.md/icon.lg),色固定 c.foregroundMuted
Labelt.xxs(12)/ fw.medium(500)/ c.foreground
Badge叠在 icon 右上的小红角标:c.error 底、c.onError 字、t.nano(10)、fw.bold

用法​

import {
BoxListOutlined,
ListOutlined,
LocationOutlined,
MailOutlined,
MoreHOutlined,
OrderOutlined,
SettingsOutlined,
UserOutlined,
} from '@unif/react-native-icons';
import { Grid } from '@unif/react-native-design';

<Grid
columns={4}
items={[
{ id: 'visit', icon: LocationOutlined, label: '拜访' },
{ id: 'orders', icon: OrderOutlined, label: '订单', badge: 3 },
{ id: 'sku', icon: BoxListOutlined, label: '商品' },
{ id: 'reports', icon: ListOutlined, label: '报表' },
{ id: 'msg', icon: MailOutlined, label: '消息', badge: 0 },
{ id: 'team', icon: UserOutlined, label: '团队' },
{ id: 'settings', icon: SettingsOutlined, label: '设置' },
{ id: 'more', icon: MoreHOutlined, label: '更多' },
]}
onPress={(item) => navigation.push(item.id)}
/>;

无障碍(a11y)​

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

  • 默认 accessibilityRole:只有 Grid 级 onPress 存在时,每格才渲染为 <Pressable accessibilityRole="button">;纯展示 Grid 使用本地 <View>,不伪装成操作。
  • a11y 名称:trim 后非空的 item.accessibilityLabel 优先;空白覆盖回退 trim 后非空的 item.label,并在 badge != null 时组合角标。最终名称为空时,action Grid 的该格失败关闭为 display-only 并在 effect 诊断;display Grid 不创建 unnamed merged a11y node。
  • icon 与 badge 视觉子树对 SR 隐藏,外层 cell 是唯一的合并名称,不产生重复焦点。
  • 状态语义:源码未设 accessibilityState(无 selected/disabled/checked 概念)。
import { MailOutlined } from '@unif/react-native-icons';
// role=button、默认名称“消息,0”
<Grid
columns={4}
items={[{ id: 'msg', icon: MailOutlined, label: '消息', badge: 0 }]}
onPress={(item) => navigation.push(item.id)}
/>;