Skip to main content

개요

채팅 인터페이스를 표시하는 UI 요소입니다.

사용법

기본 사용법

이벤트 수신

이벤트

ChatElement가 발생시키는 이벤트입니다. on() 메서드를 사용하거나 옵션에 콜백 함수를 전달하여 이러한 이벤트를 수신하세요.

error

요소 초기화 또는 작동 중에 오류가 발생하면 발생합니다. 콜백 시그니처: (error: unknown) => void

ready

요소가 로드를 완료하고 사용자 상호작용 준비가 되면 발생합니다. 콜백 시그니처: (element: ChatElement) => void

optionsUpdated

updateOptions()를 통해 요소의 옵션이 업데이트되면 발생합니다. 콜백 시그니처: (options: ChatElementOptions) => void

snapshot

요소의 내부 상태가 변경되면 발생합니다. 콜백 시그니처: (snapshot: ChatElementSnapshot) => void

profileClick

사용자가 프로필을 클릭하면 발생합니다. 콜백 시그니처: (ev: CustomEvent<{ id: string; }>) => void

linkClick

사용자가 링크를 클릭하면 발생합니다. 콜백 시그니처: (ev: CustomEvent<{ url: string; }>) => void

messageSent

사용자가 메시지를 보내면 발생합니다. 콜백 시그니처: (ev: CustomEvent<{ id: string; content: string; channelId: string; }>) => void

messageDeleted

사용자가 메시지를 삭제하면 발생합니다. 콜백 시그니처: (ev: CustomEvent<{ id: string; }>) => void

experienceClick

사용자가 experience 멘션을 클릭하면 발생합니다. 콜백 시그니처: (ev: CustomEvent<{ id: string; }>) => void

attachmentClick

사용자가 첨부 파일을 클릭하면 발생합니다. 콜백 시그니처: (ev: CustomEvent<{ messageId: string; attachments: AttachmentClickEventAttachment[]; }>) => void

메서드

mount(container)

요소를 DOM 컨테이너에 마운트합니다. 컨테이너는 빈 요소여야 합니다. 요소는 자식으로 추가됩니다. 요소가 이미 마운트되어 있으면 이 메서드는 경고를 기록하고 반환합니다.

unmount()

DOM에서 요소를 제거하고 모든 이벤트 리스너를 정리합니다. 마운트 해제 후에는 요소 인스턴스를 재사용하면 안 됩니다. 다시 마운트해야 하는 경우 새 요소 인스턴스를 만드세요.

updateOptions(options)

생성 후 요소의 구성 옵션을 업데이트합니다. 제공된 옵션만 업데이트되며, 다른 옵션은 변경되지 않습니다. 요소는 새 옵션으로 다시 렌더링됩니다.

getSnapshot()

요소의 현재 상태 스냅샷을 가져옵니다. 스냅샷에는 로딩 상태, 양식 값 또는 기타 요소별 데이터와 같은 요소의 현재 내부 상태가 포함됩니다. 반환값: ChatElementSnapshot

스타일링

appearance.classes로 이 요소를 맞춤 설정하세요. 안정적인 클래스 이름의 전체 목록과 예제 스니펫은 스타일링 레퍼런스를 참고하세요.

타입

ChatElementOptions

ChatElement의 구성 옵션입니다.

ChatElementSnapshot

ChatElement의 현재 상태를 나타냅니다. 현재 상태를 가져오려면 element.getSnapshot()을 사용하고, 변경 사항을 확인하려면 snapshot 이벤트를 수신하세요.