Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
React Native docs
ActionsReact Native

Share button

Open the operating system share surface from a token-aware native action.

Public APILumenShareButtonReact Native

Native example

Use Share button

Use to share application-owned text, URLs, or files through the operating system. Keep content generation, file permissions, completion feedback, and error handling in the application.

View verified React Native runtime capture
Share button rendered in the Expo web renderer Lumen playground
Verified runtime captureExpo web renderer
tsx
<LumenShareButton
  label="Share report"
  content={{ message: reportText }}
/>

Reference

Public API

The primary shared and platform-specific options exposed by LumenShareButton.

APIValues or typeDefaultDescription
contentShareContentRequiredSupplies application-owned share content.
optionsShareOptionsundefinedConfigures the native share presentation.
labelNative localized textShareNames the trigger action.
onError / onSharedPlatform callbackNo-opLets the application report sharing outcomes where the platform exposes them.

Native behavior

Design and accessibility

When to use it

Use to share application-owned text, URLs, or files through the operating system. Keep content generation, file permissions, completion feedback, and error handling in the application.

Accessibility

The trigger remains a native labeled button and destination selection is delegated to the operating system share surface.

Shared component

Available on other platforms

Apple / SwiftUIAndroid / Compose
React Native docsNative primitives