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.

Enter and exit

Enter and exit

Cara sesuatu muncul dan menghilang: overlay naik beberapa piksel dan membesar dari 0,96 dengan smooth spring sambil cepat memudar masuk; overlay pergi dalam 180 ms dengan kurva keluar, lebih tenang daripada saat datang, lewat jalur yang sama. Butir yang bergabung ke daftar memudar masuk dari blur tipis.

Penggunaan

Pakai saat

  • Overlay terbuka atau tertutup: dropdown menu, popover, dialog, modal, sheet, drawer, command palette, toast.
  • Satu butir baru bergabung ke sesuatu yang sudah tampil: baris berkas setelah unggahan dimulai, tag setelah Enter, pesan obrolan baru.
  • Sebuah butir pergi untuk selamanya: toast habis waktunya, alert yang ditutup, baris yang dihapus.

Pakai yang lain saat

  • Konten yang terbuka di dalam alur dan mendorong isi di bawahnya: pakai Height expand.
  • Banyak butir tiba bersamaan (hasil pencarian, feed): pakai List stagger.
  • Satu tampilan menggantikan tampilan lain di tempat yang sama: pakai View swap.
  • Gambar yang membesar dari thumbnail-nya: pakai Shared element.
  • Konten yang muncul saat halaman di-scroll: pakai Reveal on scroll.
  • Kata atau label yang berubah di tempat: pakai Text morph.

Letaknya. Pada layer itu sendiri. Layer mengambang tumbuh dari sisi yang paling dekat dengan pemicunya (transform-origin); panel bergeser dari tepi tempatnya berada; dialog di tengah naik dari sedikit di bawah tengah.

Contoh

Menu tumbuh dari pemicunyaMenu kiri tumbuh dari sudut kiri atasnya; menu kanan, yang dibuka dari tepi kanan, tumbuh dari sudut kanan atasnya (menu--right). Keduanya mengecil kembali ke asalnya dalam 180 ms.
<div class="docs-row" style="justify-content: space-between; width: 100%;">
  <div style="position: relative;">
    <button class="btn btn--gray btn--md" data-lds-menu="ee-sort" aria-haspopup="menu" aria-expanded="false">Urutkan<span class="ic" aria-hidden="true">expand_more</span></button>
    <div class="menu" id="ee-sort" role="menu" style="top: calc(100% + 6px); left: 0;">
      <button class="menu__item" role="menuitem">Tanggal lapor</button>
      <button class="menu__item" role="menuitem">Kecamatan</button>
      <button class="menu__item" role="menuitem">Baru ditambahkan</button>
    </div>
  </div>
  <div style="position: relative;">
    <button class="icon-btn" data-lds-menu="ee-more" aria-haspopup="menu" aria-expanded="false" aria-label="Aksi lainnya"><span class="ic" aria-hidden="true">more_horiz</span></button>
    <div class="menu menu--right" id="ee-more" role="menu" style="top: calc(100% + 6px); right: 0;">
      <button class="menu__item" role="menuitem"><span class="ic" aria-hidden="true">edit</span>Ganti nama</button>
      <button class="menu__item" role="menuitem"><span class="ic" aria-hidden="true">content_copy</span>Gandakan</button>
      <div class="menu__sep"></div>
      <button class="menu__item menu__item--danger" role="menuitem"><span class="ic" aria-hidden="true">delete</span>Hapus</button>
    </div>
  </div>
</div>
Dialog dan drawerDialog cepat memudar masuk (160 ms) sambil menetap dari posisi sedikit kecil dan rendah dengan smooth spring; scrim butuh 240 ms. Saat ditutup, gerakannya berbalik dalam 180 ms dengan kurva keluar. Drawer bergeser masuk dari kanan dan pergi ke kanan.

Layanan izin usaha mikro

