HorizontalFloatingToolbar

一个 Jetpack Compose HorizontalFloatingToolbar 组件，用于显示浮动操作栏。

Android

Included in Expo Go

GitHub

npm

更新日志

Recommended version:

~58.0.1

Expo UI HorizontalFloatingToolbar 封装了官方 Jetpack Compose HorizontalFloatingToolbar，用于显示悬浮在内容上方的水平工具栏，其中包含操作按钮。

注意：如果只需要单个悬浮按钮，请改用 FloatingActionButton

安装

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.

用法

在可滚动内容上方显示悬浮工具栏

将工具栏放在带有 floatingToolbarExitAlwaysScrollBehavior 的 Box 内，即可实现由滚动驱动的隐藏／显示行为。使用 align('bottomCenter') 将工具栏定位在屏幕底部。整个布局都保留在 Compose 层中，无需使用 React Native 绝对定位。

FloatingToolbarExample.tsx

import {
  Box,
  HorizontalFloatingToolbar,
  Host,
  Icon,
  IconButton,
  LazyColumn,
  ListItem,
  Text,
} from '@expo/ui/jetpack-compose';
import {
  align,
  fillMaxSize,
  offset,
} from '@expo/ui/jetpack-compose/modifiers';

const ITEMS = Array.from(
  { length: 20 },
  (_, index) => `Item ${index + 1}`
);

export default function FloatingToolbarExample() {
  return (
    <Host style={{ flex: 1 }}>
      <Box
        modifiers={[fillMaxSize()]}
        floatingToolbarExitAlwaysScrollBehavior="bottom">
        <LazyColumn modifiers={[fillMaxSize()]}>
          {ITEMS.map(item => (
            <ListItem key={item}>
              <ListItem.HeadlineContent>
                <Text>{item}</Text>
              </ListItem.HeadlineContent>
            </ListItem>
          ))}
        </LazyColumn>

        <HorizontalFloatingToolbar
          variant="vibrant"
          modifiers={[align('bottomCenter'), offset(0, -16)]}>
          <IconButton onClick={() => console.log('Edit pressed')}>
            <Icon source={require('./assets/edit.xml')} />
          </IconButton>
          <HorizontalFloatingToolbar.FloatingActionButton
            onPress={() => console.log('Add pressed')}>
            <Icon source={require('./assets/add.xml')} />
          </HorizontalFloatingToolbar.FloatingActionButton>
        </HorizontalFloatingToolbar>
      </Box>
    </Host>
  );
}

带 FloatingActionButton 的工具栏

工具栏项使用 IconButton 作为直接子元素，主操作则使用 HorizontalFloatingToolbar.FloatingActionButton。

ToolbarWithFABExample.tsx

import {
  Host,
  HorizontalFloatingToolbar,
  IconButton,
  Icon,
} from '@expo/ui/jetpack-compose';

export default function ToolbarWithFABExample() {
  return (
    <Host matchContents>
      <HorizontalFloatingToolbar>
        <IconButton onClick={() => console.log('Edit pressed')}>
          <Icon
            source={require('./assets/edit.xml')}
            contentDescription="Edit"
          />
        </IconButton>
        <IconButton onClick={() => console.log('Share pressed')}>
          <Icon
            source={require('./assets/share.xml')}
            contentDescription="Share"
          />
        </IconButton>
        <HorizontalFloatingToolbar.FloatingActionButton
          onPress={() => console.log('Add pressed')}>
          <Icon
            source={require('./assets/add.xml')}
            contentDescription="Add"
          />
        </HorizontalFloatingToolbar.FloatingActionButton>
      </HorizontalFloatingToolbar>
    </Host>
  );
}

API

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

Components

`HorizontalFloatingToolbar`

Android

Type: React.Element<HorizontalFloatingToolbarProps>

Renders a HorizontalFloatingToolbar component. A horizontal toolbar that floats above content, typically used for action buttons.

HorizontalFloatingToolbarProps

`children`

Android

Type: ReactNode

The children of the component.

`colors`

Android

Optional • Type: HorizontalFloatingToolbarColors

Per-slot color overrides. Any field set here replaces the corresponding color from the variant default; unset fields fall back to the variant.

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component.

`variant`

Android

Optional • Literal type: string • Default: 'standard'

The variant of the horizontal floating toolbar.

Acceptable values are: 'standard' | 'vibrant'

`HorizontalFloatingToolbarFloatingActionButton`

Android

Type: React.Element<HorizontalFloatingToolbarFloatingActionButtonProps>

FloatingActionButton component for HorizontalFloatingToolbar. This component marks its children to be rendered in the FAB slot.

HorizontalFloatingToolbarFloatingActionButtonProps

`children`

Android

Type: ReactNode

The children of the component.

`onPress`

Android

Optional • Type: () => void

A callback that is called when the button is pressed.

Types

`HorizontalFloatingToolbarColors`

Android

Property	Type	Description
fabContainerColor(optional)	`ColorValue`	Color of the floating action button container (background).
fabContentColor(optional)	`ColorValue`	Color of the floating action button content (icon).
toolbarContainerColor(optional)	`ColorValue`	Color of the toolbar container (background).
toolbarContentColor(optional)	`ColorValue`	Color of the toolbar content (icons/text).