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

使用 @expo/ui 构建原生 Android 界面的 Jetpack Compose 组件。

Android
Included in Expo Go
Recommended version:
~56.0.16

@expo/ui/jetpack-compose 中的 Jetpack Compose 组件允许你在 React Native 中使用 Jetpack Compose 构建完全原生的 Android 界面。

安装

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.

用法

使用 @expo/ui/jetpack-compose 中的组件需要将其包装在一个 Host 组件中。Host 是 Jetpack Compose 视图的容器。

import { Host, Button } from '@expo/ui/jetpack-compose'; export function SaveButton() { return ( <Host matchContents> <Button onClick={() => alert('已保存!')}>保存更改</Button> </Host> ); }

可用组件

ComponentDescription
AlertDialogAlertDialog 组件,用于显示原生警报对话框。
BadgeBadge 组件,用于显示状态指示和计数。
BadgedBoxBadgedBox 组件,用于在内容上叠加徽标。
BasicAlertDialogBasicAlertDialog 组件,用于显示自定义内容的对话框。
BoxBox 组件,用于堆叠子元素。
ButtonButton 组件,用于显示原生 Material3 按钮。
CardCard 组件,用于在带样式的容器中显示内容。
CarouselCarousel 组件,用于显示可滚动的项目集合。
CheckboxCheckbox 组件,用于选择控件。
ChipChip 组件,用于显示紧凑元素。
ColumnColumn 组件,用于垂直放置子元素。
DateTimePickerDateTimePicker 组件,用于选择日期和时间。
DividerDivider 组件,用于创建视觉分隔线。
DockedSearchBarDockedSearchBar 组件,用于显示内联搜索输入框。
DropdownMenuDropdownMenu 组件,用于显示下拉菜单。
ExposedDropdownMenuBoxExposedDropdownMenuBox 组件,用于显示带有可自定义锚点的下拉菜单。
FloatingActionButtonFloatingActionButton 组件,遵循 Material Design 3。
FlowRowFlowRow 组件,用于水平换行排列子元素。
HorizontalFloatingToolbarHorizontalFloatingToolbar 组件,用于显示浮动操作栏。
HorizontalPagerHorizontalPager 组件,用于可滑动页面。
HostHost 组件,用于连接 React Native 和 Jetpack Compose。
IconIcon 组件,用于显示图标。
IconButtonIconButton 组件,用于显示原生 Material3 图标按钮。
LazyColumnLazyColumn 组件,用于显示可滚动列表。
LazyRowLazyRow 组件,用于显示水平滚动列表。
ListItemListItem 组件,用于显示结构化列表项。
ModalBottomSheetModalBottomSheet 组件,用于从屏幕底部呈现内容。
NavigationBarNavigationBar 组件,用于 Material 3 底部导航。
Progress Indicators进度指示器组件,用于显示操作状态。
PullToRefreshBoxPullToRefreshBox 组件,用于下拉刷新交互。
RadioButtonRadioButton 组件,用于单选控件。
RNHostView一种可在 Jetpack Compose 中启用 React Native 视图的组件。
RowRow 组件,用于水平放置子元素。
SearchBarSearchBar 组件,用于搜索输入功能。
SegmentedButtonSegmented Button 组件,用于单选或多选。
ShapeShape 组件,用于绘制几何形状。
SliderSlider 组件,用于从范围中选择数值。
Snackbar一种简短通知,出现在屏幕底部,在不打断用户的情况下提供反馈。
SpacerSpacer 组件,用于在元素之间添加灵活间距。
SurfaceSurface 组件,用于带样式的内容容器。
SwitchSwitch 组件,用于切换控件。
TextText 组件,用于显示样式化文本。
TextFieldTextField 组件,用于原生 Material3 文本输入。
ToggleButtonToggleButton 组件,用于显示原生 Material3 切换按钮。
TooltipTooltip 组件,用于在长按时显示上下文信息。