XFA Specification
Chapter 12, User Experience
Accessibility and Field Navigation
359
Traversal Initiated When Maximum Number of Characters Supplied
In the following example, focus changes between fields when the maximum number of characters is
entered. This example yields the same behavior shown on
page 358.
Example 12.4 Default traversal for fields having a maximum number of characters
<subform name="mySubform" … >
<field name="A" x="5mm" y="20mm" …>
<ui … />
<value … >
<text maxChars=3 … />
</value>
</field>
<field name="B" x="45mm" y="20mm" …>
<ui … />
<value … >
<text maxChars=3 … />
</value>
</field>
</subform>
<subform name="mySubform" … >
<field name="A" x="5mm" y="120mm"…>
<ui … />
<value … >
<text maxChars=3 … />
</value>
</field>
<field name="B" x="45mm" y="120mm" …>
<ui … />
<value … >
<text maxChars=3 … />
</value>
</field>
</subform>
Traversal When Speech Application Completes the Current Container
If a speech-capable XFA processing application is presenting an XFA form, the text associated with each
container is spoken. The
speak
See “Speech of Text Associated with a Container” on page 360.
Traversal Sequences That Support Speech
In order to serve the speech tool, the chain of "next" links may include draw objects. Such objects cannot
accept input focus. Therefore, when advancing focus to the next input widget the XFA application
continues traversing the chain until it reaches an object that does accept input focus. It is up to the
template creator to ensure that the template does not present the XFA application with a non-terminating
loop. See also
“Speech of Text Associated with a Container” on page 360.
Delegating Focus to Another Container
The traverse element allows a container to delegate focus to another container. When an XFA form is first
displayed, focus is assigned to the first subform, per document order. Such focus assignment may be
delegated to another container with
operation="first"
, as shown in the following example.