الفرق بين المراجعتين ل"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> للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع DOMString لها كذلك. ما يعني بأنّك تستطيع | + | |
| + | ورغم أنّ الخاصيّة <code>Document.location</code> للقِراءة فقط، إلا أنّك تستطيع تعيين سلسلة نصيّة من النّوع <code>[[JavaScript/DOMString|DOMString]]</code> لها كذلك. ما يعني بأنّك تستطيع التّعامل مع هذه الخاصيّة بصفتها سلسلة نصيّة عاديّة في مُعظم الحالات. والسّطران التّاليّان مُتكافئان: | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
document.location = 'http://www.example.com' | document.location = 'http://www.example.com' | ||
document.location.href = 'http://www.example.com' | document.location.href = 'http://www.example.com' | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | للحصول على عنوان URL | + | للحصول على عنوان URL المُستندِ وحده، يُمكنك استعمال الخاصيّة <code>[[Document/URL|document.URL]]</code> كذلك. |
| − | إن لم يكن المُستند الحاليّ في سياق تصفّح، فالقيمة المُعادة ستكون null. | + | إن لم يكن المُستند الحاليّ في سياق تصفّح، فالقيمة المُعادة ستكون <code>null</code>. |
==البنية العامة== | ==البنية العامة== | ||
| سطر 46: | سطر 47: | ||
==انظر أيضا== | ==انظر أيضا== | ||
| − | واجهةُ القيمة | + | * واجهةُ القيمة المُعادة: <code>[[JavaScript/Location|Location]]</code>. |
| − | خاصيّة مُشابهة، لكنّها مُرتبطة بسياقِ تصفّح: Window.location. | + | * خاصيّة مُشابهة، لكنّها مُرتبطة بسياقِ تصفّح: <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