Input
Input 作为内置交互对象,可以要求操作者进行输入,并进行后续交互。
需要注意的是,每个交互式输入都是异步的,这意味着在每个方法调用前都需要加上 await
。
textAsync
以「输入框」的形式进行交互,该组件将会提示用户输入文本。
接口
async function (label?: string) => Promise<string>;
示例
const name = await input.textAsync('请输入你的名字:');
viewAsync
以「视图选择器」的形式进行交互,该组件将会提示用户选择指定 Datasheet 中的某个视图。
接口
async function (label: string, datasheet: Datasheet) => Promise<View>;
示例
const datasheet = await space.getActiveDatasheetAsync();
const view = await input.viewAsync('请选择一个视图:', datasheet);
fieldAsync
以「字段选择器」的形式进行交互,该组件将会提示用户选择指定 Datasheet 中的某个字段。
接口
async function (label: string, datasheet: Datasheet) => Promise<Field>;
示例
const datasheet = await space.getActiveDatasheetAsync();
const field = await input.fieldAsync('请选择一个字段:', datasheet);
recordAsync
以「记录选择器」的形式进行交互,该组件将会提示用户选择指定 Datasheet 中的某条记录。
接口
async function (label: string, datasheet: Datasheet) => Promise<Record>;
示例
const datasheet = await space.getActiveDatasheetAsync();
const record = await input.recordAsync('请选择一条记录:', datasheet);