الفرق بين المراجعتين لصفحة: «JavaScript/Document/location»

مراجعة 16:20، 21 مارس 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

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