Modal

Kip bir <dialog> öğesidir. commandfor değeri kipin id değerini gösteren ve command: 'show-modal' taşıyan herhangi bir düğme onu kip olarak açar: arkadaki sayfa etkisiz (inert) hale gelir, böylece odak ve ekran okuyucu içeride kalır. Hiçbir yerde betik yok; arka plan, Escape ve dışarı tıklama tarayıcının işi.

id değerinin zorunlu olmasının ve bileşenin o olmadan hata fırlatmasının nedeni budur: kimlik, bağlantının tamamıdır.

Temel kip

Bu sayfadaki her kip gerçekten açılır — deneyin.

Site yeniden derlensin mi?

Bu, sitelo build çalıştırır ve dist/ dizinini yeniden yayımlar.
fragment(
  button({ commandfor: 'demo-basic', command: 'show-modal' }, 'Kipi aç'),
  modal({ id: 'demo-basic', title: 'Site yeniden derlensin mi?' },
    'Bu, sitelo build çalıştırır ve dist/ dizinini yeniden yayımlar.',
  ),
)

Alt bilgiyle

Kapatma düğmesi, aynı kimliği gösteren ve command: 'close' taşıyan herhangi bir düğmedir.

Bu sayfa silinsin mi?

Bu geri alınamaz. Üretilen HTML bir sonraki derlemede kaldırılır.
fragment(
  button({ color: 'danger', commandfor: 'demo-confirm', command: 'show-modal' }, 'Sayfayı sil…'),
  modal({
    id: 'demo-confirm',
    title: 'Bu sayfa silinsin mi?',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({
        variant: 'ghost',
        color: 'neutral',
        commandfor: 'demo-confirm',
        command: 'close',
      }, 'Vazgeç'),
      button({ color: 'danger' }, 'Sil'),
    ),
  }, 'Bu geri alınamaz. Üretilen HTML bir sonraki derlemede kaldırılır.'),
)

Boyutlar

Küçük

size: sm — yaklaşık 24rem.

Orta

Varsayılan — yaklaşık 32rem.

Büyük

size: lg — yaklaşık 48rem.
fragment(
  stack({ direction: 'row', gap: 'sm', wrap: true },
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-sm', command: 'show-modal' }, 'Küçük'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-md', command: 'show-modal' }, 'Orta'),
    button({ variant: 'outline', color: 'neutral', commandfor: 'demo-lg', command: 'show-modal' }, 'Büyük'),
  ),
  modal({ id: 'demo-sm', size: 'sm', title: 'Küçük' }, 'size: sm — yaklaşık 24rem.'),
  modal({ id: 'demo-md', title: 'Orta' }, 'Varsayılan — yaklaşık 32rem.'),
  modal({ id: 'demo-lg', size: 'lg', title: 'Büyük' }, 'size: lg — yaklaşık 48rem.'),
)

Kip içinde formlar

Yeni sayfa

fragment(
  button({ variant: 'soft', commandfor: 'demo-form', command: 'show-modal' }, 'Yeni sayfa…'),
  modal({
    id: 'demo-form',
    title: 'Yeni sayfa',
    footer: stack({ direction: 'row', gap: 'sm' },
      button({ variant: 'ghost', color: 'neutral', commandfor: 'demo-form', command: 'close' }, 'Vazgeç'),
      button({ type: 'submit' }, 'Oluştur'),
    ),
  },
    stack({ gap: 'md' },
      textField({ label: 'Başlık', name: 'modal-title', placeholder: 'Hakkında' }),
      selectField({ label: 'Uzantı', name: 'modal-ext', options: ['.ht.js', '.ht.ts', '.ht.jsx'] }),
    ),
  ),
)

Kapatma düğmesi olmadan

closable: false köşedeki × işaretini kaldırır. Escape ve dışarı tıklamak yine kapatır; closedby: 'closerequest' ile yalnızca Escape kapatır.

Escape’e basın

Ya da bu iletişim kutusunun dışında bir yere tıklayın.
fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-bare', command: 'show-modal' }, 'Kapatma düğmesi yok'),
  modal({ id: 'demo-bare', title: 'Escape’e basın', closable: false },
    'Ya da bu iletişim kutusunun dışında bir yere tıklayın.',
  ),
)

Uzun içerik

Gövde kaydırılır; başlık ve alt bilgi yerinde kalır.

Sürüm notları

1. değişiklik — bir şey düzeltildi.

2. değişiklik — bir şey düzeltildi.

3. değişiklik — bir şey düzeltildi.

4. değişiklik — bir şey düzeltildi.

5. değişiklik — bir şey düzeltildi.

6. değişiklik — bir şey düzeltildi.

7. değişiklik — bir şey düzeltildi.

8. değişiklik — bir şey düzeltildi.

9. değişiklik — bir şey düzeltildi.

10. değişiklik — bir şey düzeltildi.

11. değişiklik — bir şey düzeltildi.

12. değişiklik — bir şey düzeltildi.

fragment(
  button({ variant: 'outline', color: 'neutral', commandfor: 'demo-long', command: 'show-modal' }, 'Uzun kip'),
  modal({
    id: 'demo-long',
    title: 'Sürüm notları',
    footer: button({ commandfor: 'demo-long', command: 'close' }, 'Kapat'),
  },
    stack({ gap: 'md' },
      ...Array.from({ length: 12 }, (unused, index) =>
        text({ variant: 'small', tone: 'muted' }, (index + 1) + '. değişiklik — bir şey düzeltildi.'),
      ),
    ),
  ),
)

Arka planın kaydırılması

Açık bir kipin ardındaki sayfa kaydırılmaz. Kipli bir iletişim kutusunun size bıraktığı tek şey budur ve burada CSS ile yapılır — betik yok, başlatılacak bir şey yok. Arka planın her zamanki gibi kaydırılmasına izin vermek için lockScroll: false geçirin.

Tarayıcı desteği

Bir iletişim kutusunu düğmenin command değeriyle açmak her güncel tarayıcıda çalışır — Chrome 135, Firefox 144 ve Safari 26.2 ve sonrası. Daha eski bir tarayıcıda button(), aynı işi yapmak için birkaç yüz baytlık /su/dialog.js dosyasını yükleyen bir onclick ekler — yalnızca orada ve yalnızca ilk tıklamada. Dışarı tıklayınca kapatmayı (closedby) Safari henüz desteklemiyor; orada da bunu aynı dosya üstlenir.

Proplar

PropTürVarsayılanAçıklama
idstring—Zorunlu. Bir tetikleyicinin commandfor değerinin gösterdiği şey.
titleChild—Başlık ve iletişim kutusunun erişilebilir adı.
size'sm' | 'md' | 'lg''md'En büyük genişlik.
footerChild—Kendi renkli şeridinde alt satır.
closablebooleantrueBaşlıkta × gösterir.
closeLabelstring'Close'O düğme için erişilebilir ad.
lockScrollbooleantrueAçıkken ardındaki sayfanın kaydırılmasını durdurur.

closeButton({ target }) kendiniz kurduğunuz bir başlık için o × işaretini tek başına işler.