Class ListItem

ListItem

Một phần tử đại diện cho một mục trong danh sách. ListItem là một Paragraph liên kết với một mã danh sách. ListItem có thể chứa các phần tử Equation, Footnote, HorizontalRule, InlineDrawing, InlineImage, PageBreakText. Để 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.

ListItems không được chứa ký tự dòng mới. Ký tự dòng mới ("\n") được chuyển đổi thành ký tự ngắt dòng ("\r").

ListItems có cùng mã danh sách thuộc cùng một danh sách và được đánh số tương ứng. ListItems cho một danh sách nhất định không bắt buộc phải nằm liền kề trong tài liệu hoặc thậm chí có cùng một phần tử mẹ. Hai mục thuộc cùng một danh sách có thể tồn tại ở bất kỳ đâu trong tài liệu trong khi vẫn duy trì cách đánh số liên tiếp, như ví dụ sau minh hoạ:

var body = DocumentApp.getActiveDocument().getBody();

// Append a new list item to the body.
var item1 = body.appendListItem('Item 1');

// Log the new list item's list ID.
Logger.log(item1.getListId());

// Append a table after the list item.
body.appendTable([
  ['Cell 1', 'Cell 2']
]);

// Append a second list item with the same list ID. The two items are treated as the same list,
// despite not being consecutive.
var item2 = body.appendListItem('Item 2');
item2.setListId(item1);

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addPositionedImage(image)PositionedImageTạo và chèn một PositionedImage mới từ blob hình ảnh được chỉ định.
appendHorizontalRule()HorizontalRuleTạo và thêm một HorizontalRule mới.
appendInlineImage(image)InlineImageTạo và thêm một InlineImage mới từ blob hình ảnh được chỉ định.
appendInlineImage(image)InlineImageThêm InlineImage đã cho.
appendPageBreak()PageBreakTạo và thêm một PageBreak mới.
appendPageBreak(pageBreak)PageBreakThêm PageBreak đã cho.
appendText(text)TextTạo và thêm một phần tử Text mới có nội dung được chỉ định.
appendText(text)TextThêm phần tử Text đã cho.
clear()ListItemXoá nội dung của phần tử.
copy()ListItemTrả về một bản sao sâu đã tách rời 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ử để xem thành phần con của kiểu đã chỉ định.
findElement(elementType, from)RangeElementTì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)RangeElementTì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)RangeElementTì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.
getAlignment()HorizontalAlignmentTruy xuất HorizontalAlignment.
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 đã chỉ định.
getChildIndex(child)IntegerTruy xuất chỉ mục con cho phần tử con đã chỉ định.
getGlyphType()GlyphTypeTruy xuất GlyphType của mục trong danh sách.
getHeading()ParagraphHeadingTruy xuất ParagraphHeading.
getIndentEnd()NumberTruy xuất thụt lề cuối, theo điểm.
getIndentFirstLine()NumberTruy xuất thụt lề dòng đầu tiên, theo điểm.
getIndentStart()NumberTruy xuất thụt lề đầu tiên.
getLineSpacing()NumberTruy xuất giãn cách dòng, theo điểm.
getLinkUrl()StringTruy xuất URL liên kết.
getListId()StringTruy xuất mã danh sách.
getNestingLevel()IntegerTruy xuất mức độ lồng ghép của mục danh sách.
getNextSibling()ElementTruy xuất phần tử phụ tiếp theo của phần tử.
getNumChildren()IntegerTruy xuất số lượng phần tử con.
getParent()ContainerElementTruy xuất phần tử mẹ của phần tử.
getPositionedImage(id)PositionedImageLấy PositionedImage theo mã nhận dạng của hình ảnh.
getPositionedImages()PositionedImage[]Lấy tất cả đối tượng PositionedImage liên kết với đoạn.
getPreviousSibling()ElementTruy xuất phần tử phụ trước đó của phần tử.
getSpacingAfter()NumberTruy xuất khoảng cách sau phần tử, tính bằng điểm.
getSpacingBefore()NumberTruy xuất khoảng cách trước phần tử, tính bằng điểm.
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 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 tại chỉ mục đã chỉ định.
insertInlineImage(childIndex, image)InlineImageTạo và chèn một InlineImage mới từ blob hình ảnh được chỉ định, tại chỉ mục đã chỉ định.
insertInlineImage(childIndex, image)InlineImageChèn InlineImage đã cho vào chỉ mục đã 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.
insertText(childIndex, text)TextTạo và chèn một thành phần văn bản mới tại chỉ mục đã chỉ định.
insertText(childIndex, text)TextChèn phần tử Text đã cho vào chỉ mục được chỉ định, với nội dung văn bản được chỉ định.
isAtDocumentEnd()BooleanXác định xem phần tử này có nằm ở cuối Document hay không.
isLeftToRight()BooleanTruy xuất chế độ cài đặt từ trái sang phải.
merge()ListItemHợp nhất phần tử với phần tử phụ thuộc cùng một loại trước đó.
removeChild(child)ListItemXoá phần tử con đã chỉ định.
removeFromParent()ListItemXoá phần tử khỏi phần tử mẹ.
removePositionedImage(id)BooleanXoá PositionedImage theo mã nhận dạng của hình ả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, sử dụng các biểu thức chính quy.
setAlignment(alignment)ListItemThiết lập HorizontalAlignment.
setAttributes(attributes)ListItemThiết lập các thuộc tính của phần tử.
setGlyphType(glyphType)ListItemĐặt GlyphType của mục danh sách.
setHeading(heading)ListItemThiết lập ParagraphHeading.
setIndentEnd(indentEnd)ListItemĐặt khoảng thụt lề cuối, tính theo điểm.
setIndentFirstLine(indentFirstLine)ListItemĐặt thụt lề dòng đầu tiên, tính bằng điểm.
setIndentStart(indentStart)ListItemĐặt khoảng thụt lề bắt đầu, tính theo điểm.
setLeftToRight(leftToRight)ListItemĐặt chế độ cài đặt từ trái sang phải.
setLineSpacing(multiplier)ListItemĐặt mức giãn cách dòng, dưới dạng số lượng cho biết số dòng cần sử dụng cho giãn cách.
setLinkUrl(url)ListItemĐặt URL của đường liên kết.
setListId(listItem)ListItemĐặt mã danh sách.
setNestingLevel(nestingLevel)ListItemĐặt mức độ lồng ghép của mục danh sách.
setSpacingAfter(spacingAfter)ListItemĐặt khoảng cách sau phần tử, tính bằng điểm.
setSpacingBefore(spacingBefore)ListItemĐặt khoảng cách trước phần tử, tính bằng điểm.
setText(text)voidĐặt nội dung của mục danh sách dưới dạng văn bản.
setTextAlignment(textAlignment)ListItemĐặt cách căn chỉnh văn bản.

