Window open() -menetelmä
- Edellinen sivu navigator
- Seuraava sivu opener
- Palaa yhdellä tasolla ylös Window-objekti
Määritelmä ja käyttö
open()
Menetelmä avaa uuden selaimen ikkunan tai välilehden, riippuen selaimen asetuksista ja parametrien arvoista.
Katso myös:
Esimerkki
Esimerkki 1
Avaa "www.codew3c.com" uudessa selaimen välilehdessä:
window.open("https://www.codew3c.com");
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:
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");
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>");
Esimerkki 4
Avaa uusi ikkuna korvaamaan nykyisen ikkunan:
var myWindow = window.open("", "_self"); myWindow.document.write("<p>korvasin nykyisen ikkunan.</p>")}}
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");
Esimerkki 6
Avaa useita välilehtiä:
window.open("http://www.google.com/"); window.open("https://www.codew3c.com/");
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 }
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>");
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
- Edellinen sivu navigator
- Seuraava sivu opener
- Palaa yhdellä tasolla ylös Window-objekti