Chat message
Satu giliran dalam percakapan. Kata-kata Anda ada di bubble aksen di kanan; asisten menjawab dengan teks baca biasa di kolom, dengan baris aksi yang tenang di bawahnya. Baris sistem berupa footnote di tengah.
Penggunaan
Pakai saat
- Menampilkan apa yang dikirim orang (
msg--me) dan apa yang dijawab asisten (msg--ai) di dalam chat layout. - Jawaban yang perlu aksi lanjutan: salin, coba lagi, bagikan.
- Baris tentang percakapan itu sendiri (
msg--system): pergantian hari, mode yang dinyalakan, berkas yang dilampirkan.
Pakai yang lain saat
- Komentar pada dokumen atau catatan pemeriksaan: pakai List.
- Kutipan dari sumber di dalam jawaban: pakai Quote.
- Pesan yang memberi tahu sesuatu tentang aplikasi (tersimpan, offline): pakai Toast.
- Kejadian dalam riwayat tanpa percakapan: pakai Timeline.
- Langkah yang diambil asisten (mencari, membaca berkas): pakai Tool call.
Letaknya. Di dalam .chat. msg--me rata kanan, paling lebar 88 % kolom (maksimal 520 px); msg--ai memakai lebar baca penuh (maksimal 640 px); msg--system di tengah. Meta langsung di bawah bubble; aksi hanya di bawah jawaban asisten, sejajar dengan teks.
Contoh
<div class="chat" role="log" aria-label="Percakapan" style="max-width: 560px;">
<div class="msg msg--me"><div class="bubble">Apa beda mitosis dan meiosis?</div><span class="msg__meta">09.41</span></div>
<div class="msg msg--ai">
<div class="bubble">Mitosis menghasilkan dua sel yang sama persis dengan sel induk, untuk pertumbuhan dan perbaikan. Meiosis menghasilkan empat sel yang masing-masing berisi separuh kromosom, untuk reproduksi, dan mengacak gen di prosesnya sehingga setiap sel berbeda.</div>
<div class="msg__actions"><button class="icon-btn" aria-label="Salin jawaban" data-lds-copy="Mitosis menghasilkan dua sel identik; meiosis menghasilkan empat sel dengan separuh kromosom."><span class="swap" aria-hidden="true"><span class="ic swap__a">content_copy</span><span class="ic swap__b">check</span></span></button><button class="icon-btn" aria-label="Coba lagi"><span class="ic" aria-hidden="true">refresh</span></button><button class="icon-btn" aria-label="Bagikan jawaban"><span class="ic" aria-hidden="true">share</span></button></div>
</div>
</div><div class="chat" style="max-width: 560px;">
<div class="msg msg--me"><div class="bubble">Bagaimana cara menghitung jumlah baris di tabel nilai?</div></div>
<div class="msg msg--ai">
<div class="bubble prose">
<p>Pakai <code class="code">SELECT COUNT(*) FROM grades;</code> untuk menghitung semua baris, termasuk baris dengan nilai kosong.<a class="cite" href="#">1</a></p>
<p>Untuk menghitung tugas yang sudah dinilai saja, sebut kolomnya: <code class="code">COUNT(score)</code> melewati baris yang nilainya kosong.<a class="cite" href="#">2</a></p>
</div>
<div class="msg__actions"><button class="icon-btn" aria-label="Salin jawaban" data-lds-copy="SELECT COUNT(*) FROM grades;"><span class="swap" aria-hidden="true"><span class="ic swap__a">content_copy</span><span class="ic swap__b">check</span></span></button><button class="icon-btn" aria-label="Coba lagi"><span class="ic" aria-hidden="true">refresh</span></button></div>
</div>
</div><div class="chat" style="max-width: 560px;"> <div class="msg msg--me"><div class="bubble">Ingatkan saya tugas apa yang harus dikumpulkan hari Jumat.</div><span class="msg__meta"><time class="timestamp" data-lds-time="2026-11-16T08:05:00+07:00"></time></span></div> <div class="msg msg--me"><div class="bubble">Laporan praktikum juga, ya.</div><span class="msg__meta">Diedit</span></div> <div class="msg msg--me"><div class="bubble">Dan bacaan untuk minggu ke-6.</div><span class="field__help field__help--error"><span class="ic" aria-hidden="true">error</span>Tidak terkirim. Anda sedang offline.<button class="btn btn--plain btn--sm">Coba lagi</button></span></div> </div>
Anda beralih ke mode ujian. Petunjuk disembunyikan sampai Anda mengumpulkan jawaban.
<div class="chat" style="max-width: 560px;"> <p class="msg msg--system">Anda beralih ke mode ujian. Petunjuk disembunyikan sampai Anda mengumpulkan jawaban.</p> </div>
Anatomi
| Bagian | Fungsinya |
|---|---|
.msg | Wajib. Pembungkus pesan: kolom dengan jarak 6 px antara bubble, meta dan aksi. |
.msg--me / .msg--ai / .msg--system | Wajib. Siapa yang berbicara. Satu per pesan. |
.bubble | Wajib untuk me dan ai. Isi pesan. Isian aksen dengan sudut ekor 6 px untuk --me; tanpa isian dan tanpa padding untuk --ai, jadi jawaban terbaca seperti halaman. |
.msg__meta | Baris keterangan opsional: jam, "Diedit", "Tidak terkirim". Pakai timestamp untuk waktu. |
.msg__actions | Baris opsional berisi icon button 36 px di bawah jawaban: salin (dengan icon swap), coba lagi, bagikan. |
Varian dan ukuran
| Kelas atau atribut | Kapan |
|---|---|
msg--me | Yang dikirim orang. Rata kanan, bubble aksen, sudut kanan bawah lebih kecil (6 px) sebagai ekor. |
msg--ai | Jawaban asisten. Teks biasa selebar penuh; tambahkan prose pada bubble jika jawaban berisi paragraf, daftar atau tabel. |
msg--system | Footnote di tengah tentang percakapan itu sendiri. |
Status
| Status | Caranya |
|---|---|
arriving (.is-new) | Tambahkan is-new pada pesan yang datang saat chat terbuka: pesan naik 8 px dan memudar masuk sekali (lds-msg-in). Riwayat yang dimuat sekaligus tidak memakai is-new dan langsung tampil. |
streaming | Bubble berupa .stream.is-streaming dengan caret; lihat streaming text. Sembunyikan .msg__actions sampai selesai. |
edited | "Diedit" di .msg__meta. |
not sent | Baris error di bawah bubble dengan tombol Coba lagi (di sini memakai field__help--error; belum ada kelas error khusus pesan). |
copied | Ikon salin berganti menjadi tanda centang selama 1,6 detik (copy button). |
Gerak dan mikrointeraksi
- Masuk:
lds-msg-in, naik 8 px plus fade,--d-smooth(560 ms) dengan--spring-smooth. Diputar sekali, hanya pada pesan denganis-new(dikirim atau diterima saat chat terbuka), jadi riwayat panjang tidak pernah beranimasi sebagai satu blok. - Aksi: icon button mengecil ke 0,9 saat ditekan dalam 90 ms; salin mengganti glyph-nya dengan resep icon swap (yang lama mengecil ke 0,5 dan blur 4 px, yang baru mendarat dengan
--spring-snappy). - Tanpa efek naik saat hover, tanpa bubble membesar, tanpa titik mengetik: asisten menunjukkan prosesnya dengan thinking dan teksnya dengan streaming text.
- Reduced motion: animasi masuk praktis instan (1 ms) dan icon swap cross-fade dalam 120 ms.
Aksesibilitas
- Pesan adalah elemen biasa di dalam kolom
role="log"; jangan beri tiap pesan live region sendiri. - Jika pembicara tidak jelas dari tata letak saja, tambahkan teks tersembunyi "Anda berkata" / "Tutor berkata" (
sr-only) di awal setiap pesan. - Setiap aksi adalah icon button dengan
aria-labelyang menyebut objeknya: "Salin jawaban", bukan "Salin". - Pesan yang gagal menyebutkannya dengan teks ("Tidak terkirim. Anda sedang offline.") dengan tombol Coba lagi di sebelahnya.
Lakukan dan hindari
Lakukan
- Biarkan jawaban berupa teks di kolom; tambahkan
proseuntuk struktur. - Tampilkan aksi hanya di bawah jawaban yang sudah selesai.
- Sebut sumber dengan sitasi di dalam jawaban.
Hindari
- Menaruh asisten di bubble abu-abu atau memberinya avatar di setiap giliran.
- Menampilkan stempel waktu di bawah setiap pesan; utamakan baris hari dan meta di pesan terbaru.
- Mewarnai pesan gagal dengan merah tanpa kata-kata.
Perilaku dan kode
HTML biasa. Tidak punya perilaku sendiri. Aksi salin memakai data-lds-copy (copy button); waktu memakai data-lds-time (timestamp); panggil init() pada pesan baru agar keduanya terpasang.