Chat layout
Kolom percakapan: pesan bertumpuk dengan jarak 20 px di .chat, riwayat bergulir di atas composer yang tidak ikut tergulir, dan tombol Terbaru yang muncul hanya saat pembaca menggulir ke atas. Pesan terbaru selalu di bawah.
Penggunaan
Pakai saat
- Percakapan dengan asisten atau tutor: orang bertanya di kanan, jawaban mengisi kolom baca, pesan terbaru di bawah.
- Utas layanan pengaduan atau umpan balik yang urutan dan waktunya penting, dan orang membalas dari layar yang sama.
- Riwayat yang cukup panjang untuk digulir, saat orang membaca ke belakang dan butuh cara kembali ke pesan terbaru.
Pakai yang lain saat
- Riwayat kejadian tanpa kotak balasan (perubahan nilai, pembaruan status): pakai Timeline.
- Komentar yang masing-masing melekat pada bagian dokumen atau berkas permohonan: pakai List. Letakkan di samping hal yang dibahas, bukan dalam satu kolom.
- Satu jawaban yang dibuat di dalam halaman tanpa tanya jawab: pakai Prose. Tampilkan thinking selama proses dan streaming text saat jawaban datang.
- Daftar notifikasi: pakai List.
- Penjelasan singkat untuk satu pertanyaan, di tempat: pakai Popover.
Letaknya. Kolom utama halaman atau panel setinggi layar di samping pekerjaan yang dibahas (resizable split di layar lebar). Riwayat adalah area gulir; composer ada di bawahnya, di luar area gulir, selebar kolom. Di ponsel kolom memenuhi layar dan composer duduk di atas keyboard dengan inset safe-area (safe-bottom). Batasi lebar kolom paling lebar 640 px di layar lebar agar jawaban tetap mudah dibaca.
Contoh
Hari ini, 09.12
<div class="chat-scroll" id="chat-scroll"><!-- your scroller: overflow-y: auto, flex: 1 -->
<div class="chat" role="log" aria-label="Percakapan dengan tutor Anda">
<p class="msg msg--system">Hari ini, 09.12</p>
<div class="msg msg--me"><div class="bubble">Kenapa jawaban saya untuk soal nomor 4 disalahkan?</div><span class="msg__meta">09.12</span></div>
<div class="msg msg--ai"><div class="bubble">Soal nomor 4 menanyakan gaya total…</div>
<div class="msg__actions">…</div>
</div>
<button class="btn btn--secondary btn--sm chat__jump" data-lds-jump="chat-scroll"><span class="ic" aria-hidden="true">arrow_downward</span>Terbaru</button>
</div>
</div>
<form class="composer" data-lds-composer>
<textarea rows="1" aria-label="Kirim pesan ke tutor" placeholder="Tanyakan tentang materi ini"></textarea>
<button class="composer__send" type="submit" aria-label="Kirim"><span class="ic" aria-hidden="true">arrow_upward</span></button>
</form>
<script type="module">
import { init } from 'lampung-design-system/js';
init();
document.querySelector('.composer').addEventListener('lds:send', (e) => sendToTutor(e.detail.text));
</script>Kemarin
Mode ujian aktif. Petunjuk disembunyikan sampai Anda mengumpulkan jawaban.
Anda melampirkan draf-laporan-praktikum.pdf
Hari ini
<div class="chat" role="log" aria-label="Latihan ujian" style="max-width: 560px;"> <p class="msg msg--system">Kemarin</p> <div class="msg msg--me"><div class="bubble">Uji saya tentang bab 3, sepuluh soal.</div></div> <div class="msg msg--ai"><div class="bubble">Silakan mulai kapan saja. Setiap soal punya empat pilihan; jawab dengan hurufnya.</div></div> <p class="msg msg--system">Mode ujian aktif. Petunjuk disembunyikan sampai Anda mengumpulkan jawaban.</p> <p class="msg msg--system">Anda melampirkan draf-laporan-praktikum.pdf</p> <p class="msg msg--system">Hari ini</p> <div class="msg msg--me"><div class="bubble">Kumpulkan jawaban saya.</div></div> </div>
Tanya tentang Biologi kelas X
Jawaban memakai catatan pelajaran Anda dan menyebut halaman sumbernya.
<div class="empty"> <div class="empty__icon"><span class="ic" aria-hidden="true">school</span></div> <p class="empty__title">Tanya tentang Biologi kelas X</p> <p class="empty__body">Jawaban memakai catatan pelajaran Anda dan menyebut halaman sumbernya.</p> </div> <div class="chip-row"> <button class="chip">Jelaskan osmosis dengan sederhana</button> <button class="chip">Uji saya tentang bagian sel</button> </div> <form class="composer" data-lds-composer>…</form> <!-- On a chip click: put its text in the textarea, dispatch 'input' (enables send), focus it. -->
Anatomi
| Bagian | Fungsinya |
|---|---|
.chat | Wajib. Kolom pesan (flex, jarak 20 px). Beri role="log" dan label. |
.msg | Wajib. Satu pesan; lihat chat message untuk --me, --ai dan bagian di dalamnya. |
.msg--system | Baris di tengah dengan huruf footnote untuk hal yang berubah dalam percakapan: pergantian hari, seseorang bergabung, mode yang dinyalakan. |
.chat__jump | Tombol sekunder kecil, anak terakhir .chat, dengan data-lds-jump="<scroller id>". Menempel 88 px di atas dasar area gulir dan hanya tampil saat pembaca berjarak lebih dari 160 px dari ujung. |
.composer | Kotak balasan di bawah area gulir; lihat composer. |
Status
| Status | Caranya |
|---|---|
empty | Belum ada pesan: empty state dengan dua atau tiga chip pembuka di atas composer. |
scrolled up | .chat__jump.is-visible begitu area gulir berjarak lebih dari 160 px dari ujung; tombol hilang lagi di bawah. |
assistant working | Pesan terakhir berupa baris thinking, lalu balasan mengalir masuk (streaming text). |
new message | .msg.is-new naik 8 px dan memudar masuk sekali saat disisipkan; riwayat tanpa is-new langsung tampil. |
Gerak dan mikrointeraksi
- Setiap
.msg.is-newmasuk sekali denganlds-msg-in(beriis-newhanya untuk pesan yang datang saat chat terbuka): dari 8 px di bawah dan transparan, selama--d-smooth(560 ms) dengan--spring-smooth. Saat pesan datang, tidak ada yang bergerak di kolom selain pesan baru itu. - Tombol Terbaru memudar selama
--d-fastdan naik 8 px dengan--spring-smooth; ini transition, jadi menggulir bolak-balik membaliknya dari posisi saat itu. - Lompatan menggulir dengan
behavior: smooth; dengan reduced motion langsung melompat. - Pesan yang dirender sekaligus (membuka percakapan lama) juga memainkan animasi masuk pada saat yang sama. Render riwayat sebelum menyisipkannya, atau terima satu fade bersama; jangan pernah memberi stagger pada seluruh riwayat.
- Reduced motion: animasi masuk menjadi fade 1 ms (praktis instan) dan tombol lompat cross-fade dalam 120 ms.
Aksesibilitas
- Beri
.chatrole="log"danaria-label; pesan baru lalu diumumkan secara sopan (polite). Selama balasan mengalir, pasangaria-busy="true"pada pesan itu dan hapus setelah selesai agar balasan dibacakan sekali, utuh. - Baris sistem berupa teks biasa (
<p>), bukan live region tersendiri; log yang mengumumkannya. - Textarea composer perlu label (
aria-labelatau label yang terlihat); lihat composer. - Tombol Terbaru adalah tombol sungguhan dengan label yang terlihat. Saat tersembunyi ia transparan tetapi masih bisa difokus: render hanya saat dibutuhkan jika pengguna keyboard melaporkannya.
Lakukan dan hindari
Lakukan
- Letakkan composer di luar area gulir agar tidak ikut tergulir.
- Hentikan gulir otomatis saat pembaca menggulir ke atas; tampilkan tombol Terbaru.
- Pakai baris sistem untuk hal yang dilakukan percakapan dengan sendirinya (mode, berkas, hari).
Hindari
- Menganimasikan seluruh riwayat masuk, atau memberi stagger pada pesan lama.
- Memasang stempel waktu di setiap pesan; kelompokkan per hari dengan baris sistem dan tampilkan jam saat hover atau di meta pesan.
- Membangun chat dari card atau baris list.
Perilaku dan kode
HTML biasa. Perilaku berasal dari init(): [data-lds-jump="<scroller id>"] pada tombol Terbaru menampilkannya saat area gulir berjarak lebih dari 160 px dari ujung dan menggulir ke ujung saat diklik; [data-lds-composer] memasang perilaku composer (Enter mengirim, lds:send membawa { text }). Di React, render markup yang sama dan panggil init(ref.current) di effect setelah pesan dirender.