2.2.66 domEventHandler

  • Article

The domEventHandler element specifies a handler for events triggered when the specified XML nodes change. The child rule set is run when this handler is called. The various types of child rules specify supported actions to take on the form file.

Parent Elements

domEventHandlers

Child Elements

ruleSetAction

Attributes:

dataObject: This attribute specifies the name of the secondary data source that MUST be used in the event handler. The specified name MUST match the value specified by the corresponding name attribute of the dataObject element. If this attribute is not present, its value MUST be interpreted as an empty string.

handlerObject: This attribute specifies the name of the event handler. The specified name MUST be unique within the form template.

match: This attribute specifies the XML nodes for which the event handler is declared. The value MUST be a valid XPath expression that identifies one or more XML nodes.

The following W3C XML Schema ([XMLSCHEMA1] section 2.1) fragment specifies the contents of this element.

 <xsd:element name="domEventHandler">
   <xsd:complexType>
     <xsd:sequence>
       <xsd:element ref="xsf:ruleSetAction" minOccurs="0" maxOccurs="1"/>
     </xsd:sequence>
     <xsd:attribute name="dataObject" type="xsd:string" use="optional"/>
     <xsd:attribute name="match" type="xsd:string" use="required"/>
     <xsd:attribute name="handlerObject" type="xsd:string" use="optional"/>
   </xsd:complexType>
   <xsd:keyref name="domEventHandler_ruleSetAction" refer="xsf:ruleset_name_key">
     <xsd:selector xpath="./xsf:ruleSetAction"/>
     <xsd:field xpath="@ruleSet"/>
   </xsd:keyref>
 </xsd:element>