kt-page-header

The block every screen opens with: an overline, a title, a sentence, and the actions that belong to the page rather than to anything on it.

It exists because it was being rebuilt on every screen, and the copies drifted: different heading levels, different gaps, actions sometimes above the title and sometimes beside it. None of those are decisions worth making twice.

Two levels

level="page" (the default) renders an <h1> at display scale — one per screen. level="section" renders an <h2> at body scale, for a region inside a page, where the trailing action is usually a link onward rather than a button:

Both wrap on a narrow screen: the actions drop under the copy rather than squeezing the title.

API