跳转至

显示交互式表单

语法

  present [--form <menu>] [--keep]

示例

创建并显示一个简单的表单

  form                Configure IPv4 networking on ${netX/mac}
  item netX/ip        IPv4 address
  item netX/netmask   Subnet mask
  item netX/gateway   Gateway address
  item dns            DNS server address
  present

创建并显示自定义登录界面

  form                    Login details
  item          email     Email address
  item --secret password  Password
  present

描述

显示一个交互式表单,并把每个表单项的结果值存储到指定的设置中。

A sample form

如果没有指定表单,则使用默认的(未命名)表单。除非指定了 --keep 选项,否则表单会被自动删除。

命令状态

成功 设置编辑成功
失败 设置未能成功编辑

另请参阅

备注

用户可以使用 Ctrl-C(或 Escape)退出表单而不做任何选择。因此你可能希望始终处理 present 命令失败的情况。例如:

  present || goto error

你可以使用任何合法的设置名称,包括作用域和类型。例如:

set dest:ipv4 8.8.8.8
set count:uint8 1

form                        Test network connectivity via ping
item           count:uint8  Ping count
item --default dest:ipv4    Destination IPv4 address
present

ping --count ${count} ${dest}

你可以使用 console 命令为表单添加背景图片,提升表单的外观效果。