Elemen yang merepresentasikan sel tabel. TableCell
selalu dimuat di dalam TableRow
dan dapat berisi elemen ListItem
, Paragraph
, atau Table
. Sebagai
informasi selengkapnya tentang struktur dokumen, lihat panduan untuk memperluas Google Dokumen.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
appendHorizontalRule() | HorizontalRule | Membuat dan menambahkan HorizontalRule baru. |
appendImage(image) | InlineImage | Membuat dan menambahkan InlineImage baru dari blob gambar yang ditentukan. |
appendImage(image) | InlineImage | Menambahkan InlineImage yang ditentukan. |
appendListItem(listItem) | ListItem | Menambahkan ListItem yang ditentukan. |
appendListItem(text) | ListItem | Membuat dan menambahkan ListItem baru. |
appendParagraph(paragraph) | Paragraph | Menambahkan Paragraph yang ditentukan. |
appendParagraph(text) | Paragraph | Membuat dan menambahkan Paragraph baru. |
appendTable() | Table | Membuat dan menambahkan Table baru. |
appendTable(cells) | Table | Menambahkan Table baru yang berisi sel yang ditentukan. |
appendTable(table) | Table | Menambahkan Table yang ditentukan. |
clear() | TableCell | Mengosongkan isi elemen. |
copy() | TableCell | Menampilkan salinan mendalam yang terpisah dari elemen saat ini. |
editAsText() | Text | Mendapatkan versi Text dari elemen saat ini, untuk diedit. |
findElement(elementType) | RangeElement | Menelusuri konten elemen untuk turunan dari jenis yang ditentukan. |
findElement(elementType, from) | RangeElement | Menelusuri konten elemen untuk turunan dari jenis yang ditentukan, mulai dari
RangeElement yang ditentukan. |
findText(searchPattern) | RangeElement | Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler. |
findText(searchPattern, from) | RangeElement | Menelusuri konten elemen untuk pola teks yang ditentukan, mulai dari teks tertentu hasil penelusuran. |
getAttributes() | Object | Mengambil atribut elemen. |
getBackgroundColor() | String | Mengambil warna latar belakang. |
getChild(childIndex) | Element | Mengambil elemen turunan pada indeks turunan yang ditentukan. |
getChildIndex(child) | Integer | Mengambil indeks turunan untuk elemen turunan yang ditentukan. |
getColSpan() | Integer | Mengambil span kolom, yang merupakan jumlah kolom sel tabel yang direntangkan sel ini. |
getLinkUrl() | String | Mengambil URL link. |
getNextSibling() | Element | Mengambil elemen yang seinduk berikutnya dari elemen. |
getNumChildren() | Integer | Mengambil jumlah turunan. |
getPaddingBottom() | Number | Mengambil padding bawah, dalam poin. |
getPaddingLeft() | Number | Mengambil padding kiri, dalam poin. |
getPaddingRight() | Number | Mengambil padding yang tepat, dalam poin. |
getPaddingTop() | Number | Mengambil padding atas, dalam poin. |
getParent() | ContainerElement | Mengambil elemen induk elemen. |
getParentRow() | TableRow | Mengambil TableRow yang berisi TableCell saat ini. |
getParentTable() | Table | Mengambil Table yang berisi TableCell saat ini. |
getPreviousSibling() | Element | Mengambil elemen yang seinduk sebelumnya dari elemen. |
getRowSpan() | Integer | Mengambil span baris, yang merupakan jumlah baris sel tabel yang direntangkan oleh sel ini. |
getText() | String | Mengambil konten elemen sebagai string teks. |
getTextAlignment() | TextAlignment | Mendapatkan perataan teks. |
getType() | ElementType | Mengambil ElementType elemen. |
getVerticalAlignment() | VerticalAlignment | Mengambil VerticalAlignment . |
getWidth() | Number | Mengambil lebar kolom yang berisi sel, dalam bentuk poin. |
insertHorizontalRule(childIndex) | HorizontalRule | Membuat dan menyisipkan HorizontalRule baru pada indeks yang ditentukan. |
insertImage(childIndex, image) | InlineImage | Membuat dan menyisipkan InlineImage dari blob gambar yang ditentukan, pada
Google Cloud. |
insertImage(childIndex, image) | InlineImage | Menyisipkan InlineImage yang ditentukan pada indeks yang ditentukan. |
insertListItem(childIndex, listItem) | ListItem | Menyisipkan ListItem yang ditentukan pada indeks yang ditentukan. |
insertListItem(childIndex, text) | ListItem | Membuat dan menyisipkan ListItem baru pada indeks yang ditentukan. |
insertParagraph(childIndex, paragraph) | Paragraph | Menyisipkan Paragraph yang ditentukan pada indeks yang ditentukan. |
insertParagraph(childIndex, text) | Paragraph | Membuat dan menyisipkan Paragraph baru pada indeks yang ditentukan. |
insertTable(childIndex) | Table | Membuat dan menyisipkan Table baru pada indeks yang ditentukan. |
insertTable(childIndex, cells) | Table | Membuat dan menyisipkan Table baru yang berisi sel tertentu, pada indeks yang ditentukan. |
insertTable(childIndex, table) | Table | Menyisipkan Table yang ditentukan pada indeks yang ditentukan. |
isAtDocumentEnd() | Boolean | Menentukan apakah elemen berada di akhir Document . |
merge() | TableCell | Menggabungkan elemen dengan yang seinduk sebelumnya dari jenis yang sama. |
removeChild(child) | TableCell | Menghapus elemen turunan yang ditentukan. |
removeFromParent() | TableCell | Menghapus elemen dari induknya. |
replaceText(searchPattern, replacement) | Element | Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi. |
setAttributes(attributes) | TableCell | Menetapkan atribut elemen. |
setBackgroundColor(color) | TableCell | Menetapkan warna latar belakang. |
setLinkUrl(url) | TableCell | Menetapkan URL link. |
setPaddingBottom(paddingBottom) | TableCell | Menyetel padding bawah, dalam titik. |
setPaddingLeft(paddingLeft) | TableCell | Menetapkan padding kiri, dalam titik. |
setPaddingRight(paddingRight) | TableCell | Menetapkan padding yang tepat, dalam titik. |
setPaddingTop(paddingTop) | TableCell | Menetapkan padding atas, dalam titik. |
setText(text) | TableCell | Menetapkan konten sebagai teks biasa. |
setTextAlignment(textAlignment) | TableCell | Menetapkan perataan teks. |
setVerticalAlignment(alignment) | TableCell | Menetapkan perataan vertikal. |
setWidth(width) | TableCell | Menetapkan lebar kolom yang berisi sel saat ini, dalam titik. |
Dokumentasi mendetail
appendHorizontalRule()
Membuat dan menambahkan HorizontalRule
baru.
HorizontalRule
akan dimuat dalam Paragraph
baru.
Pulang pergi
HorizontalRule
— aturan 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.
InlineImage
akan dimuat dalam Paragraph
baru.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
image | BlobSource | data gambar |
Pulang pergi
InlineImage
— gambar 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)
Menambahkan InlineImage
yang ditentukan.
InlineImage
akan dimuat dalam Paragraph
baru.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
image | InlineImage | 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 ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
listItem | ListItem | 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.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | isi teks |
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
appendParagraph(paragraph)
Menambahkan Paragraph
yang ditentukan.
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.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
text | String | isi teks |
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()
appendTable(cells)
Menambahkan Table
baru yang berisi sel yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
cells | String[][] | isi teks pada sel tabel untuk 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 ditentukan.
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 terpisah dari elemen saat ini.
Setiap elemen turunan yang ada dalam elemen tersebut juga akan disalin. Elemen baru ini tidak memiliki orang tua.
Pulang pergi
TableCell
— 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 diedit.
Gunakan editAsText
untuk memanipulasi konten elemen sebagai rich text. Mode editAsText
mengabaikan elemen non-teks (seperti InlineImage
dan HorizontalRule
).
Elemen turunan yang sepenuhnya terkandung dalam rentang teks yang dihapus akan dihapus dari elemen.
var 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 turunan dari jenis yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
elementType | ElementType | Jenis elemen yang akan ditelusuri. |
Pulang pergi
RangeElement
— 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 turunan dari jenis yang ditentukan, mulai dari
RangeElement
yang ditentukan.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Define the search parameters. var searchType = DocumentApp.ElementType.PARAGRAPH; var searchHeading = DocumentApp.ParagraphHeading.HEADING1; var searchResult = null; // Search until the paragraph is found. while (searchResult = body.findElement(searchType, searchResult)) { var par = searchResult.getElement().asParagraph(); if (par.getHeading() == searchHeading) { // Found one, update and stop. par.setText('This is the first header.'); return; } }
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
elementType | ElementType | Jenis elemen yang akan ditelusuri. |
from | RangeElement | Hasil penelusuran yang akan ditelusuri. |
Pulang pergi
RangeElement
— 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 tangkapan dan pengubah mode.
Pola ekspresi reguler yang disediakan dicocokkan secara independen dengan setiap blok teks yang ada dalam elemen saat ini.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
searchPattern | String | pola untuk mencari |
Pulang pergi
RangeElement
— hasil penelusuran yang menunjukkan posisi teks penelusuran, atau null jika tidak ada
kompensasi
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 pola teks yang ditentukan, mulai dari teks tertentu hasil penelusuran.
Sebagian fitur ekspresi reguler JavaScript tidak sepenuhnya didukung, seperti grup tangkapan dan pengubah mode.
Pola ekspresi reguler yang disediakan dicocokkan secara independen dengan setiap blok teks yang ada dalam elemen saat ini.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
searchPattern | String | pola untuk mencari |
from | RangeElement | hasil pencarian untuk mencari |
Pulang pergi
RangeElement
— hasil penelusuran yang menunjukkan posisi teks penelusuran berikutnya, atau null jika tidak ada
kompensasi
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 di mana masing-masing
nama properti sesuai dengan item dalam enumerasi DocumentApp.Attribute
.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var 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
getBackgroundColor()
Mengambil warna latar belakang.
Pulang pergi
String
— warna latar belakang, diformat dalam notasi CSS (seperti '#ffffff'
)
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.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. var 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 |
---|---|---|
childIndex | 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
getColSpan()
Mengambil span kolom, yang merupakan jumlah kolom sel tabel yang direntangkan sel ini. Sel yang tidak digabungkan memiliki rentang kolom 1.
Pulang pergi
Integer
— span kolom atau 0 untuk sel yang digabungkan dengan sel lain
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
getLinkUrl()
Mengambil URL link.
Pulang pergi
String
— URL link, atau null jika elemen berisi beberapa nilai untuk atribut 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
getNextSibling()
Mengambil elemen yang seinduk berikutnya dari elemen.
Saudara berikutnya memiliki induk yang sama dan mengikuti elemen saat ini.
Pulang pergi
Element
— Elemen yang seinduk 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
getNumChildren()
Mengambil jumlah turunan.
var 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
getPaddingBottom()
Mengambil padding bawah, dalam poin.
Pulang pergi
Number
— padding bawah, dalam titik
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
getPaddingLeft()
Mengambil padding kiri, dalam poin.
Pulang pergi
Number
— padding 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
getPaddingRight()
Mengambil padding yang tepat, dalam poin.
Pulang pergi
Number
— padding 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
getPaddingTop()
Mengambil padding atas, dalam poin.
Pulang pergi
Number
— padding 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
getParent()
Mengambil elemen induk elemen.
Elemen induk berisi elemen saat ini.
Pulang pergi
ContainerElement
— 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
getParentRow()
Mengambil TableRow
yang berisi TableCell
saat ini.
Pulang pergi
TableRow
— baris tabel yang berisi sel 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
getParentTable()
Mengambil Table
yang berisi TableCell
saat ini.
Pulang pergi
Table
— tabel yang berisi sel 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
getPreviousSibling()
Mengambil elemen yang seinduk sebelumnya dari elemen.
Saudara sebelumnya memiliki induk yang sama dan mendahului elemen saat ini.
Pulang pergi
Element
— Elemen yang seinduk 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
getRowSpan()
Mengambil span baris, yang merupakan jumlah baris sel tabel yang direntangkan oleh sel ini. Tidak digabungkan sel memiliki rentang baris 1.
Pulang pergi
Integer
— rentang baris atau 0 untuk sel yang digabungkan dengan sel lain
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
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
— jenis perataan teks, atau null
jika teks berisi beberapa jenis teks
{i>alignment<i} atau jika perataan teks belum pernah disetel
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 elemen yang tepat.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Obtain the first element in the active tab's body. var 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
getVerticalAlignment()
Mengambil VerticalAlignment
.
Pulang pergi
VerticalAlignment
— perataan vertikal
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
getWidth()
Mengambil lebar kolom yang berisi sel, dalam bentuk poin.
Pulang pergi
Number
— lebar kolom, 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
insertHorizontalRule(childIndex)
Membuat dan menyisipkan HorizontalRule
baru pada indeks yang ditentukan.
Aturan horizontal akan dimuat di Paragraph
baru.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
Pulang pergi
HorizontalRule
— aturan 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
Google Cloud.
Gambar akan dimuat di Paragraph
baru.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
image | BlobSource | 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 ditentukan pada indeks yang ditentukan.
Gambar akan dimuat di Paragraph
baru.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
image | InlineImage | 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 ditentukan pada indeks yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
listItem | ListItem | item daftar yang akan disisipkan |
Pulang pergi
ListItem
— menyisipkan 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
insertListItem(childIndex, text)
Membuat dan menyisipkan ListItem
baru pada indeks yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
text | String | isi teks |
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
insertParagraph(childIndex, paragraph)
Menyisipkan Paragraph
yang ditentukan pada indeks yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
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.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
text | String | isi teks |
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 |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
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 tertentu, pada indeks yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan |
cells | String[][] | isi teks pada sel tabel untuk 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 ditentukan pada indeks yang ditentukan.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
childIndex | Integer | indeks tempat menyisipkan elemen |
table | Table | tabel untuk menyisipkan |
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
isAtDocumentEnd()
Menentukan apakah elemen berada di akhir Document
.
Pulang pergi
Boolean
— Apakah elemen berada di akhir tab.
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
merge()
Menggabungkan elemen dengan yang seinduk sebelumnya dari jenis yang sama.
Hanya elemen ElementType
yang sama yang dapat digabungkan. Setiap elemen turunan yang
terkandung dalam
elemen saat ini dipindahkan ke elemen seinduk sebelumnya.
Elemen saat ini akan dihapus dari dokumen.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document's active tab. var par1 = body.appendParagraph('Paragraph 1.'); var 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. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
Pulang pergi
TableCell
— Elemen yang digabungkan.
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
TableCell
— 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
removeFromParent()
Menghapus elemen dari induknya.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab() var body = documentTab.getBody(); // Remove all images in the active tab's body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
Pulang pergi
TableCell
— 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
replaceText(searchPattern, replacement)
Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi.
Pola penelusuran diteruskan sebagai string, bukan objek ekspresi reguler JavaScript. Oleh karena itu, Anda harus meng-escape setiap garis miring terbalik dalam pola tersebut.
Metode ini menggunakan paket reguler RE2 Google library ekspresi, yang membatasi sintaksis yang didukung.
Pola ekspresi reguler yang disediakan dicocokkan secara independen dengan setiap blok teks yang ada dalam elemen saat ini.
var 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 |
---|---|---|
searchPattern | String | pola regex untuk mencari |
replacement | String | teks yang 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 di
enumerasi DocumentApp.Attribute
dan setiap nilai properti adalah nilai baru yang akan
diterapkan.
var doc = DocumentApp.getActiveDocument(); var documentTab = doc.getActiveTab().asDocumentTab(); var body = documentTab.getBody(); // Define a custom paragraph style. var 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. var 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
TableCell
— 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
setBackgroundColor(color)
Menetapkan warna latar belakang.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
color | String | warna latar belakang, diformat dalam notasi CSS (seperti '#ffffff' ) |
Pulang pergi
TableCell
— 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
setLinkUrl(url)
Menetapkan URL link.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
url | String | URL link |
Pulang pergi
TableCell
— 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
setPaddingBottom(paddingBottom)
Menyetel padding bawah, dalam titik.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
paddingBottom | Number | padding bawah, dalam poin |
Pulang pergi
TableCell
— 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
setPaddingLeft(paddingLeft)
Menetapkan padding kiri, dalam titik.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
paddingLeft | Number | padding kiri, dalam poin |
Pulang pergi
TableCell
— 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
setPaddingRight(paddingRight)
Menetapkan padding yang tepat, dalam titik.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
paddingRight | Number | Padding kanan, dalam poin. |
Pulang pergi
TableCell
— 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
setPaddingTop(paddingTop)
Menetapkan padding atas, dalam titik.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
paddingTop | Number | padding atas, dalam poin |
Pulang pergi
TableCell
— 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 | konten teks baru |
Pulang pergi
TableCell
— 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. var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); var text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
textAlignment | TextAlignment | jenis perataan teks yang akan diterapkan |
Pulang pergi
TableCell
— 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
setVerticalAlignment(alignment)
Menetapkan perataan vertikal.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
alignment | VerticalAlignment | perataan vertikal |
Pulang pergi
TableCell
— 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
setWidth(width)
Menetapkan lebar kolom yang berisi sel saat ini, dalam titik.
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
width | Number | lebar kolom, dalam poin |
Pulang pergi
TableCell
— 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