11. AttributeList Element

Prev		Next

An AttributeList block element is an attribute list on a line by itself:

AttributeList attributes are only applied to the immediately following block element — the attributes are made available to the block’s markup template.
Multiple contiguous AttributeList elements are additively combined in the order they appear..
The first positional attribute in the list is often used to specify the ensuing element’s style.

11.1. Attribute value substitution

By default, only substitutions that take place inside attribute list values are attribute references, this is because not all attributes are destined to be marked up and rendered as text (for example the table cols attribute). To perform normal inline text substitutions (special characters, quotes, macros, replacements) on an attribute value you need to enclose it in single quotes. In the following quote block the second attribute value in the AttributeList is quoted to ensure the http macro is expanded to a hyperlink.

[quote,'http://en.wikipedia.org/wiki/Samuel_Johnson[Samuel Johnson]']
_____________________________________________________________________
Sir, a woman's preaching is like a dog's walking on his hind legs. It
is not done well; but you are surprised to find it done at all.
_____________________________________________________________________

11.2. Common attributes

Most block elements support the following attributes:

Name	Backends	Description
id	html4, xhtml11, docbook	Unique identifier typically serve as link targets. Can also be set by the BlockId element.
role	html4, xhtml11, docbook	Role contains a string used to classify or subclassify an element: Adds role attribute to DocBook block elements. Adds role attribute to DocBook and HTML quoted inline elements.
reftext	docbook	reftext is used to set the DocBook xreflabel attribute. The reftext attribute can an also be set by the BlockId element.