Import
import { Note } from '@contentful/f36-components';// orimport { Note } from '@contentful/f36-note';
Examples
The Note component can be configured in a number of different ways. Learn when to use certain variations with this guide.
Basic usage
Component variations
Note with title (title
)
Props (API reference)
Open in StorybookName | Type | Default |
---|---|---|
children | ReactNode Children of Note | |
className | string CSS class to be appended to the root element | |
css | string number false true ComponentSelector Keyframes SerializedStyles ArrayInterpolation<undefined> ObjectInterpolation<undefined> (theme: any) => Interpolation<undefined> | |
onClose | MouseEventHandler<HTMLButtonElement> Callback for handling closing | |
testId | string A [data-test-id] attribute used for testing purposes | |
title | string number false true {} ReactElement<any, string | JSXElementConstructor<any>> ReactNodeArray ReactPortal Sets title in the Note | |
variant | "negative" "positive" "primary" "warning" Determines style variation of Note component | |
withCloseButton | false true Defines if the close button should be rendered |
Content guidelines
- Use an adequate note type to communicate the right kind of information
- Place the note visually closer to the action or real estate it relates to
- Unlike notifications, notes don't show up as feedback only after a user has performed an action
- Use clear and succinct copy
- Ensure the copy is easily scannable. Focus on the objective and limit the number of concepts in each sentence
- Use progressive disclosure. Eliminate details that can be revealed as the user interacts and requires more information
- Use active voice, present tense, and consider tone of voice depending on the circumstance
- To add additional context, link out to documentation
- Do not preface the instructions with introductory text, such as "please"