Trang này được dịch bởi Cloud Translation API.

Trình đơn tuỳ chỉnh trong Google Workspace

Tập lệnh có thể mở rộng một số sản phẩm của Google bằng cách thêm các thành phần giao diện người dùng. Khi người dùng nhấp vào các thành phần này, một hàm trong Tập lệnh Apps sẽ được thực thi. Ví dụ phổ biến nhất là chạy tập lệnh từ một mục trình đơn tuỳ chỉnh trong Google Tài liệu, Trang tính, Trang trình bày hoặc Biểu mẫu, nhưng bạn cũng có thể kích hoạt các hàm tập lệnh bằng cách nhấp vào hình ảnh và bản vẽ trong Google Trang tính.

Trình đơn tuỳ chỉnh trong Google Tài liệu, Trang tính, Trang trình bày hoặc Biểu mẫu

Apps Script có thể thêm trình đơn mới trong Google Tài liệu, Trang tính, Trang trình bày hoặc Biểu mẫu, trong đó mỗi mục trong trình đơn được liên kết với một hàm trong tập lệnh. (Trong Google Biểu mẫu, trình đơn tuỳ chỉnh chỉ hiển thị với người chỉnh sửa mở biểu mẫu để sửa đổi, chứ không hiển thị với người dùng mở biểu mẫu để trả lời.)

Tập lệnh chỉ có thể tạo trình đơn nếu được liên kết với tài liệu, bảng tính hoặc biểu mẫu. Để hiển thị trình đơn khi người dùng mở một tệp, hãy viết mã trình đơn trong hàm onOpen().

Ví dụ bên dưới cho thấy cách thêm một trình đơn có một mục, theo sau là một dấu phân cách trực quan, sau đó là một trình đơn con chứa một mục khác. (Lưu ý rằng trong Google Trang tính, trừ phi bạn đang sử dụng phiên bản mới, bạn phải sử dụng cú pháp addMenu() và không thể sử dụng trình đơn phụ.) Khi người dùng chọn một trong hai mục trình đơn, một hàm tương ứng sẽ mở hộp thoại cảnh báo. Để biết thêm thông tin về các loại hộp thoại mà bạn có thể mở, hãy xem hướng dẫn về hộp thoại và thanh bên.

function onOpen() {
  var 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!');
}

Một tài liệu, bảng tính, bản trình bày hoặc biểu mẫu chỉ có thể chứa một trình đơn có tên nhất định. Nếu cùng một tập lệnh hoặc một tập lệnh khác thêm một trình đơn có cùng tên, thì trình đơn mới sẽ thay thế trình đơn cũ. Bạn không thể xoá trình đơn khi tệp đang mở, mặc dù bạn có thể viết hàm onOpen() để bỏ qua trình đơn trong tương lai nếu đặt một thuộc tính nhất định.

Hình ảnh và bản vẽ có thể nhấp vào trong Google Trang tính

Bạn cũng có thể chỉ định một hàm Apps Script cho một hình ảnh hoặc bản vẽ trong Google Trang tính, miễn là tập lệnh được liên kết với bảng tính. Ví dụ dưới đây cho thấy cách thiết lập.

Trong Google Trang tính, hãy chọn mục trình đơn Tiện ích > Apps Script để tạo tập lệnh liên kết với bảng tính.
Xoá mọi mã trong trình soạn thảo tập lệnh rồi dán mã bên dưới vào.
```
  function showMessageBox() {
    Browser.msgBox('You clicked it!');
  }
```
Quay lại Trang tính rồi chèn hình ảnh hoặc bản vẽ bằng cách chọn Chèn > Hình ảnh hoặc Chèn > Bản vẽ.
Sau khi chèn hình ảnh hoặc bản vẽ, hãy nhấp vào hình ảnh hoặc bản vẽ đó. Một bộ chọn trình đơn thả xuống nhỏ sẽ xuất hiện ở góc trên cùng bên phải. Nhấp vào mục này rồi chọn Gán tập lệnh.
Trong hộp thoại xuất hiện, hãy nhập tên của hàm Apps Script mà bạn muốn chạy, không có dấu ngoặc đơn – trong trường hợp này là showMessageBox. Nhấp vào OK.
Nhấp lại vào hình ảnh hoặc bản vẽ đó. Hàm hiện đã thực thi.