Dojo: The Definitive Guide

TextBox Variations

Ordinary text input via the HTML input element is by far the most commonly used form field. Countless hours have been spent formatting and validating what are generally small snippets of text, and the auxiliary scripts that have supported input boxes may single-handedly account for the most collective boilerplate that's even been written to support web pages. If any one of those comments resonates deep within your soul, the Dijit TextBox family will seem like a godsend.

Let's take a look at each member of the TextBox family and improve our example form from earlier in this chapter. The most basic member is the ordinary TextBox itself, which comes packed with several custom formatting operations as well as the ability to create your own using the format and parse extension points. The following listing summarizes TextBox 's attributes and extension points. A TextBox is technically a kind of input element, so remember that the standard HTML attributes, if not listed here, still apply.

Tip

TextBox 's attributes and extension points are inherited by all other dijits in this family; they are especially important to be aware of because they are widely used.

TextBox

Table 13-2 provides a listing of pertinent features to the most basic TextBox dijit.

Table 13-2. TextBox attributes and extension points

Name	Category	Comment
trim	Attribute	Removes leading and trailing whitespace. This attribute is false by default.
uppercase	Attribute	Converts all characters to uppercase. This attribute ...