الفرق بين المراجعتين لصفحة: «JavaScript/Document/location»
< JavaScript | Document
ط تنسيق |
طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.location</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.location</code>}}</noinclude> | ||
تُعيد الخاصيّة <code>Document.location</code> القابلة للقِراءة فقط | تُعيد الخاصيّة <code>Document.location</code> القابلة للقِراءة فقط كائنًا من النّوع <code>[[JavaScript/Location|Location]]</code>، والذي يحتوي على معلومات حول عنوان URL الخاصّ بالمُستند ويُتيح توابع لتعديل عنوان URL هذا وتحميل عنوان URL آخر. | ||
ورغم أنّ الخاصيّة <code>Document.location</code> للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع <code>[[JavaScript/DOMString|DOMString]]</code> لها كذلك. ما يعني بأنّك تستطيع التّعامل مع هذه الخاصيّة بصفتها سلسلة نصيّة عاديّة في مُعظم الحالات. والسّطران التّاليّان مُتكافئان: | ورغم أنّ الخاصيّة <code>Document.location</code> للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع <code>[[JavaScript/DOMString|DOMString]]</code> لها كذلك. ما يعني بأنّك تستطيع التّعامل مع هذه الخاصيّة بصفتها سلسلة نصيّة عاديّة في مُعظم الحالات. والسّطران التّاليّان مُتكافئان: | ||
| سطر 47: | سطر 47: | ||
==انظر أيضا== | ==انظر أيضا== | ||
واجهةُ القيمة المُعادة: <code>[[JavaScript/Location|Location]]</code>. | * واجهةُ القيمة المُعادة: <code>[[JavaScript/Location|Location]]</code>. | ||
* خاصيّة مُشابهة، لكنّها مُرتبطة بسياقِ تصفّح: <code>[[JavaScript/Window/location|Window.location]]</code>. | |||
خاصيّة مُشابهة، لكنّها مُرتبطة بسياقِ تصفّح: <code>[[JavaScript/Window/location|Window.location]]</code>. | |||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
المراجعة الحالية بتاريخ 03:57، 22 مارس 2018
تُعيد الخاصيّة Document.location القابلة للقِراءة فقط كائنًا من النّوع Location، والذي يحتوي على معلومات حول عنوان URL الخاصّ بالمُستند ويُتيح توابع لتعديل عنوان URL هذا وتحميل عنوان URL آخر.
ورغم أنّ الخاصيّة Document.location للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع DOMString لها كذلك. ما يعني بأنّك تستطيع التّعامل مع هذه الخاصيّة بصفتها سلسلة نصيّة عاديّة في مُعظم الحالات. والسّطران التّاليّان مُتكافئان:
document.location = 'http://www.example.com'
document.location.href = 'http://www.example.com'
للحصول على عنوان URL المُستندِ وحده، يُمكنك استعمال الخاصيّة document.URL كذلك.
إن لم يكن المُستند الحاليّ في سياق تصفّح، فالقيمة المُعادة ستكون null.
البنية العامة
locationObj = document.location
document.location = 'http://www.hsoub.com'
// هذا مُكافئ لما يلي
// document.location.href = 'http://www.hsoub.com'
مثال
dump(document.location);
// يطبع السّطر أعلاه سلسلة نصيّة مُشابهة لما يلي
// "https://wiki.hsoub.com/JavaScript"
دعم المتصفحات
| الميزة | Chrome | Edge | Firefox | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
انظر أيضا
- واجهةُ القيمة المُعادة:
Location. - خاصيّة مُشابهة، لكنّها مُرتبطة بسياقِ تصفّح:
Window.location.
مصادر ومواصفات
- مواصفة HTML Living Standard
- مواصفة HTML5