Pull to refresh
Tarik daftar di ponsel ke bawah dari atas: konten mengikuti dengan hambatan, spinner berputar saat masuk, dan setelah melewati 56 px, melepas jari akan memuat ulang. Spinner bertahan sampai pekerjaan selesai, minimal 700 ms agar tidak berkedip.
Penggunaan
Pakai saat
- Daftar di ponsel yang isinya berubah di server saat orang sedang melihatnya: jadwal, aktivitas, kotak masuk.
- Layar yang dibuka orang untuk mengecek apakah ada yang baru.
Pakai yang lain saat
- Daftar yang memperbarui dirinya secara real time: pakai Status dot. Tunjukkan bahwa daftar itu live.
- Memuat halaman berikutnya di bawah daftar: pakai Spinner.
- Tabel di desktop: pakai Table. Pakai tombol Muat ulang di toolbar-nya.
Letaknya. Pada .phone__scroll di layar tingkat atas, dengan indikator .refresh sebagai anak pertama dan .navbar-gap sebagai pengisi ruang. Spinner muncul di antara nav bar dan judul besar.
Contoh
Hari ini
<div class="phone__scroll" data-lds-navbar="today-bar" data-lds-refresh>
<div class="refresh" aria-hidden="true"><span class="spinner" aria-hidden="true"><i></i><i></i><i></i><i></i><i></i><i></i><i></i><i></i></span></div>
<div class="navbar-gap"></div>
<h1 class="large-title">Hari ini</h1>
…
</div>
<script type="module">
import { toast } from 'lampung-design-system/js';
scroller.addEventListener('lds:refresh', (e) => e.detail.wait(loadSchedule().then(() => toast({ title: 'Jadwal sudah terbaru' }))));
</script>Anatomi
| Bagian | Fungsinya |
|---|---|
.phone__scroll[data-lds-refresh] | Wajib. Elemen yang di-scroll. Anak-anaknya (kecuali pengisi ruang dan indikator) bergeser turun sebesar --pull. |
.refresh | Wajib. Berisi spinner yang opacity dan putarannya mengikuti --pull-p (0 sampai 1). aria-hidden. |
Status
| Status | Caranya |
|---|---|
.is-pulling | Mengikuti jari; tanpa transisi. |
.is-refreshing | Tertahan di 56 px dengan spinner berputar; aria-busy="true" pada elemen scroll. |
Gerak dan mikrointeraksi
- Tarikan mengikuti jari dengan hambatan:
over·200·0.55 / (200 + 0.55·over), jadi makin melambat saat makin jauh dan tidak pernah melewati 200 px. - Spinner muncul perlahan dan berputar hingga 270° mengikuti tarikan, dan baru berputar terus setelah pemuatan ulang berjalan.
- Dilepas sebelum 56 px: konten memantul kembali dengan
--spring-smooth. Lewat dari itu: konten berhenti di 56 px, tertahan selama bekerja (minimal 700 ms), lalu memantul kembali. - Reduced motion: gerak kembali menjadi 120 ms linear; tarikan tetap mengikuti jari.
Aksesibilitas
- Tarikan tidak pernah menjadi satu-satunya cara: sediakan tombol Muat ulang atau muat ulang saat layar dibuka lagi, dan panggil
startRefresh(scroller)dari sana. - Sampaikan hasilnya dengan kata-kata (toast seperti "Jadwal sudah terbaru"), bukan hanya dengan hilangnya spinner.
- Elemen scroll mendapat
aria-busy="true"selama memuat ulang.
Lakukan dan hindari
Lakukan
- Pakai hanya di layar yang isinya bisa berubah saat orang melihatnya.
- Tunggu permintaan sebenarnya dengan
e.detail.wait(promise).
Hindari
- Menambahkannya ke layar di dalam sheet atau formulir yang didorong masuk.
- Menampilkan spinner kedua di daftar pada saat yang sama.
Perilaku dan kode
HTML biasa. data-lds-refresh pada elemen scroll: tarikan sentuh (overscroll bawaan ditahan selama menarik) dan tarikan mouse dari atas. Memicu lds:refresh dengan wait(promise) pada elemen scroll. startRefresh(scroller) menjalankannya tanpa gestur; tombol dengan data-lds-refresh-for="scrollerId" melakukan hal yang sama tanpa skrip.