Class TableCell

SelTabel

Elemen yang mewakili sel tabel. TableCell selalu berada dalam TableRow dan dapat berisi elemen ListItem, Paragraph, atau Table. Untuk informasi selengkapnya tentang struktur dokumen, lihat panduan untuk memperluas Google Dokumen.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
appendHorizontalRule()HorizontalRuleMembuat dan menambahkan HorizontalRule baru.
appendImage(image)InlineImageMembuat dan menambahkan InlineImage baru dari blob gambar yang ditentukan.
appendImage(image)InlineImageMenambahkan InlineImage yang diberikan.
appendListItem(listItem)ListItemMenambahkan ListItem yang diberikan.
appendListItem(text)ListItemMembuat dan menambahkan ListItem baru.
appendParagraph(paragraph)ParagraphMenambahkan Paragraph yang diberikan.
appendParagraph(text)ParagraphMembuat dan menambahkan Paragraph baru.
appendTable()TableMembuat dan menambahkan Table baru.
appendTable(cells)TableMenambahkan Table baru yang berisi sel yang ditentukan.
appendTable(table)TableMenambahkan Table yang diberikan.
clear()TableCellMenghapus konten elemen.
copy()TableCellMenampilkan salinan mendalam yang terpisah dari elemen saat ini.
editAsText()TextMendapatkan versi Text elemen saat ini, untuk diedit.
findElement(elementType)RangeElementMenelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan.
findElement(elementType, from)RangeElementMenelusuri konten elemen untuk mencari turunan dari jenis yang ditentukan, mulai dari RangeElement yang ditentukan.
findText(searchPattern)RangeElementMenelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler.
findText(searchPattern, from)RangeElementMenelusuri konten elemen untuk pola teks yang ditentukan, mulai dari hasil penelusuran tertentu.
getAttributes()ObjectMengambil atribut elemen.
getBackgroundColor()StringMengambil warna latar belakang.
getChild(childIndex)ElementMengambil elemen turunan pada indeks turunan yang ditentukan.
getChildIndex(child)IntegerMengambil indeks turunan untuk elemen turunan yang ditentukan.
getColSpan()IntegerMengambil span kolom, yang merupakan jumlah kolom sel tabel yang dijangkau oleh sel ini.
getLinkUrl()StringMengambil URL link.
getNextSibling()ElementMengambil elemen pasangan berikutnya dari elemen.
getNumChildren()IntegerMengambil jumlah turunan.
getPaddingBottom()NumberMengambil padding bawah, dalam poin.
getPaddingLeft()NumberMengambil padding kiri, dalam poin.
getPaddingRight()NumberMengambil padding kanan, dalam poin.
getPaddingTop()NumberMengambil padding atas, dalam poin.
getParent()ContainerElementMengambil elemen induk elemen.
getParentRow()TableRowMengambil TableRow yang berisi TableCell saat ini.
getParentTable()TableMengambil Table yang berisi TableCell saat ini.
getPreviousSibling()ElementMengambil elemen saudara sebelumnya dari elemen.
getRowSpan()IntegerMengambil rentang baris, yaitu jumlah baris sel tabel yang dijangkau sel ini.
getText()StringMengambil konten elemen sebagai string teks.
getTextAlignment()TextAlignmentMendapatkan perataan teks.
getType()ElementTypeMengambil ElementType elemen.
getVerticalAlignment()VerticalAlignmentMengambil VerticalAlignment.
getWidth()NumberMengambil lebar kolom yang berisi sel, dalam titik.
insertHorizontalRule(childIndex)HorizontalRuleMembuat dan menyisipkan HorizontalRule baru di indeks yang ditentukan.
insertImage(childIndex, image)InlineImageMembuat dan menyisipkan InlineImage dari blob gambar yang ditentukan, pada indeks yang ditentukan.
insertImage(childIndex, image)InlineImageMenyisipkan InlineImage yang diberikan pada indeks yang ditentukan.
insertListItem(childIndex, listItem)ListItemMenyisipkan ListItem yang diberikan pada indeks yang ditentukan.
insertListItem(childIndex, text)ListItemMembuat dan menyisipkan ListItem baru di indeks yang ditentukan.
insertParagraph(childIndex, paragraph)ParagraphMenyisipkan Paragraph yang diberikan pada indeks yang ditentukan.
insertParagraph(childIndex, text)ParagraphMembuat dan menyisipkan Paragraph baru di indeks yang ditentukan.
insertTable(childIndex)TableMembuat dan menyisipkan Table baru di indeks yang ditentukan.
insertTable(childIndex, cells)TableMembuat dan menyisipkan Table baru yang berisi sel yang ditentukan, di indeks yang ditentukan.
insertTable(childIndex, table)TableMenyisipkan Table yang diberikan pada indeks yang ditentukan.
isAtDocumentEnd()BooleanMenentukan apakah elemen berada di akhir Document.
merge()TableCellMenggabungkan elemen dengan elemen sebelumnya dari jenis yang sama.
removeChild(child)TableCellMenghapus elemen turunan yang ditentukan.
removeFromParent()TableCellMenghapus elemen dari induknya.
replaceText(searchPattern, replacement)ElementMengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler.
setAttributes(attributes)TableCellMenetapkan atribut elemen.
setBackgroundColor(color)TableCellMenetapkan warna latar belakang.
setLinkUrl(url)TableCellMenetapkan URL link.
setPaddingBottom(paddingBottom)TableCellMenetapkan padding bawah, dalam poin.
setPaddingLeft(paddingLeft)TableCellMenetapkan padding kiri, dalam poin.
setPaddingRight(paddingRight)TableCellMenetapkan padding kanan, dalam poin.
setPaddingTop(paddingTop)TableCellMenetapkan padding atas, dalam poin.
setText(text)TableCellMenetapkan konten sebagai teks biasa.
setTextAlignment(textAlignment)TableCellMenetapkan perataan teks.
setVerticalAlignment(alignment)TableCellMenetapkan perataan vertikal.
setWidth(width)TableCellMenetapkan lebar kolom yang berisi sel saat ini, dalam poin.

