Se usó la API de Cloud Translation para traducir esta página.

Class DocumentTab

La pestaña de un documento que contiene texto enriquecido y elementos como tablas y listas.

Recupera una pestaña de documento con Document.getTabs()[tabIndex].asDocumentTab().

// Get a specific document tab based on the tab ID.
var documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`addBookmark(position)`	`Bookmark`	Agrega un `Bookmark` en el `Position` determinado.
`addFooter()`	`FooterSection`	Agrega una sección de pie de página de pestaña, si no existe ninguna.
`addHeader()`	`HeaderSection`	Agrega una sección de encabezado de pestaña, si no existe ninguno.
`addNamedRange(name, range)`	`NamedRange`	Agrega un `NamedRange`, que es un `Range` que tiene un nombre y un ID para usar recuperación posterior.
`getBody()`	`Body`	Recupera el `Body` de la pestaña.
`getBookmark(id)`	`Bookmark`	Obtiene el `Bookmark` con el ID determinado.
`getBookmarks()`	`Bookmark[]`	Obtiene todos los objetos `Bookmark` de la pestaña.
`getFooter()`	`FooterSection`	Recupera la sección del pie de página de la pestaña, si existe.
`getFootnotes()`	`Footnote[]`	Recupera todos los elementos `Footnote` en el cuerpo de la pestaña.
`getHeader()`	`HeaderSection`	Recupera la sección del encabezado de la pestaña, si existe.
`getNamedRangeById(id)`	`NamedRange`	Obtiene el `NamedRange` con el ID determinado.
`getNamedRanges()`	`NamedRange[]`	Obtiene todos los objetos `NamedRange` de la pestaña.
`getNamedRanges(name)`	`NamedRange[]`	Obtiene todos los objetos `NamedRange` de la pestaña con el nombre determinado.
`newPosition(element, offset)`	`Position`	Crea un nuevo elemento `Position`, que es una referencia a una ubicación en la pestaña, en relación con una elemento específico.
`newRange()`	`RangeBuilder`	Crea un compilador que se usa para construir objetos `Range` a partir de elementos de pestaña.

Documentación detallada

`addBookmark(position)`

Agrega un Bookmark en el Position determinado.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Gets the tab body and adds a paragraph.
const paragraph = documentTab.getBody().appendParagraph('My new paragraph.');

// Creates a position at the first character of the paragraph text.
const position = documentTab.newPosition(paragraph.getChild(0), 0);

// Adds a bookmark at the first character of the paragraph text.
const bookmark = documentTab.addBookmark(position);

// Logs the bookmark ID to the console.
console.log(bookmark.getId());

Parámetros

Nombre	Tipo	Descripción
`position`	`Position`	La posición del nuevo marcador.

Volver

Bookmark: Es el nuevo favorito.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`addFooter()`

Agrega una sección de pie de página de pestaña, si no existe ninguna.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Adds a footer to the tab.
const footer = documentTab.addFooter();

// Sets the footer text to 'This is a footer.'
footer.setText('This is a footer');

Volver

FooterSection: Es el pie de página de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`addHeader()`

Agrega una sección de encabezado de pestaña, si no existe ninguno.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Adds a header to the tab.
const header = documentTab.addHeader();

// Sets the header text to 'This is a header.'
header.setText('This is a header');

Volver

HeaderSection: Es el encabezado de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`addNamedRange(name, range)`

Agrega un NamedRange, que es un Range que tiene un nombre y un ID para usar recuperación posterior. Los nombres no son necesariamente únicos, ni siquiera entre pestañas; en varios rangos diferentes el mismo documento puede tener el mismo nombre, al igual que una clase en HTML. Por el contrario, los IDs son únicos dentro del documento, como un ID en HTML. Después de agregar un NamedRange, no podrás modificarlo, solo puedes quitarlo.

Cualquier secuencia de comandos que acceda a la pestaña puede acceder a un NamedRange. Para evitar acciones conflictos entre secuencias de comandos, considera colocar un prefijo a los nombres de los rangos con una cadena única.

// Creates a named range that includes every table in the tab with tab ID 't.0'.
var documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('Tab t.0 tables', rangeBuilder.build());

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	El nombre del rango, que no tiene por qué ser único. los nombres de los rangos deben ser entre 1 y 256 caracteres.
`range`	`Range`	El rango de elementos que se asociarán con el nombre; El rango puede ser un resultado de la búsqueda o construido manualmente con `newRange()`.

Volver

NamedRange: Es el NamedRange.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getBody()`

Recupera el Body de la pestaña.

Las pestañas pueden contener diferentes tipos de secciones (por ejemplo, HeaderSection, FooterSection). La sección activa de una pestaña es Body.

Los métodos de elementos de DocumentTab se delegan a Body.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Gets the tab body.
const body = documentTab.getBody();

// Gets the body text and logs it to the console.
console.log(body.getText());

Volver

Body: La sección del cuerpo de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getBookmark(id)`

Obtiene el Bookmark con el ID determinado. Este método muestra null si no existe tal Bookmark en esta pestaña.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Gets the bookmark by its ID.
const bookmark = documentTab.getBookmark('id.xyz654321');

