input tag

Presentation tag

Displays a box in which the user can type a line of text.

Sample usage

<name:input> displays an empty input box named name.
<age:input width=4,em {18}> displays a narrow input box containing 18.
<pw:input password=true> displays an input box that hides what is typed.

Fields

Primary field

Scalar field

The text in the box. Reading the input tag generates what the user has typed; assigning to it changes the text in the box.

Secondary fields

password: (scalar field) true to hide the typed characters on screen. Reading the field still generates the real text.
onInput: (code field) carried out each time the user changes the text.
carat: (vector field) the text cursor position or selection.

Standard presentation fields (must be initialised at tag creation):
align field
backgroundColor field
bold field
border field
borderBottom field
borderColor field
borderLeft field
borderRight field
borderStyle field
borderTop field
bottom field
color field
editable field
focus field
focusOrder field
font field
height field
hotKey field
inline field
italic field
layer field
left field
margin field
marginBottom field
marginLeft field
marginRight field
marginTop field
onClick field
onContextClick field
onFocus field
onInput field
onKeyDown field
onKeyPress field
onKeyUp field
onMouseDown field
onMouseIn field
onMouseMove field
onMouseOut field
onMouseUp field
opacity field
pivot field
right field
rotate field
scroll field
scrollPos field
selectable field
size field
spacing field
spacingBottom field
spacingLeft field
spacingRight field
spacingTop field
top field
transition field
underline field
visible field
width field
wrap field

Behaviour

The contents of an input box are always text, even if they look like a number. Use num to convert them before calculating with them.

A common pattern is to send the contents to the program and then clear the box:

<name:input onKeyDown=<if <eq key, 13> then=<putLn name>, <name.clear>>> <button {OK} onClick=<putLn name>, <name.clear>>

Notes

If code runs on every keystroke (for example in onInput), the console's busy state can flicker while the user types. Print <console.busy false> to turn it off.

An input box holds a single line of text. For several lines, use a box with editable=true, a fixed size and scroll=true.