WOLFRAM

Wolfram 语言与系统参考资料中心

FormObject[{"name1"type1,"name2"type2,…}]

表示一个表单，含有名为 namei 的、接受 typei 类型的数据的字段.

FormObject[{{"name1",label1}type1,…}]

使用 labeli 作为名为 namei 的字段的标签.

FormObject[{"name1"assoc1,…,objj,…}]

对字段使用完整规范 associ，并且使用 objj 作为表单布局的一部分.

更多信息和选项
Details and Options Details and Options
范例  
基本范例  
范围  
FormObject 结构  
表单提交  
表单元数据  
Show More Show More
解释器规范  
默认  
输入  
控件  
标签  
帮助  
提示  
遮罩  
消除歧义  
推广和延伸  
选项  
AppearanceRules  
FormLayoutFunction  
应用  
属性和关系  
可能存在的问题  
参见
技术笔记
相关指南
相关链接
历史
按以下格式引用：

FormObject   

字段类型列表 »

FormObject[{"name1"type1,"name2"type2,…}]

表示一个表单，含有名为 namei 的、接受 typei 类型的数据的字段.

FormObject[{{"name1",label1}type1,…}]

使用 labeli 作为名为 namei 的字段的标签.

FormObject[{"name1"assoc1,…,objj,…}]

对字段使用完整规范 associ，并且使用 objj 作为表单布局的一部分.

更多信息和选项

  • FormObject[…] 在笔记本界面中显示为具有可填充字段的表单，可以或者输入文本，或者使用其他控件.
  • FormObject 可用于在 FormFunction 中指定表单结构.
  • 在计算时，FormObject[…] 转化为 FormObject[fields]，其中 fields 中的每个项目具有格式为 "namei"->associ 的完整规范. 完整规范 associ 的元素包括：
  • "Input"字段的原始输入，如果有（通常是一个字符串）
    "Interpreter"用于字段的解释器
    "Required"字段是否要求输入
    "Default"字段的默认值，如果有
    "Control"给字段提供的控件类型
    "AutoSubmitting"在字段中进行输入是否会自动提交表单
    "Disambiguation"是否要求为解释消除歧义
    "Label"字段的标签
    "Hint"显示在输入字段内的提示信息
    "Masked"是否遮住输入字段中的输入
    "Help"与字段相关联的帮助
  • Setting[FormObject[…]] 给出格式为 <|"name1"->val1,…|> 的关联，其中 vali 是通过解释 "Input" 元素获得的值，根据 "Interpreter" 与 "namei" 关联，"Input" 元素与每个 "namei" 关联.
  • 如果 "Input" 缺失，或者 "Interpreter" 失败，那么 "Value" 的值是 Failure 对象.
  • FormObject[…][<|"name1"->input1,…|>] 产生 FormObject[…]，其中对应于包括的每个 namei 的 "Input" 被 inputi 替换.
  • 在 FormObject[{…,objj,…}] 中，objj 可以是 Delimiter，表示水平分隔符.
  • 它们也可以是头部为 Style、Row、Item、Text、ExpressionCell 和 TextCell 的表达式，以及诸如 TabView 和 Grid 这样的的视窗和布局构件.
  • 在 FormObject[{"name1"->type1,…}] 中，typei 用于对完整规范中的 "Interpreter" 给出值.
  • 类型规范的可能形式为：
  • "form"由 Interpreter 支持的任何形式
    Restricted[…]等由 Interpreter 支持的任意限制形式等
    Interpreter[…]任意完整 Interpreter 对象
    tfun将应用于原始输入的任意函数
  • 如果只给出 "namei"，没有给出 typei 规则，则假定解释器是 Identity，因此值恰好是以相应 "Input" 元素给出.
  • 默认情况下，用于每个字段的控件由指定的输入类型确定. 对于类型为 "String"，单行输入默认情况下位于网络上；输入 "Text" 产生多行文本字段.
  • 显式给出与 "Control" 相关联的数值的可能的控件包括 InputField、PopupMenu、Slider 和 RadioButtonBar.
  • 规范 "namei"->AutoSubmitting[typei] 表明如果对与 namei 相关联的字段进行输入，应该自动提交整个表单.
  • FormObject[AutoSubmitting[spec]] 表明如果对任意字段进行输入，则自动提交表单.
  • FormObject 的整体选项包括：
  • AppearanceRules Automatic给出整体外观规则的关联
    FormLayoutFunction Automatic产生表单最终布局的函数
    PageThemeAutomatic部署网页时使用的整体主题
  • AppearanceRules 的设置中的典型元素包括：
  • "Title"None表单的整体标题
    "Description"None表单顶部包括的描述
    "RequiredFieldIndicator"None显示必填字段的指示器
    "SubmitLabel""Submit"表单的提交按钮的文本
    "AddLabel""+"重复元素的添加重复元素的添加按钮的文本
    "DeleteLabel""-"删除按钮的文本
    "AddTooltip""Add"添加按钮的工具提示条
    "DeleteTooltip""Remove"删除按钮的工具提示条
    "NextLabel""Next"多页面表单的"下一页"按钮的文本
    "ItemLayout""Horizontal"字段标签和消息的布局
  • "ItemLayout" 的可能设置包括 "Horizontal"、"Vertical" 和 "Inline".

