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.
ActionsApple
Share button
Open the operating system share surface from a token-aware native action.
Apple availability
Supported native targets
Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.
iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple Vision · visionOS 1+Apple Watch · watchOS 9+
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.
LumenShareButton("Share report", item: reportText)Reference
Public API
The primary shared and platform-specific options exposed by LumenShareButton.
| API | Values or type | Default | Description |
|---|---|---|---|
| item | Transferable | Required | Supplies application-owned share content. |
| Native share title | System-provided | System-provided | Configures the native share presentation. |
| label | Native localized text | Share | Names the trigger action. |
| Native ShareLink result | Platform callback | No-op | Lets the application report sharing outcomes where the platform exposes them. |
Native behavior
Design and accessibility
Accessibility
The trigger remains a native labeled button and destination selection is delegated to the operating system share surface.
Shared component