This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

小吃吧

出现在屏幕底部的简短通知,用于在不打断用户的情况下提供反馈。

Android
Included in Expo Go
Recommended version:
~58.0.15

Expo UI 提供了两个组件,它们与 Jetpack Compose 的 Snackbar API 相对应:

🌐 Expo UI exposes two components that mirror Jetpack Compose's Snackbar APIs:

  • SnackbarHost 封装了 Compose 的 SnackbarHost 和 SnackbarHostState。在布局中放置一次,然后在 ref 上调用 showSnackbar。Snackbar 会根据 duration 自动消失,也可以通过操作按钮或可选的关闭图标手动关闭。
  • Snackbar 是 SnackbarHost 的仅样式子元素。传入一个以覆盖颜色或将操作放在新行上。
Material 3 snackbar showing the message 'Item archived' with an Undo actionMaterial 3 snackbar showing the message 'Item archived' with an Undo action

安装

🌐 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

显示一个 snackbar

🌐 Showing a snackbar

在你的布局中放置一个 SnackbarHost,然后在它的引用上调用 showSnackbar 来显示一条消息。返回的 Promise 会在 snackbar 消失后以 'actionPerformed' 或 'dismissed' 作为结果解决。

🌐 Place a SnackbarHost once in your layout and call showSnackbar on its ref to display a message. The returned promise resolves with 'actionPerformed' or 'dismissed' once the snackbar goes away.

SnackbarExample.tsx
import { useRef } from 'react'; import { Box, Button, Column, Host, SnackbarHost, Text, type SnackbarHostRef, } from '@expo/ui/jetpack-compose'; import { align, fillMaxSize, fillMaxWidth, padding, } from '@expo/ui/jetpack-compose/modifiers'; export default function SnackbarExample() { const hostRef = useRef<SnackbarHostRef>(null); const onArchive = async () => { const result = await hostRef.current?.showSnackbar({ message: 'Item archived', actionLabel: 'Undo', duration: 'short', }); if (result === 'actionPerformed') { // The user tapped Undo, restore the item. } }; return ( <Host style={{ flex: 1 }}> <Box modifiers={[fillMaxSize()]}> <Column modifiers={[padding(16, 16, 16, 16)]}> <Button onClick={onArchive}> <Text>Archive</Text> </Button> </Column> <Box modifiers={[align('bottomCenter'), fillMaxWidth()]}> <SnackbarHost ref={hostRef} /> </Box> </Box> </Host> ); }

自定义样式

🌐 Custom styling

将Snackbar子项传递给SnackbarHost以覆盖颜色或将操作放在新行。Snackbar本身不包含内容,消息和操作来自每个showSnackbar调用。

🌐 Pass a Snackbar child to SnackbarHost to override colors or place the action on a new line. The Snackbar itself takes no content, the message and action come from each showSnackbar call.

StyledSnackbar.tsx
import { useRef } from 'react'; import { Box, Button, Column, Host, Snackbar, SnackbarHost, Text, type SnackbarHostRef, } from '@expo/ui/jetpack-compose'; import { align, fillMaxSize, fillMaxWidth, padding, } from '@expo/ui/jetpack-compose/modifiers'; export default function StyledSnackbar() { const hostRef = useRef<SnackbarHostRef>(null); const onSave = () => { hostRef.current?.showSnackbar({ message: 'Saved', actionLabel: 'Undo', withDismissAction: true, }); }; return ( <Host style={{ flex: 1 }}> <Box modifiers={[fillMaxSize()]}> <Column modifiers={[padding(16, 16, 16, 16)]}> <Button onClick={onSave}> <Text>Save</Text> </Button> </Column> <Box modifiers={[align('bottomCenter'), fillMaxWidth()]}> <SnackbarHost ref={hostRef}> <Snackbar containerColor="#1E1E2E" contentColor="#CDD6F4" actionContentColor="#F38BA8" dismissActionContentColor="#CDD6F4" /> </SnackbarHost> </Box> </Box> </Host> ); }

应用接口

🌐 API

import { Snackbar, SnackbarHost } from '@expo/ui/jetpack-compose';

No API data file found, sorry!