ouds-ios-components-dialogs

Files (1)

• SKILL.md

SKILL.md (first lines)

# OUDS Dialogs components

> Prerequisite: load `ouds-ios-framework-usage` first for imports, themes and image rules.

## Alert Message

Statuses: `neutral`, `accent`, `positive`, `info`, `warning`, `negative`

```swift
OUDSAlertMessage(label: "Label")
OUDSAlertMessage(label: "Label", status: .warning, description: "Details") { /* dismiss */ }
OUDSAlertMessage(label: "Label",
                 status: .neutral(image: OUDSImage(asset: Image("ic_heart"), renderingMode: .original)), // .original to avoid to have tinted images
                 bulletList: ["A", "B"],
                 link: .init(text: "More", position: .bottom) {},
                 disableVoiceOverAnnouncement: true, // default false: VoiceOver announces the alert on appear
                 onClose: {})
// description and bulletList elements are OUDSTextualContent: raw (string literal), localized or rich
OUDSAlertMessage(label: "Label",
                 description: .rich(AttributedString(…)),
                 bulletList: ["Raw", .localized("key", bundle: Bundle.module), .rich(AttributedString(…))])
```

> **Literal pitfall**: with the `LocalizedStringKey` initializer (`OUDSAlertMessage(LocalizedStringKey("key"), …)`), a bare `description: "abc"`
> may select a deprecated initializer and emit a deprecation warning, because `AttributedString` is itself expressible by a string literal.
> Write `description: .raw("abc")` in that case. With the `label:` initializer a bare literal is fine.

---

## Inline Alert

Statuses: `neutral`, `accent`, `positive`, `info`, `warning`, `negative`

```swift
OUDSInlineAlert(label: "Label")
OUDSInlineAlert(label: "Label", status: .warning)
OUDSInlineAlert(label: "Label", status: .accent(image: OUDSImage(asset: Image("ic_heart"))))
OUDSInlineAlert(label: "Label", status: .info, disableVoiceOverAnnouncement: true) // default false: VoiceOver announces the alert on appear
```

From Orange-OpenSource/ouds-ios, MIT.

More from Orange-OpenSource/ouds-ios