layout.dock

A bar that stays at the bottom of the screen while the content under it scrolls or changes: the now-playing bar, a cart total, a long form’s submit button on phones

Component

Renders

<footer>

Profile

Example

Preview

Renders <footer>; see it in your pages.

<Layout intent="layout.dock">
…
</Layout>

Choosing between neighbours

Find the row that describes your element, and use the intent on the right.

  • If it is

    Use

  • A bar that stays at the bottom of the screen while the content under it scrolls or changes: the now-playing bar, a cart total, a long form’s submit button on phones

    layout.dock this page
  • The footer at the end of every page

    layout.footer

Connections

Declared in the registry, both directions. Where an intent is used in your own code is something check and the gallery see; this site has no app code.

For registry authors

Starter intents. These are the intents prongs add puts in your registry, shown in this site’s theme. Yours are your own registry.ts: rename, restyle and add to them, and see them with prongs add gallery.

What this intent is built from and its entry in components/prongs/registry.ts. You only need this to change how it looks or to add an intent like it.

How layout.dock resolves, and its definition

Each layer adds to the one before it; a later class wins over an earlier one that sets the same thing.

  • arrange.row

    Children in a wrapping row

    flex flex-row flex-wrap items-center
  • layout.dock

    A bar that stays at the bottom of the screen while the content under it scrolls or changes: the now-playing bar, a cart total, a long form’s submit button on phones

    sticky bottom-0 z-10 flex-nowrap items-center gap-4 border-t
    border-surface-border bg-background px-4 py-3
Final classes
flex flex-row sticky bottom-0 z-10 flex-nowrap items-center
gap-4 border-t border-surface-border bg-background px-4 py-3
Definition
TS
'layout.dock': {
kind: 'semantic',
description: 'A bar that stays at the bottom of the screen while the content under it scrolls or changes: the now-playing bar, a cart total, a long form’s submit button on phones',
refs: ['arrange.row'],
binding: {
element: 'footer',
classes: 'sticky bottom-0 z-10 flex-nowrap items-center gap-4 border-t border-surface-border bg-background px-4 py-3',
},
notFor: [
{
context: 'the footer at the end of every page',
instead: 'layout.footer',
},
],
},