Tài liệu chi tiết

addPositionedImage(image)

Tạo và chèn một PositionedImage mới từ blob hình ảnh được chỉ định.

Các tham số

TênLoạiNội dung mô tả
imageBlobSourcedữ liệu hình ảnh

Cầu thủ trả bóng

PositionedImage — hình ảnh có vị trí 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

appendHorizontalRule()

Tạo và thêm một HorizontalRule 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

appendInlineImage(image)

Tạo và thêm một InlineImage mới từ blob hình ảnh được chỉ định.

Các tham số

TênLoạiNội dung mô 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

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

appendInlineImage(image)

Thêm InlineImage đã cho.

Các tham số

TênLoạiNội dung mô 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

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.

Lưu ý: PageBreaks có thể không có trong TableCells. Nếu phần tử hiện tại nằm trong một ô của bảng, hệ thống sẽ gửi ra một ngoại lệ.

Cầu thủ trả bóng

PageBreak — phần tử 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.

Lưu ý: PageBreaks có thể không có trong TableCells. Nếu phần tử hiện tại nằm trong một ô của bảng, hệ thống sẽ gửi ra một ngoại lệ.

Các tham số

TênLoạiNội dung mô tả
pageBreakPageBreakngắt trang cần nối

Cầu thủ trả bóng

