如何重置QML TextArea富文本样式 阻止后续输入继承格式

问题根源 #

TextArea 底层用 QTextDocument 存储文本内容，直接通过textArea.text += 富文本字符串的方式插入内容时，插入完成后光标会留在最后一个富文本标签的作用范围里，后续输入的内容会自动继承当前光标位置的标签格式，直接被包裹进链接、字体样式这类标签内部。

实现方案 #

不要直接拼接text属性，通过组件自带的textCursor文本光标对象插入富文本，插入完成后主动重置光标位置的字符格式，就能切断后续输入和已有富文本标签的关联。
修正后的完整可运行代码：

import QtQuick 2.12
import QtQuick.Window 2.12
import QtQuick.Controls 2.12

Window {
    width: 640
    height: 480
    visible: true
    title: qsTr("Hello World")

    TextArea {
        id: textArea
        textFormat: Qt.RichText
        focus: true
        selectByMouse: true
        selectByKeyboard: true

        Keys.onPressed: {
            if (event.text === "@") {
                // 取当前活动的文本光标
                const cursor = textArea.textCursor
                // 插入@用户链接
                cursor.insertHtml("<a href='mentioned://user'>@User</a>")
                // 核心操作：把光标位置的字符格式重置为当前段落的默认正文格式
                cursor.setCharFormat(cursor.block().charFormat())
                // 把更新后的光标同步回TextArea
                textArea.textCursor = cursor

                event.accepted = true
            }
        }
    }
}

补充说明 #

• 直接操作textCursor插入内容比拼接text字符串可控性高很多，不会打乱原有文档结构，也不会出现光标乱跳的问题。
• 执行setCharFormat重置格式后，光标就脱离了之前插入的<a>标签作用域，后续输入的内容会按普通正文渲染，不会变成链接的一部分，也不会继承链接的颜色、下划线样式。
• 如果在低版本Qt上碰到偶发的格式继承问题，可以在插入完富文本后先插入一个零宽空格\u200B，再重置字符格式，兼容性表现会更稳定。

内容的提问来源于stack exchange，提问作者Meliodas