طريقة Window open()

التعريف والاستخدام

open() تفتح نافذة متصفح جديدة أو علامة تبويب جديدة، اعتمادًا على إعدادات المتصفح الخاص بك ومعاملات القيمة.

انظر أيضًا:

طريقة close()

مثال

مثال 1

فتح "www.codew3c.com" في علامة التبويب الجديدة للمتصفح:

window.open("https://www.codew3c.com");

تجربة شخصية

تقدم الصفحة أدناه أمثلة إضافية.

النص النشط

window.open(يحدد., name, features, المعامل، وهو مخصص لتحديد ما إذا كان المستند الجديد سيكون له مسار خاص به في تاريخ التصفح للنافذة أم سيستبدل مسار المستند الحالي. إذا)

معامل

معامل وصف
يحدد.

اختياري. URL للصفحة التي سيتم فتحها.

إذا لم يتم تحديد يحدد.، سيتم فتح نافذة جديدة أو علامة تبويب فارغة.
name اختياري. الخاصية target أو اسم النافذة.
features اختياري. قائمة بالأسماء المميزة المفصولة بالكومات، بدون مسافات.
المعامل، وهو مخصص لتحديد ما إذا كان المستند الجديد سيكون له مسار خاص به في تاريخ التصفح للنافذة أم سيستبدل مسار المستند الحالي. إذا

مستبعد.

يحدد ما إذا كان يجب إنشاء مسار جديد أم استبدال المسار الحالي في قائمة التاريخ

يتم دعم القيم التالية:

  • true - استبدال المستند الحالي في قائمة التاريخ
  • false - إنشاء مسار جديد في قائمة التاريخ

تحذير:Chrome عند استخدام المعامل، وهو مخصص لتحديد ما إذا كان المستند الجديد سيكون له مسار خاص به في تاريخ التصفح للنافذة أم سيستبدل مسار المستند الحالي. إذا سيتم إلقاء استثناء عند استخدام المعامل.

يتم دعم القيم التالية من معامل name:

القيمة وصف
_blank URL يتم تحميلها في نافذة جديدة أو علامة تبويب. افتراضي.
_parent URL يتم تحميلها في إطار الأب.
_self استبدال URL الصفحة الحالية.
_top URL يحل محل أي إطار يتم تحميله.
name اسم النافذة (لا يتم تحديد عنوان النافذة).

يدعم معامل الخصائص القيم التالية:

القيمة وصف
fullscreen=yes|no|1|0 هل يتم عرض المتصفح في نمط الشاشة الكاملة. الافتراضي هو لا. يجب أن تكون النافذة في نمط السينما أيضًا في نمط الشاشة الكاملة. فقط في IE.
height=pixels عرض النافذة، مقاسها بالبكسل. الحد الأدنى هو 100.
left=pixels الموقع اليساري للنافذة (الموقع X)، مقاسها بالبكسل. لا يُسمح بالقيم السلبية.
location=yes|no|1|0 هل يتم عرض حقل العنوان. فقط في Opera.
menubar=yes|no|1|0 هل يتم عرض شريط القائمة.
resizable=yes|no|1|0 هل يمكن تغيير حجم النافذة. فقط في IE.
scrollbars=yes|no|1|0 هل يتم عرض شريط التحرك. فقط في IE، Firefox و Opera.
status=yes|no|1|0 هل يتم إضافة شريط الحالة.
titlebar=yes|no|1|0 هل يتم عرض شريط العناوين. سيتم تجاهل ذلك إلا إذا كان التطبيق المطلوب هو تطبيق HTML أو نافذة حوار موثوق.
toolbar=yes|no|1|0 هل يتم عرض شريط الأدوات للمتصفح. فقط في IE و Firefox.
top=pixels الوقت العلوية للنافذة (الموقع Y)، مقاسها بالبكسل. لا يُسمح بالقيم السلبية.
width=pixels عرض عرض النافذة، مقاسها بالبكسل. الحد الأدنى هو 100.

القيمة المعدة للإرجاع

إشارة إلى النافذة الجديدة، وإذا فشلت الدعوة، فإنها تعود إلى null.

تفاصيل التقنية

شرح

open() يبحث عن النافذة الموجودة بالفعل أو يفتح نافذة متصفح جديدة. إذا name إذا تم تحديد نافذة موجودة بالفعل، فإنها تعود إلى تلك النافذة. النافذة المعدة للعرض تحتوي على يحدد. الرقم المحدد من قبل features عند معرفة اسم النافذة فقط، فهذا هو الطريقة الوحيدة التي يمكن بها JavaScript الحصول على إشارة إلى تلك النافذة.

إذا لم يتم تحديد name إذا لم يتم تحديد open() الرقم المحدد، أو إذا لم يتم تحديد النافذة المحددة، يحدد. يُنشأ بواسطة الطريقة، النافذة الجديدة ستعرض name الرقم المحدد من قبل URL المحدد بواسطة features إذا تم تحديده، فإن حجم والسيطرة يتم تحديدها بواسطة يحدد. إذا كان فارغًا، open() سيفتح نافذة جديدة.

