Setting the possible value to specific heading level (
H2,
H3,
H4,
H5,
H6) explicitly assigns that level as the heading tag for the content where the attribute is authored.
Note: If authoring heading tags explicitly, be sure to run the accessibility checker to check for any inconsistencies in heading tags as manual assignment of explicit tags could result in out of sequence tags or skipping of tags and may cause confusion for unsighted readers when navigating the heading tag structure using assistive technologies.
Setting the TagType attribute value to Auto calculates the heading level and assigns the heading tag for the content where the attribute is authored. The level computation includes Section elements and is calculated as one level greater than a Section element for nested child elements authored with the TagType attribute set to Auto (Section elements are counted regardless if Section>Title element is present).
If both explicit and Auto TagType values are authored in the same document, the explicit TagType value is honored to create the heading tag and the specific explicit value is excluded from Auto calculations; however, if the preceding elements of these explicit elements is a Section or thead of a table, those elements are included in the level computation for Auto.
Table elements
TagType=
Auto with presence of Table element Logic:
- Table elements authored directly as a child of the Body element with contents set with TagType=Auto are assigned H2 to avoid skipping heading levels (i.e. Title H1 tag directly to an H3 tag).
- When an element with TagType=Auto is in the thead of a table, the value is greater than the standard case by the number of containing Tables that also have thead descendants with TagType=Auto. The thead element must have at least one element with the TagType=Auto to be considered in this calculation; if the TagType attribute is set to an explicit value, it will be ignored in the calculation.
- When an element with TagType=Auto exists in the Body of a table that has a thead having some descendant with a TagType=Auto, the computation of containing Tables includes the current table.
