對話標題
對話頂端可以顯示一條標題列,與 Header 的 Bot 名稱(title prop)不同。它適合用來呈現
「目前這個 channel 在談什麼」,例如工單編號、對話主題等。
對話標題
對話頂端可以顯示一條標題列,與 Header 的 Bot 名稱不同。它由 channelTitle prop 初始化(通常取自 channelMetadata()),並會隨後端 title.update 事件動態更新。可用 renderTitle 完全客製,或用 channelTitleHidden 隱藏。
呈現方式
<Chatbot
channelTitle="訂單 #1024 諮詢"
config={{ botProviderEndpoint: '...' }}
customChannelId="my-channel"
/>聊天機器人載入中…
相關 Props
| Prop | 型別 | 說明 |
|---|---|---|
channelTitle | string | null | 標題初始值(通常取自 channelMetadata()),會隨後端 title.update 事件動態更新。null = 未命名 |
renderTitle | (props) => ReactNode | 完全取代標題列。props 為 { title, renderDefault },回傳 null 可隱藏 |
untitledLabel | string | 未命名(null)時顯示的預設字,預設 新對話 |
channelTitleHidden | boolean | 直接隱藏標題列 |
動態更新
標題背後是一個響應式 store:後端送出 asgard.channel.title.update 事件時會自動更新,
無需手動重繪。Headless 消費端可用 useChannelTitle(channel) hook 訂閱,詳見
Headless 模式。
也看看
- Chatbot Props — 完整 props 清單
- 自訂標題列 renderHeader — 客製 Bot 名稱那一列(與本頁的標題列不同)