Treść karty w dokumencie Dokumentów Google. Element Body może zawierać elementy List, Paragraph, Table i Table. 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 Header, Footer i Footnote.
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
append Horizontal Rule()
Tworzy i dołącza nowy element Horizontal.
Element Horizontal będzie znajdować się w nowym elemencie Paragraph.
Powrót
Horizontal – 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
append Image(image)
Tworzy i dołącza nowy element Inline 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
Inline – 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
append Image(image)
Dołącza podany element Inline.
Element Inline będzie znajdować się w nowym elemencie Paragraph.
Użyj tej wersji append, gdy dołączasz kopię istniejącego Inline.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
image | Inline | Dane obrazu. |
Powrót
Inline – 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
append List Item(listItem)
Dołącza podany element List.
Użyj tej wersji append, gdy dołączasz kopię istniejącego List.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
list | List | Element listy do dołączenia. |
Powrót
List – 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
append List Item(text)
Tworzy i dołącza nowy element List 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
List – 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
append Page Break()
Tworzy i dołącza nowy element Page.
Element Page będzie znajdować się w nowym elemencie Paragraph.
Powrót
Page – 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
append Page Break(pageBreak)
Dołącza podany element Page.
Element Page będzie znajdować się w nowym elemencie Paragraph.
Użyj tej wersji append, gdy dołączasz kopię istniejącego Page.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
page | Page | Podział strony do dołączenia. |
Powrót
Page – 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
append Paragraph(paragraph)
Dołącza podany element Paragraph.
Użyj tej wersji append, 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
append Paragraph(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
append Table()
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
append Table(cells)
Dołącza nowy element Table zawierający element Table 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[][] | Zawartość tekstowa komórek tabeli, które mają zostać dodane 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
append Table(table)
Dołącza podany element Table.
Użyj tej wersji append, 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
edit As Text()
Pobiera wersję Text bieżącego elementu do edycji.
Użyj edit, aby manipulować zawartością elementów jako tekstem sformatowanym. Tryb edit ignoruje elementy inne niż tekstowe (takie jak Inline i Horizontal).
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.
find Element(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
Range – 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
find Element(elementType, from)
Przeszukuje zawartość elementu pod kątem elementu podrzędnego określonego typu, zaczynając od określonego elementu Range.
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
Range – 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
find Text(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 dopasowywany niezależnie do każdego bloku tekstu zawartego w bieżącym elemencie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
search | String | wzór do wyszukania, |
Powrót
Range – 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
find Text(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 dopasowywany niezależnie 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
Range – 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
get Attributes()
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 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]}`); }
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
get Child(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
get Child Index(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
get Heading Attributes(paragraphHeading)
Pobiera zestaw atrybutów dla podanego Paragraph.
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
get Images()
Pobiera wszystkie elementy Inline zawarte w sekcji.
Powrót
Inline – 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
get List Items()
Pobiera wszystkie elementy List zawarte w sekcji.
Powrót
List – 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
get Margin Bottom()
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
get Margin Left()
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
get Margin Right()
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
get Margin Top()
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
get Num Children()
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
get Page Height()
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
get Page Width()
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
get Paragraphs()
Pobiera wszystkie elementy Paragraphs zawarte w sekcji (w tym List).
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
get Parent()
Pobiera element nadrzędny elementu.
Element nadrzędny zawiera bieżący element.
Powrót
Container – 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
get Tables()
get Text()
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
get Text Alignment()
Pobiera wyrównanie tekstu. Dostępne typy wyrównania to Document, Document i Document.
Powrót
Text – 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
get Type()
Pobiera Element elementu.
Użyj właściwości get, 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
Element – 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
insert Horizontal Rule(childIndex)
Tworzy i wstawia nowy element Horizontal w określonym indeksie.
Element Horizontal będzie znajdować się w nowym elemencie Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
Powrót
Horizontal – 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
insert Image(childIndex, image)
Tworzy i wstawia Inline 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
Inline – 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
insert Image(childIndex, image)
Wstawia podany element Inline 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
Inline – 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
insert List Item(childIndex, listItem)
Wstawia podany element List 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
List – 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
insert List Item(childIndex, text)
Tworzy i wstawia nowy element List 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
List – 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
insert Page Break(childIndex)
Tworzy i wstawia nowy element Page w określonym indeksie.
Element Page będzie znajdować się w nowym elemencie Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | Indeks, w którym ma zostać wstawiony element. |
Powrót
Page – 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
insert Page Break(childIndex, pageBreak)
Wstawia podany element Page w określonym indeksie.
Element Page 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
Page – 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
insert Paragraph(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
insert Paragraph(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
insert Table(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
insert Table(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[][] | Zawartość tekstowa komórek tabeli, które mają zostać dodane 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
insert Table(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
remove Child(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
replace Text(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 JavaScript. Dlatego musisz zmienić znaczenie wszystkich ukośników odwrotnych we wzorcu.
Ta metoda korzysta z biblioteki wyrażeń regularnych RE2 Google, która ogranicza obsługiwaną składnię.
Podany wzorzec wyrażenia regularnego jest dopasowywany niezależnie 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
set Attributes(attributes)
Ustawia atrybuty elementu.
Parametr specifiedAttributes musi być obiektem, w którym każda nazwa właściwości jest elementem wyliczenia Document, 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
set Heading Attributes(paragraphHeading, attributes)
Ustawia atrybuty dla podanego Paragraph.
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
set Margin Bottom(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
set Margin Left(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
set Margin Right(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
set Margin Top(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
set Page Height(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
set Page Width(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
set Text(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
set Text Alignment(textAlignment)
Ustawia wyrównanie tekstu. Dostępne typy wyrównania to Document, Document i Document.
// 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