排

用于通用 @expo/ui 组件的水平布局容器。

Android

iOS

Web

Included in Expo Go

Recommended version:

~57.0.3

一个水平布局容器，将其子元素从开始排列到结束。在 Android 上委托给 Jetpack Compose 的 Row，在 iOS 上委托给 SwiftUI 的 HStack，在 Web 上使用 flex View。

🌐 A horizontal layout container that arranges its children from start to end. Delegates to Jetpack Compose's Row on Android, SwiftUI's HStack on iOS, and a flex View on web.

安装

🌐 Installation

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.

用法

🌐 Usage

基础划船

🌐 Basic row

RowExample.tsx

import { Host, Row, Text } from '@expo/ui';

export default function RowExample() {
  return (
    <Host matchContents>
      <Row spacing={8}>
        <Text>One</Text>
        <Text>Two</Text>
        <Text>Three</Text>
      </Row>
    </Host>
  );
}

对齐

🌐 Alignment

使用 alignment 将子元素沿交叉（垂直）轴定位。

🌐 Use alignment to position children along the cross (vertical) axis.

RowAlignmentExample.tsx

import { Host, Row, Text } from '@expo/ui';

export default function RowAlignmentExample() {
  return (
    <Host style={{ flex: 1 }}>
      <Row spacing={8} alignment="center">
        <Text>Centered</Text>
        <Text>Centered</Text>
      </Row>
    </Host>
  );
}

使用 Spacer 推开内容

🌐 Pushing content apart with Spacer

将 Row 与一个灵活的 Spacer 配对，以将其子元素推到相对两端。

🌐 Pair Row with a flexible Spacer to push its children to the opposite ends.

RowSpacerExample.tsx

import { Host, Row, Text, Spacer } from '@expo/ui';

export default function RowSpacerExample() {
  return (
    <Host style={{ flex: 1 }}>
      <Row>
        <Text>Leading</Text>
        <Spacer flexible />
        <Text>Trailing</Text>
      </Row>
    </Host>
  );
}

应用接口

🌐 API

import { Row } from '@expo/ui';

Component

`Row`

Type: React.Element<RowProps>

A horizontal layout container that arranges its children from start to end.

Props for the Row component, a horizontal layout container.

RowProps

`alignment`

Optional • Literal type: string • Default: 'start'

Cross-axis (vertical) alignment of children.

Acceptable values are: 'start' | 'center' | 'end'

`children`

Optional • Type: ReactNode

Content to render inside the row.

`disabled`

Only for:

Android

iOS

Web

Optional • Type: boolean

Whether the component is disabled. Disabled components do not respond to user interaction.

`hidden`

Only for:

Android

iOS

Web

Optional • Type: boolean

Whether the component is hidden.

`modifiers`

Only for:

Android

iOS

Optional • Type: ModifierConfig[]

Platform-specific modifier escape hatch. Pass an array of modifier configs from @expo/ui/swift-ui/modifiers or @expo/ui/jetpack-compose/modifiers. A modifier supplied here replaces any modifier of the same type that the component derives from style or other props.

`onAppear`

Only for:

Android

iOS

Web

Optional • Type: () => void

Called when the component appears on screen.

`onDisappear`

Only for:

Android

iOS

Web

Optional • Type: () => void

Called when the component is removed from screen.

`onPress`

Only for:

Android

iOS

Web

Optional • Type: () => void

Called when the component is pressed.

`spacing`

Optional • Type: number

Horizontal spacing between children, in density-independent pixels.

`style`

Only for:

Android

iOS

Web

Optional • Type:

Pick<ViewStyle, 'padding' | 'paddingHorizontal' | 'paddingVertical' | 'paddingTop' | 'paddingBottom' | 'paddingLeft' | 'paddingRight' | 'backgroundColor' | 'borderRadius' | 'borderWidth' | 'borderColor' | 'opacity' | 'width' | 'height'>

Platform-agnostic style properties. These are translated to SwiftUI modifiers on iOS and Jetpack Compose modifiers on Android.

`testID`

Only for:

Android

iOS

Web

Optional • Type: string

Identifier used to locate the component in end-to-end tests.