跳到主要内容

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);