Các tập lệnh được liên kết với Google Tài liệu, Trang tính hoặc Biểu mẫu có thể hiển thị một số loại phần tử giao diện người dùng — cảnh báo và lời nhắc được tạo sẵn, cùng với hộp thoại và thanh bên chứa tuỳ chỉnh Các trang dịch vụ HTML. Thông thường, những phần tử này được mở qua các mục trong trình đơn. (Lưu ý rằng trong Google Biểu mẫu, các phần tử giao diện người dùng chỉ hiển thị cho người chỉnh sửa mở biểu mẫu để sửa đổi chứ không phải người dùng mở biểu mẫu để trả lời).
Hộp thoại cảnh báo
Cảnh báo là một hộp thoại được tạo sẵn, mở ra bên trong tệp Google Tài liệu, Trang tính,
Trang trình bày hoặc trình chỉnh sửa Biểu mẫu. Nó sẽ hiển thị một thông báo và "OK" nút; một tiêu đề và
các nút thay thế là tuỳ chọn. Thao tác này cũng tương tự như gọi
window.alert()
trong JavaScript phía máy khách trong trình duyệt web.
Cảnh báo sẽ tạm ngưng tập lệnh phía máy chủ trong khi hộp thoại đang mở. Kịch bản tiếp tục sau khi người dùng đóng hộp thoại, nhưng JDBC không còn kết nối trong quá trình tạm ngưng.
Như trong ví dụ bên dưới, Google Tài liệu, Biểu mẫu, Trang trình bày,
và Trang tính đều sử dụng phương thức Ui.alert(). Phương thức này
có 3 biến thể. Để ghi đè tuỳ chọn "OK" mặc định hãy truyền
giá trị từ enum Ui.ButtonSet
làm đối số buttons. Để đánh giá xem người dùng đã nhấp vào nút nào, hãy so sánh
giá trị trả về cho alert() vào
Enum Ui.Button.
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show alert', 'showAlert')
.addToUi();
}
function showAlert() {
var ui = SpreadsheetApp.getUi(); // Same variations.
var result = ui.alert(
'Please confirm',
'Are you sure you want to continue?',
ui.ButtonSet.YES_NO);
// Process the user's response.
if (result == ui.Button.YES) {
// User clicked "Yes".
ui.alert('Confirmation received.');
} else {
// User clicked "No" or X in the title bar.
ui.alert('Permission denied.');
}
}
Hộp thoại lời nhắc
Câu lệnh là một hộp thoại được tạo sẵn, mở ra bên trong tệp Google Tài liệu, Trang tính,
Trang trình bày hoặc trình chỉnh sửa Biểu mẫu. Màn hình hiển thị thông báo, trường nhập dữ liệu văn bản và "OK"
nút; tiêu đề và các nút thay thế là tuỳ chọn. Thao tác này cũng tương tự như gọi
window.prompt()
trong JavaScript phía máy khách trong trình duyệt web.
Lời nhắc sẽ tạm ngưng tập lệnh phía máy chủ trong khi hộp thoại đang mở. Kịch bản tiếp tục sau khi người dùng đóng hộp thoại, nhưng JDBC không còn kết nối trong quá trình tạm ngưng.
Như trong ví dụ bên dưới, Google Tài liệu - Biểu mẫu, Trang trình bày và Trang tính đều sử dụng phương thức Ui.prompt(),
Sản phẩm này có 3 biến thể. Để ghi đè tuỳ chọn "OK" mặc định nút
truyền một giá trị từ Ui.ButtonSet
enum dưới dạng đối số buttons. Để đánh giá phản hồi của người dùng, hãy ghi lại
giá trị trả về cho prompt(), sau đó gọi
PromptResponse.getResponseText()
để truy xuất thông tin đầu vào của người dùng và so sánh giá trị trả về của
PromptResponse.getSelectedButton()
vào enum Ui.Button.
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show prompt', 'showPrompt')
.addToUi();
}
function showPrompt() {
var ui = SpreadsheetApp.getUi(); // Same variations.
var result = ui.prompt(
'Let\'s get to know each other!',
'Please enter your name:',
ui.ButtonSet.OK_CANCEL);
// Process the user's response.
var button = result.getSelectedButton();
var text = result.getResponseText();
if (button == ui.Button.OK) {
// User clicked "OK".
ui.alert('Your name is ' + text + '.');
} else if (button == ui.Button.CANCEL) {
// User clicked "Cancel".
ui.alert('I didn\'t get your name.');
} else if (button == ui.Button.CLOSE) {
// User clicked X in the title bar.
ui.alert('You closed the dialog.');
}
}
Hộp thoại tuỳ chỉnh
Hộp thoại tuỳ chỉnh có thể hiển thị người dùng dịch vụ HTML bên trong một trình chỉnh sửa Google Tài liệu, Trang tính, Trang trình bày hoặc Biểu mẫu.
Hộp thoại tuỳ chỉnh không tạm ngưng tập lệnh phía máy chủ trong khi hộp thoại đang mở.
Thành phần phía máy khách có thể thực hiện các lệnh gọi không đồng bộ đến tập lệnh phía máy chủ
bằng API google.script
cho giao diện dịch vụ HTML.
Hộp thoại có thể tự đóng bằng cách gọi
google.script.host.close()
ở phía máy khách của giao diện dịch vụ HTML. Không thể đóng hộp thoại trước
các giao diện khác, chỉ do người dùng hoặc chính người dùng đó thực hiện.
Như trong ví dụ bên dưới, Google Tài liệu, Biểu mẫu, Trang trình bày và Trang tính đều sử dụng phương thức Ui.showModalDialog() để mở hộp thoại.
Code.gs
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show dialog', 'showDialog')
.addToUi();
}
function showDialog() {
var html = HtmlService.createHtmlOutputFromFile('Page')
.setWidth(400)
.setHeight(300);
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.showModalDialog(html, 'My custom dialog');
}
Page.html
Hello, world! <input type="button" value="Close" onclick="google.script.host.close()" />
Thanh bên tuỳ chỉnh
Thanh bên có thể hiển thị người dùng dịch vụ HTML bên trong trình chỉnh sửa của Google Tài liệu, Biểu mẫu, Trang trình bày và Trang tính.
Các thanh bên không tạm ngưng tập lệnh phía máy chủ trong khi hộp thoại đang mở. Chiến lược phát hành đĩa đơn
thành phần phía máy khách có thể thực hiện lệnh gọi không đồng bộ đến tập lệnh phía máy chủ
bằng API google.script
cho giao diện dịch vụ HTML.
Thanh bên có thể tự đóng bằng cách gọi
google.script.host.close()
ở phía máy khách của giao diện dịch vụ HTML. Không thể đóng thanh bên
bởi các giao diện khác, mà chỉ do người dùng hoặc chính người dùng đó thực hiện.
Như trong ví dụ bên dưới, Google Tài liệu, Biểu mẫu, Trang trình bày và Trang tính đều sử dụng phương thức Ui.showSidebar() để mở thanh bên.
Code.gs
function onOpen() {
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.createMenu('Custom Menu')
.addItem('Show sidebar', 'showSidebar')
.addToUi();
}
function showSidebar() {
var html = HtmlService.createHtmlOutputFromFile('Page')
.setTitle('My custom sidebar');
SpreadsheetApp.getUi() // Or DocumentApp or SlidesApp or FormApp.
.showSidebar(html);
}
Page.html
Hello, world! <input type="button" value="Close" onclick="google.script.host.close()" />
Hộp thoại mở tệp
Google Inspector là một tệp "file-open" hộp thoại để xem thông tin được lưu trữ trong Máy chủ của Google, bao gồm Google Drive, Google Tìm kiếm hình ảnh, Google Video Tìm kiếm và hơn thế nữa.
Như trong ví dụ bên dưới, bạn có thể sử dụng API JavaScript phía máy khách của Bộ chọn trong dịch vụ HTML để tạo hộp thoại tuỳ chỉnh cho phép người dùng chọn các tệp hiện có hoặc tải tệp mới lên, sau đó chuyển lựa chọn đó trở lại để sử dụng trong tương lai.
Để bật Bộ chọn và nhận khoá API, hãy làm theo hướng dẫn sau:
- Xác minh rằng dự án tập lệnh của bạn đang sử dụng dự án GCP chuẩn.
- Bật "API Bộ chọn của Google" trong dự án Google Cloud của bạn.
- Khi dự án Google Cloud của bạn vẫn đang mở, hãy chọn API và Services, sau đó nhấp vào Thông tin xác thực.
- Nhấp vào Tạo thông tin xác thực > Khoá API. Thao tác này sẽ tạo ra khoá, nhưng bạn nên chỉnh sửa khoá để thêm cả các quy tắc hạn chế của ứng dụng và quy định hạn chế về API vào khoá.
- Trong hộp thoại khoá API, hãy nhấp vào Đóng.
- Bên cạnh khoá API mà bạn đã tạo, hãy nhấp vào biểu tượng Tuỳ chọn khác
> Chỉnh sửa khoá API. Trong mục Hạn chế của ứng dụng, hãy hoàn tất các bước sau:
- Chọn Đường liên kết giới thiệu HTTP (trang web).
- Trong mục Giới hạn trang web, hãy nhấp vào Thêm một mục.
- Nhấp vào Đường liên kết giới thiệu rồi nhập
*.google.com. - Thêm một mặt hàng khác rồi nhập
*.googleusercontent.comlàm đường liên kết giới thiệu. - Nhấp vào Xong.
Trong phần Các hạn chế về API, hãy hoàn thành các bước sau:
- Chọn Hạn chế khoá.
Trong phần Select APIs (Chọn API), hãy chọn Google phép đặt API rồi nhấp vào OK.
Lưu ý: API Bộ chọn của Google chỉ xuất hiện khi bạn bật vì danh sách chỉ hiển thị các API được bật cho Đám mây dự án.
Trong phần khoá API, hãy nhấp vào biểu tượng Sao chép vào bảng nhớ tạm
.Ở dưới cùng, hãy nhấp vào Lưu.