间隔器

用于在元素之间添加可伸缩空间的 Jetpack Compose Spacer 组件。

Android

Included in Expo Go

Recommended version:

~57.0.22

信息有关跨平台使用，请参阅通用 Spacer —— 它会根据平台呈现相应的原生组件。

Expo UI Spacer 与官方 Jetpack Compose Spacer API 匹配，用于在布局中在元素之间添加可变或固定大小的间距。

🌐 Expo UI Spacer matches the official Jetpack Compose Spacer API and is used to add flexible or fixed-size space between elements in a layout.

Two boxes pushed to opposite ends of a Row by a Spacer with weight modifier

安装

🌐 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

带重量的间隔片

🌐 Spacer with weight

使用 weight() 修饰符使间隔器在 Row 或 Column 内按比例填充可用空间。

🌐 Use the weight() modifier to make the spacer fill available space proportionally within a Row or Column.

SpacerWeightExample.tsx

import {
  Host,
  Row,
  Spacer,
  Text,
  useMaterialColors,
} from '@expo/ui/jetpack-compose';
import {
  fillMaxWidth,
  weight,
} from '@expo/ui/jetpack-compose/modifiers';

export default function SpacerWeightExample() {
  const colors = useMaterialColors();

  return (
    <Host
      matchContents={{ vertical: true }}
      style={{ width: '100%' }}>
      <Row modifiers={[fillMaxWidth()]}>
        <Text style={{ fontSize: 28 }} color={colors.onBackground}>
          Left
        </Text>
        <Spacer modifiers={[weight(1)]} />
        <Text style={{ fontSize: 28 }} color={colors.onBackground}>
          Right
        </Text>
      </Row>
    </Host>
  );
}

固定大小的间隔器

🌐 Spacer with fixed size

使用 height 或 width 修饰符来创建具有固定尺寸的间隔器。

🌐 Use a height or width modifier to create a spacer with a fixed dimension.

SpacerFixedSizeExample.tsx

import {
  Host,
  Column,
  Spacer,
  Text,
  useMaterialColors,
} from '@expo/ui/jetpack-compose';
import { height } from '@expo/ui/jetpack-compose/modifiers';

export default function SpacerFixedSizeExample() {
  const colors = useMaterialColors();

  return (
    <Host matchContents>
      <Column>
        <Text style={{ fontSize: 28 }} color={colors.onBackground}>
          Above
        </Text>
        <Spacer modifiers={[height(24)]} />
        <Text style={{ fontSize: 28 }} color={colors.onBackground}>
          Below (24dp gap)
        </Text>
      </Column>
    </Host>
  );
}

应用接口

🌐 API

import { Spacer } from '@expo/ui/jetpack-compose';

Component

`Spacer`

Android

Type: React.Element<SpacerProps>

A spacer component that fills available space. Use with the weight() modifier to create flexible spacing in Row or Column layouts.

Example

<Row>
  <Text>Left</Text>
  <Spacer modifiers={[weight(1)]} />
  <Text>Right</Text>
</Row>

SpacerProps

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component. Use weight() modifier to make the spacer flexible.