Inline edit
Klik sebuah nama untuk mengganti namanya di tempat: teks menjadi kolom dengan font dan lebar yang sama, Enter atau meninggalkan kolom menyimpan, Escape mengembalikannya. Penyimpanan menggambar centang kecil; penyimpanan yang ditolak mengembalikan nama lama, bergoyang, dan menjelaskan alasannya.
Penggunaan
Pakai saat
- Mengganti nama satu hal di tempatnya: kegiatan, berkas, judul catatan, nama grup.
- Satu nilai pendek yang jarang diubah dan ingin diubah tanpa membuka formulir.
Pakai yang lain saat
- Beberapa kolom diubah bersama: pakai Form layout.
- Teks panjang (deskripsi, jawaban): pakai Textarea.
- Nilai yang dipilih dari daftar: pakai Select.
- Pengaturan yang langsung berlaku: pakai Switch.
Letaknya. Pada judulnya sendiri: judul halaman, judul kartu, judul baris daftar. Ikon pensil muncul saat hover dan fokus di ujung teks.
Contoh
<h1><span class="inline-edit" data-lds-inline>
<button class="inline-edit__text" aria-label="Ganti nama kegiatan"><span class="inline-edit__value">Vaksinasi balita Mei</span><span class="ic" aria-hidden="true">edit</span></button>
</span></h1>
<script type="module">
document.querySelector('[data-lds-inline]').addEventListener('lds:save', (e) => {
e.detail.wait(api.rename(e.detail.value)); // rejection restores e.detail.previous, shakes, announces
});
</script><div class="list" style="width: 100%; max-width: 440px;"> <div class="lrow"><span class="ic" aria-hidden="true">description</span><span class="lrow__body"><span class="inline-edit" data-lds-inline><button class="inline-edit__text" aria-label="Ganti nama Notulen rapat RW"><span class="inline-edit__value">Notulen rapat RW</span><span class="ic" aria-hidden="true">edit</span></button></span></span><span class="lrow__value">340 KB</span></div> <div class="lrow"><span class="ic" aria-hidden="true">description</span><span class="lrow__body"><span class="inline-edit" data-lds-inline><button class="inline-edit__text" aria-label="Ganti nama Denah lokasi usaha"><span class="inline-edit__value">Denah lokasi usaha</span><span class="ic" aria-hidden="true">edit</span></button></span></span><span class="lrow__value">1,1 MB</span></div> </div>
Anatomi
| Bagian | Fungsinya |
|---|---|
.inline-edit | Wajib. data-lds-inline. Mewarisi font dari tempatnya berada. |
.inline-edit__text | Wajib. Tombol yang menampilkan nilai; aria-label menyebut apa yang diganti namanya ("Ganti nama kegiatan"). |
.inline-edit__value | Wajib. Teks nilainya. |
.inline-edit__input | Kolom yang menggantikan teks saat mengedit (dibuat oleh JS), ukuran sama, cincin aksen. |
.inline-edit__state | Centang yang digambar setelah tersimpan (dibuat oleh JS). |
Status
| Status | Caranya |
|---|---|
rest | Tombol teks; pensil tersembunyi. |
hover / focus | Latar berwarna tipis dan pensil muncul perlahan selama --d-fast. |
editing | Input dengan font yang sama, minimal selebar teks (minimum 80 px), seluruh teks terpilih. |
saved | .is-saved: centang tergambar dalam 300 ms dan hilang setelah 1,8 detik; "Tersimpan" diumumkan. |
refused | Nilai lama kembali, pembungkus bergoyang, dan "Gagal menyimpan. Nama sebelumnya dikembalikan." diumumkan. |
Gerak dan mikrointeraksi
- Kolom masuk:
lds-blur-inselama--d-fast(160 ms) dengan--ease-enter, dari 4 px di bawah dan kabur, dengan ukuran sama seperti teks, jadi tidak ada yang bergeser di sekitarnya. - Tersimpan: garis centang tergambar (
lds-draw) dalam 300 ms dengan--ease-enter. - Ditolak:
shake()pada pembungkus (360 ms) ditambah haptic error. - Reduced motion: kolom langsung muncul, centang tampil tanpa digambar, tanpa goyangan.
Aksesibilitas
- Nilainya adalah tombol sungguhan yang
aria-label-nya menyebut aksi dan objek ("Ganti nama kegiatan"). Input memakai label yang sama. - Enter menyimpan, Escape membatalkan dan mengembalikan fokus ke tombol, Tab menyimpan (blur).
- Hasil diumumkan lewat status polite di dalam komponen.
Lakukan dan hindari
Lakukan
- Pakai untuk satu nilai pendek.
- Berikan promise penyimpanan ke
e.detail.wait()agar kegagalan dibatalkan. - Sebut objeknya di
aria-label.
Hindari
- Merangkai beberapa inline edit sebagai formulir.
- Menyimpan di setiap ketikan.
- Mengubah ukuran font atau lebar saat kolom muncul.
Perilaku dan kode
HTML biasa. [data-lds-inline] saat init(). Memancarkan lds:save dengan { value, previous, wait } hanya bila nilainya berubah dan tidak kosong; wait(promise) menampilkan centang bila berhasil, atau mengembalikan, menggoyang, dan mengumumkan bila ditolak.