ویژگی links مستند DOM HTML

تعریف و استفاده

links بازگشت مجموعه‌ای از لینک‌های موجود در مستند.

links ویژگی بازمی‌گرداند HTMLCollection.

links ویژگی‌ها فقط خوانا هستند.

لینک‌های مجموعه نمایندگان عناصر <a> و <area> دارند که دارای ویژگی href هستند.

لطفاً به: مراجعه کنید

موضوع Anchor DOM HTML

موضوع Area DOM HTML

برچسب <a> HTML

برچسب <area> HTML

لینک HTML

HTMLCollection

HTMLCollection مجموعه‌ای از عناصر مشابه آرایه HTML است (لیست).

می‌توان از طریق شاخص به عناصر در مجموعه دسترسی داشت (از 0 شروع می‌شود).

length ویژگی بازمی‌گرداند تعداد عناصر در مجموعه.

مثال

مثال 1

تعداد لینک‌های مستند را بازگرداند:

let numb = document.links.length;

به طور شخصی امتحان کنید

مثال 2

URL لینک اول مستند را بدست آورید:

let url = document.links[0].href;

به طور شخصی امتحان کنید

مثال 3

URL لینک اول مستند را بدست آورید:

let url = document.links.item(0).href;

به طور شخصی امتحان کنید

مثال 4

URL عنصر با id="myLink" را بدست آورید:

let url = document.links.namedItem("myLink").href;

به طور شخصی امتحان کنید

مثال 5

لینک اول مستند را با خط قرمز 5 پیکسلی محصور کنید:

document.links[0].style.border = "5px solid red";

به طور شخصی امتحان کنید

مثال 6

تمام لینک‌ها را بررسی کنید و URL هر لینک (href) را چاپ کنید:

const links = document.links;
let text = "";
برای (let i = 0; i < links.length; i++) {
  text += links[i].href + "<br>";
}

به طور شخصی امتحان کنید

قانون‌نویسی

document.links

ویژگی

ویژگی توضیح
length تعداد عناصر در مجموعه.

روش

روش توضیح
[index]

عنصر با شماره شاخص مشخص شده (از 0 شروع می‌شود) را برمی‌گرداند.

اگر شماره شاخص از محدوده خارج باشد، null برمی‌گرداند.

item(index)

عنصر با شماره شاخص مشخص شده (از 0 شروع می‌شود) را برمی‌گرداند.

اگر شماره شاخص از محدوده خارج باشد، null برمی‌گرداند.

namedItem(id)

با مشخصات id عنصر

اگر id در صورت عدم وجود، null برمی‌گرداند.

مقدار بازگشتی

نوع توضیح
عنصر

مجموعه HTMLCollection.

تمام عناصر <a> و <area> در مستند.

به ترتیب ظهور آن‌ها در کد منبع مرتب شده‌اند.

پشتیبانی مرورگر

document.links این یک ویژگی DOM Level 1 (1998) است.

این را همه مرورگرها پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی می‌کند 9-11 پشتیبانی می‌کند پشتیبانی می‌کند پشتیبانی می‌کند پشتیبانی می‌کند