Proyek komunitas. Ini bukan situs resmi pemerintah.

Dikelola sukarelawan. Lampung Design System dibangun oleh komunitas open source. Tidak ada instansi pemerintah yang mengelola atau mendukungnya secara resmi.

Layanan resmi memakai go.id. Situs pemerintah Indonesia berakhiran .go.id. Jangan masukkan NIK di situs yang Anda ragukan.

Modal

Modal

Dialog tingkat halaman di atas seluruh jendela: <dialog class="modal"> native di top layer, atau .overlay yang dirender di tempat oleh framework. Di bawah 600 px modal native menjadi bottom sheet. Tutup dengan closeModal() agar animasi keluarnya diputar.

Penggunaan

Pakai saat

  • Formulir atau konfirmasi milik seluruh halaman, bukan satu area: laporkan kesalahan data, undang petugas, ubah data profil.
  • Lapisan harus berada di atas segalanya, termasuk header sticky dan app shell, tanpa mengatur z-index.
  • Aplikasi React atau framework lain yang memasang dan melepas lapisan sendiri (.overlay).

Pakai yang lain saat

  • Pertanyaan singkat di dalam area yang diposisikan (kanvas, pratinjau, bingkai ponsel): pakai Dialog.
  • Mengonfirmasi aksi destruktif: pakai Alert dialog. Pakai anatomi alert dialog (ikon, judul, tombol danger) di dalam modal jika harus tingkat halaman.
  • Tugas di ponsel yang sebaiknya bisa diseret dan tetap memperlihatkan halaman di belakang: pakai Sheet.
  • Filter atau detail di samping daftar pada layar lebar: pakai Drawer.
  • Menampilkan gambar lebih besar: pakai Lightbox.
  • Alur panjang dengan banyak langkah: pakai Steps. Beri halaman sendiri dengan steps.

Letaknya. Di tengah jendela, paling lebar 520 px (.overlay__panel 440 px), berjarak 16 px dari tepi dan bergulir sendiri jika tinggi. Di bawah 600 px modal native menempel di bawah sebagai sheet dengan sudut atas membulat dan padding safe-area. Taruh <dialog> di mana saja di halaman; top layer yang mengangkatnya.

Contoh

Modal halaman nativeTerbuka di atas seluruh halaman di top layer. Escape, klik pada backdrop, dan Batal semuanya memutar animasi keluar sebelum menutup. Persempit jendela di bawah 600 px untuk melihatnya sebagai bottom sheet.

Laporkan kesalahan data

Beri tahu kami apa yang salah pada data jadwal puskesmas dan seharusnya seperti apa.

<button class="btn btn--secondary" data-lds-modal="md-report"><span class="ic" aria-hidden="true">error</span>Laporkan kesalahan data</button>
<dialog class="modal" id="md-report" aria-labelledby="md-report-t">
  <button class="icon-btn dialog__close" data-lds-modal-close aria-label="Tutup"><span class="ic" aria-hidden="true">close</span></button>
  <h2 class="dialog__title" id="md-report-t">Laporkan kesalahan data</h2>
  <p class="dialog__body">Beri tahu kami apa yang salah pada data jadwal puskesmas dan seharusnya seperti apa.</p>
  <div class="field" style="margin-top: 16px;"><div class="control control--area"><textarea aria-label="Apa yang salah" placeholder="Jadwal menulis buka pukul 07.00, papan di lokasi menulis 08.00."></textarea></div></div>
  <div class="dialog__actions"><button class="btn btn--secondary" data-lds-modal-close>Batal</button><button class="btn btn--primary" data-lds-modal-close>Kirim laporan</button></div>
</dialog>
Overlay di tempatLapisan yang sama dirender oleh framework: pasang .overlay untuk membuka, panggil closeModal(el, unmount) untuk memutar animasi keluar lalu melepasnya. Di sini ditampilkan di dalam kotak ini.
{open && (
  <div className="overlay" ref={ref} onKeyDown={(e) => e.key === 'Escape' && closeModal(ref.current, () => setOpen(false))}>
    <div className="overlay__panel" role="dialog" aria-modal="true" aria-labelledby="invite-t">
      <h2 className="dialog__title" id="invite-t">Undang petugas</h2>
      <p className="dialog__body">Petugas menerima email berisi tautan untuk bergabung dengan tim verifikasi izin.</p>
      <div className="dialog__actions">
        <button className="btn btn--secondary" onClick={() => closeModal(ref.current, () => setOpen(false))}>Batal</button>
        <button className="btn btn--primary" onClick={send}>Kirim undangan</button>
      </div>
    </div>
  </div>
)}