PageBreak — phần tử 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

appendText(text)

Tạo và thêm một phần tử Text mới có nội dung được chỉ định.

Các tham số

TênLoạiNội dung mô tả
textStringnội dung văn bản

Cầu thủ trả bóng

Text – thành phần văn bả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

appendText(text)

Thêm phần tử Text đã cho.

Các tham số

TênLoạiNội dung mô tả
textTextthành phần văn bản cần nối

Cầu thủ trả bóng

Text — thành phần văn bả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

clear()

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

Cầu thủ trả bóng

ListItem – phần tử hiện tại


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

ListItem – 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ư InlineImageHorizontalRule).

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ênLoạiNội dung mô tả
elementTypeElementTypeloạ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ênLoạiNội dung mô 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 — 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ênLoạiNội dung mô tả
searchPatternStringmẫ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ênLoạiNội dung mô 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 để 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

getAlignment()

Truy xuất HorizontalAlignment.

Cầu thủ trả bóng

HorizontalAlignment – cách căn 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

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ênLoạiNội dung mô 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

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ênLoạiNội dung mô tả
childElementphầ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

getGlyphType()

Truy xuất GlyphType của mục trong danh sách.

Cầu thủ trả bóng

GlyphType – kiểu ký 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

getHeading()

Truy xuất ParagraphHeading.

Cầu thủ trả bóng

ParagraphHeading – tiêu đề

Ủ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

getIndentEnd()

Truy xuất thụt lề cuối, theo điểm.

Cầu thủ trả bóng

Number – thụt lề cuối, tính theo đ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

getIndentFirstLine()

Truy xuất thụt lề dòng đầu tiên, theo điểm.

Cầu thủ trả bóng

Number – thụt lề dòng đầu tiên, tính theo đ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

getIndentStart()

Truy xuất thụt lề đầu tiên.

Cầu thủ trả bóng

Number – thụt lề đầu đoạ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

getLineSpacing()

Truy xuất giãn cách dòng, theo điểm.

Cầu thủ trả bóng

Number – giãn cách dò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

getLinkUrl()

Truy xuất URL liên kết.

Cầu thủ trả bóng

String — URL liên kết hoặc rỗng nếu phần tử chứa nhiều giá trị cho thuộc tính này

Ủ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

getListId()

Truy xuất mã danh sách.

Cầu thủ trả bóng

String – mã danh sách

Ủ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

getNestingLevel()

Truy xuất mức độ lồng ghép của mục danh sách.

Theo mặc định, các mục trong danh sách có mức độ lồng nhau là 0. Cấp độ lồng xác định ký tự mà mục danh sách sử dụng.

Cầu thủ trả bóng

Integer – mức lồng ghé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

getNextSibling()

Truy xuất phần tử phụ tiếp theo của phần tử.

Thành phần đồng cấp tiếp theo có cùng thành phần mẹ và theo sau phần tử hiện tại.

Cầu thủ trả bóng

Element – Phần tử phụ tiếp theo.

Ủ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

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

getPositionedImage(id)

Lấy PositionedImage theo mã nhận dạng của hình ảnh.

Các tham số

TênLoạiNội dung mô tả
idStringmã hình ảnh

Cầu thủ trả bóng

PositionedImage — hình ảnh đã định vị

Ủ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

getPositionedImages()

Lấy tất cả đối tượng PositionedImage liên kết với đoạn.

Cầu thủ trả bóng

PositionedImage[] – danh sách các hình ảnh đã định vị

Ủ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

getPreviousSibling()

Truy xuất phần tử phụ trước đó của phần tử.

