WidgetKitApple

Widget icon

Render a labeled or decorative WidgetKit SF Symbol with semantic tone.

Public APILumenWidgetIconApple / SwiftUISwift product: LumenWidgetUI

Apple availability

Supported native targets

Import LumenWidgetUI 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 Watch · watchOS 9+

Native example

Use for compact WidgetKit SF Symbols. Keep product artwork and asset catalogs in the application.

Focused package reference

This API ships in LumenWidgetUI. No application-playground capture is published for this extension-only product yet.

LumenWidgetIcon(
    systemName: "timer",
    label: .verbatim("Active timer"),
    tone: .accent
)

Reference

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

API	Values or type	Default	Description
systemName	`String`	`Required`	Selects an application-approved SF Symbol.
label	`LumenWidgetTextContent?`	`nil`	Names a meaningful icon.
tone	`LumenWidgetTone`	`accent`	Adapts the symbol across rendering modes.
size	`CGFloat`	`18`	Sets the compact symbol dimension.

Native behavior

Use for compact WidgetKit SF Symbols. Keep product artwork and asset catalogs in the application.

The SF Symbol is decorative without a label and exposes the supplied accessible name when it conveys meaning.