type- Type: one of the values below
- You can set the type attribute to one of the values below for a more specialized type of textbox. Don't set the type if you wish to use a regular textbox.
-
autocomplete- A textbox that supports autocomplete. For more information about autocomplete textboxes, see the autocomplete documentation (XPFE [Thunderbird/SeaMonkey]) (Firefox)
number- A textbox that only allows the user to enter numbers. In addition, arrow buttons appear next to the textbox to let the user step through values. There are several attributes that allow the number textbox to be configured, including
decimalplaces,min,max,increment,wraparound,hidespinbuttons, andtextbox.value. password- A textbox that hides what is typed, used for entering passwords.
search- A textbox intended for searching. The command event will fire as the user modifies the value. A listener for the command event should update search results. If the
searchbuttonattribute is set totrue, the command event is only fired if the user presses the search button or presses theEnterkey. You may specify grey text to appear when the search box is empty using theemptytextattribute, and a timeout may be set for the command event using thetimeoutattribute (defaults to 500). timed- This textbox will fire a command event after the user types characters and a certain time has passed. The delay is set with the
timeoutattribute. The command event will fire if the user presses theEnterkey. Thetimedtype is deprecated in Gecko 1.9.1 and thesearchtextbox may be used instead.
XBL-specific note
Beware that if you create an XBL binding for a textbox, you need to use the appropriate extends attribute and changing type attribute on the tree won't have effect. E.g. if you have <binding id="input" extends="chrome://global/content/bindings/autocomplete.xml#autocomplete" >, then the textbox will have autocomplete type, regardless of tree's 'type' attribute. Use <binding extends="chrome://global/content/bindings/textbox.xml#textbox" > for ordinary textbox.