PyQt6/PySide6中QTextEdit的NVDA无障碍多行编辑器替代方案咨询

下面是几个无需切换框架的可行方案，均基于PyQt6/PySide6原生控件增强无障碍支持：

方案1：自定义无障碍增强的QTextEdit子类 #

QTextEdit的无障碍问题多源于默认未主动向屏幕阅读器发送光标移动、选区变化等关键事件。通过子类化并手动触发无障碍更新，可让NVDA正确识别编辑状态：

from PyQt6.QtWidgets import QTextEdit
from PyQt6.QtGui import QAccessible

class NVDAFriendlyTextEdit(QTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 设置无障碍标识，明确控件类型与用途
        self.setAccessibleName("多行文本编辑器")
        self.setAccessibleDescription("支持多行输入、编辑，可通过光标键导航内容")
        # 绑定事件通知屏幕阅读器状态变化
        self.textCursorChanged.connect(self._trigger_accessibility_update)
        self.selectionChanged.connect(self._trigger_accessibility_update)

    def _trigger_accessibility_update(self):
        cursor = self.textCursor()
        # 通知光标位置变化
        QAccessible.updateAccessibility(
            self,
            QAccessible.Event.CursorMove,
            QAccessible.TextCursorChange,
            cursor.position()
        )
        # 通知选区变化（若有选中内容）
        if cursor.hasSelection():
            QAccessible.updateAccessibility(
                self,
                QAccessible.Event.SelectionChanged,
                QAccessible.TextSelectionChange,
                cursor.selectionStart(),
                cursor.selectionEnd()
            )

使用时直接替换原QTextEdit即可，保留所有原生编辑功能（换行、撤销、格式调整等），同时让NVDA实时播报光标位置与选中内容。

方案2：轻量版——无障碍增强的QPlainTextEdit #

若无需富文本编辑，QPlainTextEdit更轻量，可通过同样逻辑增强无障碍支持：

from PyQt6.QtWidgets import QPlainTextEdit
from PyQt6.QtGui import QAccessible

class NVDAFriendlyPlainTextEdit(QPlainTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setAccessibleName("纯文本多行编辑器")
        self.setAccessibleDescription("用于输入和编辑纯文本内容，支持多行显示与导航")
        self.cursorPositionChanged.connect(self._trigger_accessibility_update)
        self.selectionChanged.connect(self._trigger_accessibility_update)

    def _trigger_accessibility_update(self):
        cursor = self.textCursor()
        QAccessible.updateAccessibility(
            self,
            QAccessible.Event.CursorMove,
            QAccessible.TextCursorChange,
            cursor.position()
        )
        if cursor.hasSelection():
            QAccessible.updateAccessibility(
                self,
                QAccessible.Event.SelectionChanged,
                QAccessible.TextSelectionChange,
                cursor.selectionStart(),
                cursor.selectionEnd()
            )

方案3：极简多行输入（适合简单场景） #

若仅需基础多行输入、无需复杂编辑功能，可基于无障碍完善的QLineEdit模拟：

from PyQt6.QtWidgets import QLineEdit
from PyQt6.QtCore import Qt

class MultiLineLineEdit(QLineEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setAccessibleName("多行输入框")
        self.setAccessibleDescription("支持多行输入，按Enter换行")
        # 允许输入换行符与无限制长度
        self.setValidator(None)
        self.setMaxLength(0)
        # 开启自动换行与垂直滚动
        self.setLineWrapMode(QLineEdit.LineWrapMode.WidgetWidth)
        self.setVerticalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)

    def keyPressEvent(self, event):
        # 处理Enter键换行
        if event.key() == Qt.Key.Key_Return or event.key() == Qt.Key.Key_Enter:
            self.insert("\n")
            return
        super().keyPressEvent(event)

额外使用建议 #

• 测试时切换NVDA到焦点模式（Insert+Space），可更精准操作编辑器控件
• 设置placeholderText时同步更新accessibleDescription，让用户获取输入提示
• 自定义快捷键（如Ctrl+Z撤销）可通过QAccessible.postNotification向NVDA播报操作结果

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