Nội dung của một thẻ trong tài liệu trên Google Tài liệu. Body
có thể chứa các phần tử List
, Paragraph
, Table
và Table
. Để biết thêm thông tin về cấu trúc tài liệu, hãy xem hướng dẫn mở rộng Google Tài liệu.
Body
thường chứa toàn bộ nội dung của thẻ, ngoại trừ Header
, Footer
và mọi phần tử Footnote
.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a paragraph and a page break to the tab's body section directly. body.appendParagraph('A paragraph.'); body.appendPageBreak();
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
append | Horizontal | Tạo và nối một Horizontal mới. |
append | Inline | Tạo và nối một Inline mới từ blob hình ảnh đã chỉ định. |
append | Inline | Thêm Inline đã cho. |
append | List | Thêm List đã cho. |
append | List | Tạo và nối một List mới chứa nội dung văn bản được chỉ định. |
append | Page | Tạo và nối một Page mới. |
append | Page | Thêm Page đã cho. |
append | Paragraph | Thêm Paragraph đã cho. |
append | Paragraph | Tạo và nối một Paragraph mới chứa nội dung văn bản được chỉ định. |
append | Table | Tạo và nối một Table mới. |
append | Table | Thêm một Table mới chứa Table cho mỗi giá trị chuỗi đã chỉ định. |
append | Table | Thêm Table đã cho. |
clear() | Body | Xoá nội dung của phần tử. |
copy() | Body | Trả về một bản sao sâu, tách biệt của phần tử hiện tại. |
edit | Text | Lấy phiên bản Text của phần tử hiện tại để chỉnh sửa. |
find | Range | Tìm kiếm nội dung của phần tử cho một phần tử con thuộc loại đã chỉ định. |
find | Range | Tìm kiếm nội dung của phần tử cho một phần tử con của loại đã chỉ định, bắt đầu từ Range đã chỉ định. |
find | Range | Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định bằng biểu thức chính quy. |
find | Range | Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định, bắt đầu từ một kết quả tìm kiếm nhất định. |
get | Object | Truy xuất các thuộc tính của phần tử. |
get | Element | Truy xuất phần tử con tại chỉ mục con được chỉ định. |
get | Integer | Truy xuất chỉ mục con cho phần tử con được chỉ định. |
get | Object | Truy xuất tập hợp thuộc tính cho Paragraph đã cung cấp. |
get | Inline | Truy xuất tất cả Inline có trong phần này. |
get | List | Truy xuất tất cả List có trong phần này. |
get | Number | Truy xuất lề dưới, tính bằng điểm. |
get | Number | Truy xuất lề trái, tính bằng điểm. |
get | Number | Truy xuất lề phải. |
get | Number | Truy xuất lề trên cùng. |
get | Integer | Truy xuất số lượng phần tử con. |
get | Number | Truy xuất chiều cao trang, tính bằng điểm. |
get | Number | Truy xuất chiều rộng trang, tính bằng điểm. |
get | Paragraph[] | Truy xuất tất cả Paragraphs có trong phần (bao gồm cả List ). |
get | Container | Truy xuất phần tử mẹ của phần tử. |
get | Table[] | Truy xuất tất cả Tables có trong phần này. |
get | String | Truy xuất nội dung của phần tử dưới dạng chuỗi văn bản. |
get | Text | Lấy chế độ căn chỉnh văn bản. |
get | Element | Truy xuất Element của phần tử. |
insert | Horizontal | Tạo và chèn một Horizontal mới tại chỉ mục đã chỉ định. |
insert | Inline | Tạo và chèn Inline từ blob hình ảnh đã chỉ định, tại chỉ mục đã chỉ định. |
insert | Inline | Chèn Inline đã cho vào chỉ mục đã chỉ định. |
insert | List | Chèn List đã cho vào chỉ mục đã chỉ định. |
insert | List | Tạo và chèn một List mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định. |
insert | Page | Tạo và chèn một Page mới tại chỉ mục đã chỉ định. |
insert | Page | Chèn Page đã cho vào chỉ mục đã chỉ định. |
insert | Paragraph | Chèn Paragraph đã cho vào chỉ mục đã chỉ định. |
insert | Paragraph | Tạo và chèn một Paragraph mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định. |
insert | Table | Tạo và chèn một Table mới tại chỉ mục đã chỉ định. |
insert | Table | Tạo và chèn một Table mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định. |
insert | Table | Chèn Table đã cho vào chỉ mục đã chỉ định. |
remove | Body | Xoá phần tử con được chỉ định. |
replace | Element | Thay thế tất cả các lần xuất hiện của một mẫu văn bản nhất định bằng một chuỗi thay thế nhất định, bằng cách sử dụng biểu thức chính quy. |
set | Body | Đặt thuộc tính của phần tử. |
set | Body | Đặt các thuộc tính cho Paragraph được cung cấp. |
set | Body | Đặt lề dưới, tính bằng điểm. |
set | Body | Đặt lề trái, tính bằng điểm. |
set | Body | Đặt lề phải, tính bằng điểm. |
set | Body | Đặt lề trên. |
set | Body | Đặt chiều cao trang, tính bằng điểm. |
set | Body | Đặt chiều rộng trang, tính bằng điểm. |
set | Body | Đặt nội dung dưới dạng văn bản thuần tuý. |
set | Body | Đặt chế độ căn chỉnh văn bản. |
Tài liệu chi tiết
append Horizontal Rule()
Tạo và nối một Horizontal
mới.
Horizontal
sẽ nằm trong một Paragraph
mới.
Cầu thủ trả bóng
Horizontal
– Dòng kẻ ngang mới.
Ủ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
append Image(image)
Tạo và nối một Inline
mới từ blob hình ảnh đã chỉ định.
Hình ảnh sẽ nằm trong một Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
image | Blob | Dữ liệu hình ảnh. |
Cầu thủ trả bóng
Inline
– Hình ảnh được thêm vào.
Ủ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
append Image(image)
Thêm Inline
đã cho.
Inline
sẽ nằm trong một Paragraph
mới.
Sử dụng phiên bản append
này khi thêm một bản sao của Inline
hiện có.
Tham số
Tên | Loại | Mô tả |
---|---|---|
image | Inline | Dữ liệu hình ảnh. |
Cầu thủ trả bóng
Inline
– Hình ảnh được thêm vào.
Ủ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
append List Item(listItem)
Thêm List
đã cho.
Sử dụng phiên bản append
này khi thêm một bản sao của List
hiện có.
Tham số
Tên | Loại | Mô tả |
---|---|---|
list | List | Mục danh sách cần nối. |
Cầu thủ trả bóng
List
– Mục danh sách được thêm vào.
Ủ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
append List Item(text)
Tạo và nối một List
mới chứa nội dung văn bản được chỉ định.
Các mục danh sách liên tiếp được thêm vào cùng một danh sách.
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | Nội dung văn bản của mục danh sách. |
Cầu thủ trả bóng
List
– Mục danh sách mới.
Ủ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
append Page Break()
Tạo và nối một Page
mới.
Page
sẽ nằm trong một Paragraph
mới.
Cầu thủ trả bóng
Page
– Dấu ngắt trang mới.
Ủ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
append Page Break(pageBreak)
Thêm Page
đã cho.
Page
sẽ nằm trong một Paragraph
mới.
Sử dụng phiên bản append
này khi thêm một bản sao của Page
hiện có.
Tham số
Tên | Loại | Mô tả |
---|---|---|
page | Page | Dấu ngắt trang cần thêm vào. |
Cầu thủ trả bóng
Page
– Dấu ngắt trang được thêm vào.
Ủ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
append Paragraph(paragraph)
Thêm Paragraph
đã cho.
Sử dụng phiên bản append
này khi thêm một bản sao của Paragraph
hiện có.
Tham số
Tên | Loại | Mô tả |
---|---|---|
paragraph | Paragraph | Đoạn văn bản cần thêm vào. |
Cầu thủ trả bóng
Paragraph
– Đoạn văn bản được thêm vào.
Ủ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
append Paragraph(text)
Tạo và nối một Paragraph
mới chứa nội dung văn bản được chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | Nội dung văn bản của đoạn văn. |
Cầu thủ trả bóng
Paragraph
– Đoạn văn mới.
Ủ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
append Table()
Tạo và nối một Table
mới.
Phương thức này cũng sẽ thêm một đoạn văn bản trống sau bảng, vì tài liệu Google Tài liệu không thể kết thúc bằng một bảng.
Cầu thủ trả bóng
Table
– Bảng mới.
Ủ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
append Table(cells)
Thêm một Table
mới chứa Table
cho mỗi giá trị chuỗi đã chỉ định.
Phương thức này cũng sẽ thêm một đoạn văn bản trống sau bảng, vì tài liệu Google Tài liệu không thể kết thúc bằng một bảng.
Tham số
Tên | Loại | Mô tả |
---|---|---|
cells | String[][] | Nội dung văn bản của các ô trong bảng cần thêm vào bảng mới. |
Cầu thủ trả bóng
Table
– Bảng được thêm vào.
Ủ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
append Table(table)
Thêm Table
đã cho.
Sử dụng phiên bản append
này khi thêm một bản sao của Table
hiện có.
Phương thức này cũng sẽ thêm một đoạn văn bản trống sau bảng, vì tài liệu Google Tài liệu không thể kết thúc bằng một bảng.
Tham số
Tên | Loại | Mô tả |
---|---|---|
table | Table | Bảng cần nối. |
Cầu thủ trả bóng
Table
– Bảng được thêm vào.
Ủ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
clear()
copy()
Trả về một bản sao sâu, tách biệt của phần tử hiện tại.
Mọi phần tử con có trong phần tử cũng được sao chép. Phần tử mới không có phần tử mẹ.
Cầu thủ trả bóng
Body
– Bản sao mới.
Ủ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
edit As Text()
Lấy phiên bản Text
của phần tử hiện tại để chỉnh sửa.
Sử dụng edit
để thao tác với nội dung của các phần tử dưới dạng văn bản đa dạng thức. Chế độ edit
bỏ qua các phần tử không phải văn bản (chẳng hạn như Inline
và Horizontal
).
Các phần tử con nằm hoàn toàn trong một dải văn bản đã xoá sẽ bị xoá khỏi phần tử.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, 'An editAsText sample.'); body.insertHorizontalRule(0); body.insertParagraph(0, 'An example.'); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
Cầu thủ trả bóng
Text
– phiên bản văn bản của phần tử hiện tại
find Element(elementType)
Tìm kiếm nội dung của phần tử cho một phần tử con thuộc loại đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
element | Element | Loại phần tử cần tìm kiếm. |
Cầu thủ trả bóng
Range
– Kết quả tìm kiếm cho biết vị trí của phần tử tìm kiếm.
Ủ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
find Element(elementType, from)
Tìm kiếm nội dung của phần tử cho một phần tử con của loại đã chỉ định, bắt đầu từ Range
đã chỉ định.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Define the search parameters. let searchResult = null; // Search until the paragraph is found. while ( (searchResult = body.findElement( DocumentApp.ElementType.PARAGRAPH, searchResult, ))) { const par = searchResult.getElement().asParagraph(); if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) { // Found one, update and stop. par.setText('This is the first header.'); break; } }
Tham số
Tên | Loại | Mô tả |
---|---|---|
element | Element | Loại phần tử cần tìm kiếm. |
from | Range | Kết quả tìm kiếm để tìm kiếm. |
Cầu thủ trả bóng
Range
– Kết quả tìm kiếm cho biết vị trí tiếp theo của phần tử tìm kiếm.
Ủ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
find Text(searchPattern)
Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định bằng biểu thức chính quy.
Một số tính năng của biểu thức chính quy JavaScript không được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập và đối tượng sửa đổi chế độ.
Mẫu biểu thức chính quy được cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.
Tham số
Tên | Loại | Mô tả |
---|---|---|
search | String | mẫu cần tìm kiếm |
Cầu thủ trả bóng
Range
– kết quả tìm kiếm cho biết vị trí của văn bản tìm kiếm hoặc giá trị rỗng nếu không có kết quả nào khớp
Ủ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
find Text(searchPattern, from)
Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định, bắt đầu từ một kết quả tìm kiếm nhất định.
Một số tính năng của biểu thức chính quy JavaScript không được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập và đối tượng sửa đổi chế độ.
Mẫu biểu thức chính quy được cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.
Tham số
Tên | Loại | Mô tả |
---|---|---|
search | String | mẫu cần tìm kiếm |
from | Range | kết quả tìm kiếm để tìm kiếm |
Cầu thủ trả bóng
Range
– một kết quả tìm kiếm cho biết vị trí tiếp theo của văn bản tìm kiếm hoặc giá trị rỗng nếu không có kết quả khớp
Ủ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 Attributes()
Truy xuất các thuộc tính của phần tử.
Kết quả là một đối tượng chứa một thuộc tính cho mỗi thuộc tính phần tử hợp lệ, trong đó mỗi tên thuộc tính tương ứng với một mục trong enum Document
.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Append a styled paragraph. const par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. const atts = par.getAttributes(); // Log the paragraph attributes. for (const att in atts) { Logger.log(`${att}:${atts[att]}`); }
Cầu thủ trả bóng
Object
– Các thuộc tính của phần 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 Child(childIndex)
Truy xuất phần tử con tại chỉ mục con được chỉ định.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. const firstChild = body.getChild(0); // If it's a paragraph, set its contents. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { firstChild.asParagraph().setText('This is the first paragraph.'); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục của phần tử con cần truy xuất. |
Cầu thủ trả bóng
Element
– Phần tử con tại chỉ mục được chỉ định.
Ủ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 ChildIndex(child)
Truy xuất chỉ mục con cho phần tử con được chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Element | Phần tử con để truy xuất chỉ mục. |
Cầu thủ trả bóng
Integer
– Chỉ mục con.
Ủ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 Heading Attributes(paragraphHeading)
Truy xuất tập hợp thuộc tính cho Paragraph
đã cung cấp.
Tham số
Tên | Loại | Mô tả |
---|---|---|
paragraph | Paragraph | Tiêu đề cần truy xuất thuộc tính. |
Cầu thủ trả bóng
Object
– Bản đồ của các thuộc tính và giá trị hiện tại của các thuộc tính đó.
Ủ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 Images()
Truy xuất tất cả Inline
có trong phần này.
Cầu thủ trả bóng
Inline
– Hình ảnh phần.
Ủ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 List Items()
Truy xuất tất cả List
có trong phần này.
Cầu thủ trả bóng
List
– Các mục trong danh sách phần.
Ủ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 Margin Bottom()
Truy xuất lề dưới, tính bằng điểm.
Cầu thủ trả bóng
Number
– Lề dưới, tính bằng điểm.
Ủ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 Margin Left()
Truy xuất lề trái, tính bằng điểm.
Cầu thủ trả bóng
Number
– Lề trái, tính bằng điểm.
Ủ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 Margin Right()
Truy xuất lề phải.
Cầu thủ trả bóng
Number
– Lề phải, tính bằng điểm.
Ủ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 Margin Top()
Truy xuất lề trên cùng.
Cầu thủ trả bóng
Number
– Lề trên, tính bằng điểm.
Ủ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 Num Children()
Truy xuất số lượng phần tử con.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Log the number of elements in the tab. Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);
Cầu thủ trả bóng
Integer
– Số lượng phần tử con.
Ủ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 Page Height()
Truy xuất chiều cao của trang, tính bằng điểm.
Cầu thủ trả bóng
Number
– Chiều cao trang, tính bằng điểm.
Ủ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 Page Width()
Truy xuất chiều rộng trang, tính bằng điểm.
Cầu thủ trả bóng
Number
– Chiều rộng trang, tính bằng điểm.
Ủ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 Paragraphs()
Truy xuất tất cả Paragraphs
có trong phần (bao gồm cả List
).
Cầu thủ trả bóng
Paragraph[]
– Các đoạn văn bản trong phần.
Ủ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 Parent()
Truy xuất phần tử mẹ của phần tử.
Phần tử mẹ chứa phần tử hiện tại.
Cầu thủ trả bóng
Container
– Phần tử mẹ.
Ủ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 Tables()
get Text()
Truy xuất nội dung của phần tử dưới dạng chuỗi văn bản.
Cầu thủ trả bóng
String
– nội dung của phần tử dưới dạng chuỗi văn bản
Ủ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 Text Alignment()
Lấy chế độ căn chỉnh văn bản. Các loại căn chỉnh có sẵn là Document
, Document
và Document
.
Cầu thủ trả bóng
Text
– loại căn chỉnh văn bản hoặc null
nếu văn bản chứa nhiều loại căn chỉnh văn bản hoặc nếu bạn chưa bao giờ đặt căn chỉnh văn bản
Ủ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 Type()
Truy xuất Element
của phần tử.
Sử dụng get
để xác định chính xác loại của một phần tử nhất định.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Obtain the first element in the active tab's body. const firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() === DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
Cầu thủ trả bóng
Element
– Loại phần 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
insert Horizontal Rule(childIndex)
Tạo và chèn một Horizontal
mới tại chỉ mục đã chỉ định.
Horizontal
sẽ nằm trong một Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục để chèn phần tử. |
Cầu thủ trả bóng
Horizontal
– Dòng kẻ ngang mới.
Ủ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
insert Image(childIndex, image)
Tạo và chèn Inline
từ blob hình ảnh đã chỉ định, tại chỉ mục đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục để chèn phần tử. |
image | Blob | Dữ liệu hình ảnh. |
Cầu thủ trả bóng
Inline
– Hình ảnh nội tuyến đã chèn.
Ủ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
insert Image(childIndex, image)
Chèn Inline
đã cho vào chỉ mục đã chỉ định.
Hình ảnh sẽ nằm trong một Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục để chèn phần tử. |
image | Inline | Hình ảnh cần chèn. |
Cầu thủ trả bóng
Inline
– Hình ảnh nội tuyến đã chèn.
Ủ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
insert List Item(childIndex, listItem)
Chèn List
đã cho vào chỉ mục đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục cần chèn. |
list | List | Mục danh sách cần chèn. |
Cầu thủ trả bóng
List
– Mục danh sách đã chèn.
Ủ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
insert List Item(childIndex, text)
Tạo và chèn một List
mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục cần chèn. |
text | String | Nội dung văn bản của mục danh sách. |
Cầu thủ trả bóng
List
– Mục danh sách mới.
Ủ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
insert Page Break(childIndex)
Tạo và chèn một Page
mới tại chỉ mục đã chỉ định.
Page
sẽ nằm trong một Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục để chèn phần tử. |
Cầu thủ trả bóng
Page
– Dấu ngắt trang mới.
Ủ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
insert Page Break(childIndex, pageBreak)
Chèn Page
đã cho vào chỉ mục đã chỉ định.
Page
sẽ nằm trong một Paragraph
mới.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục để chèn phần tử. |
page | Page | Phần ngắt trang cần chèn. |
Cầu thủ trả bóng
Page
– Dấu ngắt trang đã chèn.
Ủ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
insert Paragraph(childIndex, paragraph)
Chèn Paragraph
đã cho vào chỉ mục đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục cần chèn. |
paragraph | Paragraph | Đoạn văn bản cần chèn. |
Cầu thủ trả bóng
Paragraph
– Đoạn văn bản được chèn.
Ủ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
insert Paragraph(childIndex, text)
Tạo và chèn một Paragraph
mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục cần chèn. |
text | String | Nội dung văn bản của đoạn văn. |
Cầu thủ trả bóng
Paragraph
– Đoạn văn mới.
Ủ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
insert Table(childIndex)
Tạo và chèn một Table
mới tại chỉ mục đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục cần chèn. |
Cầu thủ trả bóng
Table
– Bảng mới.
Ủ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
insert Table(childIndex, cells)
Tạo và chèn một Table
mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục cần chèn. |
cells | String[][] | Nội dung văn bản của các ô trong bảng cần thêm vào bảng mới. |
Cầu thủ trả bóng
Table
– Bảng mới.
Ủ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
insert Table(childIndex, table)
Chèn Table
đã cho vào chỉ mục đã chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Integer | Chỉ mục cần chèn. |
table | Table | Bảng cần chèn. |
Cầu thủ trả bóng
Table
– Bảng đã chèn.
Ủ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 Child(child)
Xoá phần tử con được chỉ định.
Tham số
Tên | Loại | Mô tả |
---|---|---|
child | Element | Phần tử con cần xoá. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
replace Text(searchPattern, replacement)
Thay thế tất cả các lần xuất hiện của một mẫu văn bản nhất định bằng một chuỗi thay thế nhất định, bằng cách sử dụng biểu thức chính quy.
Mẫu tìm kiếm được truyền dưới dạng chuỗi, chứ không phải đối tượng biểu thức chính quy JavaScript. Do đó, bạn cần thoát mọi dấu gạch chéo ngược trong mẫu.
Phương thức này sử dụng thư viện biểu thức chính quy RE2 của Google, giới hạn cú pháp được hỗ trợ.
Mẫu biểu thức chính quy được cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText('^.*Apps ?Script.*$', 'Apps Script');
Tham số
Tên | Loại | Mô tả |
---|---|---|
search | String | mẫu biểu thức chính quy cần tìm kiếm |
replacement | String | văn bản cần dùng để thay thế |
Cầu thủ trả bóng
Element
– phần tử hiện tại
Ủ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
set Attributes(attributes)
Đặt thuộc tính của phần tử.
Tham số thuộc tính được chỉ định phải là một đối tượng, trong đó mỗi tên thuộc tính là một mục trong enumeration Document
và mỗi giá trị thuộc tính là giá trị mới sẽ được áp dụng.
const doc = DocumentApp.getActiveDocument(); const documentTab = doc.getActiveTab().asDocumentTab(); const body = documentTab.getBody(); // Define a custom paragraph style. const style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. const par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
Tham số
Tên | Loại | Mô tả |
---|---|---|
attributes | Object | Thuộc tính của phần tử. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Heading Attributes(paragraphHeading, attributes)
Đặt các thuộc tính cho Paragraph
được cung cấp.
Tham số
Tên | Loại | Mô tả |
---|---|---|
paragraph | Paragraph | Tiêu đề cần đặt thuộc tính. |
attributes | Object | Bản đồ thuộc tính và giá trị để đặt thuộc tính. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Margin Bottom(marginBottom)
Đặt lề dưới, tính bằng điểm.
Tham số
Tên | Loại | Mô tả |
---|---|---|
margin | Number | Lề dưới, tính bằng điểm. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Margin Left(marginLeft)
Đặt lề trái, tính bằng điểm.
Tham số
Tên | Loại | Mô tả |
---|---|---|
margin | Number | Lề trái, tính bằng điểm. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Margin Right(marginRight)
Đặt lề phải, tính bằng điểm.
Tham số
Tên | Loại | Mô tả |
---|---|---|
margin | Number | Lề phải. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Margin Top(marginTop)
Đặt lề trên.
Tham số
Tên | Loại | Mô tả |
---|---|---|
margin | Number | Lề trên, tính bằng điểm. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Page Height(pageHeight)
Đặt chiều cao trang, tính bằng điểm.
Tham số
Tên | Loại | Mô tả |
---|---|---|
page | Number | Chiều cao trang, tính bằng điểm. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Page Width(pageWidth)
Đặt chiều rộng trang, tính bằng điểm.
Tham số
Tên | Loại | Mô tả |
---|---|---|
page | Number | Chiều rộng trang, tính bằng điểm. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Text(text)
Đặt nội dung dưới dạng văn bản thuần tuý.
Lưu ý: nội dung hiện có sẽ bị xoá.
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | String | Nội dung văn bản mới. |
Cầu thủ trả bóng
Body
– Phần tử hiện tại.
Ủ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
set Text Alignment(textAlignment)
Đặt chế độ căn chỉnh văn bản. Các loại căn chỉnh có sẵn là Document
, Document
và Document
.
// Make the entire first paragraph in the active tab be superscript. const documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); const text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Tham số
Tên | Loại | Mô tả |
---|---|---|
text | Text | loại căn chỉnh văn bản cần áp dụng |
Cầu thủ trả bóng
Body
– phần tử hiện tại
Ủ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