Elemen yang mewakili bagian catatan kaki. Footnote
berisi teks yang
sesuai dengan Footnote
. Footnote
dapat berisi elemen List
atau
Paragraph
. Untuk informasi selengkapnya tentang struktur dokumen, lihat panduan untuk memperluas Google Dokumen.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
append | Paragraph | Menambahkan Paragraph yang diberikan. |
append | Paragraph | Membuat dan menambahkan Paragraph baru yang berisi konten teks yang ditentukan. |
clear() | Footnote | Menghapus konten elemen. |
copy() | Footnote | Menampilkan salinan mendalam yang terpisah dari elemen saat ini. |
edit | Text | Mendapatkan versi Text elemen saat ini, untuk diedit. |
find | Range | Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan. |
find | Range | Menelusuri konten elemen untuk mencari turunan dari jenis yang ditentukan, mulai dari
Range yang ditentukan. |
find | Range | Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler. |
find | Range | Menelusuri konten elemen untuk pola teks yang ditentukan, mulai 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 | Element | Mengambil elemen pasangan berikutnya dari elemen. |
get | Integer | Mengambil jumlah turunan. |
get | Paragraph[] | Mengambil semua Paragraphs yang terdapat di bagian (termasuk List ). |
get | Container | Mengambil elemen induk elemen. |
get | Element | Mengambil elemen saudara sebelumnya dari elemen. |
get | String | Mengambil konten elemen sebagai string teks. |
get | Text | Mendapatkan perataan teks. |
get | Element | Mengambil Element elemen. |
insert | Paragraph | Menyisipkan Paragraph yang diberikan pada indeks yang ditentukan. |
insert | Paragraph | Membuat dan menyisipkan Paragraph baru di indeks yang ditentukan, yang berisi konten teks yang ditentukan. |
remove | Footnote | Menghapus elemen turunan yang ditentukan. |
remove | Footnote | Menghapus elemen dari induknya. |
replace | Element | Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler. |
set | Footnote | Menetapkan atribut elemen. |
set | Footnote | Menetapkan konten sebagai teks biasa. |
set | Footnote | Menetapkan perataan teks. |
Dokumentasi mendetail
append Paragraph(paragraph)
Menambahkan Paragraph
yang diberikan.
Gunakan versi append
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
append Paragraph(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
clear()
copy()
Menampilkan salinan mendalam yang terpisah dari elemen saat ini.
Semua elemen turunan yang ada dalam elemen juga akan disalin. Elemen baru tidak memiliki induk.
Pulang pergi
Footnote
— 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
edit As Text()
Mendapatkan versi Text
elemen saat ini, untuk diedit.
Gunakan edit
untuk memanipulasi konten elemen sebagai teks kaya. Mode edit
mengabaikan elemen non-teks (seperti Inline
dan Horizontal
).
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 elemen saat ini
find Element(elementType)
Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
element | Element | Jenis elemen yang akan ditelusuri. |
Pulang pergi
Range
— 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
find Element(elementType, from)
Menelusuri konten elemen untuk mencari turunan dari jenis yang ditentukan, mulai dari
Range
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 digunakan untuk melakukan penelusuran. |
Pulang pergi
Range
— 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
find Text(searchPattern)
Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler.
Sebagian fitur ekspresi reguler JavaScript tidak didukung sepenuhnya, seperti grup pengambilan dan pengubah mode.
Pola ekspresi reguler yang disediakan dicocokkan secara independen dengan setiap blok teks yang terdapat dalam elemen saat ini.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
search | String | pola yang akan ditelusuri |
Pulang pergi
Range
— 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
find Text(searchPattern, from)
Menelusuri konten elemen untuk pola teks yang ditentukan, mulai dari hasil penelusuran tertentu.
Sebagian fitur ekspresi reguler JavaScript tidak didukung sepenuhnya, seperti grup pengambilan dan pengubah mode.
Pola ekspresi reguler yang disediakan dicocokkan secara independen dengan setiap blok teks yang terdapat dalam elemen saat ini.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
search | String | pola yang akan ditelusuri |
from | Range | hasil penelusuran yang akan digunakan untuk menelusuri |
Pulang pergi
Range
— 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
get Attributes()
Mengambil atribut elemen.
Hasilnya adalah objek yang berisi properti untuk setiap atribut elemen yang valid dengan setiap
nama properti sesuai dengan item dalam enumerasi 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]}`); }
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
get Child(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
get Child Index(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
get Next Sibling()
Mengambil elemen pasangan berikutnya dari elemen.
Saudara berikutnya memiliki induk yang sama dan mengikuti elemen saat ini.
Pulang pergi
Element
— Elemen sibling berikutnya.
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
get Num Children()
Mengambil jumlah turunan.
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
get Paragraphs()
Mengambil semua Paragraphs
yang terdapat di bagian (termasuk List
).
Pulang pergi
Paragraph[]
— 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
get Parent()
Mengambil elemen induk elemen.
Elemen induk berisi elemen saat ini.
Pulang pergi
Container
— 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
get Previous Sibling()
Mengambil elemen saudara sebelumnya dari elemen.
Saudara sebelumnya memiliki induk yang sama dan mendahului elemen saat ini.
Pulang pergi
Element
— Elemen sibling sebelumnya.
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
get Text()
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
get Text Alignment()
Mendapatkan perataan teks. Jenis perataan yang tersedia adalah Document
, Document
, dan Document
.
Pulang pergi
Text
— 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
get Type()
Mengambil Element
elemen.
Gunakan get
untuk menentukan jenis persis 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
Element
— 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
insert Paragraph(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
insert Paragraph(childIndex, text)
Membuat dan menyisipkan Paragraph
baru di 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
remove Child(child)
Menghapus elemen turunan yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
child | Element | Elemen turunan yang akan dihapus. |
Pulang pergi
Footnote
— 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
remove From Parent()
Menghapus elemen dari induknya.
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(); }
Pulang pergi
Footnote
— Elemen yang dihapus.
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
replace Text(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 garis miring terbalik dalam pola.
Metode ini menggunakan library ekspresi reguler RE2 Google, yang membatasi sintaksis yang didukung.
Pola ekspresi reguler yang disediakan dicocokkan secara independen dengan setiap blok teks yang terdapat 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 ekspresi reguler yang akan ditelusuri |
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
set Attributes(attributes)
Menetapkan atribut elemen.
Parameter atribut yang ditentukan harus berupa objek dengan setiap nama properti adalah item dalam
enumerasi Document
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
Footnote
— 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
set Text(text)
Menetapkan konten sebagai teks biasa.
Catatan: konten yang ada akan dihapus.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | Konten teks baru. |
Pulang pergi
Footnote
— 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
set Text Alignment(textAlignment)
Menetapkan perataan teks. Jenis perataan yang tersedia adalah Document
, Document
, dan 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);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | Text | jenis perataan teks yang akan diterapkan |
Pulang pergi
Footnote
— 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