Barra de aplicación

Una barra de aplicación es un <header> con una fila dentro. Las piezas están separadas para que puedas ordenarlas: appBarNav() para los enlaces, appBarSpacer() para empujar lo que sigue al extremo, y appBarActions() para los botones del final.

Barra básica

sitelo
appBar({ brand: 'sitelo' },
  appBarSpacer(),
  appBarActions(
    button({ size: 'sm', variant: 'soft' }, 'Iniciar sesión'),
  ),
)

Con navegación

navLink() es el estilo de enlace para una barra; current marca la página activa con aria-current además de con color.

appBar({ brand: 'sitelo' },
  appBarNav(
    navLink({ href: '#docs', current: true }, 'Documentación'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Ejemplos'),
  ),
  appBarSpacer(),
  appBarActions(
    button({ size: 'sm', variant: 'outline', color: 'neutral' }, 'GitHub'),
    button({ size: 'sm' }, 'Empezar'),
  ),
)

Una marca con logotipo

La marca admite cualquier marcado, y enlaza a / salvo que href diga otra cosa.

Ssitelo
v2.6.3
appBar({
  href: '#home',
  brand: stack({ direction: 'row', gap: 'sm', inline: true, align: 'center' },
    avatar({ name: 'S', size: 'sm', square: true, color: 'primary' }),
    'sitelo',
  ),
},
  appBarSpacer(),
  appBarActions(chip({ size: 'sm', color: 'neutral' }, 'v2.6.3')),
)

Fija y difuminada

sticky fija la barra arriba del contenedor de scroll; blur la vuelve translúcida para que el contenido pase por debajo. Aquí se muestran ambas dentro de una caja con scroll, no en la página misma.

sitelo
sticky

Desplázame — párrafo 1.

Desplázame — párrafo 2.

Desplázame — párrafo 3.

Desplázame — párrafo 4.

Desplázame — párrafo 5.

Desplázame — párrafo 6.

div({ style: 'height: 12rem; overflow: auto; border: 1px solid var(--su-border); border-radius: 0.6rem' },
  appBar({ brand: 'sitelo', sticky: true, blur: true },
    appBarSpacer(),
    appBarActions(chip({ size: 'sm', color: 'primary' }, 'sticky')),
  ),
  container({ size: 'sm', style: 'padding-block: 1rem' },
    stack({ gap: 'md' },
      ...Array.from({ length: 6 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Desplázame — párrafo ' + (index + 1) + '.'),
      ),
    ),
  ),
)

Fuera del camino al hacer scroll

sticky: 'auto' mantiene la barra fija, pero la desliza fuera mientras la página baja y la devuelve en cuanto sube o llega arriba del todo. Sigue a la vista mientras el foco del teclado está dentro de ella o tiene un menú abierto.

En Chromium es solo CSS, @container scroll-state(scrolled), y no se descarga nada. Los demás navegadores descargan un pequeño módulo al cargar la página, que vigila el scroll en su lugar. La barra sigue a la página; dentro de una caja con scroll propia, como esta, dale también a la caja container-type: scroll-state.

sitelo
auto

Baja y vuelve a subir — párrafo 1.

Baja y vuelve a subir — párrafo 2.

Baja y vuelve a subir — párrafo 3.

Baja y vuelve a subir — párrafo 4.

Baja y vuelve a subir — párrafo 5.

Baja y vuelve a subir — párrafo 6.

Baja y vuelve a subir — párrafo 7.

Baja y vuelve a subir — párrafo 8.

Baja y vuelve a subir — párrafo 9.

Baja y vuelve a subir — párrafo 10.

Baja y vuelve a subir — párrafo 11.

Baja y vuelve a subir — párrafo 12.

div({ style: 'height: 12rem; overflow: auto; container-type: scroll-state; border: 1px solid var(--su-border); border-radius: 0.6rem' },
  appBar({ brand: 'sitelo', sticky: 'auto', blur: true },
    appBarSpacer(),
    appBarActions(chip({ size: 'sm', color: 'primary' }, 'auto')),
  ),
  container({ size: 'sm', style: 'padding-block: 1rem' },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Baja y vuelve a subir — párrafo ' + (index + 1) + '.'),
      ),
    ),
  ),
)

Con un panel lateral en pantallas pequeñas

El patrón habitual: enlaces en la barra en escritorio y un botón que abre un drawer() en el móvil. El panel es un <dialog> que el botón abre con un command, así que no necesita script.

fragment(
  appBar({ brand: 'sitelo' },
    appBarSpacer(),
    appBarActions(
      themeToggle(),
      iconButton({
        label: 'Abrir la navegación',
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'app-bar-drawer', command: 'show-modal',
        icon: icon('menu'),
      }),
    ),
  ),
  drawer({ id: 'app-bar-drawer', title: 'Navegación' },
    navLink({ href: '#docs' }, 'Documentación'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Ejemplos'),
  ),
)

Props

appBar():

PropTipoPor defectoDescripción
brandChild—Contenido del enlace de marca al principio.
hrefstring'/'Adónde enlaza la marca.
stickyboolean | 'auto'falseFija la barra arriba al hacer scroll. 'auto' además la oculta al bajar.
blurbooleanfalseFondo translúcido con desenfoque detrás.
asstring'header'Elemento que se renderiza.

Las piezas:

PiezaPropsPor defectoDescripción
appBarNav—Un elemento nav que contiene los enlaces.
appBarSpacer—Hueco flexible; todo lo que vaya después se va al extremo.
appBarActions—Grupo de botones al final.
navLinkhref, current, color—Un enlace con estilo de barra; current marca la página activa.