Es un elemento genérico. El contenido de Document
se representa como elementos. Por ejemplo, List
, Paragraph
y Table
son elementos y heredan todos los métodos definidos por Element
, como get
.
Implementa clases
Nombre | Descripción breve |
---|---|
Body | Es el contenido de una pestaña en un documento de Documentos de Google. |
Container | Es un elemento genérico que puede contener otros elementos. |
Date | Un elemento que representa una fecha con formato |
Equation | Un elemento que representa una expresión matemática. |
Equation | Un elemento que representa una función en un Equation matemático. |
Equation | Un elemento que representa un separador de funciones en un Equation matemático. |
Equation | Es un elemento que representa un símbolo en un Equation matemático. |
Footer | Es un elemento que representa una sección de pie de página. |
Footnote | Es un elemento que representa una nota al pie. |
Footnote | Es un elemento que representa una sección de notas al pie. |
Header | Es un elemento que representa una sección de encabezado. |
Horizontal | Es un elemento que representa una regla horizontal. |
Inline | Es un elemento que representa un dibujo incorporado. |
Inline | Es un elemento que representa una imagen incorporada. |
List | Es un elemento que representa un elemento de lista. |
Page | Es un elemento que representa un salto de página. |
Paragraph | Es un elemento que representa un párrafo. |
Person | Es un elemento que representa un vínculo a una persona. |
Rich | Es un elemento que representa un vínculo a un recurso de Google, como un archivo de Drive o un video de YouTube. |
Table | Un elemento que representa una tabla. |
Table | Un elemento que representa una celda de tabla. |
Table | Es un elemento que contiene un índice. |
Table | Un elemento que representa una fila de la tabla. |
Text | Es un elemento que representa una región de texto enriquecido. |
Unsupported | Un elemento que representa una región que es desconocida o que no puede verse afectada por una secuencia de comandos, como un número de página. |
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
as | Body | Muestra el elemento actual como un Body . |
as | Date | Muestra el elemento actual como un Date . |
as | Equation | Muestra el elemento actual como un Equation . |
as | Equation | Muestra el elemento actual como un Equation . |
as | Equation | Muestra el elemento actual como un Equation . |
as | Equation | Muestra el elemento actual como un Equation . |
as | Footer | Muestra el elemento actual como un Footer . |
as | Footnote | Muestra el elemento actual como un Footnote . |
as | Footnote | Muestra el elemento actual como un Footnote . |
as | Header | Muestra el elemento actual como un Header . |
as | Horizontal | Muestra el elemento actual como un Horizontal . |
as | Inline | Muestra el elemento actual como un Inline . |
as | Inline | Muestra el elemento actual como un Inline . |
as | List | Muestra el elemento actual como un List . |
as | Page | Muestra el elemento actual como un Page . |
as | Paragraph | Muestra el elemento actual como un Paragraph . |
as | Person | Muestra el elemento actual como un Person . |
as | Rich | Muestra el elemento actual como un Rich , por ejemplo, un vínculo a un archivo de Hojas de cálculo de Google. |
as | Table | Muestra el elemento actual como un Table . |
as | Table | Muestra el elemento actual como un Table . |
as | Table | Muestra el elemento actual como un Table . |
as | Table | Muestra el elemento actual como un Table . |
as | Text | Muestra el elemento actual como un Text . |
copy() | Element | Muestra una copia profunda y separada del elemento actual. |
get | Object | Recupera los atributos del elemento. |
get | Element | Recupera el siguiente elemento hermano del elemento. |
get | Container | Recupera el elemento superior del elemento. |
get | Element | Recupera el elemento hermano anterior del elemento. |
get | Element | Recupera el Element del elemento. |
is | Boolean | Determina si el elemento está al final de Document . |
merge() | Element | Combina el elemento con el hermano anterior del mismo tipo. |
remove | Element | Quita el elemento de su elemento superior. |
set | Element | Establece los atributos del elemento. |
Documentación detallada
as Body()
Muestra el elemento actual como un Body
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Body
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Date()
Muestra el elemento actual como un Date
.
Cuando sepas que un elemento es un Date
, usa este método para establecer su tipo como Date
. De esta manera, el autocompletado en el editor de Apps Script te muestra los métodos que puedes usar con un Date
.
Volver
Date
: Es el elemento actual con su tipo establecido como Date
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Equation()
Muestra el elemento actual como un Equation
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Equation
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Equation Function()
Muestra el elemento actual como un Equation
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Equation
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Equation Function Argument Separator()
Muestra el elemento actual como un Equation
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Equation
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Equation Symbol()
Muestra el elemento actual como un Equation
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Equation
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Footnote()
Muestra el elemento actual como un Footnote
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Footnote
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Footnote Section()
Muestra el elemento actual como un Footnote
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Footnote
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Header Section()
Muestra el elemento actual como un Header
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Header
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Horizontal Rule()
Muestra el elemento actual como un Horizontal
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Horizontal
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Inline Drawing()
Muestra el elemento actual como un Inline
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Inline
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Inline Image()
Muestra el elemento actual como un Inline
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Inline
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as List Item()
Muestra el elemento actual como un List
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
List
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Page Break()
Muestra el elemento actual como un Page
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Page
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Paragraph()
Muestra el elemento actual como un Paragraph
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Paragraph
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Person()
Muestra el elemento actual como un Person
.
Cuando sepas que un elemento es un Person
, usa este método para establecer su tipo como una persona.
De esta manera, el autocompletado en el editor de Apps Script te mostrará los métodos que puedes usar con un elemento de persona.
Volver
Person
: Es el elemento actual con su tipo establecido como Person
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Rich Link()
Muestra el elemento actual como un Rich
, por ejemplo, un vínculo a un archivo de Hojas de cálculo de Google.
Cuando sepas que un elemento es un Rich
, usa este método para establecer su tipo como Rich
. De esta manera, el autocompletado en el editor de Apps Script te muestra los métodos que puedes usar con un Rich
.
Volver
Rich
: Es el elemento actual con su tipo establecido como Rich
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Table()
Muestra el elemento actual como un Table
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Table
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Table Cell()
Muestra el elemento actual como un Table
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Table
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Table Of Contents()
Muestra el elemento actual como un Table
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Table
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Table Row()
Muestra el elemento actual como un Table
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Table
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
as Text()
Muestra el elemento actual como un Text
.
Usa este método para ayudar al autocompletado cada vez que se sepa que un elemento determinado es de un tipo específico.
Volver
Text
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
copy()
Muestra una copia profunda y separada del elemento actual.
También se copian los elementos secundarios presentes en el elemento. El elemento nuevo no tiene un elemento superior.
Volver
Element
: Es la copia nueva.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Attributes()
Recupera los atributos del elemento.
El resultado es un objeto que contiene una propiedad para cada atributo de elemento válido, en el que cada nombre de propiedad corresponde a un elemento de la enumeración Document
.
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]}`); }
Volver
Object
: Son los atributos del elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Next Sibling()
Recupera el siguiente elemento hermano del elemento.
El siguiente hermano tiene el mismo elemento superior y sigue al elemento actual.
Volver
Element
: Es el siguiente elemento hermano.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Parent()
Recupera el elemento superior del elemento.
El elemento superior contiene el elemento actual.
Volver
Container
: Es el elemento superior.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Previous Sibling()
Recupera el elemento hermano anterior del elemento.
El hermano anterior tiene el mismo elemento superior y precede al elemento actual.
Volver
Element
: Es el elemento hermano anterior.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
get Type()
Recupera el Element
del elemento.
Usa get
para determinar el tipo exacto de un elemento determinado.
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.'); }
Volver
Element
: Es el tipo de elemento.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
is At Document End()
Determina si el elemento está al final de Document
.
Volver
Boolean
: Indica si el elemento está al final 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 ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
merge()
Combina el elemento con el hermano anterior del mismo tipo.
Solo se pueden combinar elementos del mismo Element
. Todos los elementos secundarios que se encuentran en el elemento actual se mueven al elemento hermano anterior.
Se quita el elemento actual del documento.
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();
Volver
Element
: Es el elemento combinado.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
remove From Parent()
Quita el elemento de su elemento superior.
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(); }
Volver
Element
: Es el elemento que se quitó.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
set Attributes(attributes)
Establece los atributos del elemento.
El parámetro de atributos especificado debe ser un objeto en el que cada nombre de propiedad sea un elemento de la enumeración Document
y cada valor de propiedad sea el valor nuevo que se aplicará.
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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
attributes | Object | Los atributos del elemento |
Volver
Element
: Es el elemento actual.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents