Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
React Native docs
Data displayReact Native

Badge

Display compact native status and classification labels using semantic tones.

Public APILumenBadgeReact Native

Native example

Use Badge

Use short status or classification labels. Prefer normal text for sentences, instructions, and frequently changing numeric values.

View verified React Native runtime capture
Badge rendered in the Expo web renderer Lumen playground
Verified runtime captureExpo web renderer
tsx
<LumenBadge tone="success">Active</LumenBadge>

Reference

Public API

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

APIValues or typeDefaultDescription
childrenString / native textRequiredProvides the visible badge label.
toneneutral · accent · success · warning · dangerneutralSelects the semantic status treatment.
styleNative layout APIAdds platform-native layout adjustments.

Native behavior

Design and accessibility

When to use it

Use short status or classification labels. Prefer normal text for sentences, instructions, and frequently changing numeric values.

Accessibility

Badge text remains available to assistive technology. Do not encode status only through tone.

Shared component

Available on other platforms

Apple / SwiftUIAndroid / Compose
React Native docsNative primitives