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.

Swipe actions

Swipe actions

Swipe baris daftar ke kiri untuk menampilkan aksinya; swipe jauh atau sentil cepat untuk menjalankan aksi terakhir, lalu baris meluncur keluar dan ruangnya menutup. Baris mengikuti jari dengan tepat, dan aksi yang sama terbuka dengan tombol panah kiri.

Penggunaan

Pakai saat

  • Aksi yang sering dipakai pada baris daftar di ponsel: mengarsipkan atau menghapus pesan, menyematkan catatan, menghapus tugas.
  • Daftar tempat orang memproses item satu per satu (kotak masuk, notifikasi, daftar tugas).

Pakai yang lain saat

  • Aksi perlu pertanyaan lebih dulu dan tidak bisa diurungkan: pakai Alert dialog.
  • Aksi untuk beberapa item sekaligus: pakai Selection bar.
  • Baris dengan banyak aksi atau aksi yang jarang dipakai: pakai Context menu. Atau dropdown menu pada tombol lainnya.
  • Layar lebar yang hanya memakai mouse: pakai Confirm in place. Tampilkan aksinya langsung di baris; jadikan swipe sebagai jalan pintas.

Letaknya. Pada baris .list, satu .swipe per baris. Dua atau tiga aksi, yang berisiko di urutan terakhir (paling kanan, tempat swipe panjang berakhir).

Contoh

Baris kotak masukTarik sebuah baris ke kiri. Lewat dari setengah lebar aksi, baris tetap terbuka; lewat 60 % lebar baris, atau dengan sentilan cepat, Hapus berjalan dan baris meluncur keluar. Hanya satu baris yang terbuka dalam satu waktu. Keyboard: fokus ke baris lalu tekan panah kiri.
Laporan jalan berlubang ditanggapiDua catatan dari petugas lapangan09.41
Lokasi rekam KTP-el pindahKini di kantor kecamatan, lantai 2Kemarin
Dokumen izin usaha siap diambilAmbil sebelum hari JumatSen
<div class="list">
  <div class="swipe" data-lds-swipe>
    <div class="swipe__actions">
      <button class="swipe__act swipe__act--gray" data-swipe="pin"><span class="ic" aria-hidden="true">keep</span>Sematkan</button>
      <button class="swipe__act swipe__act--danger" data-swipe="delete" data-swipe-commit><span class="ic" aria-hidden="true">delete</span>Hapus</button>
    </div>
    <div class="swipe__row lrow" tabindex="0">…</div>
  </div>
</div>
<script type="module">
  import { toast } from 'lampung-design-system/js';
  document.addEventListener('lds:swipe', (e) => {
    if (e.detail.action !== 'delete') return;
    toast({ title: 'Pesan dihapus', action: 'Urungkan', onAction: () => { e.detail.restore(); return { title: 'Dipulihkan' }; } });
  });
</script>
Satu aksiDaftar tugas yang hanya punya Hapus. Swipe pendek menampilkannya; swipe panjang menghapus.
Fotokopi kartu keluargaSyarat izin usahaHari ini
Bayar pajak kendaraanRp 450.000Besok
<div class="list" style="width: 100%; max-width: 420px;">
  <div class="swipe" data-lds-swipe><div class="swipe__actions"><button class="swipe__act swipe__act--danger" data-swipe="delete" data-swipe-commit><span class="ic" aria-hidden="true">delete</span>Hapus</button></div><div class="swipe__row lrow" tabindex="0"><span class="lrow__body"><span class="lrow__title">Fotokopi kartu keluarga</span><span class="lrow__sub">Syarat izin usaha</span></span><span class="lrow__value">Hari ini</span></div></div>
  <div class="swipe" data-lds-swipe><div class="swipe__actions"><button class="swipe__act swipe__act--danger" data-swipe="delete" data-swipe-commit><span class="ic" aria-hidden="true">delete</span>Hapus</button></div><div class="swipe__row lrow" tabindex="0"><span class="lrow__body"><span class="lrow__title">Bayar pajak kendaraan</span><span class="lrow__sub">Rp 450.000</span></span><span class="lrow__value">Besok</span></div></div>
