WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

FormPage   
✖
FormPage

Listing of Field Types »

✖
FormPage[formspec,func]

represents an active page that takes input from a form and generates results on the same page by applying func to the values obtained from the form whose structure is defined by formspec.

✖
FormPage[{"name1"type1,…},func]

represents an active form page with fields named namei interpreted as types typei.

✖
FormPage[{{"name1",label1}type1,…},func]

uses labeli as the label for the field named namei.

✖
FormPage[{namespec1type1default1,…},func]

uses defaulti as the default for the field specified by namespeci.

✖
FormPage[formspec,func,form]

lays out the page according to the layout specification form.

✖
FormPage[formspec,func,initformresform]

uses initform as the initial layout specification and resform as the layout specification for result pages.

Details and Options

  • CloudDeploy[FormPage[…]] yields a cloud object containing an active form page.
  • FormPage[formspec,func][<|"namek"->inputk,…|>] inserts the inputs given into the initial form specified by the FormPage object.
  • Setting[FormPage[formspec,func]] evaluates to func applied to the current values of the form.
  • In FormPage[formspec,func,layout], possible specifications for layout include:
  • "ResultBelow"display results below the form
    "ResultAbove"display results above the form
    {elem1,elem2,…}display layout elements in the specified order
  • In FormPage[formspec,func,{elem1,elem2,…}], possible elemi include:
  • "Form"the form as specified by formspec
    "Result"results generated by applying func
    "Button"button for submitting the form
  • Overall options for FormPage include:
  • AppearanceRules Automaticassociation giving overall appearance rules
    FormLayoutFunction Automaticfunction to generate layout for the form
    FormProtectionMethodAutomaticmethod for spam protection
    PageTheme Automaticoverall theme to use for the form
    ImageFormattingWidth$ImageFormattingWidthwrapping width for output formatting
    ImageSizeAutomaticoverall image size for output

Examples

open allclose all

Basic Examples  (1)Summary of the most common use cases

Use FormPage to continuously interact with a webpage:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-d6t7pc
Out[1]=1

Scope  (31)Survey of the scope of standard use cases

Interpreter Specifications  (6)

Use rich Interpreter specifications:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-fv3l5m
Out[1]=1

The Interpreter head is optional, but useful to specify options or other arguments to Interpreter:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-qztwkj
Out[1]=1

A list can be used to create a menu:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-6smtp1
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0tzrr1ra-e3ttsv
Out[2]=2

An entity list can be used as a menu:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-oqkvfa
Out[1]=1

Choices can be any expression:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-4p625p
Out[1]=1

A list of rules allows for label specification:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-xysu80
Out[1]=1

Defaults  (3)

Specify a default for a field; fields that have a default are not required:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-cdiz5z
Out[1]=1

Fields can be optional without having a default:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-b016u0
Out[1]=1

Use RuleDelayed to evaluate a new default every time:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-y9e2f2
Out[1]=1

Input  (2)

Create a form with input inside:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-o7o9nm
Out[1]=1

Input can be delayed:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-0f93a4
Out[1]=1

Label  (1)

Change the label for a field:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-fe40vb
Out[1]=1

You can use RuleDelayed and return any expression:

In[2]:=2
✖
https://wolfram.com/xid/0tzrr1ra-2ar7k
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0tzrr1ra-hd0omk
Out[3]=3

Use None to remove the label:

In[4]:=4
✖
https://wolfram.com/xid/0tzrr1ra-w510a4
Out[4]=4
In[5]:=5
✖
https://wolfram.com/xid/0tzrr1ra-5ylswd
Out[5]=5

Appearance  (4)

Change the default label to be something different from the key:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-yvbojq
Out[1]=1

Labels can be any expression:

In[2]:=2
✖
https://wolfram.com/xid/0tzrr1ra-b1796p
Out[2]=2

Change the appearance of single fields:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-utml3i
Out[1]=1

Use RuleDelayed to evaluate an expression in the cloud:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-8lx4xf
Out[1]=1

Use non-rule elements to change the default appearance:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-zw7qzq
Out[1]=1

Controls  (7)

Different types have different controllers. Color pickers for "Color":

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-mrupb9
Out[1]=1

Or file pickers for file formats:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-5ac68s
Out[1]=1

Checkboxes for "Boolean":

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-2mmd2l
Out[1]=1

Change the default controller:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-s3gz1r
Out[1]=1

Multiple choices support various types of controllers:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-bdwfhl
Out[1]=1

Labels for radio buttons can be anything you want:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-6uie7e
Out[1]=1

The control specification also accepts pure functions:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-ty4yyt
Out[1]=1

Disambiguation  (3)

For strings that are interpreted from natural language in the Wolfram Cloud, sometimes results might be ambiguous:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-1mhcla
Out[1]=1

Disambiguation is off for most types by default, but it can be easily activated:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-rjeevc
Out[1]=1

Sometimes several parts of the expression are ambiguous:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-b8hvwu
Out[1]=1