name يحدد اسم النافذة الجديدة. يمكن أن يحتوي الاسم فقط على الأرقام، الحروف أو الأشرطة. <a> و <form> قيمة الخاصية target، لتحفيز عرض المستند في هذه النافذة المحددة.

عند استخدام الطريقة Window.open() عند تحميل مستند جديد لنافذة معينة موجودة، يمكنه أن يرسل المعامل، وهو مخصص لتحديد ما إذا كان المستند الجديد سيكون له مسار خاص به في تاريخ التصفح للنافذة أم سيستبدل مسار المستند الحالي. إذا 参数，用来声明新文档是在窗口的浏览历史中拥有自己的条目，还是替换当前文档的条目。如果 المعامل، وهو مخصص لتحديد ما إذا كان المستند الجديد سيكون له مسار خاص به في تاريخ التصفح للنافذة أم سيستبدل مسار المستند الحالي. إذا replace ، إذا كان قيمته true، سيتم استبدال المستند القديم بالمستند الجديد. إذا كانت القيمة false أو تم تجاهلها، فإن المستند الجديد سيكون له مسار خاص به في تاريخ التصفح للنافذة. تقدم هذه الخاصية نفس الميزة مثل Location.replace() method

الميزات المقدمة مشابهة جدًا. Window.open() ، لا يجب الخلط بين Document.open() method، من أجل أن يكون شفافًا واضحًا في شيفرةك، من الأفضل استخدام Window.open()، وليس يجب استخدام open()، عادة ما يتم تفسير function open() في الحالات المحددة كـ Document.open()، لذلك، في هذه الحالة، يجب استخدام Window.open().

خصائص النافذة

features المعامل هو قائمة الخاصيات التي يجب عرضها في النافذة، ويتم فصل الخاصيات بفواصل. إذا كان قيمة هذا المعامل فارغة أو تم تجاهلها، فإن النافذة ستعرض جميع الخاصيات. ومع ذلك، إذا features تم تحديد خاصية معينة، فإن الخاصيات التي لا تظهر في هذه القائمة لن تظهر في النافذة. يجب الانتباه إلى أن هذا السلسلة لا تحتوي على أي مسافات أو مسافات، حيث يكون نمط كل عنصر كما يلي:

feature[=value]

بالنسبة لمعظم الخاصيات،value القيمة هي yes أو no. يجب أن تكون هناك مسافة بعد هذه الخاصية و value يمكن تجاهل القيم، إذا كانت موجودة، يتم افتراض value القيمة هي yes، إذا لم يكن هناك، يتم افتراض value القيمة هي no. ومع ذلك، إذا لم يكن هناك قيمة للخصائص width أو height، value القيمة ضرورية، يجب تحديد قيمها كأرقام بكسل.

دعم المتصفحات

يدعم جميع المتصفحات open():

كروم آي إي إدج فايرفوكس سفاري أوبرا
كروم آي إي إدج فايرفوكس سفاري أوبرا
دعم دعم دعم دعم دعم دعم

مزيد من الأمثلة

مثال 2

افتح صفحة about:blank في نافذة/علامة التبويب الجديدة:

var myWindow = window.open("", "", "width=200,height=100");

تجربة شخصية

مثال 3

افتح نافذة جديدة بعنوان "MsgWindow" واكتب بعض النصوص فيها:

var myWindow = window.open("", "MsgWindow", "width=200,height=100");
myWindow.document.write("<p>This is 'MsgWindow'. I am 200px wide and 100px tall!</p>");

تجربة شخصية

مثال 4

بفتح نافذة جديدة لتعويض النافذة الحالية：

var myWindow = window.open("", "_self");
myWindow.document.write("<p>لقد استبدلت النافذة الحالية.</p>")

تجربة شخصية

مثال 5

فتح نافذة جديدة وتحكم في مظهرها:

window.open("https://www.codew3c.com", "_blank", "toolbar=yes,scrollbars=yes,resizable=yes,top=500,left=500,width=400,height=400");

تجربة شخصية

مثال 6

فتح عدة علامات تبويب:

window.open("http://www.google.com/");
window.open("https://www.codew3c.com/");

تجربة شخصية

مثال 7

فتح نافذة جديدة. ثم استخدم close() لإغلاق هذه النافذة

function openWin() {
  myWindow = window.open("", "myWindow", "width=200,height=100");   // فتح نافذة جديدة
}
function closeWin() {
  myWindow.close();   // إغلاق هذه النافذة الجديدة
}

تجربة شخصية

مثال 8

فتح نافذة جديدة. استخدم خاصية name لاستعادة اسم النافذة الجديدة:

var myWindow = window.open("", "MsgWindow", "width=200,height=100");
myWindow.document.write("<p>اسم هذه النافذة هو: " + myWindow.name + "</p>");

تجربة شخصية

مثال 9

استخدم خاصية opener لاستعادة اشارة إلى النافذة التي تم إنشاؤها

var myWindow = window.open("", "myWindow", "width=200,height=100");   // فتح نافذة جديدة
myWindow.document.write("<p>هذا هو 'myWindow'</p>");   // نص النافذة الجديدة
myWindow.opener.document.write("<p>هذا هو نافذة المصدر!</p>");  // نص نافذة التطبيق الجديدة

تجربة شخصية