REACT-NATIVES

WIRED FOR SPEED

react-natives v2.1.2

Theme

Light

Dark

Get Started

Components

Utility

Portal

Renders children into a separate native view outside the parent component tree.

Example

Preview

Code

Props

Portal Props

Prop

Type

Default

Description

className

string

—

NativeWind utility classes to apply to the portal wrapper.

Usage Guidelines

When to use

Use Portal to render modals, tooltips, or overlays that need to escape parent clipping or z-index stacking.

Best practices

•

Use Portal for content that must visually escape its parent container.

•

Avoid using Portal directly — prefer higher-level components like Modal or Popover that use it internally.

•

Ensure portaled content is properly cleaned up on unmount.

Accessibility

Portal moves content in the native view hierarchy. Ensure focus management is handled so screen readers can reach portaled content.

Related Components

Modal

A compound overlay dialog component with backdrop, content, header, body, footer, and close button sub-components.

Popover

A positioned overlay that appears relative to a trigger element.

A dropdown menu triggered by a button or other element.

React-Natives

A comprehensive React Native component library.

Documentation

Getting Started

Components

Theming

Community

GitHub

Discord

Twitter

Blog

Support

FAQ

Contact

Contributing

License