docs_vue2/one/docs/en-US/components/alert-box.md

76 lines
2.7 KiB
Markdown
Raw Normal View History

2020-08-13 11:47:56 +08:00
# AlertBox
## Demos
### Types
`AlertBox` component has 3 contextual types, which are `success`, `info`, ` and `error`. Types are specified with the [`type`](#props-type) prop.
2020-08-13 11:47:56 +08:00
[[ demo src="/demo/alert-box/type.vue" ]]
### With title
You can customize the title of alert box with the [`title`](#props-title) prop.
2020-08-13 11:47:56 +08:00
[[ demo src="/demo/alert-box/title.vue" ]]
## API
### Props
| Name | Type | Default | Description |
| -- | -- | -- | -- |
| ``open`` | `boolean` | `false` | [^open] |
| ``type`` | `string=` | `'success'` | [^type] |
| ``title`` | `string=` | - | The title of the alert box. |
| ``loading`` | `boolean=` | `false` | Wehter the confirm box is in loading state. When loading, the OK button will enter loading state as well and become unclickable. |
| ``disabled`` | `boolean=` | `false` | Wehter the confirm box is disabled. When disabled, the OK button will be disabled as well and become unclickable. |
| ``ok-label`` | `string=` | - | The text content of the “OK” button. |
| ``before-close`` | `function(string): boolean=|Promise<boolean=>` | - | Executed when user interaction is about to trigger closing the alert box. See the [`before-close`](./dialog#props-before-close) prop of the [`Dialog`](./dialog) component. |
| ``overlay-class`` | `string | Array | Object=` | - | See the [`overlay-class`](./overlay#props-overlay-class) prop of the [`Overlay`](./overlay) component. |
| ``overlay-style`` | `string | Array | Object=` | - | See the [`overlay-style`](./overlay#props-overlay-style) prop of the [`Overlay`](./overlay) component. |
2020-08-13 11:47:56 +08:00
^^^open
:::badges
`.sync`
:::
Whether the alert box is displayed.
^^^
^^^type
The contextual type of the alert box.
+++Enum values
| Value | Description |
| -- | -- |
| `info` | Information alert box. |
| `success` | Success alert box. |
| `error` | Error alert box. |
+++
^^^
### Slots
| Name | Description |
| -- | -- |
| ``default`` | The content of the alert box. |
| ``title`` | The title of the alert box. Will ignore the [`title`](#props-title) prop when specified. |
| ``foot`` | The foot area of the alert box. Displays an “OK” button by default. |
2020-08-13 11:47:56 +08:00
### Events
| Name | Description |
| -- | -- |
| ``ok`` | Triggered when the “OK” button is clicked. |
2022-02-01 15:33:20 +08:00
| ``afteropen`` | Triggered after the box overlay is opened. The box content won't be rendered until after the overlay is opened, so if there is logic that depends on content rendering, please execute it after this event is triggered. |
| ``afterclose`` | Triggered after the box overlay is closed. If leaving transition is provided by the theme, the event will be triggered after the transition completes. |
2020-08-13 11:47:56 +08:00
### Icons
| Name | Description |
| -- | -- |
| ``info`` | Information alert. |
| ``success`` | Success alert. |
| ``error`` | Error alert. |