Một phần tử đại diện cho nội dung tài liệu. Body
có thể chứa các phần tử ListItem
, Paragraph
, Table
và TableOfContents
. Để 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 tài liệu, ngoại trừ phần tử HeaderSection
, FooterSection
và bất kỳ phần tử FootnoteSection
nào.
var doc = DocumentApp.getActiveDocument(); var body = doc.getBody(); // Append a paragraph and a page break to the document body section directly. body.appendParagraph("A paragraph."); body.appendPageBreak();
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
appendHorizontalRule() | HorizontalRule | Tạo và thêm một HorizontalRule mới. |
appendImage(image) | InlineImage | Tạo và thêm một InlineImage mới từ blob hình ảnh được chỉ định. |
appendImage(image) | InlineImage | Thêm InlineImage đã cho. |
appendListItem(listItem) | ListItem | Thêm ListItem đã cho. |
appendListItem(text) | ListItem | Tạo và thêm một ListItem mới chứa nội dung văn bản chỉ định. |
appendPageBreak() | PageBreak | Tạo và thêm một PageBreak mới. |
appendPageBreak(pageBreak) | PageBreak | Thêm PageBreak đã cho. |
appendParagraph(paragraph) | Paragraph | Thêm Paragraph đã cho. |
appendParagraph(text) | Paragraph | Tạo và thêm một Paragraph mới chứa nội dung văn bản chỉ định. |
appendTable() | Table | Tạo và thêm một Table mới. |
appendTable(cells) | Table | Thêm Table mới chứa TableCell cho từng giá trị chuỗi được chỉ định. |
appendTable(table) | 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 rời của phần tử hiện tại. |
editAsText() | Text | Lấy phiên bản Text của phần tử hiện tại để chỉnh sửa. |
findElement(elementType) | RangeElement | Tìm kiếm nội dung của phần tử để xem thành phần con của kiểu đã chỉ định. |
findElement(elementType, from) | RangeElement | Tìm kiếm nội dung của phần tử cho thành phần con của kiểu đã chỉ định, bắt đầu từ RangeElement được chỉ định. |
findText(searchPattern) | RangeElement | Tìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định bằng biểu thức chính quy. |
findText(searchPattern, from) | RangeElement | Tìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định, bắt đầu từ một kết quả tìm kiếm đã cho. |
getAttributes() | Object | Truy xuất các thuộc tính của phần tử. |
getChild(childIndex) | Element | Truy xuất phần tử con tại chỉ mục con đã chỉ định. |
getChildIndex(child) | Integer | Truy xuất chỉ mục con cho phần tử con đã chỉ định. |
getHeadingAttributes(paragraphHeading) | Object | Truy xuất tập hợp các thuộc tính cho ParagraphHeading được cung cấp. |
getImages() | InlineImage[] | Truy xuất tất cả InlineImages có trong phần này. |
getListItems() | ListItem[] | Truy xuất tất cả ListItems có trong phần này. |
getMarginBottom() | Number | Truy xuất lề dưới cùng, tính bằng điểm. |
getMarginLeft() | Number | Truy xuất lề trái, tính bằng điểm. |
getMarginRight() | Number | Truy xuất lề phải. |
getMarginTop() | Number | Truy xuất lề trên. |
getNumChildren() | Integer | Truy xuất số lượng phần tử con. |
getPageHeight() | Number | Truy xuất chiều cao của trang, tính theo điểm. |
getPageWidth() | Number | Truy xuất chiều rộng của trang, tính bằng điểm. |
getParagraphs() | Paragraph[] | Truy xuất tất cả Paragraphs có trong phần này (bao gồm cả ListItems ). |
getParent() | ContainerElement | Truy xuất phần tử mẹ của phần tử. |
getTables() | Table[] | Truy xuất tất cả Tables có trong phần này. |
getText() | String | Truy xuất nội dung của phần tử dưới dạng chuỗi văn bản. |
getTextAlignment() | TextAlignment | Lấy căn chỉnh văn bản. |
getType() | ElementType | Truy xuất ElementType của phần tử. |
insertHorizontalRule(childIndex) | HorizontalRule | Tạo và chèn một HorizontalRule mới tại chỉ mục đã chỉ định. |
insertImage(childIndex, image) | InlineImage | Tạo và chèn một InlineImage từ blob hình ảnh được chỉ định, tại chỉ mục
đã chỉ định. |
insertImage(childIndex, image) | InlineImage | Chèn InlineImage đã cho vào chỉ mục đã chỉ định. |
insertListItem(childIndex, listItem) | ListItem | Chèn ListItem đã cho vào chỉ mục đã chỉ định. |
insertListItem(childIndex, text) | ListItem | Tạo và chèn một ListItem mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định. |
insertPageBreak(childIndex) | PageBreak | Tạo và chèn một PageBreak mới tại chỉ mục đã chỉ định. |
insertPageBreak(childIndex, pageBreak) | PageBreak | Chèn PageBreak đã cho vào chỉ mục đã chỉ định. |
insertParagraph(childIndex, paragraph) | Paragraph | Chèn Paragraph đã cho vào chỉ mục đã chỉ định. |
insertParagraph(childIndex, text) | 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. |
insertTable(childIndex) | Table | Tạo và chèn một Table mới tại chỉ mục đã chỉ định. |
insertTable(childIndex, cells) | Table | Tạo và chèn một Table mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định. |
insertTable(childIndex, table) | Table | Chèn Table đã cho vào chỉ mục đã chỉ định. |
removeChild(child) | Body | Xoá phần tử con đã chỉ định. |
replaceText(searchPattern, replacement) | 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, sử dụng các biểu thức chính quy. |
setAttributes(attributes) | Body | Thiết lập các thuộc tính của phần tử. |
setHeadingAttributes(paragraphHeading, attributes) | Body | Thiết lập các thuộc tính cho ParagraphHeading đã cho. |
setMarginBottom(marginBottom) | Body | Đặt lề dưới cùng, tính bằng điểm. |
setMarginLeft(marginLeft) | Body | Đặt lề trái, tính bằng điểm. |
setMarginRight(marginRight) | Body | Đặt lề phải, tính bằng điểm. |
setMarginTop(marginTop) | Body | Đặt lề trên. |
setPageHeight(pageHeight) | Body | Đặt chiều cao của trang, tính theo điểm. |
setPageWidth(pageWidth) | Body | Đặt chiều rộng của trang, tính bằng điểm. |
setText(text) | Body | Đặt nội dung dưới dạng văn bản thuần tuý. |
setTextAlignment(textAlignment) | Body | Đặt cách căn chỉnh văn bản. |
Tài liệu chi tiết
appendHorizontalRule()
Tạo và thêm một HorizontalRule
mới.
HorizontalRule
này sẽ nằm trong một Paragraph
mới.
Cầu thủ trả bóng
HorizontalRule
— quy tắc ngang mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendImage(image)
Tạo và thêm một InlineImage
mới từ blob hình ảnh được chỉ định.
Hình ảnh đó sẽ được chứa trong một Paragraph
mới.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
image | BlobSource | dữ liệu hình ảnh |
Cầu thủ trả bóng
InlineImage
— hình ảnh được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendImage(image)
Thêm InlineImage
đã cho.
InlineImage
này sẽ nằm trong một Paragraph
mới.
Sử dụng phiên bản appendImage
này khi thêm bản sao của một InlineImage
hiện có.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
image | InlineImage | dữ liệu hình ảnh |
Cầu thủ trả bóng
InlineImage
— hình ảnh được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendListItem(listItem)
Thêm ListItem
đã cho.
Sử dụng phiên bản appendListItem
này khi thêm bản sao của một ListItem
hiện có.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
listItem | ListItem | mục danh sách cần thêm |
Cầu thủ trả bóng
ListItem
– mục danh sách được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendListItem(text)
Tạo và thêm một ListItem
mới chứa nội dung văn bản 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | nội dung văn bản của mục danh sách |
Cầu thủ trả bóng
ListItem
– mục danh sách mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendPageBreak()
Tạo và thêm một PageBreak
mới.
PageBreak
này sẽ nằm trong một Paragraph
mới.
Cầu thủ trả bóng
PageBreak
— ngắt trang mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendPageBreak(pageBreak)
Thêm PageBreak
đã cho.
PageBreak
này sẽ nằm trong một Paragraph
mới.
Sử dụng phiên bản appendPageBreak
này khi thêm bản sao của một PageBreak
hiện có.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
pageBreak | PageBreak | ngắt trang cần nối |
Cầu thủ trả bóng
PageBreak
— ngắt trang được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendParagraph(paragraph)
Thêm Paragraph
đã cho.
Sử dụng phiên bản appendParagraph
này khi thêm bản sao của một Paragraph
hiện có.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
paragraph | Paragraph | đoạn cần nối |
Cầu thủ trả bóng
Paragraph
— đoạn được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendParagraph(text)
Tạo và thêm một Paragraph
mới chứa nội dung văn bản chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
text | String | nội dung văn bản của đoạn |
Cầu thủ trả bóng
Paragraph
— đoạn mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendTable()
Tạo và thêm một Table
mới.
Phương thức này cũng sẽ nối một đoạ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 bảng.
Cầu thủ trả bóng
Table
– bảng mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
appendTable(cells)
Thêm Table
mới chứa TableCell
cho từng giá trị chuỗi được chỉ định.
Phương thức này cũng sẽ nối một đoạ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 bảng.
Các tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần đượ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
appendTable(table)
Thêm Table
đã cho.
Sử dụng phiên bản appendTable
này khi thêm bản sao của một Table
hiện có.
Phương thức này cũng sẽ nối một đoạ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 bảng.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
table | Table | bảng để thêm |
Cầu thủ trả bóng
Table
– bảng được thêm vào
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 rời 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
Tập lệnh sử dụng phương thức này cần đượ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
editAsText()
Lấy phiên bản Text
của phần tử hiện tại để chỉnh sửa.
Sử dụng editAsText
để thao tác với nội dung các phần tử dưới dạng văn bản đa dạng thức. Chế độ editAsText
bỏ qua các phần tử không phải văn bản (chẳng hạn như InlineImage
và HorizontalRule
).
Các phần tử con nằm trong phạm vi văn bản đã xoá sẽ bị xoá khỏi phần tử đó.
var body = DocumentApp.getActiveDocument().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
findElement(elementType)
Tìm kiếm nội dung của phần tử để xem thành phần con của kiểu đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
elementType | ElementType | loại phần tử cần tìm kiếm |
Cầu thủ trả bóng
RangeElement
— một kết quả tìm kiếm cho biết vị trí của phần tử tìm kiếm
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
findElement(elementType, from)
Tìm kiếm nội dung của phần tử cho thành phần con của kiểu đã chỉ định, bắt đầu từ RangeElement
được chỉ định.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Define the search parameters. var searchType = DocumentApp.ElementType.PARAGRAPH; var searchHeading = DocumentApp.ParagraphHeading.HEADING1; var searchResult = null; // Search until the paragraph is found. while (searchResult = body.findElement(searchType, searchResult)) { var par = searchResult.getElement().asParagraph(); if (par.getHeading() == searchHeading) { // Found one, update and stop. par.setText('This is the first header.'); return; } }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
elementType | ElementType | loại phần tử cần tìm kiếm |
from | RangeElement | kết quả tìm kiếm để tìm kiếm |
Cầu thủ trả bóng
RangeElement
— một 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
Tập lệnh sử dụng phương thức này cần đượ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
findText(searchPattern)
Tìm kiếm nội dung của phần tử cho mẫu văn bản được 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 chưa được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập dữ liệu và đối tượng sửa đổi chế độ.
Mẫu biểu thức chính quy đã 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
searchPattern | String | mẫu cần tìm kiếm |
Cầu thủ trả bóng
RangeElement
– một kết quả tìm kiếm cho biết vị trí của văn bản tìm kiếm hoặc để trống nếu không có kết quả nào trùng khớp
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
findText(searchPattern, from)
Tìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định, bắt đầu từ một kết quả tìm kiếm đã cho.
Một số tính năng của biểu thức chính quy JavaScript chưa được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập dữ liệu và đối tượng sửa đổi chế độ.
Mẫu biểu thức chính quy đã 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
searchPattern | String | mẫu cần tìm kiếm |
from | RangeElement | kết quả tìm kiếm để tìm kiếm |
Cầu thủ trả bóng
RangeElement
– 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 để trống nếu không có kết quả nào phù hợp
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getAttributes()
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 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 bảng liệt kê DocumentApp.Attribute
.
var body = DocumentApp.getActiveDocument().getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var 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
Tập lệnh sử dụng phương thức này cần đượ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
getChild(childIndex)
Truy xuất phần tử con tại chỉ mục con đã chỉ định.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document. var 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."); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | 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
Tập lệnh sử dụng phương thức này cần đượ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
getChildIndex(child)
Truy xuất chỉ mục con cho phần tử con đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
child | Element | phần tử con cần truy xuất chỉ mục |
Cầu thủ trả bóng
Integer
– chỉ mục con
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getHeadingAttributes(paragraphHeading)
Truy xuất tập hợp các thuộc tính cho ParagraphHeading
được cung cấp.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
paragraphHeading | ParagraphHeading | tiêu đề có các thuộc tính sẽ được truy xuất |
Cầu thủ trả bóng
Object
– bản đồ các thuộc tính và giá trị hiện tại của các thuộc tính đó
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getImages()
Truy xuất tất cả InlineImages
có trong phần này.
Cầu thủ trả bóng
InlineImage[]
– hình ảnh phần
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getListItems()
Truy xuất tất cả ListItems
có trong phần này.
Cầu thủ trả bóng
ListItem[]
– mục danh sách mục
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getMarginBottom()
Truy xuất lề dưới cùng, tính bằng điểm.
Cầu thủ trả bóng
Number
– lề dưới cùng, tính bằng điểm
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getMarginLeft()
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
Tập lệnh sử dụng phương thức này cần đượ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
getMarginRight()
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
Tập lệnh sử dụng phương thức này cần đượ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
getMarginTop()
Truy xuất lề trên.
Cầu thủ trả bóng
Number
– lề trên cùng, tính bằng điểm
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getNumChildren()
Truy xuất số lượng phần tử con.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Log the number of elements in the document. Logger.log("There are " + body.getNumChildren() + " elements in the document body.");
Cầu thủ trả bóng
Integer
– số lượng trẻ em
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getPageHeight()
Truy xuất chiều cao của trang, tính theo điểm.
Cầu thủ trả bóng
Number
– chiều cao của trang, tính bằng điểm
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getPageWidth()
Truy xuất chiều rộng của trang, tính bằng điểm.
Cầu thủ trả bóng
Number
– chiều rộng của trang, tính bằng điểm
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getParagraphs()
Truy xuất tất cả Paragraphs
có trong phần này (bao gồm cả ListItems
).
Cầu thủ trả bóng
Paragraph[]
– các đoạn văn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getParent()
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
ContainerElement
– Phần tử mẹ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getTables()
getText()
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
Tập lệnh sử dụng phương thức này cần đượ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
getTextAlignment()
Lấy căn chỉnh văn bản. Có các loại căn chỉnh là DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
và DocumentApp.TextAlignment.SUPERSCRIPT
.
Cầu thủ trả bóng
TextAlignment
– 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 chưa từng đặt cách căn chỉnh văn bản
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
getType()
Truy xuất ElementType
của phần tử.
Sử dụng getType()
để xác định loại chính xác của một phần tử nhất định.
var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document body. var 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
ElementType
– Loại phần tử.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertHorizontalRule(childIndex)
Tạo và chèn một HorizontalRule
mới tại chỉ mục đã chỉ định.
HorizontalRule
này sẽ nằm trong một Paragraph
mới.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục để chèn phần tử |
Cầu thủ trả bóng
HorizontalRule
— quy tắc ngang mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertImage(childIndex, image)
Tạo và chèn một InlineImage
từ blob hình ảnh được chỉ định, tại chỉ mục
đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục để chèn phần tử |
image | BlobSource | dữ liệu hình ảnh |
Cầu thủ trả bóng
InlineImage
– hình ảnh cùng dòng được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertImage(childIndex, image)
Chèn InlineImage
đã cho vào chỉ mục đã chỉ định.
Hình ảnh đó sẽ được chứa trong một Paragraph
mới.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục để chèn phần tử |
image | InlineImage | hình ảnh cần chèn |
Cầu thủ trả bóng
InlineImage
– hình ảnh cùng dòng được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertListItem(childIndex, listItem)
Chèn ListItem
đã cho vào chỉ mục đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục cần chèn |
listItem | ListItem | mục danh sách cần chèn |
Cầu thủ trả bóng
ListItem
– mục danh sách được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertListItem(childIndex, text)
Tạo và chèn một ListItem
mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | 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
ListItem
– mục danh sách mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertPageBreak(childIndex)
Tạo và chèn một PageBreak
mới tại chỉ mục đã chỉ định.
PageBreak
này sẽ nằm trong một Paragraph
mới.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục để chèn phần tử |
Cầu thủ trả bóng
PageBreak
— ngắt trang mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertPageBreak(childIndex, pageBreak)
Chèn PageBreak
đã cho vào chỉ mục đã chỉ định.
PageBreak
này sẽ nằm trong một Paragraph
mới.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục để chèn phần tử |
pageBreak | PageBreak | CANNOT TRANSLATE |
Cầu thủ trả bóng
PageBreak
— ngắt trang được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertParagraph(childIndex, paragraph)
Chèn Paragraph
đã cho vào chỉ mục đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục cần chèn |
paragraph | Paragraph | đoạn cần chèn |
Cầu thủ trả bóng
Paragraph
– đoạn được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertParagraph(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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục cần chèn |
text | String | nội dung văn bản của đoạn |
Cầu thủ trả bóng
Paragraph
— đoạn mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertTable(childIndex)
Tạo và chèn một Table
mới tại chỉ mục đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục cần chèn |
Cầu thủ trả bóng
Table
– bảng mới
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
insertTable(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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | 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
Tập lệnh sử dụng phương thức này cần đượ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
insertTable(childIndex, table)
Chèn Table
đã cho vào chỉ mục đã chỉ định.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
childIndex | Integer | chỉ mục cần chèn |
table | Table | bảng để chèn |
Cầu thủ trả bóng
Table
— bảng được chèn
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
removeChild(child)
Xoá phần tử con đã chỉ định.
Các tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần đượ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
replaceText(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, sử dụng các biểu thức chính quy.
Mẫu tìm kiếm được chuyển dưới dạng chuỗi, không phải đối tượng biểu thức chính quy JavaScript. Do đó, bạn sẽ cần phải 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. Thư viện này giới hạn cú pháp được hỗ trợ.
Mẫu biểu thức chính quy đã 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.
var body = DocumentApp.getActiveDocument().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
searchPattern | String | mẫu biểu thức chính quy để tìm kiếm |
replacement | String | văn bản để thay thế |
Cầu thủ trả bóng
Element
– phần tử hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
setAttributes(attributes)
Thiết lập các 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 bảng liệt kê DocumentApp.Attribute
và mỗi giá trị thuộc tính là một giá trị mới sẽ được áp dụng.
var body = DocumentApp.getActiveDocument().getBody(); // Define a custom paragraph style. var 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. var par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
Các tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần đượ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
setHeadingAttributes(paragraphHeading, attributes)
Thiết lập các thuộc tính cho ParagraphHeading
đã cho.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
paragraphHeading | ParagraphHeading | tiêu đề có các thuộc tính sẽ được đặt |
attributes | Object | tập hợp các thuộc tính và giá trị để thiết lập |
Cầu thủ trả bóng
Body
– phần tử hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
setMarginBottom(marginBottom)
Đặt lề dưới cùng, tính bằng điểm.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
marginBottom | 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
Tập lệnh sử dụng phương thức này cần đượ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
setMarginLeft(marginLeft)
Đặt lề trái, tính bằng điểm.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
marginLeft | 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
Tập lệnh sử dụng phương thức này cần đượ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
setMarginRight(marginRight)
Đặt lề phải, tính bằng điểm.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
marginRight | Number | lề phải |
Cầu thủ trả bóng
Body
– phần tử hiện tại
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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
setMarginTop(marginTop)
Đặt lề trên.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
marginTop | 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
Tập lệnh sử dụng phương thức này cần đượ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
setPageHeight(pageHeight)
Đặt chiều cao của trang, tính theo điểm.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
pageHeight | 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
Tập lệnh sử dụng phương thức này cần đượ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
setPageWidth(pageWidth)
Đặt chiều rộng của trang, tính bằng điểm.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
pageWidth | 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
Tập lệnh sử dụng phương thức này cần đượ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
setText(text)
Đặt nội dung dưới dạng văn bản thuần tuý.
Lưu ý: những nội dung hiện có sẽ bị xoá.
Các tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần đượ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
setTextAlignment(textAlignment)
Đặt cách căn chỉnh văn bản. Có các loại căn chỉnh là DocumentApp.TextAlignment.NORMAL
, DocumentApp.TextAlignment.SUBSCRIPT
và DocumentApp.TextAlignment.SUPERSCRIPT
.
// Make the entire first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
textAlignment | TextAlignment | 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
Tập lệnh sử dụng phương thức này cần đượ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