Dokumentasi mendetail

appendHorizontalRule()

Membuat dan menambahkan HorizontalRule baru.

HorizontalRule akan berada 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 berada dalam Paragraph baru.

Parameter

NamaJenisDeskripsi
imageBlobSourcedata 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 diberikan.

InlineImage akan berada dalam Paragraph baru.

Parameter

NamaJenisDeskripsi
imageInlineImagedata 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.

Parameter

NamaJenisDeskripsi
listItemListItemitem 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

NamaJenisDeskripsi
textStringkonten 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 diberikan.

Parameter

NamaJenisDeskripsi
paragraphParagraphparagraf 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

NamaJenisDeskripsi
textStringkonten 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()

Membuat dan menambahkan Table 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

appendTable(cells)

Menambahkan Table baru yang berisi sel yang ditentukan.

Parameter

NamaJenisDeskripsi
cellsString[][]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.

Parameter

NamaJenisDeskripsi
tableTabletabel 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()

Menghapus konten elemen.

Pulang pergi

TableCell — Elemen saat ini.


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

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 elemen saat ini, untuk diedit.

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 elemen saat ini


findElement(elementType)

Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan.

Parameter

NamaJenisDeskripsi
elementTypeElementTypeJenis 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 mencari turunan dari jenis yang ditentukan, mulai 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

NamaJenisDeskripsi
elementTypeElementTypeJenis elemen yang akan ditelusuri.
fromRangeElementHasil penelusuran yang akan digunakan untuk melakukan penelusuran.

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 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

NamaJenisDeskripsi
searchPatternStringpola yang akan ditelusuri

Pulang pergi

RangeElement — 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 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

NamaJenisDeskripsi
searchPatternStringpola yang akan ditelusuri
fromRangeElementhasil penelusuran yang akan digunakan untuk menelusuri

Pulang pergi

RangeElement — 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

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.

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

NamaJenisDeskripsi
childIndexIntegerIndeks 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

NamaJenisDeskripsi
childElementElemen 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 dijangkau oleh sel ini. Sel yang tidak digabungkan memiliki span kolom 1.

Pulang pergi

Integer — rentang kolom atau 0 untuk sel yang digabungkan oleh 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 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

getNumChildren()

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

getPaddingBottom()

Mengambil padding bawah, dalam poin.

Pulang pergi

Number — padding 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

getPaddingLeft()

Mengambil padding kiri, dalam poin.

Pulang pergi

Number — padding kiri, 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

getPaddingRight()

Mengambil padding kanan, 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 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

getRowSpan()

Mengambil rentang baris, yaitu jumlah baris sel tabel yang dijangkau sel ini. Sel yang tidak digabungkan memiliki rentang baris 1.

Pulang pergi

Integer — rentang baris atau 0 untuk sel yang digabungkan oleh 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 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 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

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 titik.

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 di indeks yang ditentukan.

Aturan horizontal akan berada dalam Paragraph baru.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan

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 indeks yang ditentukan.

Gambar akan berada dalam Paragraph baru.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan
imageBlobSourcedata gambar

Pulang pergi

InlineImage — gambar sisipan 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 berada dalam Paragraph baru.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan
imageInlineImagegambar yang akan disisipkan

Pulang pergi

InlineImage — gambar sisipan 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

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan
listItemListItemitem 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 di indeks yang ditentukan.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan
textStringkonten 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 diberikan pada indeks yang ditentukan.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan
paragraphParagraphparagraf 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 di indeks yang ditentukan.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan
textStringkonten 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 di indeks yang ditentukan.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan

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, di indeks yang ditentukan.

Parameter

NamaJenisDeskripsi
childIndexIntegerindeks tempat menyisipkan
cellsString[][]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

NamaJenisDeskripsi
childIndexIntegerindeks tempat elemen disisipkan
tableTabletabel 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

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 elemen sebelumnya dari jenis yang sama.

Hanya elemen dengan ElementType yang sama yang dapat digabungkan. Setiap elemen turunan yang terdapat dalam elemen saat ini akan dipindahkan ke elemen saudara sebelumnya.

Elemen saat ini akan dihapus dari dokumen.

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

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

NamaJenisDeskripsi
childElementelemen 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.

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

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 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

NamaJenisDeskripsi
searchPatternStringpola ekspresi reguler yang akan ditelusuri
replacementStringteks 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

NamaJenisDeskripsi
attributesObjectAtribut 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

NamaJenisDeskripsi
colorStringwarna latar belakang, yang 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

NamaJenisDeskripsi
urlStringURL 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)

Menetapkan padding bawah, dalam poin.

Parameter

NamaJenisDeskripsi
paddingBottomNumberpadding 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 poin.

Parameter

NamaJenisDeskripsi
paddingLeftNumberpadding 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 kanan, dalam poin.

Parameter

NamaJenisDeskripsi
paddingRightNumberPadding 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 poin.

Parameter

NamaJenisDeskripsi
paddingTopNumberpadding 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

NamaJenisDeskripsi
textStringkonten 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.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Parameter

NamaJenisDeskripsi
textAlignmentTextAlignmentjenis 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

NamaJenisDeskripsi
alignmentVerticalAlignmentperataan 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 poin.

Parameter

NamaJenisDeskripsi
widthNumberlebar 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