有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

一、功能描述

在 TUIChat 的会话中,您可以引用之前的消息以表示对特定的消息进行回复,回复后还可以通过点击引用的消息跳转至原始消息,原始消息将会高亮闪烁。




二、消息引用

2.1 引用一条消息

Web
Uniapp & H5
Web 右键消息,在消息上会弹出消息工具栏,点击工具栏中的引用按钮,即可对该消息进行引用。



被引用的消息会展示在输入框中,包含被引用消息的发送者和消息内容,如上图所示。
长按消息,在消息上会弹出消息工具栏,点击工具栏中的引用按钮,即可对该消息进行引用。



被引用的消息会展示在输入框之下,包含被引用消息的发送者和消息内容,大致如上图所示。

2.2 取消消息引用




在消息被引用但还未发出时,通过点击引用之后的关闭按钮,可以取消消息引用。

2.3 查看被引用消息




点击引用消息的引用内容,可以定位到原始消息,原始消息将进行高亮闪烁:
当被引用的消息处于屏幕内,点击引用消息的引用内容,只进行高亮闪烁。
当被引用的消息不处于屏幕内,但处于消息列表中时,点击引用内容,消息列表会自动滚动到原始消息处,并进行高亮闪烁。
当被引用的消息不处于屏幕内,也不处于消息列表时,点击引用内容,不会跳转到原始消息,也不会高亮闪烁。

三、扩展资料

说明:
以下内容仅为辅助阅读资料,消息引用功能已在 TUIKit 中默认包含,不需要用户手动实现。

3.1 如何实现消息引用

3.1.1 引用一条消息

在点击引用按钮时,会调用消息对应 Message 上的 quoteMessage() 方法,并将消息的引用记录到 Store 里。
function quoteMessage(message) {
message?.quoteMessage();
}

3.1.2 展示引用消息和取消引用

在输入框组件中监听 TUIStore 引用记录的变化,通过回调函数可以拿到被引用的消息。
const quoteMessage = ref<IMessageModel>();

onMounted(() => {
TUIStore.watch(StoreName.CHAT, {
quoteMessage: (options: { message: IMessageModel, type: string }) => {
if (options.message && options.type === "quote") {
// 监听到新的消息引用
quoteMessage.value = options.message;
} else {
// 监听到取消消息引用
quoteMessage.value = undefined;
}
},
});
});
取消引用时,将引用记录从 TUIStore 中删除即可。
function cancelQuote() {
TUIStore.update(StoreName.CHAT, "quoteMessage", { message: undefined, type: "quote" });
}

四、常见问题

4.1 我如何屏蔽引用功能?

在文件 TUIKit/components/TUIChat/message-list/message-tool/index.vue中注释掉对象数组 actionItems 中的引用部分,如下所示:
actionItems = [
{...},
{...},
// {
// text: TUITranslateService.t("TUIChat.引用"),
// iconUrl: quoteIcon,
// renderCondition() {
// if (!message.value) return false;
// const _message = TUIStore.getMessageModel(message.value.ID);
// return message.value?.status === "success" && !_message.getSignalingInfo();
// },
// clickEvent: quoteMessage,
// }
]

五、交流与反馈

单击进入 IM 社群,享有专业工程师的支持,解决您的难题。