Mathematica 9 is now available
SEARCH MATHEMATICA 8 DOCUMENTATION
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.
Mathematica > Dynamic Interactivity > Control Objects >
Built-in Mathematica SymbolTutorials »|See Also »|More About »

InputField

InputField[]
represents a blank editable input field.
InputField[x]
represents an editable input field that currently contains the expression x.
InputField[Dynamic[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.
InputField[x, String]
represents an input field whose contents are taken to be a string.
InputField[x, Number]
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.
  • 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 Enter 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, it is taken to have value "".
  • Tab moves between input fields.
  • The following options can be given:
AppearanceAutomaticthe overall appearance of the input field
BaseStyle{}base style specifications for the input field
ContinuousActionFalsewhether to update continuously every time any change is made to the input
EnabledAutomaticwhether the input field is enabled, or grayed out
FieldSize{{20., 20.},{1.,Infinity}}the size of the input field
ImageMargins0margins around the image of the displayed input field
ImageSizeAutomaticthe overall image size of the displayed input field
  • Possible settings for Appearance include "Framed" and "Frameless".
  • The settings for BaseStyle are appended to the default style typically given by the "InputField" style in the current stylesheet.
EXAMPLESCLOSE ALL
Basic Examples   (2)
Dynamically update the variable via the InputField:
Restrict the input to a specific type:
Dynamically update the variable via the InputField:
In[1]:=
Click for copyable input
Out[1]=
 
Restrict the input to a specific type:
In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=
Scope   (2)
Use Tab to move between input fields:
The input field will not be updated if the input is not of the specified type:
Options   (8)
Display InputField without a frame:
By default, variables are not continuously updated:
Setting ContinuousAction, makes variable updates whenever a change is made to the input:
By default InputField is enabled:
By setting Enabled->False, the field is disabled but visible in its current state:
Alter the field width:
Adjust the height and width:
Add margins outside the input field:
Set the width of the field:
Set the overall size of the field:
Applications   (1)
Plot any function:
Possible Issues   (1)
InputField will remain unevaluated if the expression does not match the type:
Use a cleared Dynamic variable to create an empty input field that only accepts numbers:
New in 6
Ask a question about this page  |  Suggest an improvement  |  Leave a message for the team