Home > SYS_Dialog > showInputDialog

SYS_Dialog.showInputDialog() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

弹出输入窗口

签名

function showInputDialog(
	beforeContent?: string,
	afterContent?: string,
	title?: string,
	type?:
		| 'color'
		| 'date'
		| 'datetime-local'
		| 'email'
		| 'mouth'
		| 'number'
		| 'password'
		| 'tel'
		| 'text'
		| 'time'
		| 'url'
		| 'week',
	value?: string | number,
	otherProperty?: {
		max?: undefined | number;
		maxlength?: undefined | number;
		min?: undefined | number;
		minlength?: undefined | number;
		multiple?: undefined | false | true;
		pattern?: undefined | RegExp;
		placeholder?: undefined | string;
		readonly?: undefined | false | true;
		step?: undefined | number;
	},
	callbackFn?: (value: any) => void,
): void;

参数名

参数	类型	描述
beforeContent	string	（可选） 输入框上方文字
afterContent	string	（可选） 输入框下方文字
title	string	（可选） 弹出窗口标题
type	'color' | 'date' | 'datetime-local' | 'email' | 'mouth' | 'number' | 'password' | 'tel' | 'text' | 'time' | 'url' | 'week'	（可选） 输入框类型
value	string | number	（可选） 输入框默认值
otherProperty	{ max?: undefined | number; maxlength?: undefined | number; min?: undefined | number; minlength?: undefined | number; multiple?: undefined | false | true; pattern?: undefined | RegExp; placeholder?: undefined | string; readonly?: undefined | false | true; step?: undefined | number }	（可选） 其它参数，可参考 The HTML Input element
callbackFn	(value: any) => void	（可选） 回调函数

返回值

void

用户输入的值，始终为 string 类型，除非用户点击了 **取消** 按钮

示例

// 1. 弹出数字输入窗口（默认值 5，范围 1～100）
eda.sys_Dialog.showInputDialog(
	'请输入铺铜间距', // 输入框上方文字
	'输入 1～100 之间的整数（单位 mil）', // 输入框下方文字
	'铺铜设置', // 窗口标题
	'number', // 输入类型（同 HTML input 的 type）
	5, // 默认值
	{ min: 1, max: 100, step: 1 }, // 其它输入属性（min、max、step 等）
	(value) => {
		console.log('用户输入的间距：', value);
	}
);

// 2. 窗口已弹出；回调需用户点击确认后才会触发
console.log('已弹出输入窗口');