范例

打开所有单元 关闭所有单元

基本范例  (1)

创建未填充的表单：

Wolfram Language code: form = FormObject[{"first" -> "String", "second" -> "Number"}]

指定表单的输入为字符串：

Wolfram Language code: form[<|"first" -> "a string", "second" -> "444"|>]

找到对表单提供的输入：

Wolfram Language code: Setting[%]

数字已经解析为一个显式数字：

Wolfram Language code: InputForm[%]

范围  (19)

创建未填充的表单：

Wolfram Language code: form = FormObject[{"first" -> "String", "second" -> "Number"}];

第二个字段给出的输入无法解析为一个数字，因此显示一条信息：

Wolfram Language code: form[<|"first" -> "a string", "second" -> "not a number"|>]

设置包括符号失败对象：

Wolfram Language code: Setting[%]

使用不同控件：

Wolfram Language code: FormObject["Slider" -> <|"Interpreter" -> Restricted["Number", {1, 100}], "Control" -> Slider|>]

FormObject 结构  (1)

有效的 FormObject 计算得到具有所有元信息的 Association 对象：

Wolfram Language code: FormObject["x" -> "Number" -> 3]//InputForm

表单提交  (1)

表单使用子值提交：

Wolfram Language code: FormObject["x" -> "Number" -> 3]["x" -> "abc"]

当提交一个表单时，数据存储为第二个参数，输入位于第一个参数中：

Wolfram Language code: FormObject["x" -> "Number"]["x" -> "2"]//InputForm

表单元数据  (3)

你可以提取具有子值的表单元数据：

Wolfram Language code: form = FormObject[{"x" -> "Number", "y" -> "Number"}]; form = form[{"x" -> "3", "y" -> "4"}]; form[All, "Input"]

可以提取 "Help"、"Control"、"Interpreter" 等：

Wolfram Language code: form["x", "Interpreter"]

"Control" 给出默认格式化控件：

Wolfram Language code: form["x", "Control"]

使用 "Failure" 获取失败：

Wolfram Language code: form["x", "Failure"]

如果没有指定要提取的部分，返回整个控件（具有标签和帮助）：

Wolfram Language code: form["x"]

可以按照相同方式提取 AppearanceRules：

Wolfram Language code: form = FormObject["Number" -> "Integer", AppearanceRules -> <|"Title" -> "My Form", "ItemLayout" -> "Vertical", "Description" -> "My description"|>, PageTheme -> "Black"]
Wolfram Language code: form[AppearanceRules, "Title"]
Wolfram Language code: form[AppearanceRules, "ItemLayout"]
Wolfram Language code: form[PageTheme]

