Window open() -menetelmä

Määritelmä ja käyttö

open() Menetelmä avaa uuden selaimen ikkunan tai välilehden, riippuen selaimen asetuksista ja parametrien arvoista.

Katso myös:

close() -menetelmä

Esimerkki

Esimerkki 1

Avaa "www.codew3c.com" uudessa selaimen välilehdessä:

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

Kokeile itse

Sivun alapuolella tarjotaan lisää esimerkkejä.

Syntaksi

window.open(url, name, ominaisuudet, korvaa)

Parametri

Parametri kuvaus
url

Valinnainen. Avattavan sivun URL.

Jos ei määritetty urlAvaa uuden tyhjän ikkunan tai välilehden.

name Valinnainen. target-ominaisuus tai ikkunan nimi.
ominaisuudet Valinnainen. Komalla eroteltu kohteiden lista, ilman välilyöntejä.
korvaa

Käytöstä poistunut.

Määrittää, luodaanko URL uusi kohta vai korvataanko nykyinen kohta historia-listassa.

Tuen seuraavat arvot:

  • true - URL korvaa historia-listassa olevan nykyisen dokumentin
  • false - URL luo uuden kohteen historia-listaan

Varoitus:Chrome käyttää korvaa parametria käytettäessä heitetään poikkeus.

name-parametrin tukee seuraavia arvoja:

arvo kuvaus
_blank URL ladataan uuteen ikkunaan tai välilehdessä. Oletus.
_parent URL ladataan isäkehykseen.
_self URL korvaa nykyisen sivun.
_top URL korvaa mahdollisesti ladattavat kehysryhmät.
name ikkunan nimi (ei määritetä ikkunan otsikkoa).

features-parametria tukee seuraavia arvoja:

arvo kuvaus
fullscreen=yes|no|1|0 Näytetäänkö selain täysin näytön tilassa. Oletusarvo on ei. Täysin näytön tilassa olevat ikkunat ovat myös elokuvatilassa. Vain IE.
height=pixels ikkunan korkeus pikseleissä. Minimiarvo on 100.
left=pixels ikkunan vasemman reunan sijainti (X-koordinaatti) pikseleissä. Negatiivisia arvoja ei sallita.
location=yes|no|1|0 Näytetäänkö osoitekenttä. Vain Opera.
menubar=yes|no|1|0 Näytetäänkö valikkopalkki.
resizable=yes|no|1|0 Voiko ikkuna säätää kokoa. Vain IE.
scrollbars=yes|no|1|0 Näytetäänkö roolipalkit. Vain IE, Firefox ja Opera.
status=yes|no|1|0 Lisätäänkö tilapalkki.
titlebar=yes|no|1|0 Näytetäänkö otsikkopalkki. Ellei sovellus ole HTML-sovellus tai luotettu dialogi, sitä ei oteta huomioon.
toolbar=yes|no|1|0 Näytetäänkö selaimen työkalupalkki. Vain IE ja Firefox.
top=pixels ikkunan yläosan sijainti (Y-koordinaatti) pikseleissä. Negatiivisia arvoja ei sallita.
width=pixels ikkunan leveys pikseleissä. Minimiarvo on 100.

palautusarvo

palauttaa viittauksen uuteen ikkunaan, jos kutsu epäonnistuu, niin null.

tekniset yksityiskohdat

kuvaus

open() menetelmä etsii olemassa olevaa ikkunaa tai avaa uuden selaimen ikkunan. Jos name parametria määrittämä olemassa oleva ikkuna, niin palautetaan viittaus kyseiseen ikkunaan. Palautettu ikkuna näyttää url parametria määrittämä dokumentti, mutta se jätetään huomiotta ominaisuudet parametria. Tämä on ainoa tapa, jossa JavaScript voi saada viittauksen kyseiseen ikkunaan, kun ikkunaa tunnetaan vain nimeltä.

ei ole määritetty name parametrit, tai jos määritettyä ikkunaa ei ole, niin open() menetelmä luo uuden selaimen ikkunan. Tämä uusi ikkuna näyttää url parametria määrittämä URL, sen nimi name määritetty, koko ja kontrollit ominaisuudet parametria määrittää. url on tyhjä merkkijono, niin open() avaa uuden ikkunan.

name parametria määrittääksesi uuden ikkunan nimen. Tämä nimi voi sisältää vain numeroita, kirjaimia tai alaviivoja. Se voidaan käyttää merkinnänä <a> ja <form> target-ominaisuuden arvoa, jotta dokumentti näytetään tässä määritetyssä ikkunassa.

