3.1.8.5 prop

Identifies an attribute, and usually values in the attribute, to take an action on. The attribute must be a conditional processing attribute: platform, product, audience, props. and otheprops; or a specialization of the props attribute.

A prop element may do one of the following:

Contains

startflag (optional) then endflag (optional)

Contained by

val

Example

See the example in the <val> description.

Attributes

Name

Description

Data Type

Default Value

Required?

att

The attribute to be acted upon. Must be one of props, audience, platform, product, otherprops, or a specialization of props. If the att attribute is absent, then the prop element declares a default behavior for any conditional processing attribute.

CDATA

#IMPLIED

no

val

The value to be acted upon. If the val attribute is absent, then the prop element declares a default behavior for any value in the specified attribute.

CDATA

#IMPLIED

no

action

The action to be taken. The options are:

include

Include the content in output. This is the default behavior unless otherwise set.

exclude

Exclude the content from output (if all values in the particular attribute are excluded).

passthrough

Include the content in output, and preserve the attribute value as part of the output stream for further processing by a runtime engine, for example runtime filtering based on individual user settings. The value should be preserved in whatever syntax is required by the target runtime. Values that are not explicitly passed through should be removed from the output stream, even though the content is still included.

flag

Include and flag the content on output (if the content has not been excluded).

(include | exclude | passthrough | flag)

#IMPLIED

yes

color

If flag has been set, the color to use to flag text. Colors may be entered by name or code. Processor support is recommended for the color names listed under the heading "<color>" in <http://www.w3.org/TR/2001/REC-xsl-20011015/slice5.html#section-N8794-Property-Datatypes> and for the 6 digit hex code form (#rrggbb, case insensitive). If flag has not been set, this attribute is ignored.

CDATA

#IMPLIED

no

backcolor

If flag has been set, the color to use as background for flagged text. Colors may be entered by name or code. Processor support is recommended for the color names listed under the heading "<color>" in <http://www.w3.org/TR/2001/REC-xsl-20011015/slice5.html#section-N8794-Property-Datatypes> and for the 6 digit hex code form (#rrggbb, case insensitive). If flag has not been set, this attribute is ignored.

CDATA

#IMPLIED

no

style

If flag has been set, the text style to use for flagged text. The following values are enumerated:underline

  • double-underline
  • italics
  • overline
  • bold
  • If flag has not been set, this attribute is ignored.

(underline | double-underline | italics | overline | bold)

#IMPLIED

no

Previous Topic:  3.1.8.4 style-conflict

Next Topic:  3.1.8.6 revprop

Parent Topic:  3.1.8 DITAVAL elements

Sibling Topics:

3.1.8.3 val

3.1.8.4 style-conflict

3.1.8.6 revprop

3.1.8.7 startflag

3.1.8.8 endflag

3.1.8.9 alt-text