Class Browser

Browser

Kelas ini memberikan akses ke kotak dialog khusus untuk {i>Google Sheets<i}.

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)StringMemunculkan kotak dialog dengan kotak input teks di browser pengguna.
inputBox(prompt, buttons)StringMemunculkan kotak dialog dengan kotak input teks di browser pengguna.
inputBox(title, prompt, buttons)StringMemunculkan kotak dialog dengan kotak input teks di browser pengguna.
msgBox(prompt)StringMemunculkan kotak dialog dengan pesan yang diberikan dan tombol OK di browser pengguna.
msgBox(prompt, buttons)StringMenampilkan kotak dialog dengan pesan yang diberikan dan tombol tertentu di browser pengguna.
msgBox(title, prompt, buttons)StringMenampilkan kotak dialog dengan judul dan pesan yang diberikan, serta tombol tertentu di browser pengguna.

Dokumentasi mendetail

inputBox(prompt)

Memunculkan kotak dialog dengan kotak input teks di browser pengguna.

Metode inputBox memunculkan kotak input sisi klien yang menampilkan perintah yang diberikan kepada pengguna. Perhatikan bahwa fungsi ini menyebabkan skrip sisi server ditangguhkan. Metode akan dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak akan 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');
Metode ini tidak direkomendasikan. Sebagai gantinya, gunakan perintah UI.

Parameter

NamaJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.

Return

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)

Memunculkan kotak dialog dengan kotak input teks di browser pengguna.

Metode inputBox memunculkan kotak input sisi klien yang menampilkan perintah yang diberikan kepada pengguna, dan menawarkan pilihan tombol untuk ditampilkan. Perhatikan bahwa fungsi ini menyebabkan skrip sisi server ditangguhkan. Proses ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak akan 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 perintah UI.

Parameter

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

Return

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)

Memunculkan kotak dialog dengan kotak input teks di browser pengguna.

Metode inputBox memunculkan kotak input sisi klien dengan judul yang diberikan, yang menampilkan perintah tertentu kepada pengguna, dan menawarkan pilihan tombol untuk ditampilkan. Perhatikan bahwa fungsi ini menyebabkan skrip sisi server ditangguhkan. Metode ini akan otomatis dilanjutkan setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak akan 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 perintah UI.

Parameter

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

Return

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)

Memunculkan kotak dialog dengan pesan yang diberikan dan tombol OK di browser pengguna.

Metode msgBox memunculkan kotak pesan sisi klien yang menampilkan pesan yang diberikan kepada pengguna. Perhatikan, metode ini menyebabkan skrip sisi server ditangguhkan. Metode akan dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak akan bertahan selama penangguhan.

// 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 Notifikasi UI.

Parameter

NamaJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.

Return

String — Teks huruf kecil dari tombol yang diklik oleh pengguna (atau 'cancel' 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)

Menampilkan kotak dialog dengan pesan yang diberikan dan tombol tertentu di browser pengguna.

Metode msgBox memunculkan kotak pesan sisi klien yang menampilkan pesan tertentu kepada pengguna, dan menawarkan pilihan tombol untuk ditampilkan. Perhatikan bahwa metode ini menyebabkan skrip sisi server ditangguhkan. Proses ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak akan 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 Notifikasi UI.

Parameter

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

Return

String — Teks huruf kecil dari tombol yang diklik oleh pengguna (atau 'cancel' 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)

Menampilkan kotak dialog dengan judul dan pesan yang diberikan, serta tombol tertentu 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 metode ini menyebabkan skrip sisi server ditangguhkan. Metode ini akan otomatis dilanjutkan setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak akan 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 Notifikasi UI.

Parameter

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

Return

String — Teks huruf kecil dari tombol yang diklik oleh pengguna (atau 'cancel' 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