如何在PyQt6/PySide6中实现NVDA兼容的多行文本编辑器？

针对QTextEdit与NVDA屏幕阅读器的兼容性问题，以下是三种可落地的技术方案，覆盖不同复杂度和需求场景：

方案一：基于QPlainTextEdit的轻量优化 #

QPlainTextEdit比QTextEdit更适合纯文本场景，可访问性基础更好，通过少量定制即可解决核心问题：

核心优化点 #

• 禁用自动换行，避免NVDA混淆行边界
• 过滤重复的可访问性事件，解决内容重复播报问题
• 手动控制光标位置的播报逻辑，提供可靠的行/列位置反馈

代码实现 #

from PyQt6.QtWidgets import QPlainTextEdit
from PyQt6.QtGui import QTextCursor
from PyQt6.QtCore import Qt, QEvent
from PyQt6.QtGui import QAccessible

class AccessiblePlainTextEdit(QPlainTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setLineWrapMode(QPlainTextEdit.LineWrapMode.NoWrap)
        self._last_cursor_pos = -1

    def accessibilityEvent(self, event):
        # 仅在光标位置变化时发送文本变更事件，避免重复播报
        if event.type() == QAccessible.Event.TextChanged:
            current_pos = self.textCursor().position()
            if current_pos != self._last_cursor_pos:
                self._last_cursor_pos = current_pos
                super().accessibilityEvent(event)
        else:
            super().accessibilityEvent(event)

    def keyPressEvent(self, event):
        super().keyPressEvent(event)
        # 光标导航后手动播报行/列位置
        if event.key() in (Qt.Key.Key_Up, Qt.Key.Key_Down, Qt.Key.Key_Left, Qt.Key.Key_Right):
            cursor = self.textCursor()
            line_num = cursor.blockNumber() + 1
            col_num = cursor.positionInBlock() + 1
            QAccessible.updateAccessibility(self, QAccessible.Event.StatusChanged, f"第{line_num}行，第{col_num}列")

方案二：多QLineEdit组合的完全兼容方案 #

利用QLineEdit本身良好的NVDA兼容性，通过容器组合实现多行编辑功能，适合对兼容性要求极高的场景：

核心逻辑 #

• 用QWidget作为容器，动态添加/删除QLineEdit实现多行
• 自定义上下箭头导航逻辑，切换行时保持光标位置合理性
• 为每个QLineEdit设置可访问名称，明确行号标识

代码实现 #

from PyQt6.QtWidgets import QWidget, QLineEdit, QVBoxLayout
from PyQt6.QtCore import Qt

class MultiLineAccessibleEditor(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.layout = QVBoxLayout(self)
        self.layout.setSpacing(0)
        self.layout.setContentsMargins(0, 0, 0, 0)
        self._lines = []
        self.add_new_line()

    def add_new_line(self):
        line_edit = QLineEdit()
        line_num = len(self._lines) + 1
        line_edit.setAccessibleName(f"第{line_num}行")
        line_edit.returnPressed.connect(self._on_return_pressed)
        line_edit.keyPressEvent = self._line_key_press_event
        self.layout.addWidget(line_edit)
        self._lines.append(line_edit)
        return line_edit

    def _on_return_pressed(self):
        current_edit = self.sender()
        index = self._lines.index(current_edit)
        new_edit = self.add_new_line()
        self.layout.insertWidget(index + 1, new_edit)
        new_edit.setFocus()
        new_edit.setCursorPosition(0)

    def _line_key_press_event(self, event):
        current_edit = self.sender()
        index = self._lines.index(current_edit)
        if event.key() == Qt.Key.Key_Up and index > 0:
            prev_edit = self._lines[index - 1]
            prev_edit.setFocus()
            prev_edit.setCursorPosition(len(prev_edit.text()))
        elif event.key() == Qt.Key.Key_Down and index < len(self._lines) - 1:
            next_edit = self._lines[index + 1]
            next_edit.setFocus()
            next_edit.setCursorPosition(0)
        else:
            QLineEdit.keyPressEvent(current_edit, event)
            # 更新当前行的可访问名称（若内容修改不影响行号，可省略）
            current_edit.setAccessibleName(f"第{index + 1}行")

方案三：实现QAccessibleTextInterface深度定制 #

通过实现Qt的可访问性文本接口，完全控制NVDA获取的文本、光标和选中信息，适合需要深度定制的场景：

核心逻辑 #

• 继承QPlainTextEdit，重写accessibleInterface方法返回自定义接口实现
• 实现QAccessibleTextInterface的核心方法，确保NVDA能获取准确的文本状态

代码实现 #

from PyQt6.QtWidgets import QPlainTextEdit
from PyQt6.QtGui import QAccessibleTextInterface, QTextCursor

class AccessibleTextEdit(QPlainTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        self._accessible_interface = None

    def accessibleInterface(self):
        if not self._accessible_interface:
            self._accessible_interface = _AccessibleTextImpl(self)
        return self._accessible_interface

class _AccessibleTextImpl(QAccessibleTextInterface):
    def __init__(self, editor):
        super().__init__()
        self._editor = editor

    def cursorPosition(self):
        return self._editor.textCursor().position()

    def selectionStart(self):
        return self._editor.textCursor().selectionStart()

    def selectionEnd(self):
        return self._editor.textCursor().selectionEnd()

    def setCursorPosition(self, position):
        cursor = self._editor.textCursor()
        cursor.setPosition(position)
        self._editor.setTextCursor(cursor)

    def setSelection(self, start, end):
        cursor = self._editor.textCursor()
        cursor.setSelection(start, end)
        self._editor.setTextCursor(cursor)

    def text(self, start, end):
        return self._editor.toPlainText()[start:end]

    def characterCount(self):
        return len(self._editor.toPlainText())

    def offsetAtPoint(self, point):
        cursor = self._editor.cursorForPosition(point)
        return cursor.position()

    def scrollToSubstring(self, start, end):
        cursor = self._editor.textCursor()
        cursor.setPosition(start)
        cursor.setPosition(end, QTextCursor.MoveMode.KeepAnchor)
        self._editor.setTextCursor(cursor)
        self._editor.ensureCursorVisible()

方案选择建议 #

• 快速落地选方案一：改动小，仅需对QPlainTextEdit做少量定制，解决核心兼容性问题
• 极致兼容选方案二：完全依赖QLineEdit的成熟可访问性，但需要处理多行导航和管理逻辑
• 深度定制选方案三：从底层控制可访问性数据，适合需要自定义播报规则的场景

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