Class Body

Nội dung

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ử 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 của thẻ, ngoại trừ HeaderSection, FooterSection và mọi phần tử FootnoteSection. 

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ứcLoại dữ liệu trả vềMô tả ngắn
appendHorizontalRule()HorizontalRuleTạo và nối một HorizontalRule mới.
appendImage(image)InlineImageTạo và nối một InlineImage mới từ blob hình ảnh đã chỉ định.
appendImage(image)InlineImageThêm InlineImage đã cho.
appendListItem(listItem)ListItemThêm ListItem đã cho.
appendListItem(text)ListItemTạo và nối một ListItem mới chứa nội dung văn bản được chỉ định.
appendPageBreak()PageBreakTạo và nối một PageBreak mới.
appendPageBreak(pageBreak)PageBreakThêm PageBreak đã cho.
appendParagraph(paragraph)ParagraphThêm Paragraph đã cho.
appendParagraph(text)ParagraphTạo và nối một Paragraph mới chứa nội dung văn bản được chỉ định.
appendTable()TableTạo và nối một Table mới.
appendTable(cells)TableThêm một Table mới chứa TableCell cho mỗi giá trị chuỗi đã chỉ định.
appendTable(table)TableThêm Table đã cho.
clear()BodyXoá nội dung của phần tử.
copy()BodyTrả về một bản sao sâu, tách biệt của phần tử hiện tại.
editAsText()TextLấy phiên bản Text của phần tử hiện tại để chỉnh sửa.
findElement(elementType)RangeElementTìm kiếm nội dung của phần tử cho một phần tử con thuộc loại đã chỉ định.
findElement(elementType, from)RangeElementTì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ừ RangeElement đã chỉ định.
findText(searchPattern)RangeElementTì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.
findText(searchPattern, from)RangeElementTì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.
getAttributes()ObjectTruy xuất các thuộc tính của phần tử.
getChild(childIndex)ElementTruy xuất phần tử con tại chỉ mục con được chỉ định.
getChildIndex(child)IntegerTruy xuất chỉ mục con cho phần tử con được chỉ định.
getHeadingAttributes(paragraphHeading)ObjectTruy xuất tập hợp thuộc tính cho ParagraphHeading đã 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()NumberTruy xuất lề dưới, tính bằng điểm.
getMarginLeft()NumberTruy xuất lề trái, tính bằng điểm.
getMarginRight()NumberTruy xuất lề phải.
getMarginTop()NumberTruy xuất lề trên cùng.
getNumChildren()IntegerTruy xuất số lượng phần tử con.
getPageHeight()NumberTruy xuất chiều cao trang, tính bằng điểm.
getPageWidth()NumberTruy xuất chiều rộng trang, tính bằng điểm.
getParagraphs()Paragraph[]Truy xuất tất cả Paragraphs có trong phần (bao gồm cả ListItems).
getParent()ContainerElementTruy 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()StringTruy xuất nội dung của phần tử dưới dạng chuỗi văn bản.
getTextAlignment()TextAlignmentLấy chế độ căn chỉnh văn bản.
getType()ElementTypeTruy xuất ElementType của phần tử.
insertHorizontalRule(childIndex)HorizontalRuleTạo và chèn một HorizontalRule mới tại chỉ mục đã chỉ định.
insertImage(childIndex, image)InlineImageTạo và chèn InlineImage từ blob hình ảnh đã chỉ định, tại chỉ mục đã chỉ định.
insertImage(childIndex, image)InlineImageChèn InlineImage đã cho vào chỉ mục đã chỉ định.
insertListItem(childIndex, listItem)ListItemChèn ListItem đã cho vào chỉ mục đã chỉ định.
insertListItem(childIndex, text)ListItemTạ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)PageBreakTạo và chèn một PageBreak mới tại chỉ mục đã chỉ định.
insertPageBreak(childIndex, pageBreak)PageBreakChèn PageBreak đã cho vào chỉ mục đã chỉ định.
insertParagraph(childIndex, paragraph)ParagraphChèn Paragraph đã cho vào chỉ mục đã chỉ định.
insertParagraph(childIndex, text)ParagraphTạ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)TableTạo và chèn một Table mới tại chỉ mục đã chỉ định.
insertTable(childIndex, cells)TableTạ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)TableChèn Table đã cho vào chỉ mục đã chỉ định.
removeChild(child)BodyXoá phần tử con được chỉ định.
replaceText(searchPattern, replacement)ElementThay 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.
setAttributes(attributes)BodyĐặt thuộc tính của phần tử.
setHeadingAttributes(paragraphHeading, attributes)BodyĐặt các thuộc tính cho ParagraphHeading được cung cấp.
setMarginBottom(marginBottom)BodyĐặt lề dưới, 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 trang, tính bằng điểm.
setPageWidth(pageWidth)BodyĐặt chiều rộng 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 chế độ căn chỉnh văn bản.

