SimpleCopy (Простое копирование)

Расширенное управление буфером обмена и копирование данных для NVDA

Автор: chai chaimee

URL: https://github.com/chaichaimee/simpleCopy

Описание

Simple Copy — это дополнение для NVDA (NonVisual Desktop Access), разработанное для значительного улучшения и расширения возможностей управления буфером обмена и копирования данных для пользователей скринридеров.

Это дополнение обеспечивает оптимизированный рабочий процесс для распространённых задач:

• Добавление выделенного текста к существующему содержимому буфера обмена с помощью одной команды
• Копирование URL-адресов браузера и адресов гиперссылок с интеллектуальным определением браузера
• Использование интуитивной системы одиночного/двойного нажатия для доступа к нескольким функциям с одних и тех же клавиш

Дополнение полностью интегрируется с NVDA и поддерживает все основные браузеры, включая Chrome, Firefox, Edge, Safari, Opera и Brave. Оно специально разработано для совместимости с API NVDA 2025.x.

Горячие клавиши

Дополнение использует эффективную систему на основе нажатий, при которой одиночное и двойное нажатие одной и той же клавиши выполняют различные, но связанные функции.

Control+Shift+A — Управление URL-адресами

Одиночное нажатие (нажать один раз): Скопировать текущий URL-адрес браузера в буфер обмена

Двойное нажатие (быстро нажать дважды): Скопировать URL-адрес фокусированной гиперссылки

При нажатии в редактируемом текстовом поле исходное нажатие клавиши передаётся приложению.

Control+Shift+C — Управление буфером обмена

Одиночное нажатие (нажать один раз): Скопировать или добавить выделенный текст в буфер обмена

Двойное нажатие (быстро нажать дважды): Очистить всё содержимое буфера обмена

Если при использовании функции добавления текст не выделен, исходное нажатие клавиши передаётся дальше.

Время нажатия: Чтобы двойное нажатие было распознано, второе нажатие должно произойти в течение 0,5 секунды после первого. Если прошло больше времени, NVDA будет обрабатывать их как отдельные одиночные нажатия.

Возможности

1. Умное копирование URL-адреса браузера

Жест: Control+Shift+A (Одиночное нажатие)

При активации в поддерживаемом веб-браузере эта функция копирует полный URL-адрес текущей веб-страницы в буфер обмена. Дополнение автоматически определяет, когда вы находитесь в среде браузера, и соответствующим образом корректирует своё поведение.

Поддерживаемые браузеры: Chrome, Firefox, Edge, Opera, Safari, Brave

2. Извлечение URL-адреса гиперссылки

Жест: Control+Shift+A (Двойное нажатие)

Эта функция извлекает URL-адрес из гиперссылок, используя несколько методов для максимальной совместимости:

• Стандартный доступ к свойствам
• Резервный вариант UIA (UI Automation) для современных браузеров
• Резервный вариант IAccessible для поддержки устаревших систем
• Поиск в родительском элементе, если сфокусированный объект не является непосредственно ссылкой

3. Добавление текста с интеллектуальным форматированием

Жест: Control+Shift+C (Одиночное нажатие)

Эта основная функция обеспечивает интеллектуальное добавление текста с автоматическим форматированием:

• Добавляет к существующему содержимому: Если буфер обмена содержит текст, выделенный текст добавляется с правильным разделением строк
• Создаёт новое содержимое: Если буфер обмена пуст, выделенный текст копируется как новое содержимое
• Нормализация формата: Автоматически нормализует окончания строк к согласованному формату
• Защита от не-текста: Обнаруживает и предотвращает добавление к нетекстовому содержимому буфера обмена

4. Очистка буфера обмена

Жест: Control+Shift+C (Двойное нажатие)

Быстро очищает всё содержимое буфера обмена Windows с аудиоподтверждением. Особенно полезно для целей безопасности или при подготовке буфера обмена к новому содержимому.

5. Расширенное определение выделения текста

Дополнение использует сложные методы для получения выделенного текста:

• Основной метод с использованием treeInterceptor или объектов фокуса
• Резервный метод, имитирующий Ctrl+C, когда основной метод не срабатывает
• Сохраняет исходное содержимое буфера обмена во время операций извлечения текста

6. Определение браузера и контекстная осведомлённость

Дополнение интеллектуально определяет контекст приложения:

• Автоматически определяет, когда вы работаете в веб-браузере
• Настраивает функции, связанные с URL-адресами, в зависимости от текущего контекста
• Передаёт исходные нажатия клавиш в небраузерных контекстах или редактируемых полях

Техническое примечание: Это дополнение создано специально для API NVDA 2025.x. Оно использует соответствующие инструменты Python и линтеры для обеспечения качества кода и следует лучшим практикам разработки дополнений NVDA.