// If the bookmark exists within the tab, logs the character offset of its position to the
// console. Otherwise, logs 'No bookmark exists with the given ID.' to the console.
if (bookmark) {
  console.log(bookmark.getPosition().getOffset());
} else {
  console.log('No bookmark exists with the given ID.');
}

Parámetros

Nombre	Tipo	Descripción
`id`	`String`	Es el ID de `Bookmark`.

Volver

Bookmark: El Bookmark con el ID proporcionado o null si no existe tal Bookmark existe dentro de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getBookmarks()`

Obtiene todos los objetos Bookmark de la pestaña.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Gets all of the bookmarks in the tab.
const bookmarks = documentTab.getBookmarks();

// Logs the number of bookmarks in the tab to the console.
console.log(bookmarks.length);

Volver

Bookmark[]: Es un array de los objetos Bookmark de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getFooter()`

Recupera la sección del pie de página de la pestaña, si existe.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Gets the text of the tab's footer and logs it to the console.
console.log(documentTab.getFooter().getText());

Volver

FooterSection: Indica el pie de página de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getFootnotes()`

Recupera todos los elementos Footnote en el cuerpo de la pestaña.

Las llamadas a getFootnotes provocan una iteración sobre los elementos de la pestaña. En las pestañas grandes, evita llamadas innecesarias a este método.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Gets the first footnote.
const footnote = documentTab.getFootnotes()[0];

// Logs footnote contents to the console.
console.log(footnote.getFootnoteContents().getText());

Volver

Footnote[]: Son las notas al pie de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getHeader()`

Recupera la sección del encabezado de la pestaña, si existe.

// Opens the Docs file by its ID and retrieves the tab with ID 't.0'. If you created your
// script from within a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the doc ID and the tab ID with your own.
const documentTab = DocumentApp.openById('abc123456').getTab('t.0').asDocumentTab();

// Gets the text of the tab's header and logs it to the console.
console.log(documentTab.getHeader().getText());

Volver

HeaderSection: El encabezado de la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getNamedRangeById(id)`

Obtiene el NamedRange con el ID determinado. Este método muestra null si no se encuentra NamedRange existe en la pestaña. Los nombres no son necesariamente únicos, ni siquiera entre pestañas. varios rangos diferentes en un mismo documento pueden compartir el mismo nombre, al igual que una clase en HTML Por el contrario, los IDs son únicos dentro de la pestaña, como un ID en HTML.

Parámetros

Nombre	Tipo	Descripción
`id`	`String`	El ID del rango, que es único dentro de la pestaña.

Volver

NamedRange: el NamedRange con el ID proporcionado, o null si no existe tal rango en la pestaña.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getNamedRanges()`

Obtiene todos los objetos NamedRange de la pestaña.

Se puede acceder a un NamedRange con cualquier secuencia de comandos que acceda a la pestaña. Para evitar conflictos no deseados entre secuencias de comandos, considera colocar un prefijo a los nombres de los rangos con una cadena única.

Volver

NamedRange[]: Es un array de los objetos NamedRange de la pestaña, que posiblemente incluya varios. rangos con el mismo nombre.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`getNamedRanges(name)`

Obtiene todos los objetos NamedRange de la pestaña con el nombre determinado. Los nombres no son necesariamente únicos, incluso entre pestañas; varios rangos diferentes en un mismo documento pueden compartir la misma como una clase en HTML. Por el contrario, los ID son únicos dentro de la pestaña, como un ID en HTML

Parámetros

Nombre	Tipo	Descripción
`name`	`String`	Nombre del rango, que no es necesariamente único.

Volver

NamedRange[]: Es un array de los objetos NamedRange en la pestaña con el nombre determinado.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`newPosition(element, offset)`

Crea un nuevo elemento Position, que es una referencia a una ubicación en la pestaña, en relación con una elemento específico. El cursor del usuario se representa como una Position, entre otros usos.

// Append a paragraph, then place the user's cursor after the first word of the new paragraph.
var doc = DocumentApp.openById('abc123456');
var documentTab = doc.getTab('t.0').asDocumentTab();
var paragraph = documentTab.getBody().appendParagraph('My new paragraph.');
var position = documentTab.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

Parámetros

Nombre	Tipo	Descripción
`element`	`Element`	El elemento que contiene el `Position` recién creado. debe ser Un elemento `Text` o un elemento contenedor, como `Paragraph`.
`offset`	`Integer`	Para los elementos `Text`, la cantidad de caracteres antes de `Position`. para otros elementos, la cantidad de elementos secundarios antes de `Position` dentro del mismo elemento de contenedor.

Volver

Position: Es el nuevo Position.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

`newRange()`

Crea un compilador que se usa para construir objetos Range a partir de elementos de pestaña.

// Change the user's selection to a range that includes every table in the tab.
var doc = DocumentApp.openById('abc123456');
var documentTab = doc.getTab('t.0').asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Volver

RangeBuilder: Es el compilador nuevo.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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