This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 55).

DropdownMenu

一个用于显示下拉菜单的 Jetpack Compose DropdownMenu 组件。

Android

GitHub

npm

更新日志

Expo UI DropdownMenu 与官方 Jetpack Compose Menu API 保持一致，并在触发元素被按下时显示下拉菜单。

安装

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.

用法

基础下拉菜单

BasicDropdownMenuExample.tsx

import { Host, DropdownMenu, Button, Text, Icon } from '@expo/ui/jetpack-compose';
import { useState } from 'react';

export default function BasicDropdownMenuExample() {
  const [isExpanded, setIsExpanded] = useState(false);
  return (
    <Host matchContents>
      <DropdownMenu expanded={isExpanded} onDismissRequest={() => setIsExpanded(false)}>
        <DropdownMenu.Trigger>
          <Button variant="bordered" onClick={() => setIsExpanded(true)}>
            显示菜单
          </Button>
        </DropdownMenu.Trigger>
        <DropdownMenu.Items>
          <DropdownMenuItem
            onClick={() => {
              setIsExpanded(false);
              console.log('主页被按下');
            }}>
            <DropdownMenuItem.Text>
              <Text>主页</Text>
            </DropdownMenuItem.Text>
            <DropdownMenuItem.LeadingIcon>
              <Icon source={homeIcon} size={24} />
            </DropdownMenuItem.LeadingIcon>
          </DropdownMenuItem>
        </DropdownMenu.Items>
      </DropdownMenu>
    </Host>
  );
}

API

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

Components

`DropdownMenu`

Android

Type: React.Element<DropdownMenuProps>

Props of the DropdownMenu component.

DropdownMenuProps

`children`

Android

Type: ReactNode

The contents of the submenu are used as an anchor for the dropdown menu. The children will be wrapped in a pressable element, which triggers opening of the dropdown menu.

`color`

Android

Optional • Type: ColorValue

The color of the container holding the dropdown menu items.

`expanded`

Android

Optional • Type: boolean

Whether the dropdown menu is expanded (visible).

`modifiers`

Android

Optional • Type: ModifierConfig[]

Modifiers for the component.

`onDismissRequest`

Android

Optional • Type: () => void

Callback fired when the menu requests to be dismissed (e.g. tapping outside). Must be provided when expanded is true to allow the menu to close.

`style`

Android

Optional • Type: StyleProp<ViewStyle>

Optional styles to apply to the DropdownMenu.

`DropdownMenuItem`

Android

Type: React.Element<DropdownMenuItemProps>

A dropdown menu item component that wraps Compose's DropdownMenuItem. Should be used inside ContextMenu.Items.

`Items`

Android

Type: React.Element<{ children: ReactNode }>

Container for items displayed in the dropdown menu. Children should be DropdownMenuItem components or other native views.

`Preview`

Android

Type: React.Element<{ children: ReactNode }>

Preview content shown during long press (iOS only).

`Trigger`

Android

Type: React.Element<{ children: ReactNode }>

Container for the trigger element that opens the dropdown menu.