Window open() 方法

定义和用法

open() 方法会打开新的浏览器窗口或新选项卡,具体取决于您的浏览器设置和参数值。

另请参阅:

close() 方法

实例

例子 1

在新的浏览器选项卡中打开 "www.codew3c.com":

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

Cuba sendiri

页面下方提供更多实例。

语法

window.open(url, name, features, parameter, untuk mengatakan sama ada dokumen baru adalah dalam sejarah pelayar tetingkap sendiri, atau menggantikan entri dokumen semasa. Jika)

参数

参数 penjelasan
url

可选。要打开的页面的 URL。

如果未指定 url,则会打开一个新的空白窗口或选项卡。

name 可选。target 属性或窗口的名称。
features 可选。以逗号分隔的项目列表,无空格。
parameter, untuk mengatakan sama ada dokumen baru adalah dalam sejarah pelayar tetingkap sendiri, atau menggantikan entri dokumen semasa. Jika

已弃用。

规定 URL 是创建新条目还是替换历史列表中的当前条目。

支持以下值:

  • true - URL 替换历史列表中的当前文档
  • false - URL 在历史列表中创建新条目

警告:Chrome 在使用 parameter, untuk mengatakan sama ada dokumen baru adalah dalam sejarah pelayar tetingkap sendiri, atau menggantikan entri dokumen semasa. Jika 参数时会抛出异常。

name 参数支持以下值:

nilai penjelasan
_blank URL 被加载到新窗口或选项卡中。默认。
_parent URL 被加载到父框架中。
_self URL 替换当前页面。
_top URL menggantikan mana-mana framework yang boleh dimuat.
name nama jendela (tidak tentukan tajuk jendela).

parameter features menyokong nilai berikut:

nilai penjelasan
fullscreen=yes|no|1|0 sama ada hendak memaparkan pelayar dalam mod skrin penuh. Lengkapnya adalah Tidak. Jendela mod skrin penuh juga mesti berada dalam mod filem. Hanya untuk IE.
height=pixels tinggi jendela, dalam satuan piksel. Saiz minimum adalah 100.
left=pixels kedudukan kiri jendela (koordinat X), dalam satuan piksel. Tidak diizinkan nilai negatif.
location=yes|no|1|0 sama ada hendak memaparkan medan alamat. Hanya untuk Opera.
menubar=yes|no|1|0 sama ada hendak memaparkan papan menu.
resizable=yes|no|1|0 jendela sama ada boleh diubah saiz. Hanya untuk IE.
scrollbars=yes|no|1|0 sama ada hendak memaparkan palang skrol. Hanya untuk IE, Firefox dan Opera.
status=yes|no|1|0 sama ada hendak menambah papan status.
titlebar=yes|no|1|0 sama ada hendak memaparkan papan tajuk. Kecuali aplikasi yang dipanggil adalah aplikasi HTML atau dialog yang dipercayai, maka akan diabaikan.
toolbar=yes|no|1|0 sama ada hendak memaparkan papan alat pelayar. Hanya untuk IE dan Firefox.
top=pixels kedudukan atas jendela (koordinat Y), dalam satuan piksel. Tidak diizinkan nilai negatif.
width=pixels lebar jendela, dalam satuan piksel. Saiz minimum adalah 100.

nilai kembalikan

referensi ke jendela baru, jika pemuat gagal, maka null.

detil teknikal

penerangan

open() kaedah akan mencari jendela yang sudah ada atau membuka jendela pelayar baru. Jika name jika parameter untuk jendela yang sudah ada telah ditentukan, maka kembalikan referensi ke jendela itu. Jendela yang diembalikkan akan memaparkan url dokumen yang ditentukan oleh parameter, tetapi mengabaikan features ditentukan. Dalam keadaan hanya diketahui nama jendela, ini adalah cara tunggal JavaScript mendapatkan referensi ke jendela itu.

jika tiada parameter name parameter, atau jika jendela yang ditentukan tidak wujud, maka open() kaedah akan membuat jendela pelayar baru. Jendela baru ini akan memaparkan url URL yang ditentukan oleh parameter, namanya ditentukan oleh name jika ditentukan, saiz dan kontrol oleh features parameter untuk ditentukan. url jika kosong, maka open() akan membuka jendela baru.

