Like
Memberi dukungan bersifat optimistis: hati terisi, memantul, dan melontarkan tujuh percikan begitu ditekan, dan jumlahnya bergulir naik, sebelum server menjawab. Jika server menolak, semuanya kembali dengan goyangan dan alasannya ditampilkan.
Penggunaan
Pakai saat
- Mendukung kiriman, jawaban, atau komentar, saat jumlahnya menjadi bukti sosial: jawaban di forum warga, usulan musrenbang, pengumuman kelurahan.
- Toggle apa pun yang hampir pasti berhasil dan mudah dibatalkan, sehingga menunggu server hanya menambah jeda.
Pakai yang lain saat
- Menyimpan sesuatu untuk diri sendiri (bookmark, sematkan): pakai Icon swap. Toggle yang tenang; tanpa ledakan, tanpa jumlah.
- Menilai dengan skala: pakai Rating.
- Menyalakan pengaturan: pakai Switch.
- Memilih filter atau tag: pakai Chips.
Letaknya. Di bawah atau di samping konten yang didukung, di awal baris aksinya: kaki kartu, di bawah jawaban forum, di baris aksi pesan chat bila jumlahnya penting.
Contoh
Lampu jalan di Jalan Pagar Alam sering padam
Usul agar tiga tiang dekat halte diganti lampu baru. Sudah gelap total selama empat malam.
<div class="card" style="max-width: 460px;"> <p class="card__title">Lampu jalan di Jalan Pagar Alam sering padam</p> <p class="card__sub" style="margin-top: 6px;">Usul agar tiga tiang dekat halte diganti lampu baru. Sudah gelap total selama empat malam.</p> <div class="docs-row" style="margin-top: 14px;"><button class="like" aria-pressed="false" data-lds-like aria-label="Suka"><span class="like__heart"><span class="ic" aria-hidden="true">favorite</span></span><span class="roll" data-lds-roll="128"></span></button><button class="btn btn--plain btn--sm">Balas</button></div> </div>
<button class="like" aria-pressed="false" data-lds-like aria-label="Suka">
<span class="like__heart"><span class="ic" aria-hidden="true">favorite</span></span>
<span class="roll" data-lds-roll="41"></span>
</button>
<script type="module">
import { likeRevert } from 'lampung-design-system/js';
btn.addEventListener('lds:change', async (e) => {
try { await saveLike(e.detail.pressed); }
catch { likeRevert(btn); showReason('Dukungan Anda gagal disimpan. Anda sedang offline.'); }
});
</script>Anatomi
| Bagian | Fungsinya |
|---|---|
button.like | Wajib. aria-pressed, aria-label="Suka", data-lds-like. Pil 36 px dengan isian tenang. |
.like__heart | Wajib. Berisi ikon favorite; JS menambahkan tujuh titik .like__spark. |
.roll | Jumlah opsional, data-lds-roll="<n>"; bergulir satu angka saat di-toggle. |
Status
| Status | Caranya |
|---|---|
off | aria-pressed="false": hati bergaris pada isian tenang. |
on | aria-pressed="true": hati terisi merah bahaya pada warna bahaya tipis; jumlah naik satu. |
burst | .is-burst untuk satu kali main saat dinyalakan: tujuh percikan terlontar. |
reverted | likeRevert(btn): kembali mati, jumlah kembali, goyangan, haptic error. |
Gerak dan mikrointeraksi
- Tekan: pil mengecil ke 0,94 dalam 90 ms dan memantul kembali dengan
--spring-snappy. - Hati:
lds-heartselama 420 ms dengan--spring-momentum: dari 0,6 ke 1,18 pada 55 %, lalu 1. Pantulan lebihnya pantas: ini perayaan atas tindakan yang disengaja. - Percikan: tujuh titik 4 px dengan jarak 51 derajat bergerak dari 6 ke 17 px keluar sambil memudar dan mengecil ke 0,3, 520 ms dengan
--ease-enter. Hanya saat dinyalakan. - Jumlah: digit
.rollbergulir dengan--spring-smooth. Warna dan isian berubah selama--d-fast. - Interupsi: menekan lagi di tengah ledakan langsung mematikannya; ledakan tidak perlu selesai.
- Reduced motion: tanpa percikan, tanpa pantulan; isian dan jumlah berubah dalam 120 ms.
Aksesibilitas
<button>denganaria-presseddanaria-label="Suka"; jumlahnya dibacakan lewataria-labelmilik roll. Sebut objeknya bila ada banyak:aria-label="Dukung usulan ini".- Hati terisi bukan satu-satunya sinyal:
aria-presseddan warna seluruh pil juga berubah. - Dukungan yang ditolak dijelaskan dengan teks di sampingnya, bukan hanya dengan goyangan.
Lakukan dan hindari
Lakukan
- Perbarui UI lebih dulu, baru panggil server.
- Kembalikan dengan
likeRevertdan sertakan alasannya saat gagal. - Satu like per item.
Hindari
- Menunggu server sebelum mengisi hati.
- Memainkan ledakan saat membatalkan like atau saat halaman dimuat.
- Memakai ledakan like untuk menyimpan atau bookmark.
Perilaku dan kode
HTML biasa. [data-lds-like] saat init(): mengubah aria-pressed, memainkan ledakan, menggulirkan jumlah, haptic light, dan memancarkan lds:change dengan { pressed }. likeRevert(btn) membatalkan toggle terakhir dan menggoyangkan tombol.