Class TableCell

TableCell

Một phần tử đại diện cho ô trong bảng. TableCell luôn nằm trong TableRow và có thể chứa các phần tử ListItem, Paragraph hoặc Table. Để biết thêm thông tin về cấu trúc tài liệu, hãy xem hướng dẫn về cách mở rộng Google Tài liệu.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
appendHorizontalRule()HorizontalRuleTạo và thêm một HorizontalRule mới.
appendImage(image)InlineImageTạo và thêm một InlineImage mới từ blob hình ảnh đã chỉ định.
appendImage(image)InlineImageNối InlineImage đã cho.
appendListItem(listItem)ListItemNối ListItem đã cho.
appendListItem(text)ListItemTạo và thêm một ListItem mới.
appendParagraph(paragraph)ParagraphNối Paragraph đã cho.
appendParagraph(text)ParagraphTạo và thêm một Paragraph mới.
appendTable()TableTạo và thêm một Table mới.
appendTable(cells)TableNối một Table mới chứa các ô được chỉ định.
appendTable(table)TableNối Table đã cho.
clear()TableCellXoá nội dung của phần tử.
copy()TableCellTrả về một bản sao tách biệt, sao chép sâu 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)RangeElement|nullTìm kiếm nội dung của phần tử cho một phần tử con thuộc loại được chỉ định.
findElement(elementType, from)RangeElement|nullTìm kiếm nội dung của phần tử cho một phần tử con thuộc loại được chỉ định, bắt đầu từ RangeElement được chỉ định.
findText(searchPattern)RangeElement|nullTìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định bằng cách sử dụng biểu thức chính quy.
findText(searchPattern, from)RangeElement|nullTì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ử.
getBackgroundColor()String|nullTruy xuất màu nền.
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.
getColSpan()IntegerTruy xuất khoảng cột, là số lượng cột của các ô trong bảng mà ô này trải rộng.
getLinkUrl()String|nullTruy xuất URL của đường liên kết.
getNextSibling()Element|nullTruy xuất phần tử anh chị em tiếp theo của phần tử.
getNumChildren()IntegerTruy xuất số lượng thành phần con.
getPaddingBottom()Number|nullTruy xuất khoảng đệm dưới cùng, tính bằng điểm.
getPaddingLeft()Number|nullTruy xuất khoảng đệm bên trái, tính bằng điểm.
getPaddingRight()Number|nullTruy xuất khoảng đệm bên phải, tính bằng điểm.
getPaddingTop()Number|nullTruy xuất khoảng đệm trên cùng, tính bằng điểm.
getParent()ContainerElement|nullTruy xuất phần tử mẹ của phần tử.
getParentRow()TableRow|nullTruy xuất TableRow chứa TableCell hiện tại.
getParentTable()Table|nullTruy xuất Table chứa TableCell hiện tại.
getPreviousSibling()Element|nullTruy xuất phần tử anh chị em trước đó của phần tử.
getRowSpan()IntegerTruy xuất khoảng hàng, là số hàng của các ô trong bảng mà ô này trải rộng.
getText()StringTruy xuất nội dung của phần tử dưới dạng một chuỗi văn bản.
getTextAlignment()TextAlignment|nullLấy chế độ căn chỉnh văn bản.
getType()ElementTypeTruy xuất ElementType của phần tử.
getVerticalAlignment()VerticalAlignment|nullTruy xuất VerticalAlignment.
getWidth()Number|nullTruy xuất chiều rộng của cột chứa ô, tính bằng điểm.
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 một 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 được chỉ định.
insertListItem(childIndex, listItem)ListItemChèn ListItem đã cho vào chỉ mục được chỉ định.
insertListItem(childIndex, text)ListItemTạo và chèn một ListItem mới tại chỉ mục đã chỉ định.
insertParagraph(childIndex, paragraph)ParagraphChèn Paragraph đã cho vào chỉ mục được chỉ định.
insertParagraph(childIndex, text)ParagraphTạo và chèn một Paragraph mới tại chỉ mục đã 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 được chỉ định.
isAtDocumentEnd()BooleanXác định xem phần tử có ở cuối Document hay không.
merge()TableCell|nullHợp nhất phần tử này với phần tử cùng loại đứng trước.
removeChild(child)TableCellXoá phần tử con đã chỉ định.
removeFromParent()TableCell|nullXoá phần tử khỏi phần tử mẹ.
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)TableCellĐặt các thuộc tính của phần tử.
setBackgroundColor(color)TableCellĐặt màu nền.
setLinkUrl(url)TableCellĐặt URL của đường liên kết.
setPaddingBottom(paddingBottom)TableCellĐặt khoảng đệm dưới cùng, tính bằng điểm.
setPaddingLeft(paddingLeft)TableCellĐặt khoảng đệm bên trái, tính bằng điểm.
setPaddingRight(paddingRight)TableCellĐặt khoảng đệm bên phải, tính bằng điểm.
setPaddingTop(paddingTop)TableCellĐặt khoảng đệm trên cùng, tính bằng điểm.
setText(text)TableCellĐặt nội dung dưới dạng văn bản thuần tuý.
setTextAlignment(textAlignment)TableCellĐặt chế độ căn chỉnh văn bản.
setVerticalAlignment(alignment)TableCellĐặt chế độ căn chỉnh theo chiều dọc.
setWidth(width)TableCellĐặt chiều rộng của cột chứa ô hiện tại, tính bằng điểm.

