Skip to content

Prompt 提示输入

一般用于获取用户输入,例如用户名、密码等。

TIP

该弹出层支持 Promise 风格 调用,具体可以查看 获取用户输入结果

基础使用

调用 prompt 方法并传入一段文本可以弹出一个提示输入框,在屏幕居中显示。

获取用户输入结果

该方法返回一个 Promise<string | void> 对象,当用户点击确认按钮时,会执行 resolve 方法并传入用户输入的文本,当用户点击取消按钮时,会执行 resolve 方法并传入 undefined,因此可以通过 await 来获取用户输入结果。

设置默认值

可以通过 defaultValue 选项来设置默认值。

输入框类型

可以通过 type 选项来设置输入框的类型,可选类型包括:inputtextarea ,默认值为 input

最大输入长度

可以通过 maxLength 选项来设置输入框的最大输入长度,默认不限制输入长度。

设置输入框占位符

可以通过 placeholder 选项来设置输入框的占位符。

自定义标题文本

可以通过 title 选项来自定义提示输入框的标题文本。

禁用标题栏关闭按钮

可以通过 headerClose 选项来禁用标题栏的关闭按钮。

自定义确认按钮文本

可以通过 confirmText 选项来自定义确认按钮的文本。

自定义取消按钮文本

可以通过 cancelText 选项来自定义取消按钮的文本。

禁用遮罩层高斯模糊

为了提升用户关注度,该弹出层使用了 高斯模糊 背景遮罩,可以通过 maskBlur 选项来禁用遮罩层的高斯模糊效果。

启用窗口拖拽功能

可以通过 draggable 选项来启用窗口的拖拽功能,开启后允许拖拽标题栏从而实现窗口的移动。

默认情况下,拖拽时无法超出屏幕范围,可通过 dragOverflow 选项来设置是否允许超出。

详细配置

具体可以参考 API 控制器实例 popup.prompt()

Released under the MIT License.