</div>

Anatomi

BagianFungsinya
.swipeWajib. data-lds-swipe. Pembungkus baris; tingginya menyusut saat baris dihapus (.is-gone).
.swipe__actionsWajib. Tombol-tombol di balik baris; inert sampai dibuka.
.swipe__actWajib. Masing-masing selebar 76 px: --gray, --accent, --danger. data-swipe="name"; data-swipe-commit pada yang terakhir membuat swipe panjang menjalankannya.
.swipe__rowWajib. Baris yang terlihat (sebuah .lrow), tabindex="0".

Status

StatusCaranya
closedBaris diam; aksi inert.
draggingBaris mengikuti jari 1:1; aksi melebar bersamanya; menarik ke kanan memberi efek rubber-band.
openBaris berhenti di minus lebar aksi; aksi masuk urutan tab.
full.is-full saat ditarik 40 px melewati aksi: aksi terakhir meregang mengisi ruang, menandakan melepas jari akan menjalankannya.
gone.is-gone: baris meluncur keluar dan tingginya menutup. restore() mengembalikannya.

Gerak dan mikrointeraksi

  • Memutuskan: gerakan 8 px menentukan swipe (dominan horizontal) atau scroll (dominan vertikal); scroll tidak pernah menggeser baris.
  • Mengikuti: transisi mati, baris bergerak 1:1; melewati tepi kanan, baris memberi efek rubber-band (over × 40 × 0.55 / (40 + 0.55 × |over|)).
  • Melepas: posisi akhir yang diproyeksikan = posisi + kecepatan × 0,1 detik. Terbuka bila lewat setengah lebar aksi, jika tidak menutup; keduanya dengan --spring-smooth (560 ms).
  • Menjalankan: lewat 60 % lebar baris, atau sentilan lebih cepat dari 900 px/detik melewati aksi, baris meluncur keluar sepenuhnya dengan --ease-inout dalam --d-standard (240 ms), lalu .swipe menutup tingginya dengan --spring-smooth. Haptic medium menandai aksi yang dijalankan.
  • Interupsi: menyentuh baris lain menutup baris yang terbuka; mengetuk baris yang terbuka menutupnya.
  • Reduced motion: tarikan tetap mengikuti jari; gerak kembali dan penutupan tinggi berlangsung 120 ms.

Aksesibilitas

  • Baris bisa difokus (tabindex="0"). Panah kiri membuka aksi, Tab berpindah di antaranya, panah kanan atau Escape menutup baris.
  • Setiap aksi adalah tombol sungguhan dengan label; aksi berisiko tetap perlu menawarkan Urungkan (toast dengan aksi).
  • Ajarkan gesturnya dengan petunjuk pada kunjungan pertama, dan sediakan aksi yang sama di tempat yang terlihat (menu baris) untuk orang yang tidak memakai swipe.

Lakukan dan hindari

Lakukan

  • Taruh aksi berisiko di urutan terakhir, dengan data-swipe-commit.
  • Tawarkan Urungkan setelah menghapus lewat restore().
  • Cukup dua atau tiga aksi.

Hindari

  • Menjadikan swipe satu-satunya jalan ke sebuah aksi.
  • Menaruh baris swipe di dalam scroller horizontal atau carousel.
  • Menjalankan aksi berisiko tanpa jalan kembali.

Perilaku dan kode

HTML biasa. [data-lds-swipe] saat init(). lds:swipe (bubbles) membawa { action, restore }, dengan action berisi data-swipe milik tombolnya. Mengetuk aksi biasa memancarkan event itu dan menutup baris; aksi commit (dan swipe panjang atau sentilan) menghapus baris lebih dulu.