Эта страница переведена с помощью Cloud Translation API.

Class Table

Элемент, представляющий таблицу. Table может содержать только элементы TableRow . Дополнительные сведения о структуре документа см. в руководстве по расширению Документов Google .

При создании Table , содержащей большое количество строк или ячеек, рассмотрите возможность создания ее из массива строк, как показано в следующем примере.

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

// Create a two-dimensional array containing the 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.
body.appendTable(cells);

Методы

Метод	Тип возврата	Краткое описание
`appendTableRow()`	`TableRow`	Создает и добавляет новую `TableRow` .
`appendTableRow(tableRow)`	`TableRow`	Добавляет заданную `TableRow` .
`clear()`	`Table`	Очищает содержимое элемента.
`copy()`	`Table`	Возвращает отдельную, глубокую копию текущего элемента.
`editAsText()`	`Text`	Получает `Text` версию текущего элемента для редактирования.
`findElement(elementType)`	`RangeElement`	Ищет в содержимом элемента потомка указанного типа.
`findElement(elementType, from)`	`RangeElement`	Ищет в содержимом элемента потомка указанного типа, начиная с указанного `RangeElement` .
`findText(searchPattern)`	`RangeElement`	Ищет в содержимом элемента указанный текстовый шаблон, используя регулярные выражения.
`findText(searchPattern, from)`	`RangeElement`	Выполняет поиск указанного текстового шаблона в содержимом элемента, начиная с заданного результата поиска.
`getAttributes()`	`Object`	Извлекает атрибуты элемента.
`getBorderColor()`	`String`	Получает цвет границы.
`getBorderWidth()`	`Number`	Получает ширину границы в пунктах.
`getCell(rowIndex, cellIndex)`	`TableCell`	Извлекает `TableCell` по указанным индексам строки и ячейки.
`getChild(childIndex)`	`Element`	Извлекает дочерний элемент по указанному дочернему индексу.
`getChildIndex(child)`	`Integer`	Извлекает дочерний индекс для указанного дочернего элемента.
`getColumnWidth(columnIndex)`	`Number`	Получает ширину указанного столбца таблицы в пунктах.
`getLinkUrl()`	`String`	Получает URL-адрес ссылки.
`getNextSibling()`	`Element`	Извлекает следующий одноуровневый элемент элемента.
`getNumChildren()`	`Integer`	Получает количество детей.
`getNumRows()`	`Integer`	Получает количество `TableRows` .
`getParent()`	`ContainerElement`	Извлекает родительский элемент элемента.
`getPreviousSibling()`	`Element`	Извлекает предыдущий родственный элемент элемента.
`getRow(rowIndex)`	`TableRow`	Извлекает `TableRow` по указанному индексу строки.
`getText()`	`String`	Извлекает содержимое элемента в виде текстовой строки.
`getTextAlignment()`	`TextAlignment`	Получает выравнивание текста.
`getType()`	`ElementType`	Извлекает `ElementType` элемента.
`insertTableRow(childIndex)`	`TableRow`	Создает и вставляет новую `TableRow` по указанному индексу.
`insertTableRow(childIndex, tableRow)`	`TableRow`	Вставляет данную `TableRow` по указанному индексу.
`isAtDocumentEnd()`	`Boolean`	Определяет, находится ли элемент в конце `Document` .
`removeChild(child)`	`Table`	Удаляет указанный дочерний элемент.
`removeFromParent()`	`Table`	Удаляет элемент из его родителя.
`removeRow(rowIndex)`	`TableRow`	Удаляет `TableRow` по указанному индексу строки.
`replaceText(searchPattern, replacement)`	`Element`	Заменяет все вхождения заданного текстового шаблона заданной строкой замены, используя регулярные выражения.
`setAttributes(attributes)`	`Table`	Задает атрибуты элемента.
`setBorderColor(color)`	`Table`	Задает цвет границы.
`setBorderWidth(width)`	`Table`	Устанавливает ширину границы в пунктах.
`setColumnWidth(columnIndex, width)`	`Table`	Задает ширину указанного столбца в пунктах.
`setLinkUrl(url)`	`Table`	Устанавливает URL-адрес ссылки.
`setTextAlignment(textAlignment)`	`Table`	Устанавливает выравнивание текста.

Подробная документация

`appendTableRow()`

Создает и добавляет новую TableRow .

Возвращаться

TableRow — новый элемент строки таблицы

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`appendTableRow(tableRow)`

Добавляет заданную TableRow .

Параметры

Имя	Тип	Описание
`tableRow`	`TableRow`	строка таблицы для добавления

Возвращаться

TableRow — добавленный элемент строки таблицы

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`clear()`

Очищает содержимое элемента.

Возвращаться

Table — текущий элемент

`copy()`

