Treść karty w dokumencie Dokumentów Google. Element Body może zawierać elementy ListItem, Paragraph, Table i TableOfContents. Więcej informacji o strukturze dokumentu znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.
Element Body zwykle zawiera pełną treść karty z wyjątkiem elementów HeaderSection, FooterSection i FootnoteSection.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a paragraph and a page break to the tab's body section directly. body.appendParagraph('A paragraph.'); body.appendPageBreak();
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
append | Horizontal | Tworzy i dołącza nowy element Horizontal. |
append | Inline | Tworzy i dołącza nowy element Inline z określonego obiektu blob obrazu. |
append | Inline | Dołącza podany element Inline. |
append | List | Dołącza podany element List. |
append | List | Tworzy i dołącza nowy element List zawierający określone treści tekstowe. |
append | Page | Tworzy i dołącza nowy element Page. |
append | Page | Dołącza podany element Page. |
append | Paragraph | Dołącza podany element Paragraph. |
append | Paragraph | Tworzy i dołącza nowy element Paragraph zawierający określone treści tekstowe. |
append | Table | Tworzy i dołącza nowy element Table. |
append | Table | Dołącza nowy element Table zawierający element Table dla każdej określonej wartości ciągu znaków. |
append | Table | Dołącza podany element Table. |
clear() | Body | Usuwa zawartość elementu. |
copy() | Body | Zwraca odłączoną, głęboką kopię bieżącego elementu. |
edit | Text | Pobiera wersję Text bieżącego elementu do edycji. |
find | Range | Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu. |
find | Range | Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu, zaczynając od określonego elementu Range. |
find | Range | Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu za pomocą wyrażeń regularnych. |
find | Range | Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu, zaczynając od danego wyniku wyszukiwania. |
get | Object | Pobiera atrybuty elementu. |
get | Element | Pobiera element podrzędny o określonym indeksie. |
get | Integer | Pobiera indeks elementu podrzędnego dla określonego elementu podrzędnego. |
get | Object | Pobiera zestaw atrybutów dla podanego Paragraph. |
get | Inline | Pobiera wszystkie elementy Inline zawarte w sekcji. |
get | List | Pobiera wszystkie elementy List zawarte w sekcji. |
get | Number|null | Pobiera dolny margines w punktach. |
get | Number|null | Pobiera lewy margines w punktach. |
get | Number|null | Pobiera prawy margines. |
get | Number|null | Pobiera górny margines. |
get | Integer | Pobiera liczbę dzieci. |
get | Number|null | Pobiera wysokość strony w punktach. |
get | Number|null | Pobiera szerokość strony w punktach. |
get | Paragraph[]|null | Pobiera wszystkie elementy Paragraphs zawarte w sekcji (w tym List). |
get | Container | Pobiera element nadrzędny elementu. |
get | Table[]|null | Pobiera wszystkie elementy Tables zawarte w sekcji. |
get | String | Pobiera zawartość elementu jako ciąg tekstowy. |
get | Text | Pobiera wyrównanie tekstu. |
get | Element | Pobiera Element elementu. |
insert | Horizontal | Tworzy i wstawia nowy element Horizontal w określonym indeksie. |
insert | Inline | Tworzy i wstawia Inline z określonego obiektu blob obrazu w określonym indeksie. |
insert | Inline | Wstawia podany element Inline w określonym indeksie. |
insert | List | Wstawia podany element List w określonym indeksie. |
insert | List | Tworzy i wstawia nowy element List w określonym indeksie, zawierający podaną treść tekstową. |
insert | Page | Tworzy i wstawia nowy element Page w określonym indeksie. |
insert | Page | Wstawia podany element Page w określonym indeksie. |
insert | Paragraph | Wstawia podany element Paragraph w określonym indeksie. |
insert | Paragraph | Tworzy i wstawia nowy element Paragraph w określonym indeksie, zawierający podaną treść tekstową. |
insert | Table | Tworzy i wstawia nowy element Table w określonym indeksie. |
insert | Table | Tworzy i wstawia nowy element Table zawierający określone komórki we wskazanym indeksie. |
insert | Table | Wstawia podany element Table w określonym indeksie. |
remove | Body | Usuwa określony element podrzędny. |
replace | Element | Zamienia wszystkie wystąpienia danego wzorca tekstu na dany ciąg zastępczy, korzystając z wyrażeń regularnych. |
set | Body | Ustawia atrybuty elementu. |
set | Body | Ustawia atrybuty dla podanego Paragraph. |
set | Body | Ustawia dolny margines w punktach. |
set | Body | Ustawia lewy margines w punktach. |
set | Body | Ustawia prawy margines w punktach. |
set | Body | Ustawia górny margines. |
set | Body | Ustawia wysokość strony w punktach. |
set | Body | Ustawia szerokość strony w punktach. |
set | Body | Ustawia zawartość jako zwykły tekst. |
set | Body | Ustawia wyrównanie tekstu. |
Szczegółowa dokumentacja
appendHorizontalRule()
Tworzy i dołącza nowy element HorizontalRule.
Element HorizontalRule będzie znajdować się w nowym elemencie Paragraph.
Powrót
HorizontalRule – nowa linia pozioma.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendImage(image)
Tworzy i dołącza nowy element InlineImage z określonego obiektu blob obrazu.
Obraz będzie znajdować się w nowym elemencie Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
image | Blob | Dane obrazu. |
Powrót
InlineImage – dołączony obraz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendImage(image)
Dołącza podany element InlineImage.
Element InlineImage będzie znajdować się w nowym elemencie Paragraph.
Użyj tej wersji appendImage, gdy dołączasz kopię istniejącego InlineImage.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
image | Inline | Dane obrazu. |
Powrót
InlineImage – dołączony obraz.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendListItem(listItem)
Dołącza podany element ListItem.
Użyj tej wersji appendListItem, gdy dołączasz kopię istniejącego ListItem.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
list | List | Element listy do dołączenia. |
Powrót
ListItem – dołączony element listy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendListItem(text)
Tworzy i dołącza nowy element ListItem zawierający określone treści tekstowe.
Kolejne elementy listy są dodawane w ramach tej samej listy.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
text | String | Zawartość tekstowa elementu listy. |
Powrót
ListItem – nowy element listy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendPageBreak()
Tworzy i dołącza nowy element PageBreak.
Element PageBreak będzie znajdować się w nowym elemencie Paragraph.
Powrót
PageBreak – nowy podział strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendPageBreak(pageBreak)
Dołącza podany element PageBreak.
Element PageBreak będzie znajdować się w nowym elemencie Paragraph.
Użyj tej wersji appendPageBreak, gdy dołączasz kopię istniejącego PageBreak.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
page | Page | Podział strony do dołączenia. |
Powrót
PageBreak – dołączony podział strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendParagraph(paragraph)
Dołącza podany element Paragraph.
Użyj tej wersji appendParagraph, gdy dołączasz kopię istniejącego Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
paragraph | Paragraph | Akapit do załączenia. |
Powrót
Paragraph – dołączony akapit.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendParagraph(text)
Tworzy i dołącza nowy element Paragraph zawierający określone treści tekstowe.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
text | String | Zawartość tekstowa akapitu. |
Powrót
Paragraph – nowy akapit.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable()
Tworzy i dołącza nowy element Table.
Ta metoda spowoduje też dodanie pustego akapitu po tabeli, ponieważ dokumenty Dokumentów Google nie mogą kończyć się tabelą.
Powrót
Table – nowa tabela.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable(cells)
Dołącza nowy element Table zawierający element TableCell dla każdej określonej wartości ciągu znaków.
Ta metoda spowoduje też dodanie pustego akapitu po tabeli, ponieważ dokumenty Dokumentów Google nie mogą kończyć się tabelą.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
cells | String[][] | Treść tekstowa komórek tabeli do dodania do nowej tabeli. |
Powrót
Table – dołączona tabela.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable(table)
Dołącza podany element Table.
Użyj tej wersji appendTable, gdy dołączasz kopię istniejącego Table.
Ta metoda spowoduje też dodanie pustego akapitu po tabeli, ponieważ dokumenty Dokumentów Google nie mogą kończyć się tabelą.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
table | Table | Tabela do dołączenia. |
Powrót
Table – dołączona tabela.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
clear()
copy()
Zwraca odłączoną, głęboką kopię bieżącego elementu.
Kopiowane są też wszystkie elementy podrzędne znajdujące się w elemencie. Nowy element nie ma elementu nadrzędnego.
Powrót
Body – nowy tekst.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
editAsText()
Pobiera wersję Text bieżącego elementu do edycji.
Użyj editAsText, aby manipulować zawartością elementów jako tekstem sformatowanym. Tryb editAsText ignoruje elementy inne niż tekstowe (takie jak InlineImage i HorizontalRule).
Elementy podrzędne w pełni zawarte w zakresie usuniętego tekstu są usuwane z elementu.
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);
Powrót
Text – tekstowa wersja bieżącego elementu.
findElement(elementType)
Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
element | Element | Typ elementu do wyszukania. |
Powrót
RangeElement|null – wynik wyszukiwania wskazujący pozycję elementu wyszukiwania.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findElement(elementType, from)
Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu, zaczynając od określonego elementu RangeElement.
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; } }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
element | Element | Typ elementu do wyszukania. |
from | Range | Wynik wyszukiwania, z którego chcesz wyszukiwać. |
Powrót
RangeElement|null – wynik wyszukiwania wskazujący następną pozycję elementu wyszukiwania.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findText(searchPattern)
Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu za pomocą wyrażeń regularnych.
Niektóre funkcje wyrażeń regularnych JavaScriptu nie są w pełni obsługiwane, np. grupy przechwytywania i modyfikatory trybu.
Podany wzorzec wyrażenia regularnego jest niezależnie dopasowywany do każdego bloku tekstu zawartego w bieżącym elemencie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
search | String | wzór do wyszukania, |
Powrót
RangeElement|null – wynik wyszukiwania wskazujący pozycję tekstu wyszukiwania lub wartość null, jeśli nie ma dopasowania.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
Przeszukuje zawartość elementu pod kątem określonego wzorca tekstu, zaczynając od danego wyniku wyszukiwania.
Niektóre funkcje wyrażeń regularnych JavaScriptu nie są w pełni obsługiwane, np. grupy przechwytywania i modyfikatory trybu.
Podany wzorzec wyrażenia regularnego jest niezależnie dopasowywany do każdego bloku tekstu zawartego w bieżącym elemencie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
search | String | wzór do wyszukania, |
from | Range | wynik wyszukiwania, z którego chcesz wyszukiwać; |
Powrót
RangeElement|null – wynik wyszukiwania wskazujący następną pozycję tekstu wyszukiwania lub wartość null, jeśli nie ma dopasowania.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getAttributes()
Pobiera atrybuty elementu.
Wynikiem jest obiekt zawierający właściwość dla każdego prawidłowego atrybutu elementu, przy czym nazwa każdej właściwości odpowiada elementowi w wyliczeniu 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]}`); }
Powrót
Object – atrybuty elementu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getChild(childIndex)
Pobiera element podrzędny o określonym indeksie.
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.'); }
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks elementu podrzędnego do pobrania. |
Powrót
Element – element podrzędny w określonym indeksie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getChildIndex(child)
Pobiera indeks elementu podrzędnego dla określonego elementu podrzędnego.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Element | Element podrzędny, dla którego ma zostać pobrany indeks. |
Powrót
Integer – indeks podrzędny.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getHeadingAttributes(paragraphHeading)
Pobiera zestaw atrybutów dla podanego ParagraphHeading.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
paragraph | Paragraph | Nagłówek, którego atrybuty mają zostać pobrane. |
Powrót
Object – mapa atrybutów i ich bieżących wartości.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getImages()
Pobiera wszystkie elementy InlineImages zawarte w sekcji.
Powrót
InlineImage[]|null – obrazy sekcji.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getListItems()
Pobiera wszystkie elementy ListItems zawarte w sekcji.
Powrót
ListItem[]|null – elementy listy sekcji.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginBottom()
Pobiera dolny margines w punktach.
Powrót
Number|null – dolny margines w punktach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginLeft()
Pobiera lewy margines w punktach.
Powrót
Number|null – lewy margines w punktach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginRight()
Pobiera prawy margines.
Powrót
Number|null – prawy margines w punktach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginTop()
Pobiera górny margines.
Powrót
Number|null – górny margines w punktach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getNumChildren()
Pobiera liczbę dzieci.
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.`);
Powrót
Integer – liczba dzieci.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getPageHeight()
Pobiera wysokość strony w punktach.
Powrót
Number|null – wysokość strony w punktach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getPageWidth()
Pobiera szerokość strony w punktach.
Powrót
Number|null – szerokość strony w punktach.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParagraphs()
Pobiera wszystkie elementy Paragraphs zawarte w sekcji (w tym ListItems).
Powrót
Paragraph[]|null – akapity sekcji.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParent()
Pobiera element nadrzędny elementu.
Element nadrzędny zawiera bieżący element.
Powrót
ContainerElement|null – element nadrzędny.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTables()
getText()
Pobiera zawartość elementu jako ciąg tekstowy.
Powrót
String – zawartość elementu w postaci ciągu tekstowego.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTextAlignment()
Pobiera wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i DocumentApp.TextAlignment.SUPERSCRIPT.
Powrót
TextAlignment|null – typ wyrównania tekstu lub null, jeśli tekst zawiera wiele typów wyrównania lub jeśli wyrównanie tekstu nigdy nie zostało ustawione.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getType()
Pobiera ElementType elementu.
Użyj właściwości getType(), aby określić dokładny typ danego elementu.
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.'); }
Powrót
ElementType – typ elementu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
Tworzy i wstawia nowy element HorizontalRule w określonym indeksie.
Element HorizontalRule będzie znajdować się w nowym elemencie Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
Powrót
HorizontalRule – nowa linia pozioma.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Tworzy i wstawia InlineImage z określonego obiektu blob obrazu w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
image | Blob | Dane obrazu. |
Powrót
InlineImage – wstawiony obraz w tekście.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Wstawia podany element InlineImage w określonym indeksie.
Obraz będzie znajdować się w nowym elemencie Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
image | Inline | Obraz do wstawienia. |
Powrót
InlineImage – wstawiony obraz w tekście.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertListItem(childIndex, listItem)
Wstawia podany element ListItem w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
list | List | Element listy do wstawienia. |
Powrót
ListItem – wstawiony element listy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertListItem(childIndex, text)
Tworzy i wstawia nowy element ListItem w określonym indeksie, zawierający podaną treść tekstową.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
text | String | Zawartość tekstowa elementu listy. |
Powrót
ListItem – nowy element listy.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex)
Tworzy i wstawia nowy element PageBreak w określonym indeksie.
Element PageBreak będzie znajdować się w nowym elemencie Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
Powrót
PageBreak – nowy podział strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex, pageBreak)
Wstawia podany element PageBreak w określonym indeksie.
Element PageBreak będzie znajdować się w nowym elemencie Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
page | Page | Podział strony do wstawienia. |
Powrót
PageBreak – wstawiony podział strony.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, paragraph)
Wstawia podany element Paragraph w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
paragraph | Paragraph | Akapit do wstawienia. |
Powrót
Paragraph – wstawiony akapit.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, text)
Tworzy i wstawia nowy element Paragraph w określonym indeksie, zawierający podaną treść tekstową.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
text | String | Zawartość tekstowa akapitu. |
Powrót
Paragraph – nowy akapit.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex)
Tworzy i wstawia nowy element Table w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
Powrót
Table – nowa tabela.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex, cells)
Tworzy i wstawia nowy element Table zawierający określone komórki we wskazanym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
cells | String[][] | Treść tekstowa komórek tabeli do dodania do nowej tabeli. |
Powrót
Table – nowa tabela.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex, table)
Wstawia podany element Table w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
table | Table | Tabela do wstawienia. |
Powrót
Table – wstawiona tabela.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
removeChild(child)
Usuwa określony element podrzędny.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Element | Element podrzędny do usunięcia. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
Zamienia wszystkie wystąpienia danego wzorca tekstu na dany ciąg zastępczy, korzystając z wyrażeń regularnych.
Wzorzec wyszukiwania jest przekazywany jako ciąg znaków, a nie jako obiekt wyrażenia regularnego JavaScriptu. Dlatego musisz zmienić znaczenie wszystkich ukośników odwrotnych we wzorcu.
Ta metoda korzysta z biblioteki wyrażeń regularnych RE2 od Google, co ogranicza obsługiwaną składnię.
Podany wzorzec wyrażenia regularnego jest niezależnie dopasowywany do każdego bloku tekstu zawartego w bieżącym elemencie.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText('^.*Apps ?Script.*$', 'Apps Script');
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
search | String | wzór wyrażenia regularnego do wyszukania, |
replacement | String | tekst, który ma zastąpić oryginalny tekst; |
Powrót
Element – bieżący element
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setAttributes(attributes)
Ustawia atrybuty elementu.
Parametr specifiedAttributes musi być obiektem, w którym każda nazwa właściwości jest elementem wyliczenia DocumentApp.Attribute, a każda wartość właściwości jest nową wartością do zastosowania.
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);
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
attributes | Object | Atrybuty elementu. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setHeadingAttributes(paragraphHeading, attributes)
Ustawia atrybuty dla podanego ParagraphHeading.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
paragraph | Paragraph | Nagłówek, którego atrybuty mają zostać ustawione. |
attributes | Object | Mapa atrybutów i wartości, które mają być ustawione. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginBottom(marginBottom)
Ustawia dolny margines w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
margin | Number | Dolny margines w punktach. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginLeft(marginLeft)
Ustawia lewy margines w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
margin | Number | Lewy margines w punktach. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginRight(marginRight)
Ustawia prawy margines w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
margin | Number | prawy margines. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginTop(marginTop)
Ustawia górny margines.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
margin | Number | Górny margines w punktach. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setPageHeight(pageHeight)
Ustawia wysokość strony w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
page | Number | Wysokość strony w punktach. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setPageWidth(pageWidth)
Ustawia szerokość strony w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
page | Number | Szerokość strony w punktach. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setText(text)
Ustawia zawartość jako zwykły tekst.
Uwaga: dotychczasowa zawartość zostanie wyczyszczona.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
text | String | Nowa zawartość tekstowa. |
Powrót
Body – bieżący element.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
Ustawia wyrównanie tekstu. Dostępne typy wyrównania to DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT i 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);
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
text | Text | typ wyrównania tekstu do zastosowania; |
Powrót
Body – bieżący element
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents