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.

Lightbox

Lightbox

Menampilkan satu gambar berukuran besar di atas halaman yang diredupkan: gambar tumbuh dari thumbnail-nya dan menyusut kembali ke sana. Berupa tautan di sekitar thumbnail, sehingga tanpa skrip pun tetap membuka gambar penuh.

Penggunaan

Pakai saat

  • Thumbnail foto, diagram, atau halaman pindaian yang perlu dilihat utuh: foto lokasi laporan, foto papan pengumuman, formulir yang dipindai.
  • Galeri gambar yang masing-masing dibuka sendiri.

Pakai yang lain saat

  • Menggeser sekumpulan slide di tempat: pakai Carousel.
  • Formulir, laporan, atau apa pun yang punya kontrol: pakai Modal.
  • Menampilkan gambar kecil beserta keterangannya di dalam alur: pakai Thumbnail.
  • Dokumen atau PDF yang dibaca: pakai Link. Tautkan dan biarkan browser yang membukanya.

Letaknya. Menutupi seluruh jendela (fixed, z-index 90), gambar di tengah dengan jarak 24 px di sekelilingnya dan paling tinggi setinggi jendela dikurangi 96 px; tombol tutup di kanan atas dan keterangan di bawah, keduanya bebas dari notch. Pemicunya tautan .thumb di mana saja dalam konten.

Contoh

Foto fasilitas layananBuka sebuah thumbnail: gambar tumbuh darinya. Escape, tombol tutup, atau klik di luar menyusutkannya kembali dan mengembalikan fokus ke thumbnail.
Ruang baca perpustakaan daerah Meja laboratorium puskesmas
<a class="thumb" href="/photos/library-large.jpg" data-lds-lightbox data-caption="Ruang baca perpustakaan daerah, lantai dua">
  <img src="/photos/library-small.jpg" alt="Ruang baca perpustakaan daerah">
</a>

Anatomi

BagianFungsinya
a.thumb[data-lds-lightbox]Wajib. Tautan ke gambar penuh (href), dengan data-caption opsional. --ratio mengatur bentuk thumbnail (bawaan 4 / 3).
a.thumb > imgWajib. Thumbnail dengan teks alt yang bermakna; dipakai ulang untuk gambar besar.
.lightboxDibuat oleh skrip: lapisan redup selebar jendela (role="dialog", aria-modal).
.lightbox__closeDibuat oleh skrip: icon button penutup, labelnya dari data-close (bawaan "Close").
.lightbox__captionDibuat dari data-caption.

Status

StatusCaranya
.lightbox.is-openScrim sudah muncul, gambar dalam ukuran penuh.
a.thumb:hoverGambar thumbnail membesar ke 1,03 di perangkat yang mendukung hover.

Gerak dan mikrointeraksi

  • Buka: scrim muncul selama --d-standard (240 ms) dengan --ease-enter; gambar tumbuh dari persegi thumbnail yang persis ke ukuran penuhnya (FLIP dengan Web Animations API) selama 420 ms dengan kurva masuk cubic-bezier(0.16, 1, 0.3, 1).
  • Tutup: jalur yang sama kembali ke thumbnail dalam 220 ms dengan kurva keluar cubic-bezier(0.7, 0, 0.84, 0); scrim memudar selama --d-exit. Lapisan dihapus saat gambar mendarat.
  • Hover thumbnail: gambar membesar ke 1,03 dengan --spring-smooth.
  • Reduced motion: tanpa tumbuh atau menyusut; gambar muncul dan hilang bersama efek pudar.

Aksesibilitas

  • Pemicunya tautan asli ke gambar penuh, sehingga tetap berfungsi tanpa JavaScript dan di tab baru.
  • alt thumbnail dipakai ulang untuk gambar besar; data-caption (atau alt) menjadi nama dialog.
  • Saat dibuka, fokus pindah ke tombol tutup dan Tab tetap di sana; Escape atau klik di luar gambar menutupnya dan mengembalikan fokus ke thumbnail.

Lakukan dan hindari

Lakukan

  • Beri setiap thumbnail teks alt yang bermakna dan keterangan sebagai konteks.
  • Tautkan ke berkas yang lebih besar dari thumbnail.

Hindari

  • Membungkus gambar yang sudah tampil dalam ukuran penuh.
  • Menaruh kontrol atau formulir di dalam lightbox.

Perilaku dan kode

HTML biasa. data-lds-lightbox pada <a href> di sekitar <img>: saat diklik, skrip membuat lapisan .lightbox di <body>, memutar animasi tumbuh dari thumbnail, memfokuskan tombol tutup, dan menutup saat Escape, tombol tutup, atau klik di luar gambar, sambil menyusut kembali dan mengembalikan fokus. Opsional data-caption dan data-close (label tombol tutup, misalnya "Tutup").