Metode Window open()

Definisi dan penggunaan

open() Metode ini akan membuka jendela browser baru atau tab baru, tergantung pengaturan browser Anda dan nilai parameter.

Lihat juga:

Metode close()

Contoh

Contoh 1

Buka "www.codew3c.com" di tab browser baru:

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

Coba Sendiri

Halaman di bawah ini menyediakan contoh tambahan.

Sintaks

window.open(url, name, features, replace)

Parameter

Parameter deskripsi
url

Pilihan. URL halaman yang akan dibuka.

Jika belum disebutkan url, maka akan dibuka jendela atau tab kosong baru.
name Pilihan. Atribut target atau nama jendela.
features Pilihan. Daftar item yang dipisahkan koma, tanpa spasi.
replace

Ditinggalkan.

menentukan URL adalah membuat entri baru atau menggantikan dokumen saat ini di daftar sejarah.

Dukung nilai berikut:

  • true - URL menggantikan dokumen saat ini di daftar sejarah
  • false - URL membuat entri baru di daftar sejarah

Peringatan:Chrome saat menggunakan replace parameter akan memunculkan eksepsi.

Parameter name mendukung nilai berikut:

nilai deskripsi
_blank URL ditampilkan di jendela baru atau tab. Standar.
_parent URL ditampilkan di bingkai induk.
_self URL menggantikan halaman saat ini.
_top URL menggantikan setiap frame set yang mungkin diunggah.
name nama jendela (tidak disediakan judul jendela)

parameter features mendukung nilai berikut:

nilai deskripsi
fullscreen=yes|no|1|0 apakah browser akan ditampilkan dalam mode layar penuh. Standarnya adalah tidak. Jendela mode layar penuh juga harus berada di mode bioskop. Hanya untuk IE.
height=pixels tinggi jendela, dalam satuan piksel. Nilai minimumnya adalah 100.
left=pixels posisi kiri jendela (koordinat X), dalam satuan piksel. Tidak diizinkan nilai negatif.
location=yes|no|1|0 apakah field alamat akan ditampilkan. Hanya untuk Opera.
menubar=yes|no|1|0 apakah bar menu akan ditampilkan.
resizable=yes|no|1|0 apakah jendela dapat diukur kembali. Hanya untuk IE.
scrollbars=yes|no|1|0 apakah scrollbars akan ditampilkan. Hanya untuk IE, Firefox, dan Opera.
status=yes|no|1|0 apakah status bar akan ditambahkan.
titlebar=yes|no|1|0 apakah bar judul akan ditampilkan. Hanya jika aplikasi yang dipanggil adalah aplikasi HTML atau dialog yang dipercaya, lalu akan diabaikan.
toolbar=yes|no|1|0 apakah toolbar browser akan ditampilkan. Hanya untuk IE dan Firefox.
top=pixels posisi atas jendela (koordinat Y), dalam satuan piksel. Tidak diizinkan nilai negatif.
width=pixels lebar jendela, dalam satuan piksel. Nilai minimumnya adalah 100.

nilai kembalian

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

detil teknis

penjelasan

open() metode akan mencari jendela yang sudah ada atau membuka jendela browser baru. Jika name jika parameter jendela yang sudah ada disediakan, maka kembalikan referensi ke jendela itu. Jendela yang kembali akan menampilkan url parameter untuk dokumen yang ditentukan, tetapi mengabaikan features parameter. Dengan hanya mengetahui nama jendela, ini adalah cara tunggal yang dapat disediakan JavaScript untuk mendapatkan referensi ke jendela itu.

jika tidak disediakan name parameter, atau jika jendela yang ditentukan tidak ada, maka open() metode akan membuat jendela browser baru. Jendela baru ini akan menampilkan url parameter URL yang ditentukan, nama yang ditentukan oleh name besar, ukuran, dan kontrol disediakan oleh features parameter untuk ditentukan. url jika kosong, maka open() untuk membuka jendela baru.

name parameter untuk menentukan nama jendela baru. Nama ini hanya dapat berisi angka, huruf, atau garis bawah. Nama ini dapat digunakan sebagai tanda <a> dan <form> nilai properti target, digunakan untuk memaksa dokumen untuk muncul di jendela yang ditentukan.

Ketika menggunakan metode Window.open() Ketika memuat dokumen baru ke jendela yang sudah ada, dokumen dapat disampaikan replace parameter, untuk menyatakan bahwa dokumen baru akan memiliki entri sendiri di riwayat browsing jendela atau menggantikan entri dokumen saat ini. Jika replace nilai adalah true, dokumen baru akan menggantikan dokumen lama. Jika nilai adalah false, atau dilewati, dokumen baru akan memiliki entri sendiri di riwayat browsing jendela. Fungsi parameter ini sama dengan Location.replace() metode yang disediakan

jangan khianati Window.open() metode yang hampir sama dengan Document.open() metode, untuk memastikan kode Anda jelas dan mudah dipahami, terbaik menggunakan Window.open(), jangan gunakan open(). Biasanya, di dalam penanganan peristiwa yang didefinisikan sebagai atribut HTML, fungsi open() diartikan sebagai Document.open()dengan demikian, dalam hal ini, harus digunakan Window.open().

Fitur jendela

features parameter adalah daftar fitur yang akan ditampilkan di jendela, fitur-fitur yang dipisahkan dengan koma. Jika nilai parameter opsional ini kosong, atau dilewati, jendela akan menampilkan semua fitur. Namun, jika features menentukan fitur yang ada, fitur yang tidak muncul dalam daftar ini tidak akan muncul di jendela. Perhatikan bahwa string ini tidak mengandung spasi atau simbol putih, format elemen masing-masing seperti berikut:

feature[=value]

Untuk sebagian besar fitur,value nilai adalah yes atau no. Tanda sama dan value Nilai dapat dilewati, jika terjadi, dianggap value Nilai adalah yes, jika tidak muncul, dianggap value Nilai adalah no. Namun, nilai width atau height value Nilai wajib, tentu saja harus menentukan nilai pikselnya.

Dukungan peramban

Semua peramban mendukung open():

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Dukungan Dukungan Dukungan Dukungan Dukungan Dukungan

Beberapa contoh lainnya

Contoh 2

Buka halaman about:blank di jendela/Tab baru:

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

Coba Sendiri

Contoh 3

Buka jendela baru dengan nama "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>");

Coba Sendiri

Contoh 4

Ganti jendela baru untuk jendela saat ini:

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

Coba Sendiri

Contoh 5

Membuka jendela baru dan mengendalikan penampilannya:

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

Coba Sendiri

Contoh 6

Membuka beberapa tab:

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

Coba Sendiri

Contoh 7

Membuka jendela baru. Lalu gunakan close() untuk menutup jendela ini:

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

Coba Sendiri

Contoh 8

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

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

Coba Sendiri

Contoh 9

Menggunakan properti opener untuk mengembalikan referensi ke jendela yang dibuka untuk membuat jendela baru:

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

Coba Sendiri