kun käytetään menetelmää Window.open() Kun uusi dokumentti ladataan olemassa olevaan määritettyyn ikkunaan, sitä voidaan toimittaa korvaa -parametrin, jota käytetään määrittämään, onko uusi dokumentti oma kohteensa selaimen selaushistoriassa vai korvaa se nykyisen dokumentin kohteen. Jos korvaa arvo on true, uusi dokumentti korvaa vanhan dokumentin. Jos arvo on false tai se on jätetty pois, uusi dokumentti omaa oman kohteen selaimen selaushistoriassa. Tämä parametri tarjoaa saman toiminnon Location.replace() -menetelmän tarjoamaa toimintoa.

ei pidä sekoittaa Window.open() eikä Document.open() -menetelmääole suositeltavaa käyttää Window.open()eikä open(). Yleensä HTML-ominaisuuksien määriteltyjen tapahtumankäsittelijöissä funktio open() tulkitaan Document.open()on Window.open().

Ikkunaominaisuudet

ominaisuudet parametri on luettelo ominaisuuksista, jotka ikkunassa näytetään, ja jotka erotetaan toisistaan pilkulla. Jos tämän valinnaisen parametrin arvo on tyhjä tai se on jätetty pois, ikkuna näyttää kaikki ominaisuudet. Mutta jos ominaisuudet määrittää jonkin ominaisuuden, jolloin tähän luetteloon ei kuuluvat ominaisuudet eivät näy ikkunassa. On huomattava, että tämä merkkijono ei sisällä minkäänlaisia välilyöntejä tai välitiloja, ja jokaisen elementin muotoilu näyttää tältä:

ominaisuus[=arvo]

Useimmille ominaisuuksillearvo arvon on oltava "yes" tai "no". arvo arvoja voidaan jättää pois, jos tämä ominaisuus on määritetty, oletetaan arvo Arvo on "yes", ellei sitä ole annettu, oletetaan arvo Arvo on "no". arvo Arvon on oltava pakollinen, varmista, että annat niiden pikseliarvot.

Selaintuki

Kaikki selaimet tukevat open():

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Tuki Tuki Tuki Tuki Tuki Tuki

Lisää esimerkkejä

Esimerkki 2

Avaa about:blank-sivu uudessa ikkunassa tai välilehdessä:

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

Kokeile itse

Esimerkki 3

Avaa uusi ikkuna nimeltä "MsgWindow" ja kirjoita siihen tekstiä:

var myWindow = window.open("", "MsgWindow", "width=200,height=100");
myWindow.document.write("<p>Tämä on 'MsgWindow'. Olen 200px leveä ja 100px korkea!</p>");

Kokeile itse

Esimerkki 4

Avaa uusi ikkuna korvaamaan nykyisen ikkunan:

var myWindow = window.open("", "_self");
myWindow.document.write("<p>korvasin nykyisen ikkunan.</p>")}}

Kokeile itse

Esimerkki 5

Avaa uuden ikkunan ja hallitse sen ulkoasua:

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

Kokeile itse

Esimerkki 6

Avaa useita välilehtiä:

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

Kokeile itse

Esimerkki 7

Avaa uuden ikkunan. Sitten käytä close()-toimintoa sulkeaksesi tämän ikkunan:

function openWin() {
  myWindow = window.open("", "myWindow", "width=200,height=100");   // Avaa uuden ikkunan
}
function closeWin() {
  myWindow.close();   // Sulje tämä uusi ikkuna
}

Kokeile itse

Esimerkki 8

Avaa uusi ikkuna. Käytä name-ominaisuutta palauttaaksesi uuden ikkunan nimen:

var myWindow = window.open("", "MsgWindow", "width=200,height=100");
myWindow.document.write("<p>Tämän ikkunan nimi on: " + myWindow.name + "</p>");

Kokeile itse

Esimerkki 9

Käytä opener-ominaisuutta palauttaaksesi viittauksen luodun uuden ikkunan ikkunaan:

var myWindow = window.open("", "myWindow", "width=200,height=100");   // Avaa uuden ikkunan
myWindow.document.write("<p>Tämä on 'myWindow'!</p>");   // Uuden ikkunan teksti
myWindow.opener.document.write("<p>Tämä on lähdeikkuna!</p>");  // Luo uusi ikkuna ikkunan tekstiä varten

Kokeile itse