间隔器

一个布局间隔器，用于在相邻元素之间生成空白空间。

Android

iOS

Web

Included in Expo Go

GitHub

npm

更新日志

Recommended version:

~57.0.18

在 Row 或 Column 内部，在兄弟组件之间生成空白空间的布局间隔器。使用 size 创建固定间隙，或使用 flexible 填充剩余的主轴空间。

使用带 weight 修饰符的 Spacer 将两个盒子推到 Row 的相对两端

安装

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.

用法

固定大小间隔

FixedSpacerExample.tsx

import { useColorScheme } from 'react-native';
import { Host, Column, Text, Spacer } from '@expo/ui';

export default function FixedSpacerExample() {
  const colorScheme = useColorScheme();
  const ink = { color: colorScheme === 'dark' ? '#FFFFFF' : '#000000' };

  return (
    <Host matchContents>
      <Column>
        <Text textStyle={ink}>Top</Text>
        <Spacer size={32} />
        <Text textStyle={ink}>Bottom</Text>
      </Column>
    </Host>
  );
}

弹性间隔

弹性间隔会沿其父元素的主轴填充剩余空间，将周围内容推到两端。

FlexibleSpacerExample.tsx

import { useColorScheme } from 'react-native';
import { Host, Row, Text, Spacer } from '@expo/ui';

export default function FlexibleSpacerExample() {
  const colorScheme = useColorScheme();
  const ink = { color: colorScheme === 'dark' ? '#FFFFFF' : '#000000' };

  return (
    <Host matchContents={{ vertical: true }} style={{ width: '100%' }}>
      <Row>
        <Text textStyle={ink}>Leading</Text>
        <Spacer flexible />
        <Text textStyle={ink}>Trailing</Text>
      </Row>
    </Host>
  );
}

API

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

Component

`Spacer`

Android

iOS

Web

Type: React.Element<SpacerProps>

A layout spacer that produces empty space between siblings in a Row or Column.

Props for the Spacer component.

A Spacer produces empty space between siblings in a Row or Column. Use size for a fixed amount of space, or flexible to fill the remaining space along the parent's main axis.

SpacerProps

`disabled`

Android

iOS

Web

Optional • Type: boolean

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

`flexible`

Android

iOS

Web

Optional • Type: boolean • Default: false

When true, the spacer expands to fill the available space along the parent's main axis, pushing sibling content to the opposite end.

`hidden`

Android

iOS

Web

Optional • Type: boolean

Whether the component is hidden.

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`

Android

iOS

Web

Optional • Type: string

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