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ức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
append | Horizontal | Tạo và thêm một Horizontal mới. |
append | Inline | Tạo và thêm một Inline mới từ blob hình ảnh đã chỉ định. |
append | Inline | Nối Inline đã cho. |
append | List | Nối List đã cho. |
append | List | Tạo và thêm một List mới. |
append | Paragraph | Nối Paragraph đã cho. |
append | Paragraph | Tạo và thêm một Paragraph mới. |
append | Table | Tạo và thêm một Table mới. |
append | Table | Nối một Table mới chứa các ô được chỉ định. |
append | Table | Nối Table đã cho. |
clear() | Table | Xoá nội dung của phần tử. |
copy() | Table | Trả về một bản sao tách rời, sao chép sâu của phần tử hiện tại. |
edit | Text | Lấy phiên bản Text của phần tử hiện tại để chỉnh sửa. |
find | Range | Tìm kiếm nội dung của phần tử cho một phần tử con thuộc loại được chỉ định. |
find | Range | Tìm kiếm nội dung của phần tử cho một phần tử con thuộc loại đã chỉ định, bắt đầu từ Range đã chỉ định. |
find | Range | Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định bằng cách sử dụng biểu thức chính quy. |
find | Range | Tìm kiếm nội dung của phần tử theo mẫu văn bản đã chỉ định, bắt đầu từ một kết quả tìm kiếm nhất định. |
get | Object | Truy xuất các thuộc tính của phần tử. |
get | String|null | Truy xuất màu nền. |
get | Element | Truy xuất phần tử con tại chỉ mục con được chỉ định. |
get | Integer | Truy xuất chỉ mục con cho phần tử con được chỉ định. |
get | Integer | 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. |
get | String|null | Truy xuất URL của đường liên kết. |
get | Element|null | Truy xuất phần tử anh chị em tiếp theo của phần tử. |
get | Integer | Truy xuất số lượng thành phần con. |
get | Number|null | Truy xuất khoảng đệm dưới cùng, tính bằng điểm. |
get | Number|null | Truy xuất khoảng đệm bên trái, tính bằng điểm. |
get | Number|null | Truy xuất khoảng đệm bên phải, tính bằng điểm. |
get | Number|null | Truy xuất khoảng đệm trên cùng, tính bằng điểm. |
get | Container | Truy xuất phần tử mẹ của phần tử. |
get | Table | Truy xuất Table chứa Table hiện tại. |
get | Table|null | Truy xuất Table chứa Table hiện tại. |
get | Element|null | Truy xuất phần tử anh chị em trước đó của phần tử. |
get | Integer | 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. |
get | String | Truy xuất nội dung của phần tử dưới dạng một chuỗi văn bản. |
get | Text | Lấy chế độ căn chỉnh văn bản. |
get | Element | Truy xuất Element của phần tử. |
get | Vertical | Truy xuất Vertical. |
get | Number|null | Truy xuất chiều rộng của cột chứa ô, tính bằng điểm. |
insert | Horizontal | Tạo và chèn một Horizontal mới tại chỉ mục đã chỉ định. |
insert | Inline | Tạo và chèn một Inline từ blob hình ảnh đã chỉ định, tại chỉ mục đã chỉ định. |
insert | Inline | Chèn Inline đã cho vào chỉ mục được chỉ định. |
insert | List | Chèn List đã cho vào chỉ mục được chỉ định. |
insert | List | Tạo và chèn một List mới tại chỉ mục đã chỉ định. |
insert | Paragraph | Chèn Paragraph đã cho vào chỉ mục được chỉ định. |
insert | Paragraph | Tạo và chèn một Paragraph mới tại chỉ mục đã chỉ định. |
insert | Table | Tạo và chèn một Table mới tại chỉ mục đã chỉ định. |
insert | Table | Tạo và chèn một Table mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định. |
insert | Table | Chèn Table đã cho vào chỉ mục được chỉ định. |
is | Boolean | Xác định xem phần tử có ở cuối Document hay không. |
merge() | Table | Hợp nhất phần tử này với phần tử cùng loại đứng trước. |
remove | Table | Xoá phần tử con đã chỉ định. |
remove | Table | Xoá phần tử khỏi phần tử mẹ. |
replace | Element | Thay thế tất cả các lần xuất hiện của một mẫu văn bản nhất định bằng một chuỗi thay thế nhất định, bằng cách sử dụng biểu thức chính quy. |
set | Table | Đặt các thuộc tính của phần tử. |
set | Table | Đặt màu nền. |
set | Table | Đặt URL của đường liên kết. |
set | Table | Đặt khoảng đệm dưới cùng, tính bằng điểm. |
set | Table | Đặt khoảng đệm bên trái, tính bằng điểm. |
set | Table | Đặt khoảng đệm bên phải, tính bằng điểm. |
set | Table | Đặt khoảng đệm trên cùng, tính bằng điểm. |
set | Table | Đặt nội dung dưới dạng văn bản thuần tuý. |
set | Table | Đặt chế độ căn chỉnh văn bản. |
set | Table | Đặt chế độ căn chỉnh theo chiều dọc. |
set | Table | Đặ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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
image | Blob | dữ 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
image | Inline | dữ 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
list | List | mục danh sách cần thêm |
Cầu thủ trả bóng
ListItem – mục danh sách được thêm vào
Ủy quyền
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
text | String | nộ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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
paragraph | Paragraph | đ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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
text | String | nộ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()
appendTable(cells)
Nối một Table mới chứa các ô được chỉ định.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
cells | String[][] | nội dung văn bản của các ô trong bảng cần thêm vào bảng mới |
Cầu thủ trả bóng
Table – bảng được 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)
clear()
copy()
Trả về một bản sao tách rời, 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
element | Element | Loại phần tử cần tìm kiếm. |
Cầu thủ trả bóng
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 đã 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ên | Loại | Mô tả |
|---|---|---|
element | Element | Loại phần tử cần tìm kiếm. |
from | Range | Kết quả tìm kiếm để tìm kiếm. |
Cầu thủ trả bóng
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
search | String | mẫ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ả 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
search | String | mẫu cần tìm |
from | Range | kế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.'); }
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | Chỉ mục của phần tử con cần truy xuất. |
Cầu thủ trả bóng
Element – Phần tử con tại chỉ mục được chỉ định.
Ủy quyền
Các tập lệnh sử dụng phương thức này 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Element | Phầ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ử gốc 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()
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn phần tử |
image | Blob | dữ liệu hình ảnh |
Cầu thủ trả bóng
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn phần tử |
image | Inline | hình ảnh cần chèn |
Cầu thủ trả bóng
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn phần tử |
list | List | mụ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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn phần tử |
text | String | nộ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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn phần tử |
paragraph | Paragraph | đ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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn phần tử |
text | String | nộ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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn |
cells | String[][] | nội dung văn bản của các ô trong bảng cần thêm vào bảng mới |
Cầu thủ trả bóng
Table – bảng mới
Ủy quyền
Các tập lệnh sử dụng phương thức này 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Integer | chỉ mục để chèn phần tử |
table | Table | bả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ử đã 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
child | Element | phầ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, chứ không phải là một đố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');
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
search | String | mẫu biểu thức chính quy để tìm kiếm |
replacement | String | vă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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
attributes | Object | Thuộc tính của phần tử. |
Cầu thủ trả bóng
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
color | String | mà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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
url | String | URL 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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
padding | Number | khoả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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
padding | Number | khoả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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
padding | Number | Khoả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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
padding | Number | khoả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á.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
text | String | nội dung văn bản mới |
Cầu thủ trả bóng
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);
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
text | Text | loại căn chỉnh văn bản cần áp dụng |
Cầu thủ trả bóng
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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
alignment | Vertical | că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.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
width | Number | chiề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