Element reprezentujący element listy. List to Paragraph powiązany z identyfikatorem listy. Element List może zawierać elementy Equation, Footnote, Horizontal, Inline, Inline, Page i Text. Więcej informacji o strukturze dokumentu znajdziesz w przewodniku po rozszerzaniu Dokumentów Google.
List nie może zawierać znaków nowego wiersza. Znaki nowego wiersza („\n”) są konwertowane na znaki podziału wiersza („\r”).
List o tym samym identyfikatorze listy należą do tej samej listy i są odpowiednio numerowane.
Elementy List na danej liście nie muszą być sąsiadujące na karcie ani nawet mieć tego samego elementu nadrzędnego. 2 elementy należące do tej samej listy mogą znajdować się w dowolnym miejscu na karcie, zachowując kolejną numerację, jak pokazano w tym przykładzie:
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a new list item to the body. const item1 = body.appendListItem('Item 1'); // Log the new list item's list ID. Logger.log(item1.getListId()); // Append a table after the list item. body.appendTable([['Cell 1', 'Cell 2']]); // Append a second list item with the same list ID. The two items are treated as // the same list, despite not being consecutive. const item2 = body.appendListItem('Item 2'); item2.setListId(item1);
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Positioned | Tworzy i wstawia nowy Positioned z określonego obiektu blob obrazu. |
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 | Page | Tworzy i dołącza nowy element Page. |
append | Page | Dołącza podany element Page. |
append | Text | Tworzy i dołącza nowy element Text z określoną zawartością. |
append | Text | Dołącza podany element Text. |
clear() | List | Usuwa zawartość elementu. |
copy() | List | 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 | Horizontal | Pobiera Horizontal. |
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 | Glyph | Pobiera Glyph elementu listy. |
get | Paragraph | Pobiera Paragraph. |
get | Number|null | Pobiera wcięcie końcowe w punktach. |
get | Number|null | Pobiera wcięcie pierwszego wiersza w punktach. |
get | Number|null | Pobiera wcięcie początkowe. |
get | Number|null | Pobiera odstęp między wierszami w punktach. |
get | String|null | Pobiera adres URL linku. |
get | String|null | Pobiera identyfikator listy. |
get | Integer | Pobiera poziom zagnieżdżenia elementu listy. |
get | Element|null | Pobiera następny element równorzędny. |
get | Integer | Pobiera liczbę dzieci. |
get | Container | Pobiera element nadrzędny elementu. |
get | Positioned | Pobiera Positioned według identyfikatora obrazu. |
get | Positioned | Pobiera wszystkie obiekty Positioned zakotwiczone w akapicie. |
get | Element|null | Pobiera poprzedni element sąsiedni elementu. |
get | Number|null | Pobiera odstęp po elemencie w punktach. |
get | Number|null | Pobiera odstęp przed elementem w punktach. |
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 znak Horizontal w określonym indeksie. |
insert | Inline | Tworzy i wstawia nowy Inline z określonego obiektu blob obrazu w określonym indeksie. |
insert | Inline | Wstawia podany element Inline w określonym indeksie. |
insert | Page | Tworzy i wstawia nowy element Page w określonym indeksie. |
insert | Page | Wstawia podany element Page w określonym indeksie. |
insert | Text | Tworzy i wstawia nowy element tekstowy w określonym indeksie. |
insert | Text | Wstawia podany element Text w określonym indeksie z podaną zawartością tekstu. |
is | Boolean | Określa, czy element znajduje się na końcu Document. |
is | Boolean|null | Pobiera ustawienie od lewej do prawej. |
merge() | List | Łączy element z poprzednim elementem tego samego typu. |
remove | List | Usuwa określony element podrzędny. |
remove | List | Usuwa element z elementu nadrzędnego. |
remove | Boolean | Usuwa Positioned na podstawie identyfikatora obrazu. |
replace | Element | Zamienia wszystkie wystąpienia danego wzorca tekstu na dany ciąg zastępczy, korzystając z wyrażeń regularnych. |
set | List | Ustawia wartość Horizontal. |
set | List | Ustawia atrybuty elementu. |
set | List | Ustawia Glyph elementu listy. |
set | List | Ustawia wartość Paragraph. |
set | List | Ustawia wcięcie końcowe w punktach. |
set | List | Ustawia wcięcie pierwszego wiersza w punktach. |
set | List | Ustawia wcięcie początkowe w punktach. |
set | List | Ustawia kierunek od lewej do prawej. |
set | List | Ustawia odstęp między wierszami jako liczbę wierszy, które mają być użyte do określenia odstępu. |
set | List | Ustawia adres URL linku. |
set | List | Ustawia identyfikator listy. |
set | List | Ustawia poziom zagnieżdżenia elementu listy. |
set | List | Ustawia odstęp po elemencie w punktach. |
set | List | Ustawia odstęp przed elementem w punktach. |
set | void | Ustawia zawartość elementu listy jako tekst. |
set | List | Ustawia wyrównanie tekstu. |
Szczegółowa dokumentacja
add Positioned Image(image)
Tworzy i wstawia nowy Positioned z określonego obiektu blob obrazu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
image | Blob | dane obrazu, |
Powrót
Positioned – nowy obraz z określoną pozycją.
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 Horizontal Rule()
Tworzy i dołącza nowy element Horizontal.
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 Inline Image(image)
Tworzy i dołącza nowy element Inline z określonego obiektu blob obrazu.
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 Inline Image(image)
Dołącza podany element 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 Page Break()
Tworzy i dołącza nowy element Page.
Uwaga: Page może nie zawierać się w Table.
Jeśli bieżący element znajduje się w komórce tabeli, zostanie zgłoszony wyjątek.
Powrót
Page – nowy element podziału 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.
Uwaga: Page może nie zawierać się w Table.
Jeśli bieżący element znajduje się w komórce tabeli, zostanie zgłoszony wyjątek.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
page | Page | podział strony do dołączenia, |
Powrót
Page – dołączony element podziału 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 Text(text)
Tworzy i dołącza nowy element Text z określoną zawartością.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
text | String | zawartość tekstową, |
Powrót
Text – nowy element tekstowy.
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 Text(text)
Dołącza podany element Text.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
text | Text | element tekstowy do dodania; |
Powrót
Text – dołączony element tekstowy.
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
List – 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 Alignment()
Pobiera Horizontal.
Powrót
Horizontal – wyrównanie
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 Glyph Type()
get Heading()
Pobiera Paragraph.
Powrót
Paragraph – nagłówek;
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 Indent End()
Pobiera wcięcie końcowe w punktach.
Powrót
Number|null – wcięcie na końcu 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 Indent First Line()
Pobiera wcięcie pierwszego wiersza w punktach.
Powrót
Number|null – wcięcie pierwszego wiersza 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 Indent Start()
Pobiera wcięcie początkowe.
Powrót
Number|null – wcięcie na początku;
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 Line Spacing()
Pobiera odstęp między wierszami w punktach.
Powrót
Number|null – odstępy między wierszami 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 Link Url()
Pobiera adres URL linku.
Powrót
String|null – adres URL linku lub wartość null, jeśli element zawiera wiele wartości tego atrybutu.
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 Id()
Pobiera identyfikator listy.
Powrót
String|null – identyfikator 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
get Nesting Level()
Pobiera poziom zagnieżdżenia elementu listy.
Domyślnie elementy listy mają poziom zagnieżdżenia 0. Poziom zagnieżdżenia określa glif używany przez element listy.
Powrót
Integer – poziom zagnieżdżenia.
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 Next Sibling()
Pobiera następny element równorzędny.
Następny element równorzędny ma tego samego rodzica i występuje po bieżącym elemencie.
Powrót
Element|null – następny element równorzę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 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 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 Positioned Image(id)
Pobiera Positioned według identyfikatora obrazu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
id | String | identyfikator obrazu, |
Powrót
Positioned – obraz z określoną pozycją.
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 Positioned Images()
Pobiera wszystkie obiekty Positioned zakotwiczone w akapicie.
Powrót
Positioned – lista obrazów z określonymi pozycjami.
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 Previous Sibling()
Pobiera poprzedni element sąsiedni elementu.
Poprzedni element równorzędny ma tego samego rodzica i występuje przed bieżącym elementem.
Powrót
Element|null – poprzedni element równorzę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 Spacing After()
Pobiera odstęp po elemencie w punktach.
Powrót
Number|null – odstęp po elemencie 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 Spacing Before()
Pobiera odstęp przed elementem w punktach.
Powrót
Number|null – odstęp przed elementem 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 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 znak Horizontal w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | indeks, w którym ma zostać wstawiony element |
Powrót
Horizontal – nowy element linii poziomej
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 Inline Image(childIndex, image)
Tworzy i wstawia nowy 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 element obrazu 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 Inline Image(childIndex, image)
Wstawia podany element Inline w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | indeks, w którym ma zostać wstawiony element |
image | Inline | dane obrazu, |
Powrót
Inline – wstawiony element obrazu 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 Page Break(childIndex)
Tworzy i wstawia nowy element Page w określonym indeksie.
Uwaga: Page może nie zawierać się w Table.
Jeśli bieżący element znajduje się w komórce tabeli, zostanie zgłoszony wyjątek.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | indeks, w którym ma zostać wstawiony element |
Powrót
Page – nowy element podziału 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.
Uwaga: Page może nie zawierać się w Table.
Jeśli bieżący element znajduje się w komórce tabeli, zostanie zgłoszony wyjątek.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | indeks, w którym ma zostać wstawiony element |
page | Page | podział strony do wstawienia; |
Powrót
Page – wstawiony element podziału 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 Text(childIndex, text)
Tworzy i wstawia nowy element tekstowy w określonym indeksie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | indeks, w którym ma zostać wstawiony element |
text | String | zawartość tekstową, |
Powrót
Text – nowy element tekstowy.
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 Text(childIndex, text)
Wstawia podany element Text w określonym indeksie z podaną zawartością tekstu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Integer | indeks, w którym ma zostać wstawiony element |
text | Text | element tekstowy do wstawienia; |
Powrót
Text – wstawiony element tekstowy
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
is At Document End()
Określa, czy element znajduje się na końcu Document.
Powrót
Boolean – czy element znajduje się na końcu karty.
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
is Left To Right()
Pobiera ustawienie od lewej do prawej.
Powrót
Boolean|null – ustawienie od lewej do prawej;
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
merge()
Łączy element z poprzednim elementem tego samego typu.
Można scalać tylko elementy tego samego Element. Wszystkie elementy podrzędne zawarte w bieżącym elemencie są przenoszone do poprzedniego elementu równorzędnego.
Bieżący element zostanie usunięty z dokumentu.
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();
Powrót
List – scalony 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
remove Child(child)
Usuwa określony element podrzędny.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
child | Element | element podrzędny do usunięcia. |
Powrót
List – 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
remove From Parent()
Usuwa element z elementu nadrzędnego.
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(); }
Powrót
List – usunięty 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
remove Positioned Image(id)
Usuwa Positioned na podstawie identyfikatora obrazu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
id | String |
Powrót
Boolean – czy określony obraz został usunięty;
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 Alignment(alignment)
Ustawia wartość Horizontal.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
alignment | Horizontal | wyrównanie w poziomie, |
Powrót
List – 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
List – 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 Glyph Type(glyphType)
Ustawia Glyph elementu listy.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
glyph | Glyph | typ glifu, |
Powrót
List – 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(heading)
Ustawia wartość Paragraph.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
heading | Paragraph | nagłówek, |
Powrót
List – 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 Indent End(indentEnd)
Ustawia wcięcie końcowe w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
indent | Number | wcięcie na końcu w punktach, |
Powrót
List – 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 Indent First Line(indentFirstLine)
Ustawia wcięcie pierwszego wiersza w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
indent | Number | wcięcie pierwszego wiersza w punktach, |
Powrót
List – 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 Indent Start(indentStart)
Ustawia wcięcie początkowe w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
indent | Number | wcięcie na początku w punktach, |
Powrót
List – 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 Left To Right(leftToRight)
Ustawia kierunek od lewej do prawej.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
left | Boolean | ustawienie od lewej do prawej, |
Powrót
List – 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 Line Spacing(multiplier)
Ustawia odstęp między wierszami jako liczbę wierszy, które mają być użyte do określenia odstępu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
multiplier | Number | liczba wierszy, |
Powrót
List – 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 Link Url(url)
Ustawia adres URL linku.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
url | String | adres URL linku, |
Powrót
List – 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 List Id(listItem)
Ustawia identyfikator listy.
Identyfikator listy ma taką samą wartość w przypadku określonego parametru List. Oba znaki List będą traktowane jako elementy tej samej listy.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
list | List | element listy, którego identyfikator listy ma być użyty; |
Powrót
List – 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 Nesting Level(nestingLevel)
Ustawia poziom zagnieżdżenia elementu listy.
Domyślnie elementy listy mają poziom zagnieżdżenia 0. Poziom zagnieżdżenia określa glif używany przez element listy.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
nesting | Integer | poziom zagnieżdżenia, |
Powrót
List – 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 Spacing After(spacingAfter)
Ustawia odstęp po elemencie w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
spacing | Number | odstęp po elemencie w punktach, |
Powrót
List – 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 Spacing Before(spacingBefore)
Ustawia odstęp przed elementem w punktach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
spacing | Number | odstęp przed elementem w punktach, |
Powrót
List – 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ść elementu listy jako tekst.
Uwaga: dotychczasowa zawartość zostanie wyczyszczona.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
text | String | nową zawartość tekstową, |
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
List – 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