Header Block

Introduction

page title heading deeplink

The Header enjin block is typically the first block on any page and present title-levelsemantic content.

All enjin blocks can have their own relative header, section and footer content. TheHeader block provides additional features to the basic block structure which focus on thepresentation of page-title level semantic content.

top

About Headers

Heading Levels

page title heading deeplink

Header blocks are the only enjin block which can have an <h1> tag. Allsemantic enjin based pages can have one and only one level-1 header tags becausesemantically speaking, this is the document's primary title and it does not make sense tohave more than one primary title on a given page because screen readers are an importanttarget of support for the semantic enjin theming system.

Within the Semantic Enjin systems, content editors are presented with the ability toconfigure headers (and footers) for each enjin block they add to a page. There's nocapacity presented where an editor can indicate the header priority because the priorityis dictated by the general document outline or layout of the content and that layout isdictated by the page-level metadata and the order (and nesting) of enjin blocks on thepage.

For example: this page starts with a standard header block and because it's both thefirst block on the page and it's a header block, it's header section gets an<h1> tag.

The next block is a content block and because it's in the top level of the page blocklist, it gets an <h2> tag.

The next block after that is a second header block and because it's in the top level ofthe page block list and not the first, it too gets an <h2> tag.

This is where the semantics show up, the following block after the second header blockis a normal content block, however there is the preceeding header block which tells thegeneral document outline to increment to the next level of headings and thus this contentblock has an <h3> tag.

top

Header Navigation

In-Page Navigation

page title heading deeplink

All header blocks have an additional feature, that of an in-page navigation list, normallyrendered as a horizontal bar of links to different parts of the same page. These linkscannot be to other parts of the site, nor can they be to any other domain either.

That may seem limiting, however, it is in fact a semantically correct approach becausethis particular link placement is for the convenience of navigating up or down from thecurrent place on what is likely a long an informative document worthy of being stored forhistorical context by archive.org .

The best way to link to off-or-same site content is to use the Link-List block which allows for just about any form of link including files for download likePDFs.

The header block preceding this content block has in-page-nav links, as does the firstheader block on this page. Editors of course can choose which blocks are presented in anygiven header block's in-page-nav list.

top