Alert
To implement Alert component into your project you’ll need to add the import:
import Alert from "@kiwicom/orbit-components/lib/Alert";
After adding import into your project you can use it simply like:
<Alert>Hello World!</Alert>
Props
The table below contains all types of the props available in Alert component.
Name | Type | Default | Description |
---|---|---|---|
children | React.Node | The content of the Alert. | |
closable | boolean | false | If true , the Close icon will be displayed. See Functional specs |
dataTest | string | Optional prop for testing purposes. | |
id | string | Set id for Alert . | |
icon | React.Element<any> \| boolean | The displayed icon. See Functional specs | |
inlineActions | React.Node | Renders action to a right side of a Alert. See Functional specs | |
onClose | () => void \| Promise | Function for handling Alert onClose. | |
spaceAfter | enum | Additional margin-bottom after component. | |
title | string | The title of the Alert. | |
type | enum | "info" | The type of Alert. |
suppressed | boolean | If suppressed is on, Alert will not have colored background. | |
labelClose | string | The label of the close button. Required when closable is true . |
enum
type | spaceAfter |
---|---|
"info" | "none" |
"success" | "smallest" |
"warning" | "small" |
"critical" | "normal" |
"medium" | |
"large" | |
"largest" |
Functional specs
By passing the
closable
prop into Alert, you will be able to handleonClose
function and Close icon will be displayed. Whenclosable
istrue
, thelabelClose
prop is required for accessibility. Also, if you want to select the Close Button element for testing purposes, use [data-test=“AlertCloseButton”] selector.When the Alert has a
title
prop, if you pass anicon
prop astrue
, the Alert will have its own icon based on the selectedtype
. If you want to use a different icon, just pass it to theicon
prop as aReact.Element
. Alerts without atitle
or with atitle
but without anicon
prop don’t have an icon.Passing a
inlineActions
will causechildren
to be ignored.inlineActions
should be used for displaying buttons inside short alerts which only have atitle
.
Subcomponents
AlertButton
To implement AlertButton component into your project you’ll need to add the import:
import AlertButton from "@kiwicom/orbit-components/lib/Alert/AlertButton";// orimport { AlertButton } from "@kiwicom/orbit-components/lib/Alert";
After adding import into your project you can use it simply like:
<AlertButton type="info">Hello World!</AlertButton>
Props
Table below contains all types of the props available in AlertButton component.
Name | Type | Default | Description |
---|---|---|---|
ariaControls | string | Id of the element the button controls. | |
ariaExpanded | boolean | Tells screen reader the controlled element from ariaControls is expanded | |
asComponent | string \| React.Element | "button" | The component used for the root node. |
fullWidth | boolean | false | If true , the AlertButton grows to the full width of its container. |
circled | boolean | false | If true , the AlertButton is circular. |
children | React.Node | The content of the AlertButton. | |
dataTest | string | Optional prop for testing purposes. | |
disabled | boolean | false | If true , the AlertButton is disabled. |
external | boolean | false | If true , the AlertButton opens link in a new tab. |
href | string | The URL of the link to open when AlertButton is clicked. | |
iconLeft | React.Node | The displayed icon on the left. | |
iconRight | React.Node | The displayed icon on the right. | |
loading | boolean | false | If true , the loading glyph is displayed. |
onClick | event => void \| Promise | Function for handling onClick event. | |
ref | func | Prop for forwarded ref of the AlertButton. | |
role | string | Specifies the role of an element. | |
spaceAfter | enum | Additional margin-bottom after component. | |
submit | boolean | false | If true , the Button has the type="submit" attribute, otherwise type="button" . |
tabIndex | string \| number | Specifies the tab order of an element. | |
title | string | Adds aria-label . | |
type | enum | "primary" | The type of AlertButton. |
width | string | The width of the AlertButton. Can be any string - 100px , 20% . |
Button enum
type | spaceAfter |
---|---|
"info" | "none" |
"success" | "smallest" |
"warning" | "small" |
"critical" | "normal" |
"infoSubtle" | "medium" |
"successSubtle" | "large" |
"warningSubtle" | "largest" |
"criticalSubtle" |