使用 Setting 提取清理后的数据：

Wolfram Language code: FormObject["x" -> "Integer"]//Setting

可以进行几个具有部分数据的提交：

Wolfram Language code: FormObject[{"x" -> "Integer", "y" -> "Integer"}]["x" -> "2"]//Setting
Wolfram Language code: FormObject[{"x" -> "Integer", "y" -> "Integer"}]["x" -> "2"]["y" -> "3"]//Setting

即使没有提交，使用具有默认值的表单被认为是有效的：

Wolfram Language code: FormObject["x" -> "Integer" -> 3]//Setting

解释器规范  (3)

使用丰富的 Interpreter 规范：

Wolfram Language code: FormObject[{"x" -> Restricted["Integer", {1, 10}]}][{"x" -> "23"}]

列表可用来创建菜单：

Wolfram Language code: FormObject["x" -> EntityList["Planet"]]
Wolfram Language code: FormObject["switch" -> {"On" -> True, "Off" -> False}]

选项可以是任意表达式：

Wolfram Language code: FormObject[{ "Filter" -> ImageEffect[], "Image" -> Map[ ImageResize[ExampleData[#], {100, 100}]&, ExampleData["TestImage"][[1 ;; 6]] ] }]

使用自定义解释函数：

Wolfram Language code: toObject[s_String] /; ToUpperCase[s] == s := myObject[s]; toObject[s_] := Failure["InterpretationFailure", <|"MessageTemplate" -> "Please insert an uppercased string"|>]; FormObject[{"x" -> toObject}]["x" -> "abc"]

默认  (1)

指定字段的默认值；有默认值的字段则不需要：

Wolfram Language code: FormObject[{"first" -> "String", "second" -> "Number" -> 3}]//Setting

使用 RuleDelayed 延迟计算：

Wolfram Language code: FormObject[{"date" -> "DateTime" :> DateObject[]}]//Setting

输入  (1)

指定字段的初始值：

Wolfram Language code: FormObject["Start" -> <|"Input" -> "Initial text"|>]

使用 RuleDelayed 强制在每次绘制表单时进行一次新的计算：

Wolfram Language code: FormObject["x" -> <|"Interpreter" -> Restricted["Number", {1, 100}], "Input" :> RandomInteger[{1, 100}], "Control" -> Slider|>]

控件  (2)

不同类型具有不同的控件. "Color" 的颜色选择器：

Wolfram Language code: FormObject[{"x" -> "Color"}]

或者是文件格式的文件选择器：

Wolfram Language code: FormObject[{"x" -> "Image"}]

"Boolean" 的复选框：

Wolfram Language code: FormObject[{"x" -> "Boolean"}]

你可以改变默认控件：

Wolfram Language code: FormObject[{"x" -> <|"Interpreter" -> Restricted["Integer", {1, 10}], "Control" -> Slider|>}]

多个选项支持各种控件：

Wolfram Language code: FormObject[<|"x" -> <|"Interpreter" -> {"A" -> 1, "B" -> 2, "C" -> 3}, "Control" -> RadioButtonBar|>|>]
Wolfram Language code: FormObject[<|"x" -> <|"Interpreter" -> {"A" -> 1, "B" -> 2, "C" -> 3}, "Control" -> InputField, "Help" -> "Write A, B or C"|>|>]

控件规范也接受纯函数：

Wolfram Language code: FormObject[{"cat" -> <|"Interpreter" -> "String", "Control" -> Function[Tooltip[InputField[##], EntityValue[Entity["Species", "Species:FelisCatus"], EntityProperty["Species", "Image"]]]]|>}]

标签  (1)

改变字段的标签：

Wolfram Language code: FormObject[{"x", "First Name"} -> "String"]

可以使用 RuleDelayed 并且返回任意表达式：

Wolfram Language code: FormObject["pc" -> <|"Label" :> "PC: " <> $MachineID|>]
Wolfram Language code: FormObject[ "pc" -> <|"Label" :> GeoGraphics[ $GeoLocation, GeoRange -> Quantity[100, "Meters"] ]|> ]

使用 None 删除标签：

Wolfram Language code: FormObject["Query" -> <|"Label" -> None, "Hint" -> "Search"|>]
Wolfram Language code: FormObject[{ "First" -> <|"Label" -> None, "Hint" -> "First Name"|>, "Last" -> <|"Label" -> None, "Hint" -> "Last Name"|> }]

帮助  (1)

定义帮助信息：

Wolfram Language code: FormObject["x" -> <| "Interpreter" -> Restricted["Number", {0, 100}], "Help" -> "Enter a positive number lower than 100." |>]

可以使用 RuleDelayed 并且返回任意表达式：

Wolfram Language code: FormObject["City" -> <| "Interpreter" :> Restricted["City", First@GeoIdentify["Country"]], "Help" :> "Enter your favorite city in " <> CommonName[First@GeoIdentify["Country"]] |>]

提示  (1)

使用 "Hint" 显示控件内的提示信息：

Wolfram Language code: FormObject["x" -> <| "Hint" -> "Enter your name" |>]

遮罩  (1)

使用 "Masked" 隐藏控件中的输入：

Wolfram Language code: FormObject["x" -> <| "Masked" -> True, "Input" -> "ABC" |>]

消除歧义  (1)

对于 Wolfram Cloud 中自然语言解释的字符串，有些时候结果可能有歧义：

Wolfram Language code: FormObject["where" -> "City"]["where" -> "Springfield"]

默认情况下，关闭消除歧义的功能，但可以很容易地再次激活：

Wolfram Language code: FormObject["amount" -> <|"Interpreter" -> "Quantity", "Disambiguation" -> All|>]["amount" -> "2 ounces"]

推广和延伸  (1)

可以在 XMLTemplate 内使用表单；将产生 HTML 代码：

Wolfram Language code: form = FormObject[{"x" -> "String", "y" -> {100, 200, 300}}]
Wolfram Language code: XMLTemplate["<form method='GET'><wolfram:slot id='form'/></form>"][<|"form" -> form|>]

从表单提取元数据，并且编写自定义模板：

Wolfram Language code: XMLTemplate["<form method='GET'> <wolfram:sequence values='Values[#form[All, \"Control\"]]'> <p>`1`</p> </wolfram:sequence> </form>"][<|"form" -> form|>]
Wolfram Language code: XMLTemplate["<form method='GET'> <p><wolfram:expr>#form[\"x\", \"Control\"]</wolfram:expr></p> <p class='label'><wolfram:expr>#form[\"y\", \"Label\"]</wolfram:expr></p> <p><wolfram:expr>#form[\"y\", \"Control\"]</wolfram:expr></p> </form>"][<|"form" -> form|>]

选项  (2)

AppearanceRules  (1)

编写自定义标题和描述：

Wolfram Language code: FormObject["Start" -> "Country", AppearanceRules -> <|"Title" -> "Where do you want to go?", "Description" -> "Enter a country and we will find you an accomodation"|>]

使用图像作为品牌：

Wolfram Language code: FormObject["Product" -> {"Flyers", "Business cards", "Leflets"}, AppearanceRules -> <|"Title" -> [image], "Description" -> "What do you want to print today?"|>]

使用 "ItemLayout" 改变表单字段的外观：

Wolfram Language code: FormObject[{"First" -> "String", "Second" -> "String"}, AppearanceRules -> <|"ItemLayout" -> "Vertical"|>]
Wolfram Language code: FormObject[{"First" -> <|"Help" -> "Insert a value"|>, "Second" -> <|"Help" -> "Insert a value"|>}, AppearanceRules -> <|"ItemLayout" -> "Inline"|>]

FormLayoutFunction  (1)

可以指定纯函数以给出表单的特定布局：

Wolfram Language code: FormObject["x" -> "Integer", FormLayoutFunction -> Function[Row[{#["x"], Graphics3D[Sphere[]]}]]]

应用  (1)

使用 FormObject 验证数据：

Wolfram Language code: validator = FormObject[{"Date" -> Interpreter["StructuredDate", DateFormat -> {"MonthNameShort", "Day", "Year"}], "Value" -> "Number"}]; Map[ Setting[validator[{"Date" -> First[#], "Value" -> Last[#]}]]&, Import["ExampleData/financialtimeseries.csv"] ]//Short

属性和关系  (2)

可以使用 FormObject 作为 APIFunction 和 FormFunction 的第一个参数：

Wolfram Language code: signupForm = FormObject[{"Name" -> "String", "Email" -> "EmailAddress", "Password" -> <|"Masked" -> True, "Default" :> Hash[AbsoluteTime[]], "Help" -> "Leave the field blank and a password will be generated"|>}, AppearanceRules -> <|"Title" -> "Signup", "SubmitLabel" -> "Signup now!"|>]; CloudDeploy[FormFunction[signupForm, Identity]]
Wolfram Language code: CloudDeploy[APIFunction[signupForm, Identity]]

FormObject 的单个字段使用 Interpreter 来转化 Wolfram 语言表达式下的输入：

Wolfram Language code: fo1 = FormObject["x" -> "Country"]

这实际上和下面的相同：

Wolfram Language code: fo2 = FormObject["x" -> Interpreter["Country"]]

与直接应用 Interpreter 相同：

Wolfram Language code: First[Setting[fo1["x" -> "france"]]] === First[Setting[fo2["x" -> "france"]]] === Interpreter["Country"]["france"]

可能存在的问题  (4)

"Hint" 和 "Masked" 只被 InputField 支持：

Wolfram Language code: FormObject[{ "x" -> <| "Hint" -> "Enter your name" |>, "password" -> <| "Masked" -> True, "Input" -> "ABC" |>} ]

其他控件忽略 "Hint" 和 "Masked"：

Wolfram Language code: FormObject[{ "x" -> <| "Interpreter" -> "Color", "Hint" -> "Enter your name" |>, "y" -> <| "Interpreter" -> "Image", "Masked" -> True |>} ]

在 Interpreter 类型中使用 Alternatives 时，可能会得到错误的控制器：

Wolfram Language code: FormObject["x" -> "JSON" | "String"]

明确设置 "Control" 字段可以解决问题：

Wolfram Language code: FormObject["x" -> <| "Interpreter" -> "JSON" | "String", "Control" -> InputField |>]

FormObject 是形式规约的惰性表示；因此，其中的按钮不起作用：

Wolfram Language code: FormObject["x" -> RepeatingElement["String"]]

当 Interpreter 类型不是支持列表的形式时，仅保留最后一个元素：

Wolfram Language code: FormObject["x" -> "Integer"]["x" -> {"1", "2", "3"}]
Wolfram Research (2014)，FormObject，Wolfram 语言函数，https://reference.wolfram.com/language/ref/FormObject.html.

文本

Wolfram Research (2014)，FormObject，Wolfram 语言函数，https://reference.wolfram.com/language/ref/FormObject.html.

CMS

Wolfram 语言. 2014. "FormObject." Wolfram 语言与系统参考资料中心. Wolfram Research. https://reference.wolfram.com/language/ref/FormObject.html.

APA

Wolfram 语言. (2014). FormObject. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/FormObject.html 年

BibTeX

@misc{reference.wolfram_2026_formobject, author="Wolfram Research", title="{FormObject}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/FormObject.html}", note=[Accessed: 23-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_formobject, organization={Wolfram Research}, title={FormObject}, year={2014}, url={https://reference.wolfram.com/language/ref/FormObject.html}, note=[Accessed: 23-June-2026]}