Skip to content
Design System
  • Home
  • Settings
  • Styles
  • Layouts
  • Components
  • Scripts
  • Templates
  • Access control banner
  • Activity
  • Archived content
  • Breadcrumbs
  • Cards
  • Collapsible containers
  • Columns
  • Content slider (carousel)
  • Crosslinks (You may also like)
  • Disclosure button
  • Evangelists
  • Fifty-fifty
  • Footer
  • Group list
  • Header
  • Hero
  • Image component
  • Members
  • Navigation
  • Navigation with new logo v1
  • Navigation with new logo v2
  • Notes
  • Pagination
  • Pre-footer
  • Quote component
  • RSS
  • Table of contents
  • Tag list
  • Text component
  • Translations
  • Video component

Notes

Notes can be used for simple informational messages, and for success, warning and error alerts. They are an enhancement of the default box layout.

Open this Notes in a new tab

HTML:

<div class="l-box note note--info" role="status" aria-labelledby="unique-id-1" tabindex="-1" data-anchor="no">
    <h2 id="unique-id-1" class="txt-saturn">Informative note heading</h2>
    <p>Group calendering is currently in beta-test. We encourage everyone to use it and report feedback and issues to its <a href="#1">dedicated GitHub repository</a>.</p>
</div>

<div class="l-box note note--success" role="status" aria-labelledby="unique-id-2" tabindex="-1" data-anchor="no">
    <h2 id="unique-id-2" class="txt-saturn">Success note heading</h2>
    <p>Main profile successfully updated.</p>
</div>

<div class="l-box note note--warning" role="status" aria-labelledby="unique-id-3" tabindex="-1" data-anchor="no">
    <h2 id="unique-id-3" class="txt-saturn">Warning note heading</h2>
    <p>We could not detect your affiliation based on your email address. Please select your affiliation below or <a href="#2">go back to use your corporate email address.</a></p>
</div>

<div class="l-box note note--error" role="alert" aria-labelledby="unique-id-4" tabindex="-1" data-anchor="no">
    <h2 id="unique-id-4" class="txt-saturn">Error note heading</h2>
    <p>There has been an error.</p>
</div>

¶Considerations

Note the use of role="status" and role="alert". Both create an ARIA live region.

If the content of the note is advisory information not important enough to justify an alert, use role="status". When added to an element, the browser will send out an accessible status event to assistive technologies, which can then notify the user about it.

For error messages, use role="alert". The alert role should read out content that has changed, or bring the user's attention to it immediately, so it should not be used for static content or used regularly. Alerts, by definition, are disruptive. Lots of alerts at once or unnecessary alerts will create a bad user experience.

Copyright © 2025 W3C - generated 10 Jan 2025, 12:43:28 UTC

Feedback is welcome and can be submitted as a GitHub issue.