Konten tab dalam dokumen Google Dokumen. Body dapat berisi elemen ListItem, Paragraph, Table, dan TableOfContents. Untuk mengetahui informasi selengkapnya tentang
struktur dokumen, lihat panduan untuk
memperluas Google Dokumen.
Body biasanya berisi konten tab lengkap, kecuali HeaderSection, FooterSection, dan elemen 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();
Metode
| Metode | Jenis nilai yang ditampilkan | Deskripsi singkat |
|---|---|---|
append | Horizontal | Membuat dan menambahkan Horizontal baru. |
append | Inline | Membuat dan menambahkan Inline baru dari blob gambar yang ditentukan. |
append | Inline | Menambahkan Inline yang diberikan. |
append | List | Menambahkan List yang diberikan. |
append | List | Membuat dan menambahkan List baru yang berisi konten teks yang ditentukan. |
append | Page | Membuat dan menambahkan Page baru. |
append | Page | Menambahkan Page yang diberikan. |
append | Paragraph | Menambahkan Paragraph yang diberikan. |
append | Paragraph | Membuat dan menambahkan Paragraph baru yang berisi konten teks yang ditentukan. |
append | Table | Membuat dan menambahkan Table baru. |
append | Table | Menambahkan Table baru yang berisi Table untuk setiap nilai string yang ditentukan. |
append | Table | Menambahkan Table yang diberikan. |
clear() | Body | Menghapus konten elemen. |
copy() | Body | Menampilkan salinan mendalam yang terlepas dari elemen saat ini. |
edit | Text | Mendapatkan versi Text dari elemen saat ini, untuk pengeditan. |
find | Range | Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan. |
find | Range | Menelusuri konten elemen untuk menemukan keturunan dari jenis yang ditentukan, dimulai dari
Range yang ditentukan. |
find | Range | Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler. |
find | Range | Menelusuri konten elemen untuk menemukan pola teks yang ditentukan, dimulai dari hasil penelusuran tertentu. |
get | Object | Mengambil atribut elemen. |
get | Element | Mengambil elemen turunan pada indeks turunan yang ditentukan. |
get | Integer | Mengambil indeks turunan untuk elemen turunan yang ditentukan. |
get | Object | Mengambil kumpulan atribut untuk Paragraph yang diberikan. |
get | Inline | Mengambil semua Inline yang ada di bagian. |
get | List | Mengambil semua List yang ada di bagian. |
get | Number|null | Mengambil margin bawah, dalam poin. |
get | Number|null | Mengambil margin kiri, dalam poin. |
get | Number|null | Mengambil margin kanan. |
get | Number|null | Mengambil margin atas. |
get | Integer | Mengambil jumlah anak. |
get | Number|null | Mengambil tinggi halaman, dalam poin. |
get | Number|null | Mengambil lebar halaman, dalam poin. |
get | Paragraph[]|null | Mengambil semua Paragraphs yang ada dalam bagian (termasuk List). |
get | Container | Mengambil elemen induk elemen. |
get | Table[]|null | Mengambil semua Tables yang ada di bagian. |
get | String | Mengambil konten elemen sebagai string teks. |
get | Text | Mendapatkan perataan teks. |
get | Element | Mengambil Element elemen. |
insert | Horizontal | Membuat dan menyisipkan Horizontal baru pada indeks yang ditentukan. |
insert | Inline | Membuat dan menyisipkan Inline dari blob gambar yang ditentukan, pada indeks yang ditentukan. |
insert | Inline | Menyisipkan Inline yang diberikan pada indeks yang ditentukan. |
insert | List | Menyisipkan List yang diberikan pada indeks yang ditentukan. |
insert | List | Membuat dan menyisipkan List baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan. |
insert | Page | Membuat dan menyisipkan Page baru pada indeks yang ditentukan. |
insert | Page | Menyisipkan Page yang diberikan pada indeks yang ditentukan. |
insert | Paragraph | Menyisipkan Paragraph yang diberikan pada indeks yang ditentukan. |
insert | Paragraph | Membuat dan menyisipkan Paragraph baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan. |
insert | Table | Membuat dan menyisipkan Table baru pada indeks yang ditentukan. |
insert | Table | Membuat dan menyisipkan Table baru yang berisi sel yang ditentukan, pada indeks yang ditentukan. |
insert | Table | Menyisipkan Table yang diberikan pada indeks yang ditentukan. |
remove | Body | Menghapus elemen turunan yang ditentukan. |
replace | Element | Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler. |
set | Body | Menetapkan atribut elemen. |
set | Body | Menetapkan atribut untuk Paragraph yang diberikan. |
set | Body | Menetapkan margin bawah, dalam poin. |
set | Body | Menetapkan margin kiri, dalam poin. |
set | Body | Menetapkan margin kanan, dalam poin. |
set | Body | Menetapkan margin atas. |
set | Body | Menetapkan tinggi halaman, dalam poin. |
set | Body | Menetapkan lebar halaman, dalam poin. |
set | Body | Menetapkan konten sebagai teks biasa. |
set | Body | Menetapkan perataan teks. |
Dokumentasi mendetail
appendHorizontalRule()
Membuat dan menambahkan HorizontalRule baru.
HorizontalRule akan dimuat dalam Paragraph baru.
Pulang pergi
HorizontalRule — Penggaris horizontal baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendImage(image)
Membuat dan menambahkan InlineImage baru dari blob gambar yang ditentukan.
Gambar akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
image | Blob | Data gambar. |
Pulang pergi
InlineImage — Gambar yang ditambahkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendImage(image)
Menambahkan InlineImage yang diberikan.
InlineImage akan dimuat dalam Paragraph baru.
Gunakan versi appendImage ini saat menambahkan salinan InlineImage yang ada.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
image | Inline | Data gambar. |
Pulang pergi
InlineImage — Gambar yang ditambahkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendListItem(listItem)
Menambahkan ListItem yang diberikan.
Gunakan versi appendListItem ini saat menambahkan salinan ListItem yang ada.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
list | List | Item daftar yang akan ditambahkan. |
Pulang pergi
ListItem — Item daftar yang ditambahkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendListItem(text)
Membuat dan menambahkan ListItem baru yang berisi konten teks yang ditentukan.
Item daftar berurutan ditambahkan sebagai bagian dari daftar yang sama.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | String | Konten teks item daftar. |
Pulang pergi
ListItem — Item daftar baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendPageBreak()
Membuat dan menambahkan PageBreak baru.
PageBreak akan dimuat dalam Paragraph baru.
Pulang pergi
PageBreak — Batas halaman baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendPageBreak(pageBreak)
Menambahkan PageBreak yang diberikan.
PageBreak akan dimuat dalam Paragraph baru.
Gunakan versi appendPageBreak ini saat menambahkan salinan PageBreak yang ada.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
page | Page | Pemisah halaman yang akan ditambahkan. |
Pulang pergi
PageBreak — Batas halaman yang ditambahkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendParagraph(paragraph)
Menambahkan Paragraph yang diberikan.
Gunakan versi appendParagraph ini saat menambahkan salinan Paragraph yang ada.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
paragraph | Paragraph | Paragraf yang akan ditambahkan. |
Pulang pergi
Paragraph — Paragraf yang ditambahkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendParagraph(text)
Membuat dan menambahkan Paragraph baru yang berisi konten teks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | String | Konten teks paragraf. |
Pulang pergi
Paragraph — Paragraf baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable()
Membuat dan menambahkan Table baru.
Metode ini juga akan menambahkan paragraf kosong setelah tabel, karena dokumen Google Dokumen tidak boleh diakhiri dengan tabel.
Pulang pergi
Table — Tabel baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable(cells)
Menambahkan Table baru yang berisi TableCell untuk setiap nilai string yang ditentukan.
Metode ini juga akan menambahkan paragraf kosong setelah tabel, karena dokumen Google Dokumen tidak boleh diakhiri dengan tabel.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
cells | String[][] | Konten teks sel tabel yang akan ditambahkan ke tabel baru. |
Pulang pergi
Table — Tabel yang ditambahkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
appendTable(table)
Menambahkan Table yang diberikan.
Gunakan versi appendTable ini saat menambahkan salinan Table yang ada.
Metode ini juga akan menambahkan paragraf kosong setelah tabel, karena dokumen Google Dokumen tidak boleh diakhiri dengan tabel.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
table | Table | Tabel yang akan ditambahkan. |
Pulang pergi
Table — Tabel yang ditambahkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
clear()
copy()
Menampilkan salinan mendalam yang terlepas dari elemen saat ini.
Semua elemen turunan yang ada dalam elemen juga disalin. Elemen baru tidak memiliki induk.
Pulang pergi
Body — Salinan baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
editAsText()
Mendapatkan versi Text dari elemen saat ini, untuk pengeditan.
Gunakan editAsText untuk memanipulasi konten elemen sebagai teks kaya. Mode editAsText mengabaikan elemen non-teks (seperti InlineImage dan HorizontalRule).
Elemen turunan yang sepenuhnya berada dalam rentang teks yang dihapus akan dihapus dari elemen.
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);
Pulang pergi
Text — versi teks dari elemen saat ini
findElement(elementType)
Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
element | Element | Jenis elemen yang akan ditelusuri. |
Pulang pergi
RangeElement|null — Hasil penelusuran yang menunjukkan posisi elemen penelusuran.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findElement(elementType, from)
Menelusuri konten elemen untuk menemukan keturunan dari jenis yang ditentukan, dimulai dari
RangeElement yang ditentukan.
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; } }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
element | Element | Jenis elemen yang akan ditelusuri. |
from | Range | Hasil penelusuran yang akan ditelusuri. |
Pulang pergi
RangeElement|null — Hasil penelusuran yang menunjukkan posisi berikutnya dari elemen penelusuran.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findText(searchPattern)
Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler.
Sebagian fitur ekspresi reguler JavaScript tidak sepenuhnya didukung, seperti grup pengambilan dan pengubah mode.
Pola ekspresi reguler yang diberikan dicocokkan secara terpisah dengan setiap blok teks yang ada dalam elemen saat ini.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
search | String | pola yang akan ditelusuri |
Pulang pergi
RangeElement|null — hasil penelusuran yang menunjukkan posisi teks penelusuran, atau null jika tidak ada
kecocokan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
Menelusuri konten elemen untuk menemukan pola teks yang ditentukan, dimulai dari hasil penelusuran tertentu.
Sebagian fitur ekspresi reguler JavaScript tidak sepenuhnya didukung, seperti grup pengambilan dan pengubah mode.
Pola ekspresi reguler yang diberikan dicocokkan secara terpisah dengan setiap blok teks yang ada dalam elemen saat ini.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
search | String | pola yang akan ditelusuri |
from | Range | hasil penelusuran yang akan digunakan untuk memulai penelusuran |
Pulang pergi
RangeElement|null — hasil penelusuran yang menunjukkan posisi berikutnya dari teks penelusuran, atau null jika tidak ada
kecocokan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getAttributes()
Mengambil atribut elemen.
Hasilnya adalah objek yang berisi properti untuk setiap atribut elemen yang valid, dengan setiap nama properti sesuai dengan item dalam enumerasi 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]}`); }
Pulang pergi
Object — Atribut elemen.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getChild(childIndex)
Mengambil elemen turunan pada indeks turunan yang ditentukan.
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.'); }
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks elemen turunan yang akan diambil. |
Pulang pergi
Element — Elemen turunan pada indeks yang ditentukan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getChildIndex(child)
Mengambil indeks turunan untuk elemen turunan yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Element | Elemen turunan yang indeksnya akan diambil. |
Pulang pergi
Integer — Indeks turunan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getHeadingAttributes(paragraphHeading)
Mengambil kumpulan atribut untuk ParagraphHeading yang diberikan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
paragraph | Paragraph | Judul yang atributnya harus diambil. |
Pulang pergi
Object — Peta atribut dan nilai saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getImages()
Mengambil semua InlineImages yang ada di bagian.
Pulang pergi
InlineImage[]|null — Gambar bagian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getListItems()
Mengambil semua ListItems yang ada di bagian.
Pulang pergi
ListItem[]|null — Item daftar bagian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginBottom()
Mengambil margin bawah, dalam poin.
Pulang pergi
Number|null — Margin bawah, dalam poin.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginLeft()
Mengambil margin kiri, dalam poin.
Pulang pergi
Number|null — Margin kiri, dalam poin.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginRight()
Mengambil margin kanan.
Pulang pergi
Number|null — Margin kanan, dalam poin.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getMarginTop()
Mengambil margin atas.
Pulang pergi
Number|null — Margin atas, dalam poin.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getNumChildren()
Mengambil jumlah anak.
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.`);
Pulang pergi
Integer — Jumlah turunan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getPageHeight()
Mengambil tinggi halaman, dalam poin.
Pulang pergi
Number|null — Tinggi halaman, dalam poin.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getPageWidth()
Mengambil lebar halaman, dalam poin.
Pulang pergi
Number|null — Lebar halaman, dalam poin.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParagraphs()
Mengambil semua Paragraphs yang ada dalam bagian (termasuk ListItems).
Pulang pergi
Paragraph[]|null — Paragraf bagian.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getParent()
Mengambil elemen induk elemen.
Elemen induk berisi elemen saat ini.
Pulang pergi
ContainerElement|null — Elemen induk.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTables()
getText()
Mengambil konten elemen sebagai string teks.
Pulang pergi
String — konten elemen sebagai string teks
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getTextAlignment()
Mendapatkan perataan teks. Jenis perataan yang tersedia adalah DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT, dan DocumentApp.TextAlignment.SUPERSCRIPT.
Pulang pergi
TextAlignment|null — jenis perataan teks, atau null jika teks berisi beberapa jenis perataan teks atau jika perataan teks belum pernah ditetapkan
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getType()
Mengambil ElementType elemen.
Gunakan getType() untuk menentukan jenis pasti elemen tertentu.
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.'); }
Pulang pergi
ElementType — Jenis elemen.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertHorizontalRule(childIndex)
Membuat dan menyisipkan HorizontalRule baru pada indeks yang ditentukan.
HorizontalRule akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
Pulang pergi
HorizontalRule — Penggaris horizontal baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Membuat dan menyisipkan InlineImage dari blob gambar yang ditentukan, pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
image | Blob | Data gambar. |
Pulang pergi
InlineImage — Gambar inline yang disisipkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertImage(childIndex, image)
Menyisipkan InlineImage yang diberikan pada indeks yang ditentukan.
Gambar akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
image | Inline | Gambar yang akan disisipkan. |
Pulang pergi
InlineImage — Gambar inline yang disisipkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertListItem(childIndex, listItem)
Menyisipkan ListItem yang diberikan pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
list | List | Item daftar yang akan disisipkan. |
Pulang pergi
ListItem — Item daftar yang disisipkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertListItem(childIndex, text)
Membuat dan menyisipkan ListItem baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
text | String | Konten teks item daftar. |
Pulang pergi
ListItem — Item daftar baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex)
Membuat dan menyisipkan PageBreak baru pada indeks yang ditentukan.
PageBreak akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
Pulang pergi
PageBreak — Batas halaman baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex, pageBreak)
Menyisipkan PageBreak yang diberikan pada indeks yang ditentukan.
PageBreak akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
page | Page | Pemisah halaman yang akan disisipkan. |
Pulang pergi
PageBreak — Batas halaman yang disisipkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, paragraph)
Menyisipkan Paragraph yang diberikan pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
paragraph | Paragraph | Paragraf yang akan disisipkan. |
Pulang pergi
Paragraph — Paragraf yang disisipkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertParagraph(childIndex, text)
Membuat dan menyisipkan Paragraph baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
text | String | Konten teks paragraf. |
Pulang pergi
Paragraph — Paragraf baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex)
Membuat dan menyisipkan Table baru pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
Pulang pergi
Table — Tabel baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex, cells)
Membuat dan menyisipkan Table baru yang berisi sel yang ditentukan, pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
cells | String[][] | Konten teks sel tabel yang akan ditambahkan ke tabel baru. |
Pulang pergi
Table — Tabel baru.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insertTable(childIndex, table)
Menyisipkan Table yang diberikan pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
table | Table | Tabel yang akan disisipkan. |
Pulang pergi
Table — Tabel yang disisipkan.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
removeChild(child)
Menghapus elemen turunan yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Element | Elemen turunan yang akan dihapus. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler.
Pola penelusuran diteruskan sebagai string, bukan objek ekspresi reguler JavaScript. Oleh karena itu, Anda harus meng-escape semua garis miring terbalik dalam pola.
Metode ini menggunakan library ekspresi reguler RE2 Google, yang membatasi sintaksis yang didukung.
Pola ekspresi reguler yang diberikan dicocokkan secara terpisah dengan setiap blok teks yang ada dalam elemen saat ini.
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText('^.*Apps ?Script.*$', 'Apps Script');
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
search | String | pola regex yang akan dicari |
replacement | String | teks yang akan digunakan sebagai pengganti |
Pulang pergi
Element — elemen saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setAttributes(attributes)
Menetapkan atribut elemen.
Parameter atribut yang ditentukan harus berupa objek dengan setiap nama properti adalah item dalam
enumerasi DocumentApp.Attribute dan setiap nilai properti adalah nilai baru yang akan
diterapkan.
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);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
attributes | Object | Atribut elemen. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setHeadingAttributes(paragraphHeading, attributes)
Menetapkan atribut untuk ParagraphHeading yang diberikan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
paragraph | Paragraph | Judul yang atributnya harus ditetapkan. |
attributes | Object | Peta atribut dan nilai yang akan ditetapkan. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginBottom(marginBottom)
Menetapkan margin bawah, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | Number | Margin bawah, dalam poin. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginLeft(marginLeft)
Menetapkan margin kiri, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | Number | Margin kiri, dalam poin. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginRight(marginRight)
Menetapkan margin kanan, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | Number | Margin kanan. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setMarginTop(marginTop)
Menetapkan margin atas.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | Number | Margin atas, dalam poin. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setPageHeight(pageHeight)
Menetapkan tinggi halaman, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
page | Number | Tinggi halaman, dalam poin. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setPageWidth(pageWidth)
Menetapkan lebar halaman, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
page | Number | Lebar halaman, dalam poin. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setText(text)
Menetapkan konten sebagai teks biasa.
Catatan: konten yang ada akan dihapus.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | String | Isi teks baru. |
Pulang pergi
Body — Elemen saat ini.
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
Menetapkan perataan teks. Jenis perataan yang tersedia adalah DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT, dan 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);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | jenis perataan teks yang akan diterapkan |
Pulang pergi
Body — elemen saat ini
Otorisasi
Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents