String.prototype.link()
Застаріло: Це — нерекомендована функціональність. Хоча деякі браузери все ще можуть її підтримувати, її або вже виключено з актуальних вебстандартів, або вона знаходиться в процесі завершення підтримки, або ж її залишили лише з міркувань зворотної сумісності. Слід уникати її використання, і якщо можливо — оновлювати вже написаний код, що опирається на цю функціональність (дивіться таблицю сумісності внизу цієї сторінки, щоб прийняти рішення). Майте на увазі: ця функціональність може припинити працювати в будь-який момент.
Метод link() (посилання) значень String створює рядок, що вбудовує рядок цього методу в елемент <a> (<a href="...">str</a>), аби використати його як гіпертекстове посилання на іншу URL-адресу.
Примітка: Всі обгортальні методи HTML є нерекомендованими та стандартизовані заради потреб сумісності. Замість них слід використовувати API DOM, наприклад,
document.createElement().
Синтаксис
link(url)
Параметри
urlБудь-який рядок, що задає атрибут
hrefелемента<a>; повинен бути дійсним URL (відносним або абсолютним), в якому всі символи&екрановані як&.
Повернене значення
Рядок, що починається з початкового тега <a href="url"> (подвійні рядки в url замінюються на "), потім текст str, і закінчується кінцевим тегом </a>.
Приклади
Застосування link()
Код нижче створює рядок HTML, а потім замінює ним тіло документа:
const contentString = "ВебДоки";
document.body.innerHTML = contentString.link("https://webdoky.org/");
Це створить наступний HTML:
<a href="https://webdoky.org/">ВебДоки</a>
Замість використання link() і безпосереднього створення тексту HTML слід використовувати API DOM, такі як document.createElement(). Наприклад:
const contentString = "ВебДоки";
const elem = document.createElement("a");
elem.href = "https://webdoky.org/";
elem.innerText = contentString;
document.body.appendChild(elem);
Специфікації
Сумісність із браузерами
| desktop | mobile | server | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
link
|
Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | Internet Explorer Full support 3 | Opera Full support 3 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox for Android Full support 4 | Opera Android Full support 10.1 | Safari on iOS Full support 1 | Samsung Internet Full support 1.0 | Deno Full support 1.0 | Node.js Full support 0.10.0 |