Class Browser

Browser

Class ini memberikan akses ke kotak dialog khusus untuk Google Sheets.

Metode di class ini hanya tersedia untuk digunakan dalam konteks Google Spreadsheet. Sebagai gantinya, gunakan dialog Google Workspace.

Lihat juga

Properti

PropertiJenisDeskripsi
ButtonsButtonSet

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
inputBox(prompt)StringMuncul kotak dialog dengan kotak input teks di browser pengguna.
inputBox(prompt, buttons)StringMuncul kotak dialog dengan kotak input teks di browser pengguna.
inputBox(title, prompt, buttons)StringMuncul kotak dialog dengan kotak input teks di browser pengguna.
msgBox(prompt)StringMuncul kotak dialog berisi pesan yang diberikan dan tombol OK di browser pengguna.
msgBox(prompt, buttons)StringMuncul kotak dialog berisi pesan yang diberikan dan tombol tertentu di browser pengguna.
msgBox(title, prompt, buttons)StringMuncul kotak dialog dengan judul, pesan, dan tombol tertentu yang ditentukan di browser pengguna.

Dokumentasi mendetail

inputBox(prompt)

Muncul kotak dialog dengan kotak input teks di browser pengguna.

Metode inputBox memunculkan kotak input sisi klien yang menampilkan prompt yang diberikan ke . Perhatikan bahwa fungsi ini menyebabkan skrip sisi server ditangguhkan. Melanjutkan secara otomatis setelah pengguna menghapus dialog, namun koneksi JDBC tidak bertahan di seluruh penangguhan pembayaran.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
Metode ini tidak direkomendasikan. Sebagai gantinya, gunakan UI prompt.

Parameter

NamaJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.

Pulang pergi

String — Teks yang dimasukkan oleh pengguna (atau 'batal' untuk dialog yang dibatalkan atau ditolak).

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(prompt, buttons)

Muncul kotak dialog dengan kotak input teks di browser pengguna.

Metode inputBox memunculkan kotak input sisi klien yang menampilkan prompt yang diberikan ke pengguna, dan menawarkan pilihan tombol untuk ditampilkan. Perhatikan bahwa fungsi ini menyebabkan skrip sisi server akan ditangguhkan. Ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak bertahan selama penangguhan.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
Metode ini tidak direkomendasikan. Sebagai gantinya, gunakan UI prompt.

Parameter

NamaJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang disetel untuk digunakan.

Pulang pergi

String — Teks yang dimasukkan oleh pengguna (atau 'batal' untuk dialog yang dibatalkan atau ditolak).

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(title, prompt, buttons)

Muncul kotak dialog dengan kotak input teks di browser pengguna.

Metode inputBox memunculkan kotak input sisi klien dengan judul yang diberikan, yang menampilkan perintah yang diberikan kepada pengguna, dan menawarkan pilihan tombol untuk ditampilkan. Perhatikan bahwa menyebabkan skrip sisi server ditangguhkan. Ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, namun koneksi JDBC tidak bertahan selama penangguhan.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
Metode ini tidak direkomendasikan. Sebagai gantinya, gunakan UI prompt.

Parameter

NamaJenisDeskripsi
titleStringJudul untuk kotak dialog.
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang disetel untuk digunakan.

Pulang pergi

String — Teks yang dimasukkan oleh pengguna (atau 'batal' untuk dialog yang dibatalkan atau ditolak).

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt)

Muncul kotak dialog berisi pesan yang diberikan dan tombol OK di browser pengguna.

Metode msgBox memunculkan kotak pesan sisi klien yang menampilkan pesan yang diberikan ke . Perhatikan bahwa metode ini menyebabkan skrip sisi server ditangguhkan. Melanjutkan secara otomatis setelah pengguna menghapus dialog, namun koneksi JDBC tidak bertahan di seluruh penangguhan pembayaran.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
Metode ini tidak direkomendasikan. Sebagai gantinya, gunakan dialog UI pemberitahuan.

Parameter

NamaJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.

Pulang pergi

String — Teks huruf kecil pada tombol yang diklik oleh pengguna (atau 'batal' untuk dialog yang ditutup).

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt, buttons)

Muncul kotak dialog berisi pesan yang diberikan dan tombol tertentu di browser pengguna.

Metode msgBox memunculkan kotak pesan sisi klien yang menampilkan pesan yang diberikan ke pengguna, dan menawarkan pilihan tombol untuk ditampilkan. Perhatikan bahwa metode ini menyebabkan skrip sisi server akan ditangguhkan. Ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak bertahan selama penangguhan.

// The code below displays "hello world" in a dialog box with OK and Cancel buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
Metode ini tidak direkomendasikan. Sebagai gantinya, gunakan dialog UI pemberitahuan.

Parameter

NamaJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang disetel untuk digunakan.

Pulang pergi

String — Teks huruf kecil pada tombol yang diklik oleh pengguna (atau 'batal' untuk dialog yang ditutup).

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(title, prompt, buttons)

Muncul kotak dialog dengan judul, pesan, dan tombol tertentu yang ditentukan di browser pengguna.

Metode msgBox memunculkan kotak pesan sisi klien dengan judul yang diberikan, yang menampilkan pesan tertentu kepada pengguna, dan menawarkan pilihan tombol untuk ditampilkan. Perhatikan bahwa yang menyebabkan skrip sisi server ditangguhkan. Ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, namun koneksi JDBC tidak bertahan selama penangguhan.

// The code below displays "hello world" in a dialog box with a custom title and Yes and
// No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
Metode ini tidak direkomendasikan. Sebagai gantinya, gunakan dialog UI pemberitahuan.

Parameter

NamaJenisDeskripsi
titleStringJudul kotak dialog.
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang disetel untuk digunakan.

Pulang pergi

String — Teks huruf kecil pada tombol yang diklik oleh pengguna (atau 'batal' untuk dialog yang ditutup).

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets