Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,17 @@ section: components
related: ['Notification drawer', 'Page']
---

import '../components.css';

## Elements

<img src="./img/notification-badge.png" alt="basic notification drawer" width="598"/>
<div class="ws-docs-content-img">
![Elements of a notification badge.](./img/badge-elements.svg)
</div>

1. **Icon:** The notification badge will be located in the masthead and display the 'fa-bell' icon in it's default state. Clicking the icon (or anywhere within the badge) will toggle the notification drawer open and closed.

2. **Background:** In the default state, the background will change color to indicate that the notification drawer is opened. Optionally the background color can also convey status.
2. **Border:** In the default state, the border will change color to indicate that the notification drawer is opened.

3. **Unread status (optional):** Setting the background color to blue will indicate that one or more unread notifications are present in the drawer.

Expand Down
Comment thread
bekah-stephens marked this conversation as resolved.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,15 @@ section: components
related: ['Notification drawer', 'Notification badge', 'Drawer']
---

import '../components.css';

## Elements

### Basic notification drawer

<img src="./img/Simple-Notification-Drawer.png" alt="basic notification drawer" width="743"/>
<div class="ws-docs-content-img">
![Elements of a basic notification drawer.](./img/drawer-elements.svg)
</div>

1. **Header:** The header contains the title of the drawer (default to “Notifications”).

Expand All @@ -32,7 +36,9 @@ related: ['Notification drawer', 'Notification badge', 'Drawer']
### Grouped notification drawer
If you want to sort notifications by category, collapsible headers may be used to group content. The grouped notification drawer utilizes an accordion pattern where only one category will be opened at a time. By default, the first category will be opened, although if the drawer is closed and reopened, the prior state should persist.

<img src="./img/Complex-Notification-Drawer.png" alt="grouped notification drawer" width="724"/>
<div class="ws-docs-content-img">
![Elements of a grouped notification drawer.](./img/grouped-drawer-elements.svg)
</div>

1. **Notification group:** Notifications can be grouped by category. You may have any number of categories, however more than 3-4 categories is not recommended. Each category header will have a name. Clicking on the header will expand the category (and collapse the current category).

Expand Down Expand Up @@ -79,8 +85,9 @@ In cases where it makes sense to immediately notify the user about a change in s

## Placement

<img src="./img/Notification-drawer-in-page.png" alt="grouped notification drawer" width="677"/>

<div class="ws-docs-content-img">
![Example showing the placement of a notification drawer.](./img/drawer-placement.svg)
</div>

1. **Notification badge:** Whenever the notification drawer is used, a [notification badge](/components/notification-badge) must be placed in the masthead. Clicking on the badge will toggle the drawer open or closed. Depending on options supported in the application, the badge can also be used to display the number of notifications in the drawer and whether there are unread or critical notifications needing attention. See the [notification badge](/components/notification-badge) usage guidelines for more information about these options.

Expand Down
Loading