Class Browser

Browser

Class ini menyediakan akses ke kotak dialog khusus untuk Google Spreadsheet.

Metode di kelas 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)StringMemunculkan kotak dialog dengan pesan yang ditentukan dan tombol yang ditentukan di browser pengguna.
msgBox(title, prompt, buttons)StringMemunculkan kotak dialog dengan judul, pesan, dan tombol yang ditetapkan 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 permintaan tertentu kepada pengguna. Perhatikan bahwa fungsi ini menyebabkan skrip sisi server ditangguhkan. Fitur ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak terus ada di seluruh 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

NameJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.

Return

String — Teks yang dimasukkan oleh pengguna (atau 'cancel' untuk dialog yang dibatalkan atau 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

inputBox(prompt, buttons)

Memunculkan kotak dialog dengan kotak input teks di browser pengguna.

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

NameJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang ditetapkan untuk digunakan.

Return

String — Teks yang dimasukkan oleh pengguna (atau 'cancel' untuk dialog yang dibatalkan atau 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

inputBox(title, prompt, buttons)

Memunculkan kotak dialog dengan kotak input teks di browser pengguna.

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

NameJenisDeskripsi
titleStringJudul untuk kotak dialog.
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang ditetapkan untuk digunakan.

Return

String — Teks yang dimasukkan oleh pengguna (atau 'cancel' untuk dialog yang dibatalkan atau 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)

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

Metode msgBox memunculkan kotak pesan sisi klien yang menampilkan pesan tertentu kepada pengguna. Perhatikan bahwa metode ini menyebabkan skrip sisi server ditangguhkan. Fitur ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak terus ada di seluruh 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

NameJenisDeskripsi
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)

Memunculkan kotak dialog dengan pesan yang ditentukan dan tombol yang ditentukan 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. Fitur ini dilanjutkan secara otomatis setelah pengguna menghapus dialog, tetapi koneksi JDBC tidak terus ada 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

NameJenisDeskripsi
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang ditetapkan 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)

Memunculkan kotak dialog dengan judul, pesan, dan tombol yang ditetapkan di browser pengguna.

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

NameJenisDeskripsi
titleStringJudul kotak dialog.
promptStringTeks yang akan ditampilkan di kotak dialog.
buttonsButtonSetJenis tombol yang ditetapkan 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