موضوع Window

موضوع Window

شیء Window نماینده‌ای از پنجره‌ای که در مرورگر باز شده است است.

اگر مستند شامل فریم (برچسب frame یا iframe) باشد، مرورگر یک شیء window برای مستند HTML ایجاد می‌کند و برای هر فریم یک شیء window اضافی ایجاد می‌کند.

نکته:没有应用于 window 对象的公开标准，不过所有浏览器都支持该对象。

هیچ استاندارد عمومی برای window وجود ندارد، اما همه مرورگرها از این اشیا پشتیبانی می‌کنند.

مجموعه Window توضیح
Window

تمام فریم‌های نام‌گذاری شده در پنجره را برمی‌گرداند.

مجموعه

frames[]

این مجموعه یک آرایه از اشیای Window است، هر Window شامل یک فریم یا <iframe> در پنجره دارد. ویژگی frames.length تعداد عناصر موجود در آرایه frames[] را ذخیره می‌کند. توجه داشته باشید که فریم‌های موجود در آرایه frames[] ممکن است فریم‌های دیگری نیز داشته باشند که خودشان نیز آرایه frames[] دارند. توضیح
ویژگی‌های Window ویژگی
closed متن پیش‌فرض نوار وضعیت پنجره را تنظیم یا برمی‌گرداند.
document defaultStatus ارجاع خوانا به اشیای Document. لطفاً ببینید..
اشیا Document history موضوع History.
ارجاع خوانا به اشیای History. لطفاً پارامتر را ببینید. ارتفاع ناحیه نمایش مستند پنجره را برمی‌گرداند.
innerwidth پهناي ناحیه نمایش مستند پنجره را برمی‌گرداند.
length تعداد فریم‌های موجود در پنجره را تنظیم یا برمی‌گرداند.
location اشیا Location برای پنجره یا فریم. لطفاً ببینید. موضوع Location.
name نام پنجره را تنظیم یا برمی‌گرداند.
Navigator ارجاع خوانا به اشیای Navigator. لطفاً پارامتر را ببینید. موضوع Navigator.
opener ارجاع به پنجره‌ای که این پنجره را ایجاد کرده است را برمی‌گرداند.
outerheight ارتفاع بیرونی پنجره را برمی‌گرداند.
outerwidth پهناي بیرونی پنجره را برمی‌گرداند.
pageXOffset موقعیت X صفحه فعلی را در برابر گوشه بالا چپ ناحیه نمایش پنجره تنظیم یا برمی‌گرداند.
pageYOffset موقعیت Y صفحه فعلی را در برابر گوشه بالا چپ ناحیه نمایش پنجره تنظیم یا برمی‌گرداند.
parent پنجره والد را برمی‌گرداند.
Screen ارجاع خوانا به اشیای Screen. لطفاً پارامتر را ببینید. موضوع Screen.
self ارجاع به پنجره فعلی را برمی‌گرداند. معادل ویژگی Window است.
status متن نوار وضعیت پنجره را تنظیم می‌کند.
top پنجره والد را برمی‌گرداند.
window ویژگی window معادل ویژگی self است، که شامل ارجاع به پنجره خود است.
  • screenLeft
  • screenTop
  • screenX
  • screenY
 تنها اعداد خوانا. مشخص می‌کند که گوشه بالا چپ پنجره در کordinat x و y صفحه نمایش قرار دارد. IE، Safari و Opera از screenLeft و screenTop پشتیبانی می‌کنند، در حالی که Firefox و Safari از screenX و screenY پشتیبانی می‌کنند.

روش‌های شیء Window

