Reference version

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:
~57.0.0

Expo UI 提供与官方 Jetpack Compose Divider API 匹配的 HorizontalDividerVerticalDivider

三个文本区域由水平 Material 3 分割线分隔

安装

Terminal
npx expo install @expo/ui

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

用法

水平分隔线

一条细水平线,用于在列表和布局中直观地分隔内容。

HorizontalDividerExample.tsx
import { Host, HorizontalDivider, Column, Text } from '@expo/ui/jetpack-compose'; export default function HorizontalDividerExample() { return ( <Host matchContents> <Column> <Text>第一部分</Text> <HorizontalDivider /> <Text>第二部分</Text> </Column> </Host> ); }

自定义粗细和颜色

HorizontalDividerVerticalDivider 都接受 thicknesscolor 属性。使用 StyleSheet.hairlineWidth 可绘制单像素线,或设置自定义的粗细和颜色。

CustomDividerExample.tsx
import { Host, HorizontalDivider, Column, Text } from '@expo/ui/jetpack-compose'; import { StyleSheet } from 'react-native'; export default function CustomDividerExample() { return ( <Host matchContents> <Column> <Text>细线分隔线(1 像素)</Text> <HorizontalDivider thickness={StyleSheet.hairlineWidth} /> <Text>粗的彩色分隔线</Text> <HorizontalDivider thickness={4} color="#E91E63" /> <Text>下方</Text> </Column> </Host> ); }

垂直分隔线

一条垂直线,用于在横向排列的行布局中分隔并排项目。

VerticalDividerExample.tsx
import { Host, VerticalDivider, Row, Text } from '@expo/ui/jetpack-compose'; import { height } from '@expo/ui/jetpack-compose/modifiers'; export default function VerticalDividerExample() { return ( <Host matchContents> <Row verticalAlignment="center" modifiers={[height(48)]}> <Text>左侧</Text> <VerticalDivider /> <Text>右侧</Text> </Row> </Host> ); }

API

import { HorizontalDivider, VerticalDivider } from '@expo/ui/jetpack-compose';

Components

HorizontalDivider

Type: React.Element<ComponentType<DividerCommonConfig>>

A horizontal divider line that groups content in lists and layouts, matching Compose's HorizontalDivider.

VerticalDivider

Type: React.Element<ComponentType<DividerCommonConfig>>

A vertical divider line that groups content in layouts, matching Compose's VerticalDivider.

Types

DividerCommonConfig

PropertyTypeDescription
color(optional)ColorValue

Color of the divider line.

modifiers(optional)ModifierConfig[]

Modifiers for the component.

thickness(optional)number

Thickness of the divider line. Accepts dp values; use StyleSheet.hairlineWidth for a single-pixel line.