String.prototype.link()
Baseline Ограниченная доступность
Эта функция не является Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.
Устарело: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут по-прежнему поддерживать ее, она уже могла быть удалена из соответствующих веб-стандартов, находится в процессе удаления или сохранена только для обеспечения совместимости. Избегайте ее использования и, если возможно, обновите существующий код; см. таблицу совместимости внизу этой страницы, чтобы помочь вам принять решение. Имейте в виду, что эта функция может перестать работать в любое время.
Метод link() объекта String создает строку, которая встраивает эту строку в элемент <a> (<a href="...">str</a>), которая будет использоваться в качестве гиперссылки на другой URL.
Примечание: Все методы обертки HTML устарели и стандартизированы только для целей совместимости. Используйте DOM API, такие как document.createElement(), вместо них.
Синтаксис
link(url)
Параметры
-
url - Любая строка, которая определяет атрибут
hrefэлемента<a>; это должен быть допустимый URL (относительный или абсолютный), с любыми символами&, экранированными как&.
Возвращаемое значение
Строка, начинающаяся с тега открытия <a href="url"> (двойные кавычки в url заменяются на "), затем текст str, а затем тег закрытия </a>.
Примеры
Использование link()
Код ниже создает строку HTML, а затем заменяет ею тело документа:
const contentString = "MDN Web Docs";
document.body.innerHTML = contentString.link("https://developer.mozilla.org/");
Это создаст следующий HTML:
<a href="https://developer.mozilla.org/">MDN Web Docs</a>
Вместо использования link() и прямого создания HTML-текста следует использовать DOM API, такие как document.createElement(). Например:
const contentString = "MDN Web Docs";
const elem = document.createElement("a");
elem.href = "https://developer.mozilla.org/";
elem.innerText = contentString;
document.body.appendChild(elem);
Спецификации
Совместимость с браузерами
| Настольные компьютеры | Мобильные | Сервер | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on iOS | Samsung Internet | WebView Android | WebView on iOS | Bun | Deno | Node.js | |
link |
1 |
12 |
1 |
3 |
1 |
18 |
4 |
10.1 |
1 |
1.0 |
4.4 |
1 |
1.0.0 |
1.0 |
0.10.0 |
См. также
- Polyfill of
String.prototype.linkincore-js - es-shims polyfill of
String.prototype.link - Методы обертки HTML
<a>
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/link