<div class="viewport docs-box">
  <div class="viewport__content">
    <p class="card__title">Layanan izin usaha mikro</p>
    <div class="docs-row">
      <button class="btn btn--secondary btn--md" data-lds-open="ee-dialog" aria-haspopup="dialog">Ganti nama layanan</button>
      <button class="btn btn--secondary btn--md" data-lds-open="ee-drawer" aria-haspopup="dialog"><span class="ic" aria-hidden="true">tune</span>Filter</button>
    </div>
  </div>
  <div class="scrim" data-lds-scrim="ee-dialog"></div>
  <div class="dialog" id="ee-dialog" role="dialog" aria-modal="true" aria-labelledby="ee-dialog-t" data-lds-layer>
    <h3 class="dialog__title" id="ee-dialog-t">Ganti nama layanan</h3>
    <p class="dialog__body">Warga melihat nama baru saat mereka membuka aplikasi berikutnya.</p>
    <div class="control" style="margin-top: 16px;"><input aria-label="Nama layanan" value="Layanan izin usaha mikro" data-lds-autofocus></div>
    <div class="dialog__actions"><button class="btn btn--secondary btn--md" data-lds-close>Batal</button><button class="btn btn--primary btn--md" data-lds-close>Simpan nama</button></div>
  </div>
  <div class="scrim" data-lds-scrim="ee-drawer"></div>
  <aside class="drawer" id="ee-drawer" role="dialog" aria-modal="true" aria-labelledby="ee-drawer-t" data-lds-layer>
    <div class="sheet__head" style="margin: 0;"><h3 class="sheet__title" id="ee-drawer-t">Filter</h3><button class="icon-btn" aria-label="Tutup filter" data-lds-close style="margin: -10px -10px -10px 0;"><span class="ic" aria-hidden="true">close</span></button></div>
    <button class="btn btn--primary btn--block" style="margin-top: auto;" data-lds-close>Tampilkan 8 layanan</button>
  </aside>
</div>
Toast datang dan pergiToast naik 24 px dari bawah dengan smooth spring; setelah empat detik ia memudar keluar dalam 180 ms. Kirim beberapa: yang lebih lama terselip di belakang dan mengecil 5% masing-masing.

Laporan warga

import { toast } from 'lampung-design-system/js';
toast({ title: 'Draf tersimpan', icon: 'check_circle' });
Satu butir bergabung ke daftarBaris berkas baru memudar masuk dari blur 4 px dan naik 4 px (240 ms, kurva masuk). Baris yang sudah ada tidak bergerak kecuali untuk memberi ruang.
foto-jalan-rusak.jpg1,2 MB
<div class="docs-col" style="max-width: 420px;">
  <div><div class="file-row"><span class="file-row__icon"><span class="ic" aria-hidden="true">description</span></span><span class="file-row__body"><span class="file-row__name">foto-jalan-rusak.jpg</span><span class="file-row__meta">1,2 MB</span></span><button class="icon-btn" aria-label="Hapus foto-jalan-rusak.jpg"><span class="ic" aria-hidden="true">close</span></button></div></div>
  <button class="btn btn--secondary btn--sm" style="align-self: flex-start;" onclick="const list = this.previousElementSibling; const row = list.firstElementChild.cloneNode(true); row.querySelector('.file-row__name').textContent = 'lampiran-' + (list.children.length + 1) + '.pdf'; row.querySelector('.file-row__meta').textContent = '340 KB'; list.append(row);"><span class="ic" aria-hidden="true">add</span>Tambah berkas</button>
</div>
Modal halamandialog.modal bawaan naik dari 8 px di bawah dan skala 0,96 dengan smooth spring, backdrop-nya memudar selama 240 ms; modal pergi ke skala 0,97 dalam 180 ms. Di bawah 600 px modal menjadi bottom sheet yang naik dan turun.

Laporkan kesalahan

Sebutkan data yang salah pada tagihan pajak daerah Anda dan isi yang seharusnya.

<button class="btn btn--secondary" data-lds-modal="ee-modal">Laporkan kesalahan</button>
<dialog class="modal" id="ee-modal" aria-labelledby="ee-modal-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="ee-modal-t">Laporkan kesalahan</h2>
  <p class="dialog__body">Sebutkan data yang salah pada tagihan pajak daerah Anda dan isi yang seharusnya.</p>
  <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>

Varian dan ukuran

