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.

Box

用于堆叠子元素的 Jetpack Compose Box 组件。

Android
Included in Expo Go
Recommended version:
~58.0.1

Expo UI Box 与官方 Jetpack Compose Box API 相匹配,可将子元素层叠在一起,并配置内容对齐方式。

Material 3 Box,内部居中显示文本内容Material 3 Box,内部居中显示文本内容

安装

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.

用法

Box 会将子元素层叠在一起。使用 contentAlignment 在 Box 内定位这些子元素。

BoxExample.tsx
import { Host, Box, Text } from '@expo/ui/jetpack-compose'; import { size, background, } from '@expo/ui/jetpack-compose/modifiers'; export default function BoxExample() { return ( <Host matchContents> <Box contentAlignment="center" modifiers={[size(200, 200), background('#E0E0E0')]}> <Text>Centered in Box</Text> </Box> </Host> ); }

API

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

Component

Box

Android

Type: React.Element<BoxProps>

BoxProps

children

Android
Optional • Type: ReactNode

contentAlignment

Android
Optional • Type: ContentAlignment

Alignment of children within the box.

floatingToolbarExitAlwaysScrollBehavior

Android
Optional • Type: FloatingToolbarExitAlwaysScrollBehavior

Scroll behavior for the floating toolbar exit.

Inherited props

  • PrimitiveBaseProps