Dynamic Forms  (1)

Parts of forms that contain TemplateSlot are not evaluated until the keys mentioned in TemplateSlot[key] are bound to a proper value:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-gek4j1
Out[1]=1

Layout  (4)

Put the result below the form:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-ssqtlo
Out[1]=1

Put the result above the form:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-33ncij
Out[1]=1

Specify a custom order:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-nz9mgw
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0tzrr1ra-y1189f

Specify a different order for the initial form and the results:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-ye6c1v
Out[1]=1

Options  (6)Common values & functionality for each option

AppearanceRules  (1)

Write a custom title and description:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-lc50lb
Out[1]=1

Use an image for branding:

In[2]:=2
✖
https://wolfram.com/xid/0tzrr1ra-y6kz35
Out[2]=2

Use an "ItemLayout" to change form fields' appearance:

In[3]:=3
✖
https://wolfram.com/xid/0tzrr1ra-1sw2kb
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0tzrr1ra-4w5qpc
Out[4]=4

Change the submit label:

In[5]:=5
✖
https://wolfram.com/xid/0tzrr1ra-bker7k
Out[5]=5

FormLayoutFunction  (1)

A pure function can be specified to give a specific layout to a form:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-jyf1do
Out[1]=1

PageTheme  (4)

Deploy a form with a white theme:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-kpu9ak
Out[1]=1

Deploy a form with a blue theme:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-8o9380
Out[1]=1

Deploy a form with a black theme:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-v03qlo
Out[1]=1

Deploy a form with a red theme:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-zib0jp
Out[1]=1

Applications  (2)Sample problems that can be solved with this function

Draw the flight path between two airports:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-8i6e34
Out[1]=1

Get demographic data for a city:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-s1t3cl
Out[1]=1

Properties & Relations  (9)Properties of the function, and connections to other functions

FormPage is designed to be interchangeable with FormFunction:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-gdqgs1
Out[1]=1

FormPage is designed to be interchangeable with APIFunction:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-cx3tzu
Out[1]=1

And vice versa:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-uunrde
Out[1]=1

The first argument of FormPage can be given as a full FormObject:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-izi7l8
Out[1]=1

FormPage evaluates so that the first argument becomes a full FormObject:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-ud6stg

The single fields of a FormPage use Interpreter to transform the input in Wolfram Language expressions:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-pwx7ot
Out[1]=1

This is effectively the same as:

In[2]:=2
✖
https://wolfram.com/xid/0tzrr1ra-me9ej6
Out[2]=2

AnySubset can be used to generate a controller where more than one choice can be picked:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-ek29ej
Out[1]=1

RepeatingElement can be used to create a group of fields that can be added and deleted:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-cael9i
Out[1]=1

CompoundElement can be used to create an extensible table of fields:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-k52ks
Out[1]=1

Possible Issues  (1)Common pitfalls and unexpected behavior

Interpreter["String"] accepts an empty string. This is not true for FormPage, where the empty string and an empty field are considered equivalent:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-xswe58
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0tzrr1ra-obuq5z
Out[2]=2

Neat Examples  (1)Surprising or curious use cases

Make a simple web application to apply a filter to an image:

In[1]:=1
✖
https://wolfram.com/xid/0tzrr1ra-2os45k
Out[1]=1
Wolfram Research (2015), FormPage, Wolfram Language function, https://reference.wolfram.com/language/ref/FormPage.html.
✖
Wolfram Research (2015), FormPage, Wolfram Language function, https://reference.wolfram.com/language/ref/FormPage.html.

Text

Wolfram Research (2015), FormPage, Wolfram Language function, https://reference.wolfram.com/language/ref/FormPage.html.

✖
Wolfram Research (2015), FormPage, Wolfram Language function, https://reference.wolfram.com/language/ref/FormPage.html.

CMS

Wolfram Language. 2015. "FormPage." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/FormPage.html.

✖
Wolfram Language. 2015. "FormPage." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/FormPage.html.

APA

Wolfram Language. (2015). FormPage. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/FormPage.html

✖
Wolfram Language. (2015). FormPage. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/FormPage.html

BibTeX

@misc{reference.wolfram_2025_formpage, author="Wolfram Research", title="{FormPage}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/FormPage.html}", note=[Accessed: 08-June-2025 ]}

✖
@misc{reference.wolfram_2025_formpage, author="Wolfram Research", title="{FormPage}", year="2015", howpublished="\url{https://reference.wolfram.com/language/ref/FormPage.html}", note=[Accessed: 08-June-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_formpage, organization={Wolfram Research}, title={FormPage}, year={2015}, url={https://reference.wolfram.com/language/ref/FormPage.html}, note=[Accessed: 08-June-2025 ]}

✖
@online{reference.wolfram_2025_formpage, organization={Wolfram Research}, title={FormPage}, year={2015}, url={https://reference.wolfram.com/language/ref/FormPage.html}, note=[Accessed: 08-June-2025 ]}