Tài liệu chi tiết

appendHorizontalRule()

Tạo và thêm một HorizontalRule mới.

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

Cầu thủ trả bóng

HorizontalRule – quy tắc đường kẻ ngang mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 đã chỉ định.

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

Thông số

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

Cầu thủ trả bóng

InlineImage – hình ảnh mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendImage(image)

Nối InlineImage đã cho.

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

Thông 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendListItem(listItem)

Nối ListItem đã cho.

Thông số

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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

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

Cầu thủ trả bóng

ListItem – mục mới trong danh sách

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendParagraph(paragraph)

Nối Paragraph đã cho.

Thông số

TênLoạiMô tả
paragraphParagraphđoạn văn cần thêm

Cầu thủ trả bóng

Paragraph – đoạn văn được thêm vào

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
textStringnội dung văn bả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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable()

Tạo và thêm một Table 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(cells)

Nối một Table mới chứa các ô được chỉ định.

Thông 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 nối

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

appendTable(table)

Nối Table đã cho.

Thông số

TênLoạiMô tả
tableTablebảng cần thêm

Cầu thủ trả bóng

Table – bảng được nối

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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

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

copy()

Trả về một bản sao tách biệt, sao chép sâu của phần tử hiện tại.

Mọi phần tử con có trong phần tử cũng sẽ được sao chép. Phần tử mới không có phần tử mẹ.

Cầu thủ trả bóng

TableCell – Bản sao mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 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 đã bị 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 được chỉ định.

Thông số

TênLoạiMô tả
elementTypeElementTypeLoại phần tử cần tìm kiếm.

Cầu thủ trả bóng

RangeElement|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 thuộc loại được chỉ định, bắt đầu từ RangeElement được 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;
  }
}

Thông 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|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cách sử dụng biểu thức chính quy.

Một số tính năng biểu thức chính quy JavaScript không được hỗ trợ đầy đủ, chẳng hạn như nhóm chụp và bộ sửa đổi chế độ.

Mẫu biểu thức chính quy được cung cấp sẽ đượ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.

Thông số

TênLoạiMô tả
searchPatternStringmẫu cần tìm

Cầu thủ trả bóng

RangeElement|null – 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ả trùng khớp

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 biểu thức chính quy JavaScript không được hỗ trợ đầy đủ, chẳng hạn như nhóm chụp và bộ sửa đổi chế độ.

Mẫu biểu thức chính quy được cung cấp sẽ đượ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.

Thông số

TênLoạiMô tả
searchPatternStringmẫu cần tìm
fromRangeElementkết quả tìm kiếm để tìm

Cầu thủ trả bóng

RangeElement|null – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 phép liệt kê 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 – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getBackgroundColor()

Truy xuất màu nền.

Cầu thủ trả bóng

String|null – màu nền, được định dạng theo ký hiệu CSS (chẳng hạn như '#ffffff')

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.');
}

Thông 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
childElementPhần tử con mà bạn muốn 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getColSpan()

Truy xuất khoảng cột, là số lượng cột của các ô trong bảng mà ô này trải rộng. Các ô không được hợp nhất có khoảng cột là 1.

Cầu thủ trả bóng

Integer – khoảng cột hoặc 0 cho một ô được hợp nhất bởi một ô khác

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getLinkUrl()

Truy xuất URL của đường liên kết.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNextSibling()

Truy xuất phần tử anh chị em tiếp theo của phần tử.

Phần tử anh chị em tiếp theo có cùng phần tử mẹ và nằm sau phần tử hiện tại.

Cầu thủ trả bóng

Element|null – Phần tử anh chị em tiếp theo.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNumChildren()

Truy xuất số lượng thành phần 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ố trẻ em.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingBottom()

Truy xuất khoảng đệm dưới cùng, tính bằng điểm.

Cầu thủ trả bóng

Number|null – khoảng đệm dưới cùng, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingLeft()

Truy xuất khoảng đệm bên trái, tính bằng điểm.

Cầu thủ trả bóng

Number|null – khoảng đệm bên 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingRight()

Truy xuất khoảng đệm bên phải, tính bằng điểm.

Cầu thủ trả bóng

Number|null – khoảng đệm bên 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPaddingTop()

Truy xuất khoảng đệm trên cùng, tính bằng điểm.

Cầu thủ trả bóng

Number|null – khoảng đệm trên cùng, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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|null – Phần tử mẹ.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParentRow()

Truy xuất TableRow chứa TableCell hiện tại.

Cầu thủ trả bóng

TableRow|null – hàng trong bảng chứa ô hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParentTable()

Truy xuất Table chứa TableCell hiện tại.

Cầu thủ trả bóng

Table|null – bảng chứa ô hiện tại

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPreviousSibling()

