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.

Overlay

一个用于在另一个视图上层叠内容的 SwiftUI Overlay 组件。

iOS
tvOS
Included in Expo Go
Recommended version:
~57.0.0

Expo UI Overlay 与官方 SwiftUI overlay 修饰符一致,并提供了一种在视图上层叠加次要内容的方法,该内容可通过指定的对齐方式进行定位。

一个带红色 3 通知徽标的铃铛图标,叠加在右上角

安装

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.

用法

OverlayExample.tsx
import { Host, Overlay, Text, Image } from '@expo/ui/swift-ui'; import { foregroundStyle, frame, font, background, clipShape, offset, } from '@expo/ui/swift-ui/modifiers'; export default function OverlayExample() { return ( <Host style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}> <Overlay alignment="topTrailing"> <Image systemName="bell.fill" modifiers={[font({ size: 28 }), foregroundStyle('#007AFF')]} /> <Overlay.Content> <Text modifiers={[ font({ size: 11, weight: 'bold' }), foregroundStyle('#FFFFFF'), frame({ width: 18, height: 18 }), background('#FF3B30'), clipShape('circle'), offset({ x: 8, y: -8 }), ]}> 3 </Text> </Overlay.Content> </Overlay> </Host> ); }

API

import { Overlay } from '@expo/ui/swift-ui';

Component

Overlay

iOS
tvOS

Type: React.Element<OverlayProps>

OverlayProps

alignment

iOS
tvOS
Optional • Type: Alignment • Default: 'center'

The alignment of the overlay content relative to the base content.

children

iOS
tvOS
Type: ReactNode