Возвращает отдельную, глубокую копию текущего элемента.

Любые дочерние элементы, присутствующие в элементе, также копируются. Новый элемент не имеет родителя.

Возвращаться

Table — новая копия.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`editAsText()`

Получает Text версию текущего элемента для редактирования.

Используйте editAsText для управления содержимым элементов в виде форматированного текста. Режим editAsText игнорирует нетекстовые элементы (например, InlineImage и HorizontalRule ).

Дочерние элементы, полностью содержащиеся в удаленном текстовом диапазоне, удаляются из элемента.

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

Возвращаться

Text — текстовая версия текущего элемента.

`findElement(elementType)`

Ищет в содержимом элемента потомка указанного типа.

Параметры

Имя	Тип	Описание
`elementType`	`ElementType`	тип элемента для поиска

Возвращаться

RangeElement — результат поиска, указывающий позицию элемента поиска.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`findElement(elementType, from)`

Ищет в содержимом элемента потомка указанного типа, начиная с указанного RangeElement .

// 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;
  }
}

Параметры

Имя	Тип	Описание
`elementType`	`ElementType`	тип элемента для поиска
`from`	`RangeElement`	результат поиска для поиска

Возвращаться

RangeElement — результат поиска, указывающий следующую позицию элемента поиска.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`findText(searchPattern)`

Ищет в содержимом элемента указанный текстовый шаблон, используя регулярные выражения.

Подмножество функций регулярных выражений JavaScript поддерживается не полностью, например, группы захвата и модификаторы режима.

Предоставленный шаблон регулярного выражения независимо сопоставляется с каждым текстовым блоком, содержащимся в текущем элементе.

Параметры

Имя	Тип	Описание
`searchPattern`	`String`	образец для поиска

Возвращаться

RangeElement — результат поиска, указывающий позицию искомого текста, или null, если совпадений нет.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`findText(searchPattern, from)`

Выполняет поиск указанного текстового шаблона в содержимом элемента, начиная с заданного результата поиска.

Параметры

Имя	Тип	Описание
`searchPattern`	`String`	образец для поиска
`from`	`RangeElement`	результат поиска для поиска

Возвращаться

RangeElement — результат поиска, указывающий следующую позицию искомого текста, или null, если совпадений нет.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getAttributes()`

Извлекает атрибуты элемента.

Результатом является объект, содержащий свойство для каждого допустимого атрибута элемента, где имя каждого свойства соответствует элементу в перечислении 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]);
}

Возвращаться

Object — атрибуты элемента.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getBorderColor()`

Получает цвет границы.

Возвращаться

String — цвет границы, отформатированный в нотации CSS (например '#ffffff' )

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getBorderWidth()`

Получает ширину границы в пунктах.

Возвращаться

Number — ширина границы в пунктах

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getCell(rowIndex, cellIndex)`

Извлекает TableCell по указанным индексам строки и ячейки.

Параметры

Имя	Тип	Описание
`rowIndex`	`Integer`	индекс строки, содержащей ячейку для извлечения
`cellIndex`	`Integer`	индекс ячейки для получения

Возвращаться

TableCell — ячейка таблицы

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getChild(childIndex)`

Извлекает дочерний элемент по указанному дочернему индексу.

// 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.");
}

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	индекс дочернего элемента для извлечения

Возвращаться

Element — дочерний элемент по указанному индексу

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getChildIndex(child)`

Извлекает дочерний индекс для указанного дочернего элемента.

Параметры

Имя	Тип	Описание
`child`	`Element`	дочерний элемент, для которого нужно получить индекс

Возвращаться

Integer — дочерний индекс

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getColumnWidth(columnIndex)`

Получает ширину указанного столбца таблицы в пунктах.

Параметры

Имя	Тип	Описание
`columnIndex`	`Integer`	индекс столбца

Возвращаться

Number — ширина столбца в пунктах

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getLinkUrl()`

Получает URL-адрес ссылки.

Возвращаться

String — URL-адрес ссылки или null, если элемент содержит несколько значений для этого атрибута.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getNextSibling()`

Извлекает следующий одноуровневый элемент элемента.

Следующий брат имеет того же родителя и следует за текущим элементом.

Возвращаться

Element — следующий одноуровневый элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getNumChildren()`

Получает количество детей.

// 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.");

Возвращаться

Integer — количество детей

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getNumRows()`

Получает количество TableRows .

Возвращаться

Integer — количество строк таблицы

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getParent()`

Извлекает родительский элемент элемента.

Родительский элемент содержит текущий элемент.

Возвращаться

ContainerElement — родительский элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getPreviousSibling()`

Извлекает предыдущий родственный элемент элемента.

Предыдущий родственный элемент имеет того же родителя и предшествует текущему элементу.

Возвращаться

Element — предыдущий одноуровневый элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getRow(rowIndex)`

