This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

进度指示器

用于显示操作状态的 Jetpack Compose 进度指示器组件。

Android
Included in Expo Go
Recommended version:
~58.0.15

Expo UI 进度指示器与官方 Jetpack Compose Progress Indicator API 匹配。

🌐 Expo UI Progress Indicators match the official Jetpack Compose Progress Indicator API.

Indeterminate circular progress indicator with two determinate linear progress bars at 30% and 75%Indeterminate circular progress indicator with two determinate linear progress bars at 30% and 75%

安装

🌐 Installation

Terminal
- npx expo install @expo/ui
- yarn expo install @expo/ui
- pnpm expo install @expo/ui
- bun expo install @expo/ui

If you are installing this in an existing React Native app, make sure to install expo in your project.

用法

🌐 Usage

线性进展

🌐 Linear progress

一个水平条,用于指示进度。为确定模式提供一个介于 0 和 1 之间的 progress 值。

🌐 A horizontal bar that fills to indicate progress. Provide a progress value between 0 and 1 for determinate mode.

LinearExample.tsx
import { Host, LinearProgressIndicator, } from '@expo/ui/jetpack-compose'; export default function LinearExample() { return ( <Host matchContents> <LinearProgressIndicator progress={0.5} /> </Host> ); }

圆形进度

🌐 Circular progress

一个旋转的圆圈,其描边会增长以表示进度。

🌐 A spinning circle whose stroke grows to indicate progress.

CircularExample.tsx
import { Host, CircularProgressIndicator, } from '@expo/ui/jetpack-compose'; export default function CircularExample() { return ( <Host matchContents> <CircularProgressIndicator progress={0.75} /> </Host> ); }

不确定

🌐 Indeterminate

省略 progress 属性以实现连续动画,而不指示特定的完成度。

🌐 Omit the progress prop to animate continuously without indicating a specific completion level.

IndeterminateExample.tsx
import { CircularProgressIndicator, CircularWavyProgressIndicator, Column, Host, LinearProgressIndicator, LinearWavyProgressIndicator, } from '@expo/ui/jetpack-compose'; export default function IndeterminateExample() { return ( <Host matchContents> <Column verticalArrangement={{ spacedBy: 16 }}> <LinearProgressIndicator /> <CircularProgressIndicator /> <CircularWavyProgressIndicator /> <LinearWavyProgressIndicator /> </Column> </Host> ); }

自定义颜色

🌐 Custom colors

将 color 用于指示器,将 trackColor 用于背景轨道。

🌐 Use color for the indicator and trackColor for the background track.

ColorsExample.tsx
import { Host, CircularProgressIndicator, } from '@expo/ui/jetpack-compose'; export default function ColorsExample() { return ( <Host matchContents> <CircularProgressIndicator progress={0.6} color="red" trackColor="#cccccc" /> </Host> ); }

波浪形变体

🌐 Wavy variants

LinearWavyProgressIndicator 和 CircularWavyProgressIndicator 添加了来自 Material 3 Expressive 的表现性波浪动画。

WavyExample.tsx
import { Host, LinearWavyProgressIndicator, CircularWavyProgressIndicator, Column, } from '@expo/ui/jetpack-compose'; export default function WavyExample() { return ( <Host matchContents> <Column verticalArrangement={{ spacedBy: 16 }}> <LinearWavyProgressIndicator progress={0.6} /> <CircularWavyProgressIndicator progress={0.6} /> </Column> </Host> ); }

波形配置

🌐 Wave configuration

使用 amplitude 来设置波浪高度,0 为平线,1 为最大高度。使用 wavelength 来设置单个波浪的长度(dp),waveSpeed 来设置波浪每秒的移动速度(dp/s)。waveSpeed 默认为 wavelength。设置 waveSpeed={0} 可以渲染静态波浪。

🌐 Use amplitude to set the wave height, from 0 for a flat line to 1 for the full height. Use wavelength to set the length of a single wave in dp, and waveSpeed to set how fast the wave travels in dp per second. waveSpeed defaults to wavelength. Set waveSpeed={0} to render a static wave.

WaveConfigExample.tsx
import { Host, LinearWavyProgressIndicator, } from '@expo/ui/jetpack-compose'; export default function WaveConfigExample() { return ( <Host matchContents> <LinearWavyProgressIndicator progress={0.6} amplitude={0.4} wavelength={24} waveSpeed={18} /> </Host> ); }

应用接口

🌐 API

import { LinearProgressIndicator, CircularProgressIndicator, LinearWavyProgressIndicator, CircularWavyProgressIndicator, } from '@expo/ui/jetpack-compose';

No API data file found, sorry!