name parameter untuk menentukan nama jendela baru. Nama ini hanya boleh mengandungi nombor, huruf atau garis bawah. Ia boleh digunakan sebagai tanda <a> dan <form> nilai properti target, untuk memaksa dokumen untuk dipaparkan di dalam jendela yang ditentukan.

ketika menggunakan kaedah Window.open() Saat memuat dokumen baru ke jendela yang sudah ada, boleh dihantar parameter, untuk mengatakan sama ada dokumen baru adalah dalam sejarah pelayar tetingkap sendiri, atau menggantikan entri dokumen semasa. Jika 参数,用来声明新文档是在窗口的浏览历史中拥有自己的条目,还是替换当前文档的条目。如果 parameter, untuk mengatakan sama ada dokumen baru adalah dalam sejarah pelayar tetingkap sendiri, atau menggantikan entri dokumen semasa. Jika replace apabila nilai adalah true, dokumen baru akan menggantikan dokumen lama. Jika nilai adalah false, atau diabaikan, dokumen baru akan mempunyai entri sendiri di sejarah pelayar tetingkap. Fungsi parameter ini adalah sama seperti yang disediakan oleh fungsi. Method Location.replace()

jangan campur tangan Window.open() method hampir sama dengan Document.open() methoduntuk membuat kod anda jelas dan mudah difahami, lebih baik gunakan Window.open()tanpa menggunakan open()biasanya digunakan untuk mengartikan fungsi open() Document.open()oleh kerana, dalam keadaan ini, Window.open().

Sifat tetingkap

features parameter adalah senarai sifat yang akan dipaparkan di dalam tetingkap, di mana setiap sifat dipisahkan dengan koma. Jika nilai parameter ini kosong atau diabaikan, tetingkap akan memaparkan semua sifat. Walau bagaimanapun, jika features menentukan sifat khas, sifat yang tidak muncul dalam senarai ini tidak akan dipaparkan di dalam tetingkap. Perhatikan bahawa string ini tidak mengandungi apa-apa ruang atau simbol kosong, di mana setiap elemen berformat seperti berikut:

feature[=value]

Untuk kebanyakan sifat,value nilai adalah yes atau no. Simbol sama dengan dan value Nilai boleh diabaikan, jika muncul, jadilah value Nilai adalah yes, jika tidak muncul, jadilah value Nilai adalah no. Walau bagaimanapun, nilai khas width atau height value Nilai adalah wajib, jadilah pasti tentukan nilai piksel mereka.

Pendukung pelayar

Semua pelayar mendukung open():

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Disebabkan Disebabkan Disebabkan Disebabkan Disebabkan Disebabkan

Lebih banyak contoh

Contoh 2

Buka laman about:blank di dalam tetingkap/pekala baru:

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

Cuba sendiri

Contoh 3

Buka tetingkap baru bernama "MsgWindow" dan tulis beberapa teks didalamnya:

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

Cuba sendiri

Contoh 4

Tukar tetingkap baru untuk tetingkap semasa:

var myWindow = window.open("", "_self");
myWindow.document.write("<p>Saya menggantikan window saat ini.</p>")

Cuba sendiri

Contoh 5

Membuka window baru dan mengawasi penampilannya:

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

Cuba sendiri

Contoh 6

Membuka beberapa tab:

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

Cuba sendiri

Contoh 7

Membuka window baru. kemudian gunakan close() untuk menutup window ini:

function openWin() {
  myWindow = window.open("", "myWindow", "width=200,height=100");   // Membuka window baru
}
function closeWin() {
  myWindow.close();   // Menutup window baru ini
}

Cuba sendiri

Contoh 8

Membuka window baru. Menggunakan properti name untuk mengembalikan nama window baru:

var myWindow = window.open("", "MsgWindow", "width=200,height=100");
myWindow.document.write("<p>Nama window ini adalah: " + myWindow.name + "</p>");

Cuba sendiri

Contoh 9

Menggunakan properti opener untuk mengembalikan referensi kepada window yang membuat window baru:

var myWindow = window.open("", "myWindow", "width=200,height=100");   // Membuka window baru
myWindow.document.write("<p>Ini adalah 'myWindow'</p>");   // Teks kepada window baru
myWindow.opener.document.write("<p>Ini adalah window sumber!</p>");  // Menulis teks kepada window yang dibuka untuk window baru

Cuba sendiri