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.

Coachmark

Coachmark

Card berwarna terbalik yang menunjuk satu bagian antarmuka dengan penjelasan singkat, dalam tur paling banyak tiga langkah. Selalu bisa dilewati.

Penggunaan

Pakai saat

  • Fitur baru berada di tempat yang tidak akan dicari orang, dan satu kalimat yang menunjuknya menghemat satu pertanyaan ke layanan bantuan.
  • Tur singkat saat pertama kali dipakai (satu sampai tiga langkah) di layar yang padat, seperti editor formulir permohonan atau buku nilai.

Pakai yang lain saat

  • Tips sekali tampil yang tidak perlu menunjuk kontrol: pakai Hints.
  • Menjelaskan istilah atau ikon saat hover atau fokus: pakai Tooltip.
  • Konten kaya dan interaktif yang dibuka dengan klik: pakai Popover.
  • Mengumumkan sesuatu tentang seluruh aplikasi: pakai Banner.
  • Antarmuka butuh tur lebih dari tiga langkah: pakai Empty state. Biasanya layarnya butuh tampilan awal yang lebih baik, bukan tur yang lebih panjang.

Letaknya. Tepat di bawah kontrol yang dijelaskan, dengan panah mengarah ke kontrol itu (panah di tepi atas, diatur dengan --arrow). Wadahnya harus diposisikan (position: relative). Di ponsel, jaga agar tetap di dalam lebar layar (card 280 px) dan di bawah targetnya.

Contoh

Tur tiga langkahCard meluncur ke target berikutnya dan panahnya mengikuti. Tekan Lanjut.
<div style="position: relative;">
  <button class="btn btn--secondary btn--md is-lit" id="search-btn">Cari</button>
  <div class="coach" role="dialog" aria-labelledby="coach-t" aria-describedby="coach-b" style="top: 64px; left: 0; --arrow: 40px;">
    <div class="coach__step">Langkah 1 dari 3</div>
    <div class="coach__title" id="coach-t">Cari semua laporan</div>
    <div class="coach__body" id="coach-b">Temukan laporan lewat kata apa pun di dalamnya, tidak hanya judulnya.</div>
    <div class="cluster" style="margin-top: 14px; justify-content: flex-end;">
      <button class="btn btn--sm">Lewati</button>
      <button class="btn btn--sm is-primary">Lanjut</button>
    </div>
  </div>
</div>
Satu penunjukSatu langkah tidak perlu penghitung; satu-satunya aksi adalah "Mengerti".
<div style="position: relative; min-height: 210px;">
  <button class="btn btn--gray btn--md is-lit"><span class="ic" aria-hidden="true">download</span>Ekspor</button>
  <div class="coach" role="dialog" aria-labelledby="cm2-t" style="top: 60px; left: 0; --arrow: 36px;">
    <div class="coach__title" id="cm2-t">Ekspor data retribusi ke spreadsheet</div>
    <div class="coach__body">Semua kolom yang Anda lihat ikut diekspor, dengan urutan yang sama.</div>
    <div class="docs-row" style="margin-top: 14px; justify-content: flex-end;"><button class="btn btn--sm is-primary" onclick="this.closest('.coach').hidden = true; this.closest('.coach').parentElement.querySelector('.is-lit').classList.remove('is-lit');">Mengerti</button></div>
  </div>
</div>

Anatomi

BagianFungsinya
.coachWajib. Card berwarna terbalik 280 px, diposisikan absolut di dalam wadah relatif; atur top/left (atau transform) untuk menempatkannya.
.coach::beforePanah di tepi atas. Geser dengan --arrow (jarak dari kiri, bawaan 24 px); ia meluncur saat nilainya berubah.
.coach__step"Langkah 1 dari 3".
.coach__titleWajib. Apa ini, dalam beberapa kata.
.coach__bodySatu kalimat: kenapa ini membantu.
.btn.btn--smLewati (warna terbalik) dan Lanjut atau Selesai (.btn--sm.is-primary, aksen).
.is-litPada target: ring aksen dengan celah, agar orang melihat apa yang dimaksud.

Status

StatusCaranya
openCard ditempatkan di bawah target dan target memakai .is-lit.
next stepGeser card (transform) dan panah (--arrow); ganti teksnya; pindahkan .is-lit.
skipped or doneHapus card dan .is-lit, lalu ingat statusnya agar tur tidak pernah tampil lagi.

Gerak dan mikrointeraksi

  • Antarlangkah, card meluncur dengan transform memakai --spring-smooth (--d-smooth, 560 ms) dan panah bergeser dengan left memakai spring yang sama, jadi mata mengikuti ke target baru tanpa kehilangan arah.
  • Teks langkah baru boleh naik masuk dengan lds-rise selama --d-standard (240 ms) dengan --ease-enter.
  • Opasitas memakai --d-standard dengan --ease-enter. Reduced motion: pergerakan menjadi perubahan linear 120 ms.

Aksesibilitas

  • role="dialog" (non-modal) dengan aria-labelledby ke judul dan aria-describedby ke isi. Pindahkan fokus ke tombol Lanjut saat terbuka, dan kembali ke target saat ditutup.
  • Escape harus melewati tur; pasang di aplikasi (tidak ada perilaku bawaan).
  • Halaman di belakangnya tetap bisa dipakai: tanpa scrim, tanpa focus trap.
  • Ring yang menyala bukan satu-satunya petunjuk; teksnya menyebut kontrolnya ("Saring per kecamatan").

Lakukan dan hindari

Lakukan

  • Tunjuk satu kontrol per langkah, paling banyak tiga langkah.
  • Selalu tawarkan Lewati, dan jangan pernah tampilkan lagi tur yang sudah selesai.
  • Mulai tur hanya setelah layar selesai dimuat dan orang sedang tidak beraktivitas.

Hindari

  • Merangkai coachmark lintas halaman.
  • Menjelaskan hal yang sudah disebut labelnya ("Ini tombol cari").
  • Menutupi kontrol yang ditunjuknya.

Perilaku dan kode

HTML biasa. Tidak ada perilaku bawaan: menempatkan card, menggeser --arrow, mengganti .is-lit, Escape dan mengingat tur yang selesai diatur oleh aplikasi.