一、配置
| Argument | Default value |
含义 |
Description |
|---|---|---|---|
| title | null (required) | 模态对话框的标题。它可以在参数对象的title参数中设置，也可以在swal()方法的第一个参数设置。 |
The title of the modal. It can either be added to the object under the key "title" or passed as the first parameter of the function. |
| text | null | 模态对话框的内容。它可以在参数对象的text参数中设置，也可以在swal()方法的第二个参数设置。 |
A description for the modal. It can either be added to the object under the key "text" or passed as the second parameter of the function. |
| type | null | 类型：warning, error,success、info、input。它可以在参数对象的type参数中设置，也可以在swal()方法的第三个参数设置。 |
The type of the modal. SweetAlert comes with 4 built-in types which will show a corresponding icon animation: "warning", "error", "success" and "info". You can also set it as "input" to get a prompt modal. It can either be put in the object under the key "type" or passed as the third parameter of the function. |
| allowEscapeKey | true | 是否允许按下Esc键来关闭对话框。 | If set to true, the user can dismiss the modal by pressing the Escape key. |
| customClass | null | 自定义CSS | A custom CSS class for the modal. It can be added to the object under the key "customClass". |
| allowOutsideClick | false | 是否允许点击对话框外部来关闭对话框。 | If set to true, the user can dismiss the modal by clicking outside it. |
| showCancelButton | false | 展示取消按钮 | If set to true, a "Cancel"-button will be shown, which the user can click on to dismiss the modal. |
| showConfirmButton | true | 展示确认按钮 | If set to false, the "OK/Confirm"-button will be hidden. Make sure you set a timer or set allowOutsideClick to true when using this, in order not to annoy the user. |
| confirmButtonText | "OK" | 确认按钮上显示文本 | Use this to change the text on the "Confirm"-button. If showCancelButton is set as true, the confirm button will automatically show "Confirm" instead of "OK". |
| confirmButtonColor | "#AEDEF4" | 确认按钮颜色 | Use this to change the background color of the "Confirm"-button (must be a HEX value). |
| cancelButtonText | "Cancel" | 取消按钮上显示文本 | Use this to change the text on the "Cancel"-button. |
| closeOnConfirm | true | 确认后，显示一个新的确认弹出框 | Set to false if you want the modal to stay open even if the user presses the "Confirm"-button. This is especially useful if the function attached to the "Confirm"-button is another SweetAlert. |
| closeOnCancel | true | 取消后，显示一个新的确认弹出框 | Same as closeOnConfirm, but for the cancel button. |
| imageUrl | null | 图片地址 | Add a customized icon for the modal. Should contain a string with the path to the image. |
| imageSize | "80x80" | 图片大小 | If imageUrl is set, you can specify imageSize to describes how big you want the icon to be in px. Pass in a string with two values separated by an "x". The first value is the width, the second is the height. |
| timer | null | 自动关闭模态框 毫秒 | Auto close timer of the modal. Set in ms (milliseconds). |
| html | false | text,title 是否是html | If set to true, will not escape title and text parameters. (Set to false if you‘re worried about XSS attacks.) |
| animation | true | 显示动画，默认pop，其他值：slide-from-top, slide-from-bottom | If set to false, the modal‘s animation will be disabled. Possible (string) values : pop (default when animation set to true), slide-from-top, slide-from-bottom |
| inputType | "text" | 在type是input时，可以定义inputType类型，如password | Change the type of the input field when using type: "input" (this can be useful if you want users to type in their password for example). |
| inputPlaceholder | null | input的placeholder | When using the input-type, you can specify a placeholder to help the user. |
| inputValue | null | 类型是input是的值 | Specify a default text value that you want your input to show when using type: "input" |
| showLoaderOnConfirm | false | 设置为true时，按钮被禁用，并显示一个在加载的进度条。该参数用于AJAX请求的情况。 | Set to true to disable the buttons and show that something is loading. |
二、方法
| Function | Example |
含义 |
Description |
|---|---|---|---|
| setDefaults | swal.setDefaults({ confirmButtonColor: ‘#0000‘ }); | 设置默认的一些参数 | If you end up using a lot of the same settings when calling SweetAlert, you can use setDefaults at the start of your program to set them once and for all! |
| close | swal.close(); | 关闭 | Close the currently open SweetAlert programatically. |
| showInputError | swal.showInputError("Invalid email!"); | 展示错误消息 | Show an error message after validating the input field, if the user‘s data is bad |
| enableButtons, disableButtons | swal.disableButtons(); | 启用，禁用确认或者取消 | Disable or enable the user to click on the cancel and confirm buttons. |
时间： 2024-12-28 16:24:03