Chat

The chat pattern is one that composes an input with messages between the user and one or more other entities.

Chat input

For a copilot-friendly input, with a series of buttons placed within the visual (not semantic) boundaries of the textarea, use the .textarea-form component.

HTML
<div class="textarea-form">
    <textarea
        class="textarea"
        rows="3"
        placeholder="Ask a question or describe what you'd like to do"
    ></textarea>
    <div class="textarea-form-footer">
        <div class="textarea-form-footer-left">
            <span class="margin-left-xxs color-text-subtle">0 / 500</span>
        </div>
        <div class="textarea-form-footer-right">
            <button class="button button-clear" aria-label="Attach (non functional)">
                <span class="icon font-size-lg">
                    <svg viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
                        <g>
                            <path
                                class="fill-current-color"
                                d="M4.82841 10.4848L10.4853 4.8279C11.6568 3.65633 13.5563 3.65633 14.7279 4.8279C15.8995 5.99947 15.8995 7.89897 14.7279 9.07054L8.01039 15.7881C7.4246 16.3738 6.47485 16.3738 5.88907 15.7881C5.30328 15.2023 5.30328 14.2525 5.88907 13.6667L11.8995 7.65633C12.0947 7.46106 12.0947 7.14448 11.8995 6.94922C11.7042 6.75396 11.3876 6.75396 11.1924 6.94922L5.18196 12.9596C4.20565 13.9359 4.20565 15.5189 5.18196 16.4952C6.15827 17.4715 7.74118 17.4715 8.71749 16.4952L15.435 9.77765C16.9971 8.21555 16.9971 5.68289 15.435 4.12079C13.8729 2.55869 11.3403 2.55869 9.77815 4.12079L4.1213 9.77765C3.92604 9.97291 3.92604 10.2895 4.1213 10.4848C4.31656 10.68 4.63315 10.68 4.82841 10.4848Z"
                            />
                        </g>
                    </svg>
                </span>
            </button>
            <span class="textarea-form-footer-divider" aria-hidden="true"></span>
            <button class="button button-clear" aria-label="Send">
                <span class="icon font-size-lg">
                    <svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48">
                        <path
                            class="fill-current-color"
                            d="M4.12775 6.9639C3.50837 5.06496 5.48618 3.36055 7.27283 4.2536L42.7565 21.9901C44.4152 22.8192 44.4152 25.1862 42.7565 26.0153L7.27283 43.7518C5.48618 44.6448 3.50837 42.9404 4.12775 41.0415L9.68537 24.0027L4.12775 6.9639ZM11.9073 25.2527L6.68995 41.2482L41.1914 24.0027L6.68995 6.75717L11.9073 22.7527H28.7502C29.4405 22.7527 30.0002 23.3123 30.0002 24.0027C30.0002 24.693 29.4405 25.2527 28.7502 25.2527H11.9073Z"
                        />
                    </svg>
                </span>
            </button>
        </div>
    </div>
</div>

Messages

The following markup utilizes various components and atomics to create a chat experience. As you can see from the example below, we create a grid container and place several .message components within. In each message we make use of .persona to display a user's information, and a popover to house the overflow menu and its contents.

May 29, 2023, 4:50PM

Avatar for Jane Doe

Q&A Moderator

Moderator

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ullamcorper velit sed ullamcorper morbi tincidunt ornare massa eget egestas. Pellentesque elit ullamcorper dignissim cras tincidunt lobortis feugiat.

May 29, 2023, 4:55PM

Avatar for Jane Doe

Kay Smith

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Viverra aliquet eget sit amet tellus cras. Nisl nisi scelerisque eu ultrices vitae. Condimentum id venenatis a condimentum. Ut eu sem integer vitae.

HTML
<section class="display-grid gap-sm">
    <article class="display-grid">
        <div class="message">
            <p class="message-time">May 29, 2023, 4:50PM</p>
            <div class="persona message-persona">
                <figure class="persona-avatar">
                    <img src="~/src/scaffold/media/avatar.png" alt="Avatar for Jane Doe" />
                </figure>
            </div>
            <div class="message-content">
                <div class="message-content-header">
                    <div class="persona">
                        <div class="persona-details">
                            <p class="persona-name">Q&A Moderator</p>
                            <p>Moderator</p>
                        </div>
                    </div>
                    <details class="message-content-options popover popover-right">
                        <summary class="button button-clear button-primary"></summary>
                        <div class="popover-content padding-none">
                            <button
                                data-page-action-item="overflow-mobile"
                                type="button"
                                class="justify-content-flex-start button-block button-sm has-inner-focus button button-clear"
                                data-bi-name="contents-expand"
                                data-contents-button=""
                                data-popover-close=""
                            >
                                Edit message
                            </button>
                            <button
                                data-page-action-item="overflow-mobile"
                                type="button"
                                class="justify-content-flex-start button-block button-sm has-inner-focus button button-clear"
                                data-bi-name="contents-expand"
                                data-contents-button=""
                                data-popover-close=""
                            >
                                Delete message
                            </button>
                        </div>
                    </details>
                </div>
                <p>
                    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt
                    ut labore et dolore magna aliqua. Ullamcorper velit sed ullamcorper morbi tincidunt ornare
                    massa eget egestas. Pellentesque elit ullamcorper dignissim cras tincidunt lobortis
                    feugiat.
                </p>
            </div>
        </div>
    </article>
    <article class="display-grid">
        <div class="message message-sender">
            <p class="message-time">May 29, 2023, 4:55PM</p>
            <div class="persona message-persona">
                <figure class="persona-avatar">
                    <img src="~/src/scaffold/media/avatar.png" alt="Avatar for Jane Doe" />
                </figure>
            </div>
            <div class="message-content">
                <div class="message-content-header">
                    <div class="persona">
                        <div class="persona-details">
                            <p class="persona-name">Kay Smith</p>
                        </div>
                    </div>
                    <details class="message-content-options popover popover-right">
                        <summary class="button button-clear"></summary>
                        <div class="popover-content padding-none">
                            <button
                                data-page-action-item="overflow-mobile"
                                type="button"
                                class="justify-content-flex-start button-block button-sm has-inner-focus button button-clear"
                                data-bi-name="contents-expand"
                                data-contents-button=""
                                data-popover-close=""
                            >
                                <span>Edit message</span>
                            </button>
                            <button
                                data-page-action-item="overflow-mobile"
                                type="button"
                                class="justify-content-flex-start button-block button-sm has-inner-focus button button-clear"
                                data-bi-name="contents-expand"
                                data-contents-button=""
                                data-popover-close=""
                            >
                                <span>Delete message</span>
                            </button>
                        </div>
                    </details>
                </div>
                <p>
                    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt
                    ut labore et dolore magna aliqua. Viverra aliquet eget sit amet tellus cras. Nisl nisi
                    scelerisque eu ultrices vitae. Condimentum id venenatis a condimentum. Ut eu sem integer
                    vitae.
                </p>
            </div>
        </div>
    </article>
</section>