一、配置
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-10-16 02:14:41