سبد (0)

document.links

مثال (document.links)

فهمیدن اینکه چه تعداد لینک در سند وجود دارند:

var x = document.links.length;

خروجی x در کد بالا

5

خودتان امتحان کنید »

در انتهای این صفحه، مثال های بیشتری آورده شده است.


تعریف و کاربرد

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

لینک های درون مجموعه مشخص کننده ی عنصرهای <a> و یا <area> با یک خصوصیت href می باشند.

نکته: در صورتی که عنصر مورد نظر خصوصیت href را نداشته باشد، هیچ چیز بازگشت داده نمی شود.

نکته: عناصر درون مجموعه همان طور که در سورس کد ظاهر می شوند، نمایش داده می شوند.

نکته: برای اطلاعات بیشتر می توانید مقاله های Anchor Object و Area Object را ببینید.


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

Collection     
links بله بله بله بله بله

نحوه استفاده

document.links

Properties

متدتوضیحات
length

تعداد عناصر <a> و یا <area> را در مجموعه برمی گرداند.

نکته: این خصوصیت فقط خواندنی است.

Methods

متدتوضیحات
[index]

عنصر <a> و یا <area> از مجموعه را با یک اندیس مشخص(که از 0 شروع می شود) برمی گرداند.

نکته: در صورتی که عدد اندیس خارج از مجموعه باشد، null را برمی گرداند.

item(index)

عنصر <a> و یا <area> از مجموعه را با یک اندیس مشخص(که از 0 شروع می شود) برمی گرداند.

نکته: در صورتی که عدد اندیس خارج از محدوده باشد، null را برمی گرداند.

namedItem(id)

عنصر <a> و یا <area> از مجموعه را با یک ID مشخص برمی گردند.

نکته: در صورتی که id موجود نباشد، null را برمی گرداند.

جزئیات تکنیکی

DOM Version: Core Level 1 کلیه توابع و خصوصیت های شیء Document در JavaScript
مقدار برگشتی

یک شیء HTMLCollecton که مشخص کننده ی تمام عناصر <a> و یا عناصر<area> در سند را برمی گرداند. عناصر درون مجموعه، همان طور که درون سورس کد نمایش داده می شوند، ذخیره می شوند.

مثال

مثال - خودتان امتحان کنید

مثال (document.links)

[index]

به دست آوردن url اولین لینک(اندیس 0) در سند:

var x = document.links[0].href;

خروجی x در کد بالا

http://www.w3schools.com/jsref/sun.htm

خودتان امتحان کنید »

مثال (document.links)

item(index)

به دست آوردن url اولین لینک(اندیس 0) در سند:

var x = document.links.item(0).href;

خروجی x در کد بالا

http://www.w3schools.com/jsref/sun.htm

خودتان امتحان کنید »

مثال (document.links)

namedItem(id)

به دست آوردن url عنصر با ویژگی "id="myLink  در سند:

var x = document.links.namedItem("myLink").href;

خروجی x در کد بالا

http://www.w3schools.com/html/default.asp

خودتان امتحان کنید »

مثال (document.links)

اضافه کردن یک کادر قرمز به اولین لینک از سند:

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

خودتان امتحان کنید »

مثال (document.links)

ایجاد یک حلقه بر روی تمام لینک ها در سند و برگرداندن url از هر لینک:

var x = document.links;
var txt = "";
var i;
for (i = 0; i < x.length; i++) {
    txt = txt + x[i].href + "<br>";
}

خروجی txt در کد بالا:

http://www.w3schools.com/jsref/sun.htm
http://www.w3schools.com/jsref/mercur.htm
http://www.w3schools.com/jsref/venus.htm
http://www.w3schools.com/html/default.asp
http://www.w3schools.com/css/default.asp

خودتان امتحان کنید »

آموزش های مرتبط

مرجع جاوا اسکریبت: HTML DOM Anchor Object

مرجع جاوا اسکریبت: HTML DOM Area Object

آموزش اچ تی ام ال: HTML Links

مرجع تگ ها: HTML <a> tag

مرجع تگ ها: HTML <area> tag


کلیه توابع و خصوصیت های شیء Document در JavaScript Reference کلیه توابع و خصوصیت های شیء Document در JavaScript


تمامی محصولات و خدمات این وبسایت، حسب مورد دارای مجوزهای لازم از مراجع مربوطه می‌باشند و فعالیت‌های این سایت تابع قوانین و مقررات جمهوری اسلامی ایران است.
logo-samandehi مجوز نشر دیجیتال از وزرات فرهنگ و ارشاد اسلامی پرداخت آنلاین -  بانک ملت معرفی بیاموز در شبکه سه