Range có tên và mã nhận dạng để cho phép truy xuất sau này. Tên không nhất thiết phải là duy nhất; một số dải ô khác nhau trong cùng một thẻ có thể có cùng tên, giống như một lớp trong HTML. Ngược lại, mã nhận dạng là duy nhất trong thẻ, giống như mã nhận dạng trong HTML. Sau khi thêm Named vào một thẻ, bạn không thể sửa đổi mà chỉ có thể xoá thẻ đó.
Mọi tập lệnh truy cập vào thẻ đều có thể truy cập vào Named. Để tránh các xung đột không mong muốn giữa các tập lệnh, hãy cân nhắc đặt tiền tố cho tên dải ô bằng một chuỗi duy nhất.
// Create a named range that includes every table in the active tab.
const documentTab =
DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());
Phương thức
| Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
|---|---|---|
get | String | Lấy mã nhận dạng của Named này. |
get | String | Lấy tên của Named này. |
get | Range | Lấy phạm vi các phần tử được liên kết với Named này. |
remove() | void | Xoá Named này khỏi thẻ. |
Tài liệu chi tiết
get
Lấy mã nhận dạng của Named này. Mã nhận dạng này là duy nhất trong thẻ.
Cầu thủ trả bóng
String – Mã nhận dạng của dải ô, là mã nhận dạng duy nhất trong thẻ.
get
Lấy tên của Named này. Tên không nhất thiết phải là duy nhất.
Cầu thủ trả bóng
String – Tên của dải ô, không nhất thiết phải là tên duy nhất.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get
Lấy phạm vi các phần tử liên kết với Named này.
Cầu thủ trả bóng
Range – Phạm vi các phần tử được liên kết với tên và mã nhận dạng.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
remove()
Xoá Named này khỏi thẻ. Phương thức này không xoá nội dung của phạm vi; mà chỉ xoá tệp tham chiếu. Việc gọi phương thức này trên một Named đã bị xoá sẽ không có hiệu lực.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents