Alert (alert)

An alert keeps users informed of important and sometimes time-sensitive changes.

🔗 External documentation.

ID Label Description Schema
heading Heading The alert heading. Optional.
message Message The alert message
slim Slim Display an alert slimmer then default.
                        type: boolean

                      
no_icon No Icon Display an alert without an icon.
                        type: boolean

                      
            id: alert
label: Alert
description: 'An alert keeps users informed of important and sometimes time-sensitive changes.'
group: 'Alerts / Banner'
homepage: 'https://designsystem.digital.gov/components/alert/'
variants:
    info:
        id: info
        label: Informative
    warning:
        id: warning
        label: Warning
    error:
        id: error
        label: Error
    success:
        id: success
        label: Success
    emergency:
        id: emergency
        label: Emergency
slots:
    heading:
        id: heading
        label: Heading
        description: 'The alert heading. Optional.'
    message:
        id: message
        label: Message
        description: 'The alert message'
props:
    slim:
        id: slim
        label: Slim
        description: 'Display an alert slimmer then default.'
        schema:
            type: boolean
    no_icon:
        id: no_icon
        label: 'No Icon'
        description: 'Display an alert without an icon.'
        schema:
            type: boolean
examples:
    preview:
        id: preview
        label: Preview
        renderable:
            '@component': alert
            heading: 'Hello world'
            message: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.'

          

Informative ( info )

Hello world

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.
<div class="usa-alert--info usa-alert" role="region"> <div class="usa-alert__body"> <h4 class="usa-alert__heading">Hello world</h4> <div class="usa-alert__text">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.</div> </div> </div>

Warning ( warning )

Hello world

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.
<div class="usa-alert--warning usa-alert" role="region"> <div class="usa-alert__body"> <h4 class="usa-alert__heading">Hello world</h4> <div class="usa-alert__text">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.</div> </div> </div>

Error ( error )

<div class="usa-alert--error usa-alert" role="alert"> <div class="usa-alert__body"> <h4 class="usa-alert__heading">Hello world</h4> <div class="usa-alert__text">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.</div> </div> </div>

Success ( success )

Hello world

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.
<div class="usa-alert--success usa-alert" role="status"> <div class="usa-alert__body"> <h4 class="usa-alert__heading">Hello world</h4> <div class="usa-alert__text">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.</div> </div> </div>

Emergency ( emergency )

<div class="usa-alert--emergency usa-alert" role="alert"> <div class="usa-alert__body"> <h4 class="usa-alert__heading">Hello world</h4> <div class="usa-alert__text">Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod.</div> </div> </div>