Kelas atau atributKapan
Menu, popoverMasuk: opacity --d-fast dengan --ease-enter, transform dari scale(0.96) translateY(-4px) dengan --spring-smooth (560 ms), dari transform-origin. Keluar: keduanya selama --d-exit dengan --ease-exit, lalu visibility: hidden setelah 180 ms.
Dialog, command paletteMasuk: opacity --d-fast, transform dari translateY(4px) scale(0.98) (palette scale(0.97)) dengan --spring-smooth. Keluar: kembali ke keadaan itu selama --d-exit dengan --ease-exit.
Page modal (.modal, .overlay)Masuk: lds-modal-in dari translateY(8px) scale(0.96) dengan --spring-smooth; backdrop lds-fade-in 240 ms. Keluar: tambahkan .is-closing, lds-modal-out ke scale(0.97) dalam 180 ms; closeModal() menunggu, lalu menutup. Ponsel: lds-sheet-up / lds-sheet-down (260 ms).
SheetMasuk: dari translateY(105%) dengan --spring-smooth. Keluar: 260 ms dengan --ease-exit (menempuh seluruh tingginya). Dilempar: --spring-momentum (600 ms).
DrawerMasuk: dari luar layar sebelah kanan dengan --spring-smooth. Keluar: 240 ms dengan --ease-exit.
ScrimMasuk: 240 ms --ease-enter. Keluar: 180 ms --ease-exit.
ToastMasuk: lds-toast-in dari translateY(24px) scale(0.96) dengan --spring-smooth. Keluar: .is-leaving, 180 ms dengan --ease-exit, dihapus setelah 200 ms.
Item joining (file row, tab panel)lds-blur-in: dari 4 px di bawah, blur 4 px, transparan; --d-standard dengan --ease-enter. Tag dan digit OTP memakai lds-pop-in (dari 0,6) dengan --spring-snappy.
Tooltip, hover cardTunggu 500 ms (hover card 600 ms) sebelum masuk dengan --spring-snappy / --spring-smooth; pergi dalam 100 sampai 120 ms. Tanpa jeda saat keluar.

Gerak dan mikrointeraksi

  • Saat masuk, opacity selalu lebih cepat daripada transform (160 ms lawan 560 ms): layer hampir langsung terbaca dan terus menetap sementara orang sudah membacanya.
  • Keluar lebih singkat daripada masuk (180 ms lawan 560 ms) dan makin cepat (--ease-exit). Tidak ada yang memantul saat keluar.
  • Overlay memakai transisi pada .is-open, jadi menutup di tengah gerakan masuk akan berbalik dari posisi saat itu; visibility berganti setelah gerakan keluar sehingga layer yang setengah tertutup tidak pernah menangkap klik.
  • Jalur kembali yang sama: menu mengecil ke sudut asalnya, sheet turun, drawer bergeser ke sisinya, toast turun 12 px.
  • Reduced motion: dialog, menu, popover, dan palette berhenti berubah skala (hanya opacity); modal halaman melewati animasinya dan langsung tertutup; semua transisi yang tersisa berjalan 120 ms linear.

Aksesibilitas

  • Fokus masuk ke overlay saat terbuka dan kembali ke pemicunya saat tertutup (openLayer / closeLayer, openModal / closeModal melakukannya).
  • Overlay yang tertutup memakai visibility: hidden dan inert, sehingga keluar dari urutan tab bahkan selama gerakan keluar.
  • Toast diumumkan oleh kontainer role="status"-nya; butir yang bergabung ke daftar diumumkan oleh pemilik daftar jika penting (live region atau toast), bukan oleh gerakannya.

Lakukan dan hindari

Lakukan

  • Buka overlay dengan hook sistem (data-lds-open, data-lds-menu, data-lds-modal) agar gerakan masuk, keluar, dan fokus datang bersamaan.
  • Tutup modal halaman dengan closeModal(el) agar gerakan keluar diputar sebelum dialog tertutup.
  • Pilih menu--right atau menu--up agar menu tumbuh dari sisi pemicunya.

Hindari

  • Menghapus elemen pada frame yang sama dengan dimulainya gerakan keluar; tunggu --d-exit.
  • Menggeser overlay masuk dari sisi yang bukan tempatnya.
  • Memudarkan masuk setiap elemen baru di halaman; sebagian besar konten cukup langsung ada.

Perilaku dan kode

HTML biasa. openLayer(id) / closeLayer(id) untuk overlay [data-lds-layer]; openModal(el) / closeModal(el, done) untuk dialog.modal dan .overlay (menambahkan .is-closing, menunggu --d-exit, lalu menutup); toast({ … }); menu lewat data-lds-menu. Semuanya menghormati reduced motion.

React. Dari lampung-design-system/react.

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

// Render .overlay > .overlay__panel while open; on close, play the exit first:
closeModal(overlayRef.current, () => setOpen(false));