Tài liệu chi tiết

appendHorizontalRule()

Tạo và nối một HorizontalRule mới.

HorizontalRule sẽ nằm trong một Paragraph mới.

Cầu thủ trả bóng

HorizontalRule – 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

appendImage(image)

Tạo và nối một InlineImage mới từ blob hình ảnh đã chỉ định.

Hình ảnh sẽ nằm trong một Paragraph mới.

Tham số

TênLoạiMô tả
imageBlobSourceDữ liệu hình ảnh.

Cầu thủ trả bóng

InlineImage – 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

appendImage(image)

Thêm InlineImage đã cho.

InlineImage sẽ nằm trong một Paragraph mới.

Sử dụng phiên bản appendImage này khi thêm một bản sao của InlineImage hiện có.

Tham số

TênLoạiMô tả
imageInlineImageDữ liệu hình ảnh.

Cầu thủ trả bóng

InlineImage – 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

appendListItem(listItem)

Thêm ListItem đã cho.

Sử dụng phiên bản appendListItem này khi thêm một bản sao của ListItem hiện có.

Tham số

TênLoạiMô tả
listItemListItemMục danh sách cần nối.

Cầu thủ trả bóng

ListItem – 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

appendListItem(text)

Tạo và nối một ListItem 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ênLoạiMô tả
textStringNộ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

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

appendPageBreak()

Tạo và nối một PageBreak mới.

PageBreak sẽ nằm trong một Paragraph mới.

Cầu thủ trả bóng

PageBreak – 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

appendPageBreak(pageBreak)

Thêm PageBreak đã cho.

PageBreak sẽ nằm trong một Paragraph mới.

Sử dụng phiên bản appendPageBreak này khi thêm một bản sao của PageBreak hiện có.

Tham số

TênLoạiMô tả
pageBreakPageBreakDấu ngắt trang cần thêm vào.

Cầu thủ trả bóng

PageBreak – 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

appendParagraph(paragraph)

Thêm Paragraph đã cho.

Sử dụng phiên bản appendParagraph này khi thêm một bản sao của Paragraph hiện có.

Tham số

TênLoạiMô tả
paragraphParagraphĐ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

