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 idforAlert | |
| 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-bottomafter component. | |
| title | string | The title of the Alert. | |
| type | enum | "info" | The type of Alert. | 
| suppressed | boolean | If suppressedis on, Alert will not have colored background | |
| labelClose | string | The label of the close button. | 
enum
| type | spaceAfter | 
|---|---|
| "info" | "none" | 
| "success" | "smallest" | 
| "warning" | "small" | 
| "critical" | "normal" | 
| "medium" | |
| "large" | |
| "largest" | 
Functional specs
- By passing the - closableprop into Alert, you will be able to handle- onClosefunction and Close icon will be displayed. Also, if you want to select the Close Button element for testing purposes, use [data-test=“AlertCloseButton”] selector.
- When the Alert has a - titleprop, if you pass an- iconprop as- true, the Alert will have its own icon based on the selected- type. If you want to use a different icon, just pass it to the- iconprop as a- React.Element. Alerts without a- titleor with a- titlebut without an- iconprop don’t have an icon.
- Passing a - inlineActionswill cause- childrento be ignored.- inlineActionsshould be used for displaying buttons inside short alerts which only have a- title.
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 ariaControlsis 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-bottomafter component. | |
| submit | boolean | false | If true, the Button has thetype="submit"attribute, otherwisetype="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" |