Dojo: The Definitive Guide

Form Dijits

Form dijits that are explicitly declared suitable for use in bona fide HTML forms, as defined with the FORM tag, are a part of the dijit.form namespace. This section walks through all of the dijits included in this namespace, providing example code and sample screenshots that use Dijit's built-in tundra theme. But first, it's worth reiterating that all form dijits are designed to be fully degradable and accessible; in other words, they remain fully functional even if JavaScript, CSS, and images aren't available, and if a keyboard is the only input device available. Accessibility attributes on Windows environments also support high-contrast mode and screen readers.

Figure 13-1 shows the general inheritance structure of the dijit.form module. The diagram does not show every single mixin class along the way, but does convey the general relationships amongst the widgets. The hope is that you'll be able to use it to get a better idea of how the source code is laid out when it comes time to cut your teeth on it.

Figure 13-1. The inheritance-rich dijit.form module

In addition to the standard dijit attributes inherited from _Widget, such as domNode, et al., and ordinary HTML attributes included in the HTML 4.01 spec, such as disabled and tabIndex, form dijits all inherit from a base class that explicitly supports the attributes, methods, and extension points listed in Table 13-1 ...