Извлекает TableRow по указанному индексу строки.

Параметры

Имя	Тип	Описание
`rowIndex`	`Integer`	индекс строки для извлечения

Возвращаться

TableRow — строка таблицы

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getText()`

Извлекает содержимое элемента в виде текстовой строки.

Возвращаться

String — содержимое элемента в виде текстовой строки

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getTextAlignment()`

Получает выравнивание текста. Доступные типы выравнивания: DocumentApp.TextAlignment.NORMAL , DocumentApp.TextAlignment.SUBSCRIPT и DocumentApp.TextAlignment.SUPERSCRIPT .

Возвращаться

TextAlignment — тип выравнивания текста или null , если текст содержит несколько типов выравнивания текста или если выравнивание текста никогда не устанавливалось.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`getType()`

Извлекает ElementType элемента.

Используйте getType() , чтобы определить точный тип данного элемента.

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

Возвращаться

ElementType — тип элемента.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`insertTableRow(childIndex)`

Создает и вставляет новую TableRow по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	индекс, по которому нужно вставить элемент

Возвращаться

TableRow — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`insertTableRow(childIndex, tableRow)`

Вставляет данную TableRow по указанному индексу.

Параметры

Имя	Тип	Описание
`childIndex`	`Integer`	индекс, по которому нужно вставить элемент
`tableRow`	`TableRow`	строка таблицы для вставки

Возвращаться

TableRow — вставленный элемент строки таблицы

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`isAtDocumentEnd()`

Определяет, находится ли элемент в конце Document .

Возвращаться

Boolean — находится ли элемент в конце документа.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`removeChild(child)`

Удаляет указанный дочерний элемент.

Параметры

Имя	Тип	Описание
`child`	`Element`	дочерний элемент для удаления

Возвращаться

Table — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`removeFromParent()`

Удаляет элемент из его родителя.

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();
}

Возвращаться

Table — удаленный элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`removeRow(rowIndex)`

Удаляет TableRow по указанному индексу строки.

Параметры

Имя	Тип	Описание
`rowIndex`	`Integer`	индекс удаляемой строки

Возвращаться

TableRow — удаленная строка

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`replaceText(searchPattern, replacement)`

Заменяет все вхождения заданного текстового шаблона заданной строкой замены, используя регулярные выражения.

Шаблон поиска передается в виде строки, а не объекта регулярного выражения JavaScript. Из-за этого вам нужно избегать любых обратных косых черт в шаблоне.

Этот метод использует библиотеку регулярных выражений Google RE2 , которая ограничивает поддерживаемый синтаксис .

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

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

Параметры

Имя	Тип	Описание
`searchPattern`	`String`	шаблон регулярного выражения для поиска
`replacement`	`String`	текст для использования в качестве замены

Возвращаться

Element — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`setAttributes(attributes)`

Задает атрибуты элемента.

Указанный параметр атрибутов должен быть объектом, где каждое имя свойства является элементом в перечислении DocumentApp.Attribute , а каждое значение свойства является новым применяемым значением.

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

Параметры

Имя	Тип	Описание
`attributes`	`Object`	Атрибуты элемента.

Возвращаться

Table — Текущий элемент.

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`setBorderColor(color)`

Задает цвет границы.

Параметры

Имя	Тип	Описание
`color`	`String`	цвет границы, отформатированный в нотации CSS (например `'#ffffff'` )

Возвращаться

Table — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`setBorderWidth(width)`

Устанавливает ширину границы в пунктах.

Параметры

Имя	Тип	Описание
`width`	`Number`	ширина границы, в пунктах

Возвращаться

Table — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`setColumnWidth(columnIndex, width)`

Задает ширину указанного столбца в пунктах.

Параметры

Имя	Тип	Описание
`columnIndex`	`Integer`	индекс столбца
`width`	`Number`	ширина границы, в пунктах

Возвращаться

Table — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`setLinkUrl(url)`

Устанавливает URL-адрес ссылки.

Параметры

Имя	Тип	Описание
`url`	`String`	URL-адрес ссылки

Возвращаться

Table — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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

`setTextAlignment(textAlignment)`

Устанавливает выравнивание текста. Доступные типы выравнивания: DocumentApp.TextAlignment.NORMAL , DocumentApp.TextAlignment.SUBSCRIPT и DocumentApp.TextAlignment.SUPERSCRIPT .

// Make the entire first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Параметры

Имя	Тип	Описание
`textAlignment`	`TextAlignment`	применяемый тип выравнивания текста

Возвращаться

Table — текущий элемент

Авторизация

Сценарии, использующие этот метод, требуют авторизации в одной или нескольких следующих областях :

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