添加菜单项或表单项

语法

  item [--menu <menu>] [--key <key>] [--default] [<name>|--gap [<text>]]

  item [--form <form>] [--key <key>] [--default] [--secret] [<name>|--gap [<text>]]

示例

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

  menu Please choose an operating system to boot
  item fedora   Fedora Linux
  item win7     Windows 7
  choose os

添加一个带快捷键的菜单项

  item --key f fedora   Fedora Linux

添加一个动态菜单项

  item san      Boot from ${root-path}

添加一个菜单分隔符

  item --gap Operating systems:

添加一个空白菜单分隔符

  item

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

  form                IPv4 networking
  item netX/ip        IPv4 address
  item netX/netmask   Subnet mask
  item netX/gateway   Gateway address
  present

创建并显示一个带密码字段的表单

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

描述

添加一个具有指定名称和显示文本的菜单项或表单项。如果没有指定菜单或表单，则使用默认的菜单或表单。如果指定了按键，它会用作该项的快捷键。如果指定了 --default 选项，该项会成为默认选择。如果没有提供名称或指定了 --gap 选项，该项会作为分隔符（用户无法选择）。

名称不会被显示。对于菜单项，choose 命令用它来表示用户做出的选择。对于表单项，present 命令用它来确定要把值存储到哪个设置中。

快捷键可以指定为字符字面量（例如 f），也可以指定为扩展 ASCII 字符值。Ctrl-B、F12 等特殊键的键值定义在 iPXE 源代码的 include/ipxe/keys.h 中。一些常用的键值：

按键	键码
Ctrl-A	0x01
Ctrl-B	0x02
Ctrl-C	0x03
…
Ctrl-Z	0x1a
F5	0x107e
F6	0x127e
F7	0x137e
F8	0x147e
F9	0x157e
F10	0x167e
F11	0x187e
F12	0x197e

命令状态

成功	菜单项或表单项添加成功
失败	菜单项或表单项未能成功添加

另请参阅

• menu
• form
• choose
• present
• iPXE 脚本指南
• 全部 iPXE 命令列表

备注

显示文本在必要时会截断以适应可用宽度。

快捷键不会被自动显示出来。你可能希望在显示文本中包含快捷键提示。例如：

  item --key f   fedora   Boot (F)edora
  item --key x   winxp    Boot Windows (X)P

你可以在同一个菜单中多次使用同一个快捷键。iPXE 会先从当前选中的菜单位置向后搜索，然后再从菜单开头搜索。这为你提供了一种定义快捷键序列的方法。例如：

  item --key d --gap (D)ebian
  item --key s debst Debian (s)table release
  item --key u debun Debian (u)nstable release
  item --key f --gap (F)edora
  item --key s fedst Fedora (s)table release
  item --key u fedun Fedora (u)nstable release

在这个菜单中依次按下 d s 会选中 Debian 稳定版，而按下 f s 会选中 Fedora 稳定版。

指定菜单默认项有两种方式：在用 item 命令创建菜单项时使用 --default 选项，或在用 choose 命令显示菜单时使用 --default <name> 选项。

如果你希望分隔符文本以短横线开头，必须使用 -- 来防止 iPXE 把分隔符文本当作选项解析。例如：

  item --gap -- ---------------- Advanced configuration ----------------

上/下方向键、Tab 键、回车键等导航键不能用作快捷键。