Feedback/DSTidbit

DSTidbit

feedback
since 1.2.0

Inline callout card with icon, title, body text, optional button, and dismiss.

iOSmacOS

Purpose

Use for contextual tips, hints, or inline notifications within content. Less intrusive than modals.

Variants

Info

.info

Blue with info icon

Success

.success

Green with checkmark icon

Warning

.warning

Yellow with warning icon

Error

.error

Red with error icon

Props

PropTypeDefaultDescription
titleString?nilOptional title
bodyreqString—Main text content
styleDSTidbitStyle.infoStyle: .info, .success, .warning, or .error
buttonTitleString?nilOptional button label
buttonAction(() -> Void)?nilOptional button action
onDismiss(() -> Void)?nilIf set, shows close button
accessibilityLabelString?nilOptional accessibility label

Examples

Helpful tip

Inline tip with action button.

swift
DSTidbit(
    title: "Pro tip",
    body: "Use keyboard shortcuts to work faster.",
    style: .info,
    buttonTitle: "Learn more",
    buttonAction: { showShortcuts() },
    onDismiss: { dismissTip() }
)

Warning message

Warning without title or actions.

swift
DSTidbit(
    body: "Changes will be lost if you navigate away.",
    style: .warning
)

Usage Guidelines

  • Use for contextual, non-blocking messages
  • Place near related content for context
  • Keep body text concise (1-2 sentences)
  • Use dismiss button for optional tips, not critical warnings

Related Components

NoticeBarToastAlert