Empty 空态
展示空内容或简单失败提示。icon={null} 隐藏装饰图标,action 接收居中展示的操作。请求、重试和加载状态由调用方维护。
代码演示
暂无客户
客户添加后会显示在这里
暂时无法连接
简单失败与重试
import { Empty, IconButton } from '@unif/react-native-design';
import { RefreshOutlined } from '@unif/react-native-icons';
<Empty
title="暂时无法连接"
icon={null}
accessibilityRole="alert"
action={
<IconButton
icon={RefreshOutlined}
accessibilityLabel="重试"
loading={loading}
onPress={retry}
/>
}
/>;
不传 action 时只显示内容;不传 icon 时保留默认图标。desc 仅用于补充说明,避免重复标题。已有数据的刷新失败由页面保留数据,并在合适位置显示提示。
API
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
title | string | — | 居中标题 |
desc | string | — | 可选说明 |
icon | ComponentType<IconProps> | null | SparkOutlined | 圆盘内图标;null 隐藏整个装饰区域 |
action | ReactNode | — | 可选操作区,居中展示调用方提供的按钮 |
accessibilityRole | TextProps['accessibilityRole'] | — | 标题语义;简单错误可设为 alert |
style | StyleProp<ViewStyle> | — | 外层布局样式 |
testID | string | — | 测试定位 |
主题与无障碍
标题使用 type.h3、fw.semi 和 foreground;说明使用 type.xs 和 foregroundSubtle。装饰图标使用 primaryContainer 圆盘与 primary 前景色。
标题和说明可独立朗读,操作区保留按钮自身的可访问名称、禁用和加载语义。图标按钮必须提供 accessibilityLabel;组件不会自动发起请求或把失败解释为空结果。