Menu Kustom di Google Workspace

Skrip dapat memperluas produk Google tertentu dengan menambahkan elemen antarmuka pengguna yang, saat diklik, akan menjalankan fungsi Google Apps Script. Contoh yang paling umum adalah menjalankan skrip dari item menu kustom di Google Dokumen, Google Spreadsheet, Google Slide, atau Google Formulir, tetapi fungsi skrip juga dapat dipicu dengan mengklik gambar dan diagram di Spreadsheet.

Menu kustom di Dokumen, Spreadsheet, Slide, atau Formulir

Apps Script dapat menambahkan menu baru di Dokumen, Spreadsheet, Slide, atau Formulir, dengan setiap item menu dikaitkan ke fungsi dalam skrip. (Di Formulir, menu kustom hanya terlihat oleh editor yang membuka formulir untuk mengubahnya, bukan oleh pengguna yang membuka formulir untuk merespons.)

Hanya skrip terikat yang dapat membuat menu. Untuk menampilkan menu saat pengguna membuka file, tulis kode menu dalam fungsi onOpen.

Contoh berikut menunjukkan cara menambahkan menu dengan satu item, diikuti dengan pemisah visual, lalu sub-menu yang berisi item lain. Saat pengguna memilih salah satu item menu, fungsi yang sesuai akan membuka dialog alert. Untuk mengetahui informasi selengkapnya tentang jenis dialog yang dapat Anda buka, lihat panduan untuk dialog dan sidebar.

function onOpen() {
  const ui = SpreadsheetApp.getUi();
  // Or DocumentApp, SlidesApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
      .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp, SlidesApp or FormApp.
      .alert('You clicked the second menu item!');
}

Dokumen, spreadsheet, presentasi, atau formulir hanya dapat berisi satu menu dengan nama tertentu. Jika skrip yang sama atau skrip lain menambahkan menu dengan nama yang sama, menu baru akan menggantikan menu lama. Menu tidak dapat dihapus saat file terbuka, meskipun Anda dapat menulis fungsi onOpen untuk melewati menu pada masa mendatang jika properti tertentu ditetapkan.

Add-on editor juga dapat memiliki item menu, tetapi menggunakan aturan khusus untuk cara item menu tersebut ditentukan.

Gambar dan gambar yang dapat diklik di Spreadsheet

Anda juga dapat menetapkan fungsi Apps Script ke gambar atau gambar di Spreadsheet, asalkan skrip terikat ke spreadsheet. Contoh berikut menunjukkan cara menyiapkannya.

  1. Di Spreadsheet, pilih item menu Ekstensi > Apps Script untuk membuat skrip yang terikat ke spreadsheet.
  2. Hapus semua kode yang ada di editor skrip dan tempelkan kode di bawah.
function showMessageBox() {
  SpreadsheetApp.getUi().alert('You clicked it!');
}
  1. Kembali ke Spreadsheet dan sisipkan gambar atau diagram dengan memilih Sisipkan > Gambar atau Sisipkan > Diagram.
  2. Setelah menyisipkan gambar atau membuat gambar, klik gambar tersebut. Pemilih menu drop-down kecil akan muncul di pojok kanan atas. Klik, lalu pilih Tetapkan skrip.
  3. Dalam dialog yang muncul, ketik nama fungsi Apps Script yang ingin Anda jalankan, tanpa tanda kurung — dalam hal ini, showMessageBox. Klik Oke.
  4. Klik gambar lagi. Fungsi kini dijalankan.

Eksekusi skrip hanya dipicu dengan mengklik gambar atau diagram di browser web. Skrip tidak dijalankan jika gambar atau gambar yang dibuat diklik di perangkat seluler.