signitems

Specifies which types of items filtered for a particular signature.

Filtering an item means keeping or omitting all items of a particular type, rather than specific items (see signitemrefs).

Syntax

   <signitems>
      <filter>item filter</filter>
      <itemtype>item type1</itemtype>
      ...
      <itemtype>item typen</itemtype>
   </signitems>
Note: There may be any number of item type entries.
Table 1. signitem parameters
Parameter Type Description
item filter keep include types of items in the item type list with the signature; omit those not in the list
  omit omit types of items in the item type list from the signature; include those not in the list
item type string specifies the type (element tag name) of items to be filtered

Available in

button, signature

Example

This sample sets the signitems option to keep the following types of items with the signature: boxes, buttons, and fields.

   <signitems>
      <filter>keep</filter>
      <itemtype>box</itemtype>
      <itemtype>button</itemtype>
      <itemtype>field</itemtype>
   </signitems>

Usage details

  1. Default: omit nothing (keep all items), unless the containing page is omitted.
  2. The only recommended use of this filter is to omit data items in support of the usage of the signdatagroups filter.
  3. Element tag names can be specified with or without a namespace prefix. The default namespace URI is the XFDL namespace URI if no namespace prefix is given. If a namespace prefix is given, then the namespace URI to which the prefix is bound is used in determining whether or not each element matches the given filter.

    For example, the filter component <itemtype>box</itemtype> could equivalently be written <itemtype>xfdl:box</itemtype> if the prefix xfdl is mapped to the XFDL namespace URI.

  4. Other filters may take precedence over the signitems option. Refer to Order of precedence of filters for more information on the order of precedence of filters.