跳到主要内容

LinearProgress 横向进度

用于页面加载等已知比例的过程。默认使用 2pt 高度与主题主色,明暗主题自动切换。

当前进度:42%

按钮只切换演示数值。真实接入传入加载方报告的 0..1 比例;组件直接展示当前值,不产生计时进度、不请求数据,也不会在 100% 时自行隐藏。

用法​

import { LinearProgress } from '@unif/react-native-design';

{
loading && (
<LinearProgress value={progress} accessibilityLabel="网页加载进度" />
);
}

调用方决定放在导航栏下方或其他位置,并处理开始、完成、失败与重试。默认铺满纵向容器的可用宽度;横向容器中通过 style 指定宽度或 flex。页面加载时可以用绝对定位覆盖内容上沿,避免显示隐藏时挤动页面。组件不接收点击事件。

API​

参数类型默认值说明
valuenumber必填真实 0..1 比例;越界收敛到边界,非有限值按 0 处理
thicknessnumber2高度;非有限或非正数按 2 处理
colorstring主题 primary已完成部分颜色
trackColorstring主题 surfaceContainer轨道颜色
accessibilityLabelstring进度读屏名称
styleStyleProp<ViewStyle>—外层布局样式
testIDstring—测试定位

无障碍与平台​

iOS、Android 与 Web 使用同一基础 View 实现,无新增原生依赖。外层提供 progressbar、0~100 的取整百分比与文字值,内部装饰对读屏隐藏。没有自动动画,系统减少动态效果时仍直接显示真实值。

只知道“仍在加载”但没有比例时使用 Spinner,不要制造进度。100% 仅表示输入比例,不代表业务成功。

源码与公开类型:src/components/ui/LinearProgress/。