Uygulama çubuğu

Bir uygulama çubuğu, içinde bir satır bulunan bir <header> öğesidir. Parçalar ayrıdır, böylece onları siz dizersiniz: bağlantılar için appBarNav(), ardından geleni en uca itmek için appBarSpacer() ve sondaki düğmeler için appBarActions().

Temel uygulama çubuğu

sitelo
appBar({ brand: 'sitelo' },
  appBarSpacer(),
  appBarActions(
    button({ size: 'sm', variant: 'soft' }, 'Giriş yap'),
  ),
)

Gezinmeyle birlikte

navLink() bir çubuğa uygun bağlantı biçemidir; current etkin sayfayı renkle olduğu kadar aria-current ile de işaretler.

appBar({ brand: 'sitelo' },
  appBarNav(
    navLink({ href: '#docs', current: true }, 'Belgeler'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Örnekler'),
  ),
  appBarSpacer(),
  appBarActions(
    button({ size: 'sm', variant: 'outline', color: 'neutral' }, 'GitHub'),
    button({ size: 'sm' }, 'Başlayın'),
  ),
)

İşaretli bir marka

Marka her tür biçimlendirmeyi alır ve href aksini söylemedikçe / adresine bağlanır.

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

Yapışkan ve bulanık

sticky çubuğu kaydırma kabının üstüne sabitler; blur onu yarı saydam yapar, böylece içerik altından geçer. İkisi de burada sayfanın kendisinde değil, kaydırılan bir kutu içinde gösteriliyor.

sitelo
yapışkan

Beni kaydırın — paragraf 1.

Beni kaydırın — paragraf 2.

Beni kaydırın — paragraf 3.

Beni kaydırın — paragraf 4.

Beni kaydırın — paragraf 5.

Beni kaydırın — paragraf 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' }, 'yapışkan')),
  ),
  container({ size: 'sm', style: 'padding-block: 1rem' },
    stack({ gap: 'md' },
      ...Array.from({ length: 6 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, 'Beni kaydırın — paragraf ' + (index + 1) + '.'),
      ),
    ),
  ),
)

Kaydırırken yoldan çekilen

sticky: 'auto' çubuğu sabit tutar, ama sayfa aşağı kaydıkça kenara çeker ve yukarı kaydığı ya da en üste ulaştığı anda geri getirir. Klavye odağı içindeyken ya da içindeki bir menü açıkken görünür kalır.

Chromium’da bu tamamen CSS’tir, @container scroll-state(scrolled), ve hiçbir şey indirilmez. Diğer tarayıcılar sayfa yüklenirken bunun yerine kaydırmayı izleyen küçük bir modül indirir. Çubuk sayfayı izler; buradaki gibi kendi kaydırılan kutunuzun içindeyse kutuya ayrıca container-type: scroll-state verin.

sitelo
auto

Aşağı kaydırın, sonra geri çıkın — paragraf 1.

Aşağı kaydırın, sonra geri çıkın — paragraf 2.

Aşağı kaydırın, sonra geri çıkın — paragraf 3.

Aşağı kaydırın, sonra geri çıkın — paragraf 4.

Aşağı kaydırın, sonra geri çıkın — paragraf 5.

Aşağı kaydırın, sonra geri çıkın — paragraf 6.

Aşağı kaydırın, sonra geri çıkın — paragraf 7.

Aşağı kaydırın, sonra geri çıkın — paragraf 8.

Aşağı kaydırın, sonra geri çıkın — paragraf 9.

Aşağı kaydırın, sonra geri çıkın — paragraf 10.

Aşağı kaydırın, sonra geri çıkın — paragraf 11.

Aşağı kaydırın, sonra geri çıkın — paragraf 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' }, 'Aşağı kaydırın, sonra geri çıkın — paragraf ' + (index + 1) + '.'),
      ),
    ),
  ),
)

Küçük ekranlarda çekmeceyle

Alışıldık kalıp: masaüstünde çubuktaki bağlantılar, telefonda bir drawer() açan bir düğme. Çekmece, düğmenin command ile açtığı bir <dialog>’dur, bu yüzden betiğe ihtiyaç yoktur.

fragment(
  appBar({ brand: 'sitelo' },
    appBarSpacer(),
    appBarActions(
      themeToggle(),
      iconButton({
        label: 'Gezinmeyi aç',
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'app-bar-drawer', command: 'show-modal',
        icon: icon('menu'),
      }),
    ),
  ),
  drawer({ id: 'app-bar-drawer', title: 'Gezinme' },
    navLink({ href: '#docs' }, 'Belgeler'),
    navLink({ href: '#ui' }, 'UI'),
    navLink({ href: '#examples' }, 'Örnekler'),
  ),
)

Proplar

appBar():

PropTürVarsayılanAçıklama
brandChild—Baştaki marka bağlantısının içeriği.
hrefstring'/'Markanın bağlandığı yer.
stickyboolean | 'auto'falseKaydırmada çubuğu üste sabitler. 'auto' ayrıca aşağı kaydırırken onu gizler.
blurbooleanfalseArka plan bulanıklığıyla yarı saydam zemin.
asstring'header'İşlenecek öğe.

Parçalar:

ParçaProplarVarsayılanAçıklama
appBarNav—Bağlantıları tutan bir nav öğesi.
appBarSpacer—Esnek boşluk; ardından gelen her şey en uca gider.
appBarActions—Sondaki düğme kümesi.
navLinkhref, current, color—Çubuk için biçimlendirilmiş bir bağlantı; current etkin sayfayı işaretler.