روش توضیح
alert() یک پنجره اطلاع‌رسانی با یک پیام و دکمه تأیید نمایش می‌دهد.
blur() توجه کلید از پنجره بالایی برداشته می‌شود.
clearInterval() توقف timeout تنظیم شده توسط روش setInterval().
clearTimeout() توقف timeout تنظیم شده توسط روش setTimeout().
close() بستن پنجره مرورگر.
confirm() یک پنجره اطلاع‌رسانی با یک پیام و دکمه تأیید و لغو نمایش می‌دهد.
createPopup() یک پنجره پاپ‌آپ ایجاد می‌کند.
focus() توجه کلید به یک پنجره می‌دهد.
moveBy() می‌توان پنجره را به تعداد مشخص شده از پیکسل به صورت نسبی به موقعیت فعلی آن حرکت داد.
moveTo() بالای گوشه چپ پنجره را به یک موقعیت مشخص شده حرکت می‌دهد.
open() یک پنجره مرورگر جدید باز یا به یک پنجره نام‌گذاری شده جستجو می‌کند.
print() محتوای فعلی پنجره را چاپ می‌کند.
prompt() یک پنجره قابل اطلاع‌رسانی به کاربر باز می‌کند.
resizeBy() اندازه پنجره را به تعداد مشخص شده از پیکسل تنظیم می‌کند.
resizeTo() اندازه پنجره را به اندازه مشخص شده به صورت پیکسلی تنظیم می‌کند.
scrollBy() کонтنت به تعداد مشخص شده از پیکسل به صورت عمودی و افقی حرکت می‌دهد.
scrollTo() کонтنت به یک موقعیت مشخص شده به صورت عمودی و افقی حرکت می‌دهد.
setInterval() اجرای یک تابع یا محاسبه عبارات به صورت دوره‌ای (به میلی‌ثانیه) تعیین شده.
setTimeout() اجرای یک تابع یا محاسبه عبارات در پس از تعداد مشخصی از میلی‌ثانیه.

توضیح شی Window

شی Window یک پنجره مرورگر یا یک فریم است. در JavaScript کاربردهای کلاینت، شی Window یک شیء جهانی است و تمامی عبارات در محیط فعلی محاسبه می‌شوند. یعنی، برای اشاره به پنجره فعلی، نیازی به نویسی خاصی نیست و می‌توان ویژگی‌های آن را به عنوان متغیرهای جهانی استفاده کرد. به عنوان مثال، می‌توان فقط نوشت: document، نیازی به نوشتن window.document نیست.

همچنین، می‌توان روش‌های شی Window را به عنوان یک تابع استفاده کرد، مانند alert() که نیازی به نوشتن Window.alert() نیست.

بجز ویژگی‌ها و روش‌هایی که در بالا لیست شده‌اند، شی Window نیز تمام ویژگی‌ها و روش‌های جهانی که توسط JavaScript تعریف شده‌اند را پیاده‌سازی کرده است.

ویژگی window Window اشیاء ویژگی selfهمه به خود اشاره می‌کنند. وقتی می‌خواهید به طور خاص به پنجره فعلی اشاره کنید و نه به صورت ضمنی، می‌توانید از این دو ویژگی استفاده کنید. به علاوه، ویژگی‌های parent، top و آرایه frame[] به Window‌های دیگر مرتبط به Window فعلی اشاره می‌کنند.

برای اشاره به یک فریم در پنجره، می‌توان از این نحو استفاده کرد:

frame[i]		//فریم فعلی پنجره
self.frame[i]	//فریم فعلی پنجره
w.frame[i]	//فریم w پنجره

برای اشاره به پدر یک فریم (یا فریم پدر)، می‌توان از این نحو استفاده کرد:

parent		//پدر پنجره فعلی
self.parent	//پدر پنجره فعلی
w.parent 		//پنجره w پدر

برای اشاره به هر فریمی از پنجره بالاترین، می‌توان از این نحو استفاده کرد:

top		//فریم فعلی بالاترین پنجره
self.top		//فریم فعلی بالاترین پنجره
f.top		//فریم f بالاترین پنجره

پنجره‌های مرورگر بالاترین جدید توسط روش Window.open() ایجاد می‌شوند. هنگام فراخوانی این روش، باید مقدار بازگشتی open() را در یک متغیر ذخیره کنید و سپس از آن متغیر برای اشاره به پنجره جدید استفاده کنید. پنجره جدید ویژگی openerبه پنجره‌ای که آن را باز کرده است اشاره دارد.

به طور کلی، روش‌های Window به عملکرد برخی از نوع خاصی از پنجره‌های مرورگر یا فریم‌ها می‌پردازند. در حالی که روش alert()وروش confirm()و روش promptفرق می‌کند، آنها با یک پنجره ساده با کاربر تعامل دارند.