Создано:
1 день, 12 часов ago
Текстовые фрагменты позволяют пользователям напрямую ссылаться на определенную часть текста в веб-документе, не требуя от автора документа указания идентификатора. Эта функция использует уникальный синтаксис во фрагменте URL для идентификации и выделения целевого текста.
Это позволяет создавать ссылки, выделяющие определенную часть текста на веб-странице. Когда кто-то нажимает на вашу ссылку, браузер переходит на веб-страницу, автоматически прокручивает ее и выделяет нужный текст.
Как использовать текстовые фрагменты
Одной из самых важных особенностей Интернета является возможность создавать ссылки между различными документами. Существует два основных способа создания ссылок:
Ссылка на начало документа путем указания URL-адреса документа
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a
Ссылка на определенный раздел документа путем добавления фрагмента документа (идентификатора) к URL-адресу
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#browser_compatibility
Создание и использование текстовых фрагментов в Firefox
- Определите текст, который нужно выделить. Выберите именно тот текст, который вы хотите, чтобы пользователи видели на целевой веб-странице.
- Создайте URL-адрес. Используйте следующий синтаксис, чтобы добавить текстовый фрагмент в URL-адрес:
- https://example.com#:~:text=[prefix-,]highlightedText[,highlightedEnd[,suffix]]
| text= | Текстовая директива. Это предоставляет браузеру фрагмент текста, определяющий, на какой текст должна быть сделана ссылка в связанном документе. |
| textStart | Текстовая строка, указывающая на начало связанного текста. При использовании без textEnd он будет содержать весь диапазон, который необходимо выделить. |
| textEnd | Текстовая строка, указывающая на конец связанного текста. Когда присутствуют textStart и textEnd, они служат граничными точками диапазона. |
| prefix- | Текстовая строка, за которой следует дефис указывает, какой текст должен непосредственно предшествовать тексту со ссылкой, допуская только пробелы между ними. Это помогает браузеру выбрать правильный текст со ссылкой в тех случаях, когда имеется несколько совпадений. |
| -suffix | Дефис, за которым следует текстовая строка указывает, какой текст должен следовать непосредственно за текстом ссылки, допуская только пробелы между ними. Это помогает браузеру выбрать правильный текст ссылки в тех случаях, когда имеется несколько совпадений. |
- Примечание: Текстовые строки, используемые для следующих параметров, должны быть закодированы в процентах: textStart, textEnd, prefix, suffix-.
- Например, это выделяет фразу "Текстовые фрагменты Firefox" на странице:
- https://example.com#:~:text=Тексовые%20фрагменты%20Firefox
Проверьте свою ссылку: откройте ссылку в Firefox, чтобы убедиться, что она выделяет нужный текст. Если содержимое веб-страницы изменилось или есть несколько совпадений, измените фрагмент, используя префикс или суффикс для большей точности.
Практические примеры
- Выделение единственного слова:
- https://example.com#:~:text=example
- Это выделяет слово "example."
- Выделение диапазона текста:
- https://example.com#:~:text=Text%20Fragments%20are%20useful
- Это выделяет текст "Text Fragments are useful."
- Добавление контекста для неоднозначных совпадений:
- https://example.com#:~:text=Before-,specific%20phrase,-After
- Это гарантирует, что конкретная фраза будет выделена, даже если на странице есть похожий текст.
Частые вопросы
Что произойдет, если целевой текст изменится?
Текстовый фрагмент может не отображаться, если исходный текст удален или существенно изменен. Используйте префиксы и суффиксы для повышения устойчивости. При сбое сопоставления страница будет работать так, как будто текстового фрагмента нет. Если присутствует дополнительный фрагмент документа, он прокручивается до него, в противном случае страница прокручивается до самого верха.
Могу ли я использовать текстовые фрагменты с нетекстовыми элементами?
Нет. Текстовые фрагменты работают только с выбранным текстом, но не с изображениями, видео или динамическими элементами.
Все ли пользователи видят выделения
Да, при условии, что их браузер поддерживает текстовые фрагменты.
Каковы ограничения при создании ссылок на фрагменты документа?
Для создания ссылок на фрагменты документа автору страницы необходимо указать привязку, например, атрибут id в HTML.
Если идентификатор изменен или удален, ссылка разрывается, и пользователь перенаправляется в начало страницы. Хотя такое поведение является примером постепенной деградации, оно ограничивает возможности автора ссылки. Возможность создания точной ссылки на определенный контент зависит от решений автора страницы.
