Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Chat Message

    Pesan dalam percakapan AI. Gelembung user di kanan, balasan asisten dengan avatar, aksi saat hover, indikator mengetik, dan efek streaming token opsional.

    Can you draft an invoice in Rupiah for a website project?

    Markas AI

    Sure. Here is a simple layout for it: Design and build, Rp 12.500.000 VAT 11%, Rp 1.375.000 Total due, Rp 13.875.000
    Add a 14 day payment term, please.

    Markas AI

    Typing
    Can you draft an invoice in Rupiah for a website project?

    Markas AI

    Sure. Here is a simple layout for it: Design and build, Rp 12.500.000 VAT 11%, Rp 1.375.000 Total due, Rp 13.875.000
    Add a 14 day payment term, please.

    Markas AI

    Typing
    Can you draft an invoice in Rupiah for a website project?

    Markas AI

    Sure. Here is a simple layout for it: Design and build, Rp 12.500.000 VAT 11%, Rp 1.375.000 Total due, Rp 13.875.000
    Add a 14 day payment term, please.

    Markas AI

    Typing
    Can you draft an invoice in Rupiah for a website project?

    Markas AI

    Sure. Here is a simple layout for it: Design and build, Rp 12.500.000 VAT 11%, Rp 1.375.000 Total due, Rp 13.875.000
    Add a 14 day payment term, please.

    Markas AI

    Typing
    Can you draft an invoice in Rupiah for a website project?

    Markas AI

    Sure. Here is a simple layout for it: Design and build, Rp 12.500.000 VAT 11%, Rp 1.375.000 Total due, Rp 13.875.000
    Add a 14 day payment term, please.

    Markas AI

    Typing
    @php
        $log = 'grid gap-4';
        $answer = "Sure. Here is a simple layout for it:\nDesign and build, Rp 12.500.000\nVAT 11%, Rp 1.375.000\nTotal due, Rp 13.875.000";
    @endphp
    
    <div role="log" aria-label="Conversation" class="{{ $log }}">
        <x-markas.chat-message from="user" text="Can you draft an invoice in Rupiah for a website project?" time="10:24" />
        <x-markas.chat-message :text="$answer" time="10:24" assistant-label="Markas AI" />
        <x-markas.chat-message from="user" text="Add a 14 day payment term, please." time="10:25" />
        <x-markas.chat-message typing assistant-label="Markas AI" />
    </div>
    import { ChatMessage } from "@/components/markas/ChatMessage";
    
    const log = "grid gap-4";
    const answer =
      "Sure. Here is a simple layout for it:\nDesign and build, Rp 12.500.000\nVAT 11%, Rp 1.375.000\nTotal due, Rp 13.875.000";
    
    export default function ChatMessageExample() {
      return (
        <div role="log" aria-label="Conversation" className={log}>
          <ChatMessage
            from="user"
            text="Can you draft an invoice in Rupiah for a website project?"
            time="10:24"
          />
          <ChatMessage text={answer} time="10:24" assistantLabel="Markas AI" />
          <ChatMessage
            from="user"
            text="Add a 14 day payment term, please."
            time="10:25"
          />
          <ChatMessage typing assistantLabel="Markas AI" />
        </div>
      );
    }
    <script setup lang="ts">
    import ChatMessage from "@/components/markas/ChatMessage.vue";
    
    const log = "grid gap-4";
    const answer =
      "Sure. Here is a simple layout for it:\nDesign and build, Rp 12.500.000\nVAT 11%, Rp 1.375.000\nTotal due, Rp 13.875.000";
    </script>
    
    <template>
      <div role="log" aria-label="Conversation" :class="log">
        <ChatMessage
          from="user"
          text="Can you draft an invoice in Rupiah for a website project?"
          time="10:24"
        />
        <ChatMessage :text="answer" time="10:24" assistant-label="Markas AI" />
        <ChatMessage
          from="user"
          text="Add a 14 day payment term, please."
          time="10:25"
        />
        <ChatMessage typing assistant-label="Markas AI" />
      </div>
    </template>
    <script lang="ts">
      import ChatMessage from "$lib/components/markas/ChatMessage.svelte";
    
      const log = "grid gap-4";
      const answer =
        "Sure. Here is a simple layout for it:\nDesign and build, Rp 12.500.000\nVAT 11%, Rp 1.375.000\nTotal due, Rp 13.875.000";
    </script>
    
    <div role="log" aria-label="Conversation" class={log}>
      <ChatMessage
        from="user"
        text="Can you draft an invoice in Rupiah for a website project?"
        time="10:24"
      />
      <ChatMessage text={answer} time="10:24" assistantLabel="Markas AI" />
      <ChatMessage
        from="user"
        text="Add a 14 day payment term, please."
        time="10:25"
      />
      <ChatMessage typing assistantLabel="Markas AI" />
    </div>
    ---
    import ChatMessage from "@/components/markas/ChatMessage.astro";
    
    const log = "grid gap-4";
    const answer =
      "Sure. Here is a simple layout for it:\nDesign and build, Rp 12.500.000\nVAT 11%, Rp 1.375.000\nTotal due, Rp 13.875.000";
    ---
    
    <div role="log" aria-label="Conversation" class={log}>
      <ChatMessage
        from="user"
        text="Can you draft an invoice in Rupiah for a website project?"
        time="10:24"
      />
      <ChatMessage text={answer} time="10:24" assistantLabel="Markas AI" />
      <ChatMessage
        from="user"
        text="Add a 14 day payment term, please."
        time="10:25"
      />
      <ChatMessage typing assistantLabel="Markas AI" />
    </div>
    import { Component } from "@angular/core";
    import { ChatMessage } from "./markas/chat-message.component";
    
    @Component({
      selector: "markas-example",
      imports: [ChatMessage],
      template: `
        <div role="log" aria-label="Conversation" [class]="log">
          <markas-chat-message
            from="user"
            text="Can you draft an invoice in Rupiah for a website project?"
            time="10:24"
          />
          <markas-chat-message
            [text]="answer"
            time="10:24"
            assistantLabel="Markas AI"
          />
          <markas-chat-message
            from="user"
            text="Add a 14 day payment term, please."
            time="10:25"
          />
          <markas-chat-message typing assistantLabel="Markas AI" />
        </div>
      `,
    })
    export default class ChatMessageExample {
      protected readonly log = "grid gap-4";
      protected readonly answer =
        "Sure. Here is a simple layout for it:\nDesign and build, Rp 12.500.000\nVAT 11%, Rp 1.375.000\nTotal due, Rp 13.875.000";
    }

    Contoh

    Chat dukungan dengan gelembung

    My invoice shows Rp 0 for shipping. Is that right?

    Support bot

    Yes. Orders above Rp 500.000 ship for free, so the shipping line stays at Rp 0.
    My invoice shows Rp 0 for shipping. Is that right?

    Support bot

    Yes. Orders above Rp 500.000 ship for free, so the shipping line stays at Rp 0.
    My invoice shows Rp 0 for shipping. Is that right?

    Support bot

    Yes. Orders above Rp 500.000 ship for free, so the shipping line stays at Rp 0.
    My invoice shows Rp 0 for shipping. Is that right?

    Support bot

    Yes. Orders above Rp 500.000 ship for free, so the shipping line stays at Rp 0.
    My invoice shows Rp 0 for shipping. Is that right?

    Support bot

    Yes. Orders above Rp 500.000 ship for free, so the shipping line stays at Rp 0.

    Jawaban streaming

    When is VAT due for my October invoices?

    Markas AI

    VAT for October is due by the end of November. Report it in your monthly return and pay before you file, so the payment code is already on record.
    When is VAT due for my October invoices?

    Markas AI

    VAT for October is due by the end of November. Report it in your monthly return and pay before you file, so the payment code is already on record.
    When is VAT due for my October invoices?

    Markas AI

    VAT for October is due by the end of November. Report it in your monthly return and pay before you file, so the payment code is already on record.
    When is VAT due for my October invoices?

    Markas AI

    VAT for October is due by the end of November. Report it in your monthly return and pay before you file, so the payment code is already on record.
    When is VAT due for my October invoices?

    Markas AI

    VAT for October is due by the end of November. Report it in your monthly return and pay before you file, so the payment code is already on record.

    Transkrip hanya baca

    Please resend invoice INV-2041.

    Markas AI

    Done. A fresh copy went to finance@sinarjaya.co.id.
    Thanks, received it.
    Please resend invoice INV-2041.

    Markas AI

    Done. A fresh copy went to finance@sinarjaya.co.id.
    Thanks, received it.
    Please resend invoice INV-2041.

    Markas AI

    Done. A fresh copy went to finance@sinarjaya.co.id.
    Thanks, received it.
    Please resend invoice INV-2041.

    Markas AI

    Done. A fresh copy went to finance@sinarjaya.co.id.
    Thanks, received it.
    Please resend invoice INV-2041.

    Markas AI

    Done. A fresh copy went to finance@sinarjaya.co.id.
    Thanks, received it.

    Instalasi

    npx markasui@latest add chat-message

    Pemakaian

    <div role="log" aria-label="Percakapan" class="grid gap-5">
        <x-markas.chat-message from="user" text="Bagaimana menagih klien dalam Rupiah?" time="10.24" user-label="Anda" />
        <x-markas.chat-message
            text="Atur mata uang ke IDR dan tulis setiap item beserta nominalnya."
            time="10.24"
            assistant-label="Markas AI"
            actions-label="Aksi pesan"
            copy-label="Salin"
            copied-label="Tersalin"
            like-label="Jawaban bagus"
            dislike-label="Jawaban buruk"
            regenerate-label="Buat ulang"
        />
        <x-markas.chat-message typing assistant-label="Markas AI" typing-label="Sedang mengetik" />
    </div>
    import { ChatMessage } from "@/components/markas/ChatMessage";
    
    <ChatMessage
      text={jawaban}
      assistantLabel="Markas AI"
      copyLabel="Salin"
      copiedLabel="Tersalin"
      likeLabel="Jawaban bagus"
      dislikeLabel="Jawaban buruk"
      regenerateLabel="Buat ulang"
      onFeedback={nilai}
    />;
    <script setup lang="ts">
    import ChatMessage from "@/components/markas/ChatMessage.vue";
    </script>
    
    <template>
      <ChatMessage
        from="user"
        text="Bagaimana menagih klien dalam Rupiah?"
        user-label="Anda"
        copy-label="Salin"
        copied-label="Tersalin"
      />
    </template>
    <script lang="ts">
      import ChatMessage from "$lib/components/markas/ChatMessage.svelte";
    </script>
    
    <div role="log" aria-label="Conversation" class="grid gap-5">
      <ChatMessage
        from="user"
        text="How do I bill a client in Rupiah?"
        time="10:24"
      />
      <ChatMessage
        text={answer}
        time="10:24"
        assistantLabel="Markas AI"
        stream
        onFeedback={rate}
        onRegenerate={retry}
      />
    </div>
    ---
    import ChatMessage from "@/components/markas/ChatMessage.astro";
    ---
    
    <div role="log" aria-label="Conversation" class="grid gap-5">
      <ChatMessage from="user" text="How do I bill a client in Rupiah?" time="10:24" />
      <ChatMessage text={answer} time="10:24" assistantLabel="Markas AI" stream />
    </div>

    Custom element kecil menjalankan streaming, menyalin teks, dan mengganti rating. Ia mengirim markas-feedback (nilai baru sebagai detail) dan markas-regenerate, keduanya menggelembung.

    import { Component } from "@angular/core";
    import { ChatMessage } from "./markas/chat-message.component";
    
    @Component({
      selector: "app-conversation",
      imports: [ChatMessage],
      template: `
        <div role="log" aria-label="Conversation" class="grid gap-5">
          <markas-chat-message
            from="user"
            text="How do I bill a client in Rupiah?"
          />
          <markas-chat-message
            [text]="answer"
            assistantLabel="Markas AI"
            stream
            (feedback)="rate($event)"
            (regenerate)="retry()"
          />
        </div>
      `,
    })
    export class Conversation {
      answer = "Add the amount in Rupiah and a payment term.";
      rate(value: "like" | "dislike" | null) {}
      retry() {}
    }
    • Baris aksi muncul saat kursor di atas pesan atau fokus ada di dalamnya, jadi percakapan tetap rapi.
    • Copy menampilkan centang selama dua detik. Like dan dislike saling eksklusif dan memicu feedback dengan nilai barunya.
    • stream memunculkan teks kata demi kata dengan kursor. Bila text bertambah saat streaming, kemunculan berlanjut sampai akhir yang baru.
    • Reduced motion mematikan streaming, denyut titik, dan efek pudar.

    Props

    NamaTipeDefaultKeterangan
    from"user" | "assistant"assistantPenulis pesan. Pesan user berupa gelembung primary di kanan, pesan asisten di kiri dengan avatar.
    textstring""Teks pesan. Baris baru dipertahankan. Copy menyalin teks ini ke clipboard.
    variant"plain" | "bubble"plainGaya asisten: teks polos, atau gelembung halus subtle.
    timestring-Waktu dalam elemen time, di samping nama untuk asisten dan di bawah gelembung untuk user.
    avatarstring-URL gambar avatar asisten. Tanpa ini tampil ikon kilau.
    typingbooleanfalseMenampilkan tiga titik berdenyut sebagai ganti teks, diumumkan sebagai typingLabel.
    streambooleanfalseMemunculkan teks token demi token dengan kursor, seperti model yang streaming. Dengan reduced motion teks tampil utuh sekaligus.
    streamSpeednumber40Jeda antar token dalam ms.
    actionsbooleantrueMenampilkan baris aksi saat hover dan fokus: copy, plus like, dislike, dan regenerate untuk asisten. Disembunyikan saat mengetik atau streaming.
    onFeedback / @feedback / x-on:feedback(value: "like" | "dislike" | null) => void-Dipicu saat like atau dislike diubah. Menekan yang aktif sekali lagi mengirim null.
    onRegenerate / @regenerate / x-on:regenerate() => void-Dipicu saat tombol regenerate ditekan.
    userLabelstringYouNama aksesibel pesan user. Default "You", isi misalnya "Anda".
    assistantLabelstringAssistantNama di atas pesan asisten sekaligus nama aksesibelnya, misalnya nama produk. Default "Assistant", isi misalnya "Asisten".
    typingLabelstringTypingTeks status tersembunyi saat typing aktif. Default "Typing", isi misalnya "Sedang mengetik".
    actionsLabelstringMessage actionsNama aksesibel grup aksi. Default "Message actions", isi misalnya "Aksi pesan".
    copyLabelstringCopyNama aksesibel tombol copy. Default "Copy", isi misalnya "Salin".
    copiedLabelstringCopiedStatus yang diumumkan setelah menyalin. Default "Copied", isi misalnya "Tersalin".
    likeLabelstringGood responseNama aksesibel tombol like. Default "Good response", isi misalnya "Jawaban bagus".
    dislikeLabelstringBad responseNama aksesibel tombol dislike. Default "Bad response", isi misalnya "Jawaban buruk".
    regenerateLabelstringRegenerateNama aksesibel tombol regenerate. Default "Regenerate", isi misalnya "Buat ulang".
    (feedback) / (regenerate)output-Khusus Angular. Memancarkan rating baru (like, dislike, atau null) dan tekanan regenerate. Svelte memakai onFeedback dan onRegenerate seperti React.
    markas-feedback / markas-regenerateCustomEvent-Khusus Astro. Event menggelembung dari markas-chat-message, dengan rating baru sebagai detail untuk feedback.

    Aksesibilitas

    • Setiap pesan adalah article bernama userLabel atau assistantLabel. Letakkan pesan di dalam elemen role="log" agar pesan baru diumumkan.
    • Aksi muncul saat hover dan saat fokus keyboard di dalam pesan, serta selalu tampil di layar sentuh. Like dan dislike adalah tombol toggle dengan aria-pressed.
    • Menyalin mengumumkan copiedLabel lewat region status. Titik mengetik disembunyikan dan diumumkan sebagai typingLabel.
    • Saat streaming, pembaca layar mendapat teks utuh sekaligus dari salinan tersembunyi. Reduced motion melewati streaming dan denyut.

    Komponen terkait

    Komponen markasui lain dengan class yang sama di setiap framework.