Alert
Alert (경고 메시지)
출처: 문서
본문
Alert
중요한 경고 메시지를 표시해요.
기본 사용법
Alert 컴포넌트는 페이지 안에 있는 오버레이가 아닌 요소로, 자동으로 사라지지 않아요.
Alert는 type으로 정의되는 5가지 테마를 제공하는데, 기본값은 info예요. primary는 2.9.11에 추가됐어요.
- Success alert
- Info alert
- Warning alert
- Error alert
.el-alert {
margin: 20px 0 0;
}
.el-alert:first-child {
margin: 0;
}
테마
Alert는 light와 dark 두 가지 테마를 제공해요.
effect를 설정해서 테마를 바꿔요. 기본값은 light예요.
닫기 버튼 커스터마이즈
닫기 버튼을 텍스트나 다른 기호로 커스터마이즈할 수 있어요.
Alert는 닫을 수 있는지 여부를 설정할 수 있어요. 닫기 버튼 텍스트와 닫힘 콜백도 커스터마이즈할 수 있어요. closable 속성은 컴포넌트를 닫을 수 있는지 결정해요. boolean을 받고 기본값은 true예요. close-text 속성을 설정하면 기본 X 기호 대신 닫기 버튼을 바꿀 수 있어요. 주의할 점은 close-text는 반드시 string이어야 한다는 점이에요. 컴포넌트가 닫히면 close 이벤트가 실행돼요.
const hello = () => {
// eslint-disable-next-line no-alert
alert('Hello World!')
}
.el-alert {
margin: 20px 0 0;
}
.el-alert:first-child {
margin: 0;
}
아이콘과 함께
아이콘을 표시하면 가독성이 좋아져요.
show-icon 속성을 설정하면 현재 Alert type에 맞는 아이콘이 표시돼요. 또는 icon 슬롯으로 아이콘을 커스터마이즈할 수 있어요.
import { Bell } from '@element-plus/icons-vue'
.el-alert {
margin: 20px 0 0;
}
.el-alert:first-child {
margin: 0;
}
텍스트 가운데 정렬
center 속성을 사용해서 텍스트를 가운데로 정렬해요.
설명과 함께
설명은 더 상세한 정보를 담은 메시지를 포함해요.
필수 속성인 title 외에 description 속성을 추가해서 alert를 더 자세히 설명할 수 있어요. description은 텍스트 문자열만 저장할 수 있고, 자동으로 줄바꿈돼요.
아이콘과 설명 함께
마지막으로, 아이콘과 설명을 모두 갖춘 예시예요.
.el-alert {
margin: 20px 0 0;
}
.el-alert:first-child {
margin: 0;
}
Alert API
Attributes
| Name | Description | Type | Default |
|---|---|---|---|
| title | alert 제목 | string | — |
| type | alert 유형 | enum | info |
| description | 설명 텍스트 | string | — |
| closable | alert를 닫을 수 있는지 여부 | boolean | true |
| center | 내용을 가운데에 배치할지 여부 | boolean | false |
| close-text | 커스터마이즈된 닫기 버튼 텍스트 | string | — |
| show-icon | 타입 아이콘을 표시할지 여부 | boolean | false |
| effect | 테마 스타일 | enum | light |
Events
| Name | Description | Type |
|---|---|---|
| close | alert가 닫힐 때 실행돼요 | Function |
Slots
| Name | Description |
|---|---|
| default | alert 설명 내용 |
| title | alert 제목 내용 |
| icon 2.9.7 | alert 아이콘 내용 |