Home > SYS_Dialog > showSelectDialog

SYS_Dialog.showSelectDialog() method

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

弹出选择窗口

签名

function showSelectDialog(
	options: Array<string> | Array<{ value: string; displayContent: string }>,
	beforeContent?: string,
	afterContent?: string,
	title?: string,
	defaultOption?: string,
	multiple?: false,
	callbackFn?: (value: string) => void | Promise<void>,
): void;

参数名

参数	类型	描述
options	Array<string> | Array<{ value: string; displayContent: string }>	选项列表，可以为字符串数组或对象数组，在未指定 defaultOption 时，默认值为列表的第一项； 如若为字符串数组，则选项的值和选项的展示内容将保持一致； 如若为对象数组，则 value 表示选项的值，displayContent 表示选项的展示内容
beforeContent	string	（可选） 选择框上方文字
afterContent	string	（可选） 选择框下方文字
title	string	（可选） 选择框标题
defaultOption	string	（可选） 默认选项，以选项的值作为匹配参数，如若 multiple 参数为 true，则此处需要传入字符串数组
multiple	false	（可选） 是否支持多选，默认为单选框
callbackFn	(value: string) => void | Promise<void>	（可选） 回调函数

返回值

void

用户选择的值，对应传入的 options 中的 value 字段

示例

// 1. 单选：对象数组让 value 与展示文案分离，默认选中 TOP
eda.sys_Dialog.showSelectDialog(
	[
		{ value: 'TOP', displayContent: '顶层' },
		{ value: 'BOTTOM', displayContent: '底层' }
	],
	'请选择丝印放置的层', // 选择框上方文字
	'设置会应用到全部丝印', // 选择框下方文字
	'丝印层设置', // 窗口标题
	'TOP', // 默认选项（匹配选项的 value）
	false, // 单选
	(value) => {
		console.log('单选结果：', value);
	}
);

// 2. 多选：字符串数组作选项，multiple 传 true，默认选中两项
eda.sys_Dialog.showSelectDialog(
	['DRC', 'BOM', 'Gerber'],
	'请选择需要导出的内容', // 多选框上方文字
	'', // 多选框下方文字
	'导出设置', // 窗口标题
	['DRC', 'BOM'], // 默认选项数组
	true, // 多选
	(values) => {
		console.log('多选结果：', values);
	}
);

// 3. 两个窗口已弹出；回调需用户点击确认后才会触发
console.log('已弹出选择窗口（单选 + 多选）');