Window objekti

Window objekti

Window-objekti edustaa selaimessa avoimia ikkunoita.

Jos dokumentti sisältää kehyksiä (<iframe>-elementti), selain luo HTML-dokumentille ikkunaojenteen ja luo ylimääräisiä ikkunaojenttejä jokaiselle kehykselle.

Window-objektin ominaisuudet

Olio 描述
closed Palauttaa, onko ikkuna suljettu.
console 返回窗口的 Console-objekti。
defaultStatus 弃用。Asettaa tai palauttaa ikkunan tilapalkin oletusarvoisen tekstin.
document 返回窗口的 Document-objekti。
frameElement Palauttaa kaikki ikkunassa suoritettavat kehykset.
frames Palauttaa kaikki ikkunassa suoritettavat ikkunat.
history 返回窗口的 History-objekti。
innerHeight Palauttaa ikkunan dokumentin näyttöalueen korkeuden.
innerWidth Palauttaa ikkunan dokumentin näyttöalueen leveyden.
length Palauttaa nykyisessä ikkunassa olevien <iframe>-elementtien määrän.
localStorage Mahdollistaa avainsanaväliä/arvojen tallentamisen Web-selaimessa. Tallenna tietoja ilman erääntymispäivää.
location 返回窗口的 Location-objekti。
name Asettaa tai palauttaa ikkunan nimen.
navigator 返回窗口的 Navigator-objekti。
opener Palauttaa luodun ikkunan viittauksen.
outerHeight Palauttaa selaimen ikkunan korkeuden, mukaan lukien työkalupalkki/roolikuva.
outerWidth Palauttaa selaimen ikkunan leveyden, mukaan lukien työkalupalkki/roolikuva.
pageXOffset Palauttaa nykyisen dokumentin pyöristetyn kuvan pinnan (horisontaalisesti) kuvapisteinä.
pageYOffset Palauttaa nykyisen dokumentin pyöristetyn kuvan pinnan (pystysuunnassa) kuvapisteinä.
parent 返回当前窗口的父窗口。
screen 返回窗口的 Screen objekti。
screenLeft 返回窗口相对于屏幕的水平坐标。
screenTop 返回窗口相对于屏幕的垂直坐标。
screenX 返回窗口相对于屏幕的水平坐标。
screenY 返回窗口相对于屏幕的垂直坐标。
sessionStorage 允许在 Web 浏览器中保存键/值对。存储会话的数据。
scrollX pageXOffset 的别名。
scrollY pageYOffset 的别名。
self 返回当前窗口。
status 已弃用。请避免使用它。
top 返回最顶层的浏览器窗口。

Window 对象方法

方法 描述
alert() 显示带有消息和确定按钮的警报框（对话框）。
atob() 解码 base-64 编码的字符串。
blur() 从当前窗口移除焦点。
btoa() 以 base-64 编码字符串。
clearInterval() 清除使用 setInterval() 设置的计时器。
clearTimeout() 清除使用 setTimeout() 设置的计时器。
close() 关闭当前窗口。
confirm() 显示包含消息以及确定和取消按钮的对话框。
focus() 将焦点设置到当前窗口。
getComputedStyle() 确定应用到一个文档元素的 CSS 样式。
getSelection() 返回 Selection 对象，表示用户选择的文本范围。
matchMedia() 返回 MediaQueryList 对象，表示指定的 CSS 媒体查询字符串。
moveBy() 相对于其当前位置移动窗口。
moveTo() 将窗口移动到指定位置。
open() 打开新的浏览器窗口。
print() 打印当前窗口的内容。
prompt() 使用对话框请求输入一条简单的字符串。
requestAnimationFrame() 请求浏览器在下一次重绘之前调用函数来更新动画。
resizeBy() 按指定像素调整窗口大小。
resizeTo() 将窗口大小调整为指定的宽度和高度。
scroll() 弃用。此方法已被 scrollTo() 方法 替代。
scrollBy() 滚动文档到指定的像素数。
scrollTo() Siirrä dokumentti määritettyyn koordinaattiin.
setInterval() Suorita määritetty koodi säännöllisesti.
setTimeout() Suorita koodi määritetyn ajan jälkeen.
stop() Pysäytä ikkunan lataaminen.

Window-objektin kuvaus

Window-objekti edustaa selaimen ikkunaa tai kehyksiä. Asiakassivun JavaScriptissä Window-objekti on globaali objekti, ja kaikki lausekkeet lasketaan nykyisessä ympäristössä. Tämä tarkoittaa, että nykyisen ikkunan viittaamiseen ei tarvita erityistä syntaksia, ja voit käyttää kyseisen ikkunan ominaisuuksia globaalina muuttujana. Esimerkiksi voit kirjoittaa vain documentEikä tarvitse kirjoittaa window.document.

Samoin, voit käyttää nykyisen ikkunaobjektin menetelmiä funktiona, kuten kirjoittaessaan vain alert(), eikä tarvitse kirjoittaa Window.alert().

Lisäksi, paitsi edellä luetelluista ominaisuuksista ja menetelmistä, Window-objekti toteuttaa kaikki core JavaScriptissä määritellyt globaalit ominaisuudet ja metodit.

Window-objektin window-ominaisuus ja self-ominaisuusViitataan aina itseensä. Kun haluat selkeästi viitata nykyiseen ikkunaan, ei pelkästään implisiittisesti, voit käyttää näitä ominaisuuksia. Näiden kahden ominaisuuden lisäksi parent-ominaisuus, top-ominaisuus ja frame[] -taulukko viittaavat muihin nykyisen Window-objektin kanssa liittyviin Window-objekteihin.

Jos haluat viitata ikkunan kehykseen, voit käyttää seuraavaa syntaksia:

frame[i]		// nykyisen ikkunan kehykset
self.frame[i]	// nykyisen ikkunan kehykset
w.frame[i]	// ikkunan w kehykset

Jos haluat viitata kehyksen emoikkunaan (tai emokehys) käyttää voit seuraavaa syntaksia:

parent		// nykyisen ikkunan emoikkuna
self.parent	// nykyisen ikkunan emoikkuna
w.parent 		// ikkunan w emoikkuna

Jos haluat viitata yliseen ikkunaan, joka sisältää minkä tahansa kehyksen, voit käyttää seuraavaa syntaksia:

top		// nykyisen kehyksen ylin ikkuna
self.top		// nykyisen kehyksen ylin ikkuna
f.top		// kehyksen f ylin ikkuna

Uusi ylin selaimen ikkuna luodaan metodilla Window.open(). Kun kutsutaan tätä metodia, tulisi tallentaa open() -kutsun palautusarvo muuttujaan ja käyttää sitä uuden ikkunan viittaamiseen. Uuden ikkunan opener-ominaisuusviittaa takaisin sitä avanneeseen ikkunaan.

Yleensä, Window-objektin metodit suorittavat jokin toiminto selaimen ikkunassa tai kehyksessä. Ja alert() -metodi、confirm() -metodija prompt-metodiErilaiset, ne kommunikoivat käyttäjän kanssa yksinkertaisen dialogin avulla.