Thành phần đồng cấp trước có cùng thành phần mẹ và đứng trước phần tử hiện tại.

Cầu thủ trả bóng

Element – Phần tử phụ trướ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

getSpacingAfter()

Truy xuất khoảng cách sau phần tử, tính bằng điểm.

Cầu thủ trả bóng

Number – khoảng cách sau phần tử, 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

getSpacingBefore()

Truy xuất khoảng cách trước phần tử, tính bằng điểm.

Cầu thủ trả bóng

Number – khoảng cách trước phần tử, 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

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.SUBSCRIPTDocumentApp.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 tại chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử

Cầu thủ trả bóng

HorizontalRule — phần tử 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

insertInlineImage(childIndex, image)

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

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
imageBlobSourcedữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage – phần tử 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

insertInlineImage(childIndex, image)

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

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
imageInlineImagedữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage – phần tử 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

insertPageBreak(childIndex)

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

Lưu ý: PageBreaks có thể không có trong TableCells. Nếu phần tử hiện tại nằm trong một ô của bảng, hệ thống sẽ gửi ra một ngoại lệ.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử

Cầu thủ trả bóng

PageBreak — phần tử 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.

Lưu ý: PageBreaks có thể không có trong TableCells. Nếu phần tử hiện tại nằm trong một ô của bảng, hệ thống sẽ gửi ra một ngoại lệ.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
pageBreakPageBreakCANNOT TRANSLATE

Cầu thủ trả bóng

PageBreak — phần tử 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

insertText(childIndex, text)

Tạo và chèn một thành phần văn bản mới tại chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
textStringnội dung văn bản

Cầu thủ trả bóng

Text – thành phần văn bả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

insertText(childIndex, text)

Chèn phần tử Text đã cho vào chỉ mục được chỉ định, với nội dung văn bản được chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
textTextthành phần văn bản cần chèn

Cầu thủ trả bóng

Text — phần tử văn bả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

isAtDocumentEnd()

Xác định xem phần tử này có nằm ở cuối Document hay không.

Cầu thủ trả bóng

Boolean – Liệu phần tử có nằm ở cuối tài liệu hay không.

Ủ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

isLeftToRight()

Truy xuất chế độ cài đặt từ trái sang phải.

Cầu thủ trả bóng

Boolean — cài đặt từ trái sang phả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

merge()

Hợp nhất phần tử với phần tử phụ thuộc cùng một loại trước đó.

Bạn chỉ có thể hợp nhất các phần tử của cùng một ElementType. Mọi phần tử con có trong phần tử hiện tại đều được chuyển sang phần tử phụ trước đó.

Phần tử hiện tại đã bị xoá khỏi tài liệu.

var body = DocumentApp.getActiveDocument().getBody();
// Example 1: Merge paragraphs
// Append two paragraphs to the document.
var par1 = body.appendParagraph('Paragraph 1.');
var par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

Cầu thủ trả bóng

ListItem — Phần tử đã hợp nhấ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

removeChild(child)

Xoá phần tử con đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childElementphần tử con cần xoá

Cầu thủ trả bóng

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

removeFromParent()

Xoá phần tử khỏi phần tử mẹ.

var body = DocumentApp.getActiveDocument().getBody();

// Remove all images in the document body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Cầu thủ trả bóng

ListItem – Phần tử đã bị xoá.

Ủ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

removePositionedImage(id)

Xoá PositionedImage theo mã nhận dạng của hình ảnh.

Các tham số

TênLoạiNội dung mô tả
idString

Cầu thủ trả bóng

Boolean — cho dù hình ảnh được chỉ định đã bị xoá hay chưa

Ủ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ênLoạiNội dung mô tả
searchPatternStringmẫu biểu thức chính quy để tìm kiếm
replacementStringvă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

setAlignment(alignment)

Thiết lập HorizontalAlignment.

Các tham số