Truy xuất phần tử anh chị em trước đó của phần tử.

Phần tử anh chị em trước có cùng phần tử mẹ và đứng trước phần tử hiện tại.

Cầu thủ trả bóng

Element|null – Phần tử anh chị em trước đó.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getRowSpan()

Truy xuất khoảng hàng, là số hàng của các ô trong bảng mà ô này trải rộng. Các ô không được hợp nhất có khoảng hàng là 1.

Cầu thủ trả bóng

Integer – khoảng hàng hoặc 0 cho một ô được hợp nhất bởi một ô khác

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 một 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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|null – loại căn chỉnh văn bản hoặc null nếu văn bản có nhiều loại căn chỉnh văn bản hoặc nếu bạn chưa bao giờ đặt chế độ 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getType()

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

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getVerticalAlignment()

Truy xuất VerticalAlignment.

Cầu thủ trả bóng

VerticalAlignment|null – căn chỉnh theo chiều dọc

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getWidth()

Truy xuất chiều rộng của cột chứa ô, tính bằng điểm.

Cầu thủ trả bóng

Number|null – chiều rộng cột, tính bằng điểm

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Đường kẻ ngang sẽ nằm trong một Paragraph mới.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử

Cầu thủ trả bóng

HorizontalRule – quy tắc đường kẻ ngang mới

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

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

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
imageBlobSourcedữ 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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 được chỉ định.

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

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
imageInlineImagehì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

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 được chỉ định.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
listItemListItemmục danh sách cần chèn

Cầu thủ trả bóng

ListItem – đã chèn 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
textStringnội dung văn bản

Cầu thủ trả bóng

ListItem – mục mới trong danh sách

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 được chỉ định.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
paragraphParagraphđoạn văn cần chèn

Cầu thủ trả bóng

Paragraph – đoạn văn được chèn

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
textStringnội dung văn bả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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục để 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 được chỉ định.

Thông số

TênLoạiMô tả
childIndexIntegerchỉ mục mà bạn muốn chèn phần tử
tableTablebảng cần chèn

Cầu thủ trả bóng

Table – bảng được chèn

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

isAtDocumentEnd()

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

Cầu thủ trả bóng

Boolean – Cho biết phần tử có nằm ở cuối thẻ hay không.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

merge()

Hợp nhất phần tử này với phần tử cùng loại đứng trước.

Bạn chỉ có thể hợp nhất các phần tử có cùng ElementType. Mọi phần tử con có trong phần tử hiện tại đều được chuyển đến phần tử anh chị em trước đó.

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

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const 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.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

Cầu thủ trả bóng

TableCell|null – Phần tử được hợp nhất.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeChild(child)

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

Thông số

TênLoạiMô tả
childElementphần tử con cần xoá

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeFromParent()

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

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

Cầu thủ trả bóng

TableCell|null – Phần tử đã bị xoá.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 một chuỗi, không phải là đố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úp giới hạn cú pháp được hỗ trợ.

Mẫu biểu thức chính quy được cung cấp sẽ đượ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');

Thông số

TênLoạiMô tả
searchPatternStringmẫu biểu thức chính quy để tìm kiếm
replacementStringvăn bả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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setAttributes(attributes)

Đặt 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 phép liệt kê 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);

Thông số

TênLoạiMô tả
attributesObjectThuộc tính của phần tử.

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setBackgroundColor(color)

Đặt màu nền.

Thông số

TênLoạiMô tả
colorStringmàu nền, được định dạng theo ký hiệu CSS (chẳng hạn như '#ffffff')

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setLinkUrl(url)

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

Thông số

TênLoạiMô tả
urlStringURL của đường liên kết

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingBottom(paddingBottom)

Đặt khoảng đệm dưới cùng, tính bằng điểm.

Thông số

TênLoạiMô tả
paddingBottomNumberkhoảng đệm dưới cùng, tính bằng điểm

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingLeft(paddingLeft)

Đặt khoảng đệm bên trái, tính bằng điểm.

Thông số

TênLoạiMô tả
paddingLeftNumberkhoảng đệm bên trái, tính bằng điểm

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingRight(paddingRight)

Đặt khoảng đệm bên phải, tính bằng điểm.

Thông số

TênLoạiMô tả
paddingRightNumberKhoảng đệm bên phải, tính bằng điểm.

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setPaddingTop(paddingTop)

Đặt khoảng đệm trên cùng, tính bằng điểm.

Thông số

TênLoạiMô tả
paddingTopNumberkhoảng đệm trên cùng, tính bằng điểm

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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á.

Thông số

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

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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);

Thông 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

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setVerticalAlignment(alignment)

Đặt chế độ căn chỉnh theo chiều dọc.

Thông số

TênLoạiMô tả
alignmentVerticalAlignmentcăn chỉnh theo chiều dọc

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setWidth(width)

Đặt chiều rộng của cột chứa ô hiện tại, tính bằng điểm.

Thông số

TênLoạiMô tả
widthNumberchiều rộng cột, tính bằng điểm

Cầu thủ trả bóng

TableCell – 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents