跳到主要内容

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​

参数类型默认值说明
titlestring—居中标题
descstring—可选说明
iconComponentType<IconProps> | nullSparkOutlined圆盘内图标;null 隐藏整个装饰区域
actionReactNode—可选操作区,居中展示调用方提供的按钮
accessibilityRoleTextProps['accessibilityRole']—标题语义;简单错误可设为 alert
styleStyleProp<ViewStyle>—外层布局样式
testIDstring—测试定位

主题与无障碍​

标题使用 type.h3、fw.semi 和 foreground;说明使用 type.xs 和 foregroundSubtle。装饰图标使用 primaryContainer 圆盘与 primary 前景色。

标题和说明可独立朗读,操作区保留按钮自身的可访问名称、禁用和加载语义。图标按钮必须提供 accessibilityLabel;组件不会自动发起请求或把失败解释为空结果。