appendParagraph(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ênLoạiMô tả
textStringNộ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

appendTable()

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

appendTable(cells)

Thêm một Table mới chứa TableCell 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ênLoạiMô tả
cellsString[][]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

appendTable(table)

Thêm Table đã cho.

Sử dụng phiên bản appendTable 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ênLoạiMô tả
tableTableBả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()

Xoá nội dung của phần tử.

Cầu thủ trả bóng

Body – Phần tử hiện tại.

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

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ủa 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 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

findElement(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ênLoạiMô tả
elementTypeElementTypeLoại phần tử cần tìm kiếm.

Cầu thủ trả bóng

RangeElement – 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

findElement(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ừ RangeElement đã 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ênLoạiMô tả
elementTypeElementTypeLoại phần tử cần tìm kiếm.
fromRangeElementKết quả tìm kiếm để tìm kiếm.

Cầu thủ trả bóng

RangeElement – 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

findText(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ênLoạiMô tả
searchPatternStringmẫu cần tìm kiếm

Cầu thủ trả bóng

RangeElement – 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

findText(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ênLoạiMô tả
searchPatternStringmẫu cần tìm kiếm
fromRangeElementkế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 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

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 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 DocumentApp.Attribute. 

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

getChild(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ênLoạiMô tả
childIndexIntegerChỉ 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

getChildIndex(child)

Truy xuất chỉ mục con cho phần tử con được chỉ định.

Tham số

TênLoạiMô tả
childElementPhầ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

getHeadingAttributes(paragraphHeading)

Truy xuất tập hợp thuộc tính cho ParagraphHeading đã cung cấp.

Tham số

TênLoạiMô tả
paragraphHeadingParagraphHeadingTiê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

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

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

getListItems()

Truy xuất tất cả ListItems có trong phần này.

Cầu thủ trả bóng

ListItem[] – 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

getMarginBottom()

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

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

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

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

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

getMarginTop()

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

getNumChildren()

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

getPageHeight()

Truy xuất chiều cao 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

getPageWidth()

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

getParagraphs()

Truy xuất tất cả Paragraphs có trong phần (bao gồm cả ListItems).

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

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

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

getTables()

Truy xuất tất cả Tables có trong phần này.

Cầu thủ trả bóng

Table[] – Các bảng mụ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

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

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

getTextAlignment()

Lấy chế độ căn chỉnh văn bản. Các loại căn chỉnh có sẵn 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 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

getType()

Truy xuất ElementType của phần tử.

Sử dụng getType() để 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

ElementType – 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

insertHorizontalRule(childIndex)

Tạo và chèn một HorizontalRule mới tại chỉ mục đã chỉ định.

HorizontalRule sẽ nằm trong một Paragraph mới.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục để chèn phần tử.

Cầu thủ trả bóng

HorizontalRule – 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

insertImage(childIndex, image)

Tạo và chèn InlineImage từ blob hình ảnh đã chỉ định, tại chỉ mục đã chỉ định.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục để chèn phần tử.
imageBlobSourceDữ liệu hình ảnh.

Cầu thủ trả bóng

InlineImage – 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

insertImage(childIndex, image)

Chèn InlineImage đã cho vào chỉ mục đã chỉ định.

Hình ảnh sẽ nằm trong một Paragraph mới.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục để chèn phần tử.
imageInlineImageHình ảnh cần chèn.

Cầu thủ trả bóng

InlineImage – 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

insertListItem(childIndex, listItem)

Chèn ListItem đã cho vào chỉ mục đã chỉ định.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục cần chèn.
listItemListItemMục danh sách cần chèn.

Cầu thủ trả bóng

ListItem – 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

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.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục cần chèn.
textStringNộ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

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

insertPageBreak(childIndex)

Tạo và chèn một PageBreak mới tại chỉ mục đã chỉ định.

PageBreak sẽ nằm trong một Paragraph mới.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục để chèn phần tử.

Cầu thủ trả bóng

PageBreak – 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

insertPageBreak(childIndex, pageBreak)

Chèn PageBreak đã cho vào chỉ mục đã chỉ định.

PageBreak sẽ nằm trong một Paragraph mới.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục để chèn phần tử.
pageBreakPageBreakPhần ngắt trang cần chèn.

Cầu thủ trả bóng

PageBreak – 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

insertParagraph(childIndex, paragraph)

Chèn Paragraph đã cho vào chỉ mục đã chỉ định.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục cần chèn.
paragraphParagraphĐ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

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.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục cần chèn.
textStringNộ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

insertTable(childIndex)

Tạo và chèn một Table mới tại chỉ mục đã chỉ định.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ 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

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.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục cần chèn.
cellsString[][]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

insertTable(childIndex, table)

Chèn Table đã cho vào chỉ mục đã chỉ định.

Tham số

TênLoạiMô tả
childIndexIntegerChỉ mục cần chèn.
tableTableBả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

removeChild(child)

Xoá phần tử con được chỉ định.

Tham số

TênLoạiMô tả
childElementPhầ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

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, 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ênLoạiMô tả
searchPatternStringmẫu biểu thức chính quy cần tìm kiếm
replacementStringvă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

setAttributes(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 DocumentApp.Attribute 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ênLoạiMô tả
attributesObjectThuộ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

setHeadingAttributes(paragraphHeading, attributes)

Đặt các thuộc tính cho ParagraphHeading được cung cấp.

Tham số

TênLoạiMô tả
paragraphHeadingParagraphHeadingTiêu đề cần đặt thuộc tính.
attributesObjectBả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

setMarginBottom(marginBottom)

Đặt lề dưới, tính bằng điểm.

Tham số

TênLoạiMô tả
marginBottomNumberLề 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

setMarginLeft(marginLeft)

Đặt lề trái, tính bằng điểm.

Tham số

TênLoạiMô tả
marginLeftNumberLề 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

setMarginRight(marginRight)

Đặt lề phải, tính bằng điểm.

Tham số

TênLoạiMô tả
marginRightNumberLề 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

setMarginTop(marginTop)

Đặt lề trên.

Tham số

TênLoạiMô tả
marginTopNumberLề 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

setPageHeight(pageHeight)

Đặt chiều cao trang, tính bằng điểm.

Tham số

TênLoạiMô tả
pageHeightNumberChiề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

setPageWidth(pageWidth)

Đặt chiều rộng trang, tính bằng điểm.

Tham số

TênLoạiMô tả
pageWidthNumberChiề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

setText(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ênLoạiMô tả
textStringNộ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

setTextAlignment(textAlignment)

Đặt chế độ căn chỉnh văn bản. Các loại căn chỉnh có sẵn là DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT và DocumentApp.TextAlignment.SUPERSCRIPT. 

// 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ênLoạiMô tả
textAlignmentTextAlignmentloạ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

Các phương thức ngừng hoạt động