WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

InputField

✖

represents a blank editable input field.

✖

represents an editable input field that currently contains the expression x.

✖

takes the contents of the input field to be the dynamically updated current value of x, with the value of x being reset if new contents are entered.

✖

represents an input field whose contents are taken to be a string.

✖

represents an input field whose contents are taken to be a number.

✖
InputField[x,type]

represents an input field whose contents are taken to be of the specified type.

Details and Options

  • The following are possible types:
  • Boxesraw boxes
    Expressionexpression (default)
    Hold[Expression]expression in held form
    Numbernumber
    Stringstring
  • The setting for the input field is not updated until its contents are explicitly entered, typically by pressing TemplateBox[{return}, Key0, BaseStyle -> {Notes, FontWeight -> Plain, FontFamily -> Source Sans Pro}] or by moving focus away from the input field.
  • If the data given in the input field cannot be converted to the type specified, then the setting for the input field will not be updated.
  • For String and Boxes types the conversion can always be done.
  • For expressions, a blank input field is taken to have value Null. For strings and boxes, it is taken to have value "".
  • moves between input fields.
  • The following options can be given:
  • Appearance Automaticthe overall appearance of the input field
    BackgroundAutomaticinput field background color
    BaselinePosition Automatichow to align with a surrounding text baseline
    BaseStyle {}base style specifications for the input field
    ContentPadding Truewhether to shrink the margins tightly around the contents
    ContinuousAction Falsewhether to update continuously every time any change is made to the input
    Enabled Automaticwhether the input field is enabled or grayed out
    FieldCompletionFunction Automaticfunction that takes the current value of the input field and returns possible completions
    FieldHint Nullexpression to display when the input field is empty
    FieldHintStyle {}style to apply to the field hint
    FieldMasked Falsewhether to mask characters in the input field
    FieldSize {{20., 20.},{1.,Infinity}}the size of the input field
    FrameMargins Automaticminimum margins to leave inside the frame
    ImageMargins 0margins around the image of the displayed input field
    ImageSize Automaticthe overall image size of the displayed input field
  • An InputField of type Expression replaces its contents with the fully evaluated form every time the contents are updated. ContinuousAction has no effect on such an InputField, so that no disorienting replacements happen while typing inputs.
  • Possible settings for Appearance include "Framed" and "Frameless".
  • InputField[] is equivalent to InputField[Null].
  • The settings for BaseStyle are appended to the default style typically given by the "InputField" style in the current stylesheet.

Examples

open allclose all

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

Dynamically update the variable via the InputField:

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

Restrict the input to a specific type:

In[1]:=1
✖
https://wolfram.com/xid/0enza37la-fhmhb9
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0enza37la-whxfk
Out[2]=2

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

Use to move between input fields:

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

The input field will not be updated if the input is not of the specified type:

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

Options  (16)Common values & functionality for each option

Appearance  (1)

Display InputField without a frame:

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

BaselinePosition  (1)

Align InputField with text:

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

BaseStyle  (1)

Use a named style:

In[1]:=1
✖
https://wolfram.com/xid/0enza37la-001rh
Out[1]=1

ContentPadding  (1)

Create an input field that is exactly as tall as its contents:

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

ContinuousAction  (2)

By default, variables are not continuously updated:

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

Setting ContinuousAction makes variable updates whenever a change is made to the input:

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

Enabled  (2)

By default, InputField is enabled:

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

By setting Enabled->False, the field is disabled but visible in its current state:

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

FieldCompletionFunction  (1)

Create an input field that offers completions of all matching System` functions:

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

FieldHint  (1)

Display a prompt in an empty input field:

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

FieldHintStyle  (1)

Display the field hint in a different color:

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

FieldMasked  (1)

Create a password-style input field:

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

FieldSize  (1)

Alter the field width:

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

Adjust the height and width:

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

FrameMargins  (1)

Set a large internal margin for an input field:

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

ImageMargins  (1)

Add margins outside the input field:

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

ImageSize  (1)

Set the width of the field:

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

Set the overall size of the field:

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

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

Plot any function:

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

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

Manipulator is constructed with InputField:

In[1]:=1
✖
https://wolfram.com/xid/0enza37la-cjw5hk
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0enza37la-fwows3
Out[2]=2

Possible Issues  (4)Common pitfalls and unexpected behavior

InputField will remain unevaluated if the expression does not match the type:

In[1]:=1
✖
https://wolfram.com/xid/0enza37la-j746r2
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0enza37la-l14tm
Out[2]=2

Use a cleared Dynamic variable to create an empty input field that only accepts numbers:

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

Null indicates no value in an input field of style Boxes:

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

The box representation of the symbol Null is the string "Null":

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

Null in an Expression style input field produces an empty result:

In[1]:=1
✖
https://wolfram.com/xid/0enza37la-e78dah
Out[1]=1
Wolfram Research (2007), InputField, Wolfram Language function, https://reference.wolfram.com/language/ref/InputField.html (updated 2016).
✖
Wolfram Research (2007), InputField, Wolfram Language function, https://reference.wolfram.com/language/ref/InputField.html (updated 2016).

Text

Wolfram Research (2007), InputField, Wolfram Language function, https://reference.wolfram.com/language/ref/InputField.html (updated 2016).

✖
Wolfram Research (2007), InputField, Wolfram Language function, https://reference.wolfram.com/language/ref/InputField.html (updated 2016).

CMS

Wolfram Language. 2007. "InputField." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2016. https://reference.wolfram.com/language/ref/InputField.html.

✖
Wolfram Language. 2007. "InputField." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2016. https://reference.wolfram.com/language/ref/InputField.html.

APA

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

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

BibTeX

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

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

BibLaTeX

@online{reference.wolfram_2025_inputfield, organization={Wolfram Research}, title={InputField}, year={2016}, url={https://reference.wolfram.com/language/ref/InputField.html}, note=[Accessed: 04-June-2025 ]}

✖
@online{reference.wolfram_2025_inputfield, organization={Wolfram Research}, title={InputField}, year={2016}, url={https://reference.wolfram.com/language/ref/InputField.html}, note=[Accessed: 04-June-2025 ]}