TênLoạiNội dung mô tả
alignmentHorizontalAlignmentcăn ngang

Cầu thủ trả bóng

ListItem – 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ênLoạiNội dung mô tả
attributesObjectThuộc tính của phần tử.

Cầu thủ trả bóng

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

setGlyphType(glyphType)

Đặt GlyphType của mục danh sách.

Các tham số

TênLoạiNội dung mô tả
glyphTypeGlyphTypeloại ký tự

Cầu thủ trả bóng

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

setHeading(heading)

Thiết lập ParagraphHeading.

Các tham số

TênLoạiNội dung mô tả
headingParagraphHeadingtiêu đề

Cầu thủ trả bóng

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

setIndentEnd(indentEnd)

Đặt khoảng thụt lề cuối, tính theo điểm.

Các tham số

TênLoạiNội dung mô tả
indentEndNumberthụt lề cuối, tính theo điểm

Cầu thủ trả bóng

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

setIndentFirstLine(indentFirstLine)

Đặt thụt lề dòng đầu tiên, tính bằng điểm.

Các tham số

TênLoạiNội dung mô tả
indentFirstLineNumberthụt lề dòng đầu tiên, tính theo điểm

Cầu thủ trả bóng

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

setIndentStart(indentStart)

Đặt khoảng thụt lề bắt đầu, tính theo điểm.

Các tham số

TênLoạiNội dung mô tả
indentStartNumberthụt lề đầu đoạn, tính theo điểm

Cầu thủ trả bóng

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

setLeftToRight(leftToRight)

Đặt chế độ cài đặt từ trái sang phải.

Các tham số

TênLoạiNội dung mô tả
leftToRightBooleancài đặt từ trái sang phải

Cầu thủ trả bóng

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

setLineSpacing(multiplier)

Đặt mức giãn cách dòng, dưới dạng số lượng cho biết số dòng cần sử dụng cho giãn cách.

Các tham số

TênLoạiNội dung mô tả
multiplierNumbersố dòng

Cầu thủ trả bóng

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

setLinkUrl(url)

Đặt URL của đường liên kết.

Các tham số

TênLoạiNội dung mô tả
urlStringurl liên kết

Cầu thủ trả bóng

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

setListId(listItem)

Đặt mã danh sách.

Mã danh sách được đặt thành cùng một giá trị với ListItem được chỉ định. Hai ListItems này sẽ được coi là thành phần của cùng một danh sách.

Các tham số

TênLoạiNội dung mô tả
listItemListItemmục danh sách có mã danh sách được sử dụng

Cầu thủ trả bóng

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

setNestingLevel(nestingLevel)

Đặt mức độ lồng ghép của mục danh sách.

Theo mặc định, các mục trong danh sách có mức độ lồng nhau là 0. Cấp độ lồng xác định ký tự mà mục danh sách sử dụng.

Các tham số

TênLoạiNội dung mô tả
nestingLevelIntegermức lồng ghép

Cầu thủ trả bóng

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

setSpacingAfter(spacingAfter)

Đặt khoảng cách sau phần tử, tính bằng điểm.

Các tham số

TênLoạiNội dung mô tả
spacingAfterNumberkhoảng cách sau thành phần, tính bằng điểm

Cầu thủ trả bóng

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

setSpacingBefore(spacingBefore)

Đặt khoảng cách trước phần tử, tính bằng điểm.

Các tham số

TênLoạiNội dung mô tả
spacingBeforeNumberkhoảng cách trước phần tử, tính bằng điểm

Cầu thủ trả bóng

ListItem – 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 của mục danh sách dưới dạng văn bản.

Lưu ý: những nội dung hiện có sẽ bị xoá.

Các tham số

TênLoạiNội dung mô tả
textStringnội dung văn bả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

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.SUBSCRIPTDocumentApp.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ênLoạiNội dung mô tả
textAlignmentTextAlignmentloại căn chỉnh văn bản cần áp dụng

Cầu thủ trả bóng

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