String.prototype.link()

Застаріло: Це — не рекомендована до використання функціональність. Хоча деякі браузери все ще можуть її підтримувати, її або вже виключено з актуальних вебстандартів, або вона знаходиться в процесі завершення підтримки, або ж її залишили лише з міркувань зворотної сумісності. Слід уникати її використання, і якщо можливо — оновлювати вже написаний з код, що опирається на цю функціональність (дивіться таблицю сумісності) внизу цієї сторінки, щоб прийняти рішення). Майте на увазі: ця функціональність може припинити працювати в будь-який момент.

Метод link() (посилання) значень String створює рядок, що вбудовує рядок цього методу в елемент <a> (<a href="...">str</a>), аби використати його як гіпертекстове посилання на іншу URL-адресу.

Примітка: Всі обгортальні методи HTML є нерекомендованими та стандартизовані заради потреб сумісності. Замість них слід використовувати API DOM, наприклад, document.createElement().

Синтаксис

link(url)

Параметри

url

Будь-який рядок, що задає атрибут href елемента <a>; повинен бути дійсним URL (відносним або абсолютним), в якому всі символи & екрановані як &amp;.

Повернене значення

Рядок, що починається з початкового тега <a href="url"> (подвійні рядки в url замінюються на &quot;), потім текст str, і закінчується кінцевим тегом </a>.

Приклади

Код нижче створює рядок 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
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on iOS Samsung Internet Deno Node.js
link
Deprecated
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

Дивіться також