Anatomi

BagianFungsinya
dialog.modalWajib untuk versi native. id, aria-labelledby ke judul. Dibuka dengan showModal().
.overlayWajib untuk versi di tempat: scrim fixed selebar jendela yang menengahkan panel; dirender hanya saat terbuka.
.overlay__panel[role=dialog][aria-modal=true]Panel di dalam .overlay; kolom dengan jarak 8 px.
.dialog__closeIcon button tutup, kanan atas; data-lds-modal-close di versi native.
.dialog__title / .dialog__bodyJudul wajib dan baris konteks, bagian yang sama dengan dialog.
.dialog__actionsWajib. Sekunder lalu utama, berbagi lebar.
[data-lds-modal="id"]Pemicu untuk modal native.

Varian dan ukuran

Kelas atau atributKapan
dialog.modalNative: top layer, ::backdrop, fokus diurus browser, bottom sheet di bawah 600 px. Bawaan.
.overlay > .overlay__panelDi tempat: untuk framework yang merender lapisan secara kondisional. Tetap di tengah di ponsel. Anda yang menangani Escape, fokus, dan klik backdrop.

Status

StatusCaranya
[open]Modal native tampil; masuk dengan spring dan backdrop-nya muncul perlahan.
.is-closingMemutar animasi keluar (lds-modal-out, atau lds-sheet-down di ponsel). Ditambahkan oleh closeModal(), dihapus setelah tertutup.

Gerak dan mikrointeraksi

  • Masuk: lds-modal-in dari translateY(8px) scale(0.96) dan transparan, dengan --spring-smooth selama --d-smooth (560 ms). Backdrop muncul selama --d-standard (240 ms); .overlay muncul selama --d-fast.
  • Keluar: lds-modal-out ke scale(0.97) dan transparan selama --d-exit (180 ms) dengan --ease-exit, backdrop memudar bersamanya. closeModal() menunggunya, lalu memanggil close() atau done Anda.
  • Ponsel (600 px ke bawah): modal native naik dengan lds-sheet-up pada --spring-smooth dan turun dengan lds-sheet-down dalam 260 ms dengan --ease-exit.
  • Reduced motion: tanpa animasi; closeModal() langsung menutup.

Aksesibilitas

  • Native: showModal() membuat sisa halaman inert, mengunci fokus, dan memindahkannya ke elemen pertama yang bisa difokus (atau [autofocus]); saat ditutup browser mengembalikan fokus ke pemicu.
  • Native: aria-labelledby ke judul. Escape dicegat (cancel) agar animasi keluar diputar sebelum menutup.
  • Overlay: taruh role="dialog", aria-modal="true", dan aria-labelledby pada .overlay__panel; pindahkan fokus ke dalamnya saat dipasang, kunci Tab, tutup dengan Escape, dan kembalikan fokus ke pemicu setelah dilepas. Sistem tidak melakukan ini untuk .overlay.

Lakukan dan hindari

Lakukan

  • Tutup dengan closeModal() (atau [data-lds-modal-close]) agar animasi keluar diputar; jangan pernah memanggil dialog.close() langsung.
  • Batasi pada satu tugas dengan satu aksi utama.
  • Biarkan konten panjang bergulir di dalam modal, bukan halaman di belakangnya.

Hindari

  • Membungkus dialog.modal dengan pembungkus fixed sendiri atau memberinya z-index; top layer sudah melakukannya.
  • Membuka modal saat halaman dimuat.
  • Menumpuk modal di atas modal.

Perilaku dan kode

HTML biasa. [data-lds-modal="id"] membuka dialog#id.modal dengan openModal(el) (showModal()). Di dalamnya, [data-lds-modal-close], Escape, dan klik pada backdrop memanggil closeModal(el), yang menambahkan .is-closing, menunggu animasi keluar (180 ms; 260 ms sebagai sheet ponsel), lalu menutup. closeModal(overlayEl, done) melakukan hal yang sama untuk .overlay lalu memanggil done untuk melepasnya.

React. Dari lampung-design-system/react.

import { closeModal } from 'lampung-design-system/react';

const ref = useRef<HTMLDivElement>(null);
{open && (
  <div className="overlay" ref={ref}>
    <div className="overlay__panel" role="dialog" aria-modal="true" aria-labelledby="t">…
      <button className="btn btn--secondary" onClick={() => closeModal(ref.current, () => setOpen(false))}>Batal</button>
    </div>
  </div>
)}