Панель приложения

Панель приложения — это <header> со строкой внутри. Части разделены, чтобы вы могли их расставить: appBarNav() для ссылок, appBarSpacer(), чтобы отодвинуть всё следующее к дальнему краю, и appBarActions() для кнопок в конце.

Простая панель

sitelo
appBar({ brand: 'sitelo' },
  appBarSpacer(),
  appBarActions(
    button({ size: 'sm', variant: 'soft' }, 'Войти'),
  ),
)

С навигацией

navLink() — стиль ссылки для панели; current помечает активную страницу не только цветом, но и aria-current.

appBar({ brand: 'sitelo' },
  appBarNav(
    navLink({ href: '#docs', current: true }, 'Документация'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Примеры'),
  ),
  appBarSpacer(),
  appBarActions(
    button({ size: 'sm', variant: 'outline', color: 'neutral' }, 'GitHub'),
    button({ size: 'sm' }, 'Начать'),
  ),
)

Марка со знаком

Марка принимает любую разметку и ведёт на /, если href не говорит иначе.

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')),
)

Липкая и размытая

sticky прикрепляет панель к верху контейнера прокрутки; blur делает её полупрозрачной, чтобы содержимое проходило под ней. Здесь показано и то и другое внутри прокручиваемого блока, а не на самой странице.

sitelo
sticky

Прокрутите меня — абзац 1.

Прокрутите меня — абзац 2.

Прокрутите меня — абзац 3.

Прокрутите меня — абзац 4.

Прокрутите меня — абзац 5.

Прокрутите меня — абзац 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' }, 'Прокрутите меня — абзац ' + (index + 1) + '.'),
      ),
    ),
  ),
)

Уходит с дороги при прокрутке

sticky: 'auto' держит панель прикреплённой, но убирает её, пока страница прокручивается вниз, и возвращает, как только она прокручивается вверх или доходит до начала. Панель остаётся на месте, пока в ней фокус клавиатуры или открыто её меню.

В Chromium это чистый CSS, @container scroll-state(scrolled), и ничего не загружается. Остальные браузеры при загрузке страницы получают небольшой модуль, который вместо этого следит за прокруткой. Панель следует за страницей; в собственном прокручиваемом блоке, как этот, задайте блоку ещё и container-type: scroll-state.

sitelo
auto

Прокрутите вниз, потом обратно — абзац 1.

Прокрутите вниз, потом обратно — абзац 2.

Прокрутите вниз, потом обратно — абзац 3.

Прокрутите вниз, потом обратно — абзац 4.

Прокрутите вниз, потом обратно — абзац 5.

Прокрутите вниз, потом обратно — абзац 6.

Прокрутите вниз, потом обратно — абзац 7.

Прокрутите вниз, потом обратно — абзац 8.

Прокрутите вниз, потом обратно — абзац 9.

Прокрутите вниз, потом обратно — абзац 10.

Прокрутите вниз, потом обратно — абзац 11.

Прокрутите вниз, потом обратно — абзац 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' }, 'Прокрутите вниз, потом обратно — абзац ' + (index + 1) + '.'),
      ),
    ),
  ),
)

С боковой панелью на узких экранах

Обычный приём: ссылки в панели на десктопе и кнопка, открывающая drawer() на телефоне. Боковая панель — это <dialog>, который кнопка открывает через command, так что скрипт не нужен.

fragment(
  appBar({ brand: 'sitelo' },
    appBarSpacer(),
    appBarActions(
      themeToggle(),
      iconButton({
        label: 'Открыть навигацию',
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'app-bar-drawer', command: 'show-modal',
        icon: icon('menu'),
      }),
    ),
  ),
  drawer({ id: 'app-bar-drawer', title: 'Навигация' },
    navLink({ href: '#docs' }, 'Документация'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Примеры'),
  ),
)

Пропсы

appBar():

ПропТипПо умолчаниюОписание
brandChild—Содержимое ссылки-марки в начале.
hrefstring'/'Куда ведёт марка.
stickyboolean | 'auto'falseПрикрепляет панель к верху при прокрутке. 'auto' ещё и прячет её при прокрутке вниз.
blurbooleanfalseПолупрозрачный фон с размытием под ним.
asstring'header'Какой элемент рендерить.

Части:

ЧастьПропсыПо умолчаниюОписание
appBarNav—Элемент nav, в котором лежат ссылки.
appBarSpacer—Гибкий пробел; всё после него уходит к дальнему краю.
appBarActions—Группа кнопок в конце.
navLinkhref, current, color—Ссылка в стиле панели; current помечает активную страницу.