Interface Element

องค์ประกอบ

องค์ประกอบทั่วไป เนื้อหา Document จะแสดงเป็นองค์ประกอบ เช่น ListItem, Paragraph และ Table เป็นองค์ประกอบและรับค่าวิธีการทั้งหมดที่ Element กำหนดไว้ เช่น getType()

การใช้คลาส

ชื่อรายละเอียดแบบย่อ
Bodyเนื้อหาของแท็บในเอกสาร Google เอกสาร
ContainerElementองค์ประกอบทั่วไปที่อาจมีองค์ประกอบอื่นๆ
Dateองค์ประกอบที่แสดงวันที่ที่มีการจัดรูปแบบ
Equationองค์ประกอบที่แสดงนิพจน์ทางคณิตศาสตร์
EquationFunctionองค์ประกอบที่แสดงถึงฟังก์ชันใน Equation ทางคณิตศาสตร์
EquationFunctionArgumentSeparatorองค์ประกอบที่แสดงตัวคั่นฟังก์ชันใน Equation ทางคณิตศาสตร์
EquationSymbolองค์ประกอบที่แสดงถึงสัญลักษณ์ใน Equation ทางคณิตศาสตร์
FooterSectionองค์ประกอบที่แสดงส่วนท้าย
Footnoteองค์ประกอบที่แสดงเชิงอรรถ
FootnoteSectionองค์ประกอบที่แสดงส่วนเชิงอรรถ
HeaderSectionองค์ประกอบที่แสดงส่วนหัว
HorizontalRuleองค์ประกอบที่แสดงเส้นแนวนอน
InlineDrawingองค์ประกอบที่แสดงภาพวาดที่ฝัง
InlineImageองค์ประกอบที่แสดงรูปภาพที่ฝัง
ListItemองค์ประกอบที่แสดงรายการ
PageBreakองค์ประกอบที่แสดงตัวแบ่งหน้า
Paragraphองค์ประกอบที่แสดงย่อหน้า
Personองค์ประกอบที่แสดงลิงก์ไปยังบุคคล
RichLinkองค์ประกอบที่แสดงลิงก์ไปยังทรัพยากรของ Google เช่น ไฟล์ในไดรฟ์หรือวิดีโอ YouTube
Tableองค์ประกอบที่แสดงตาราง
TableCellองค์ประกอบที่แสดงถึงเซลล์ตาราง
TableOfContentsองค์ประกอบที่มีสารบัญ
TableRowองค์ประกอบที่แสดงแถวตาราง
Textองค์ประกอบที่แสดงถึงภูมิภาค Rich Text
UnsupportedElementองค์ประกอบที่แสดงถึงภูมิภาคที่ไม่รู้จักหรือได้รับผลกระทบจากสคริปต์ไม่ได้ เช่น หมายเลขหน้า

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
asBody()Bodyแสดงผลองค์ประกอบปัจจุบันเป็น Body
asDate()Dateแสดงผลองค์ประกอบปัจจุบันเป็น Date
asEquation()Equationแสดงผลองค์ประกอบปัจจุบันเป็น Equation
asEquationFunction()EquationFunctionแสดงผลองค์ประกอบปัจจุบันเป็น EquationFunction
asEquationFunctionArgumentSeparator()EquationFunctionArgumentSeparatorแสดงผลองค์ประกอบปัจจุบันเป็น EquationFunctionArgumentSeparator
asEquationSymbol()EquationSymbolแสดงผลองค์ประกอบปัจจุบันเป็น EquationSymbol
asFooterSection()FooterSectionแสดงผลองค์ประกอบปัจจุบันเป็น FooterSection
asFootnote()Footnoteแสดงผลองค์ประกอบปัจจุบันเป็น Footnote
asFootnoteSection()FootnoteSectionแสดงผลองค์ประกอบปัจจุบันเป็น FootnoteSection
asHeaderSection()HeaderSectionแสดงผลองค์ประกอบปัจจุบันเป็น HeaderSection
asHorizontalRule()HorizontalRuleแสดงผลองค์ประกอบปัจจุบันเป็น HorizontalRule
asInlineDrawing()InlineDrawingแสดงผลองค์ประกอบปัจจุบันเป็น InlineDrawing
asInlineImage()InlineImageแสดงผลองค์ประกอบปัจจุบันเป็น InlineImage
asListItem()ListItemแสดงผลองค์ประกอบปัจจุบันเป็น ListItem
asPageBreak()PageBreakแสดงผลองค์ประกอบปัจจุบันเป็น PageBreak
asParagraph()Paragraphแสดงผลองค์ประกอบปัจจุบันเป็น Paragraph
asPerson()Personแสดงผลองค์ประกอบปัจจุบันเป็น Person
asRichLink()RichLinkแสดงผลองค์ประกอบปัจจุบันเป็น RichLink เช่น ลิงก์ไปยังไฟล์ Google ชีต
asTable()Tableแสดงผลองค์ประกอบปัจจุบันเป็น Table
asTableCell()TableCellแสดงผลองค์ประกอบปัจจุบันเป็น TableCell
asTableOfContents()TableOfContentsแสดงผลองค์ประกอบปัจจุบันเป็น TableOfContents
asTableRow()TableRowแสดงผลองค์ประกอบปัจจุบันเป็น TableRow
asText()Textแสดงผลองค์ประกอบปัจจุบันเป็น Text
copy()Elementแสดงผลสำเนาที่แยกออกและแบบเจาะลึกขององค์ประกอบปัจจุบัน
getAttributes()Objectดึงข้อมูลแอตทริบิวต์ขององค์ประกอบ
getNextSibling()Elementดึงข้อมูลองค์ประกอบพี่น้องถัดไปขององค์ประกอบ
getParent()ContainerElementดึงข้อมูลองค์ประกอบหลักขององค์ประกอบ
getPreviousSibling()Elementดึงข้อมูลองค์ประกอบพี่น้องก่อนหน้าขององค์ประกอบ
getType()ElementTypeดึงข้อมูล ElementType ขององค์ประกอบ
isAtDocumentEnd()Booleanระบุว่าองค์ประกอบอยู่ท้าย Document หรือไม่
merge()Elementผสานองค์ประกอบเข้ากับรายการก่อนหน้าที่เป็นประเภทเดียวกัน
removeFromParent()Elementนำองค์ประกอบออกจากองค์ประกอบหลัก
setAttributes(attributes)Elementตั้งค่าแอตทริบิวต์ขององค์ประกอบ

เอกสารประกอบโดยละเอียด

asBody()

แสดงผลองค์ประกอบปัจจุบันเป็น Body

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

Body — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asDate()

แสดงผลองค์ประกอบปัจจุบันเป็น Date

เมื่อทราบว่าองค์ประกอบเป็น Date ให้ใช้เมธอดนี้เพื่อตั้งค่าประเภทเป็น Date ซึ่งจะช่วยให้เครื่องมือเติมข้อความอัตโนมัติในเครื่องมือแก้ไข Apps Script แสดงเมธอดที่คุณใช้ได้พร้อม Date

รีเทิร์น

Date — องค์ประกอบปัจจุบันที่มีการตั้งค่าประเภทเป็น Date

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquation()

แสดงผลองค์ประกอบปัจจุบันเป็น Equation

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

Equation — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquationFunction()

แสดงผลองค์ประกอบปัจจุบันเป็น EquationFunction

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

EquationFunction — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquationFunctionArgumentSeparator()

แสดงผลองค์ประกอบปัจจุบันเป็น EquationFunctionArgumentSeparator

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

EquationFunctionArgumentSeparator — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquationSymbol()

แสดงผลองค์ประกอบปัจจุบันเป็น EquationSymbol

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

EquationSymbol — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asFooterSection()

แสดงผลองค์ประกอบปัจจุบันเป็น FooterSection

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

FooterSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asFootnote()

แสดงผลองค์ประกอบปัจจุบันเป็น Footnote

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

Footnote — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asFootnoteSection()

แสดงผลองค์ประกอบปัจจุบันเป็น FootnoteSection

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

FootnoteSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asHeaderSection()

แสดงผลองค์ประกอบปัจจุบันเป็น HeaderSection

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

HeaderSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asHorizontalRule()

แสดงผลองค์ประกอบปัจจุบันเป็น HorizontalRule

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

HorizontalRule — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asInlineDrawing()

แสดงผลองค์ประกอบปัจจุบันเป็น InlineDrawing

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

InlineDrawing — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asInlineImage()

แสดงผลองค์ประกอบปัจจุบันเป็น InlineImage

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

InlineImage — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asListItem()

แสดงผลองค์ประกอบปัจจุบันเป็น ListItem

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

ListItem — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asPageBreak()

แสดงผลองค์ประกอบปัจจุบันเป็น PageBreak

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

PageBreak — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asParagraph()

แสดงผลองค์ประกอบปัจจุบันเป็น Paragraph

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

Paragraph — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asPerson()

แสดงผลองค์ประกอบปัจจุบันเป็น Person

เมื่อทราบว่าองค์ประกอบเป็น Person ให้ใช้เมธอดนี้เพื่อตั้งค่าประเภทเป็นบุคคล ซึ่งจะช่วยให้การเติมข้อความอัตโนมัติในเครื่องมือแก้ไข Apps Script แสดงเมธอดที่คุณใช้ได้กับองค์ประกอบบุคคล

รีเทิร์น

Person — องค์ประกอบปัจจุบันที่มีการตั้งค่าประเภทเป็น Person

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

แสดงผลองค์ประกอบปัจจุบันเป็น RichLink เช่น ลิงก์ไปยังไฟล์ Google ชีต

เมื่อทราบว่าองค์ประกอบเป็น RichLink ให้ใช้เมธอดนี้เพื่อตั้งค่าประเภทเป็น RichLink ซึ่งจะช่วยให้การเติมข้อความอัตโนมัติในเครื่องมือแก้ไข Apps Script แสดงวิธีการที่คุณใช้ได้พร้อม RichLink

รีเทิร์น

RichLink — องค์ประกอบปัจจุบันที่มีการตั้งค่าประเภทเป็น RichLink

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTable()

แสดงผลองค์ประกอบปัจจุบันเป็น Table

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

Table — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTableCell()

แสดงผลองค์ประกอบปัจจุบันเป็น TableCell

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

TableCell — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTableOfContents()

แสดงผลองค์ประกอบปัจจุบันเป็น TableOfContents

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

TableOfContents — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTableRow()

แสดงผลองค์ประกอบปัจจุบันเป็น TableRow

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

TableRow — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asText()

แสดงผลองค์ประกอบปัจจุบันเป็น Text

ใช้เมธอดนี้เพื่อช่วยในการเติมข้อความอัตโนมัติทุกครั้งที่ทราบว่าองค์ประกอบหนึ่งๆ เป็นประเภทที่เฉพาะเจาะจง

รีเทิร์น

Text — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

copy()

แสดงผลสำเนาที่แยกออกและแบบเจาะลึกขององค์ประกอบปัจจุบัน

ระบบจะคัดลอกองค์ประกอบย่อยทั้งหมดที่อยู่ในองค์ประกอบนั้นด้วย องค์ประกอบใหม่ไม่มีองค์ประกอบหลัก

รีเทิร์น

Element — สำเนาใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getAttributes()

ดึงข้อมูลแอตทริบิวต์ขององค์ประกอบ

ผลลัพธ์ที่ได้คือออบเจ็กต์ที่มีพร็อพเพอร์ตี้สำหรับแอตทริบิวต์องค์ประกอบที่ถูกต้องแต่ละรายการ โดยที่ชื่อพร็อพเพอร์ตี้แต่ละรายการสอดคล้องกับรายการในการแจกแจง 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]}`);
}

รีเทิร์น

Object — แอตทริบิวต์ขององค์ประกอบ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getNextSibling()

ดึงข้อมูลองค์ประกอบพี่น้องถัดไปขององค์ประกอบ

องค์ประกอบถัดไปมีองค์ประกอบหลักเดียวกันและอยู่หลังองค์ประกอบปัจจุบัน

รีเทิร์น

Element — องค์ประกอบระดับถัดไป

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getParent()

ดึงข้อมูลองค์ประกอบหลักขององค์ประกอบ

องค์ประกอบหลักมีองค์ประกอบปัจจุบัน

รีเทิร์น

ContainerElement — องค์ประกอบหลัก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getPreviousSibling()

ดึงข้อมูลองค์ประกอบพี่น้องก่อนหน้าขององค์ประกอบ

องค์ประกอบระดับข้างเคียงก่อนหน้ามีองค์ประกอบหลักเดียวกันและอยู่ก่อนองค์ประกอบปัจจุบัน

รีเทิร์น

Element — องค์ประกอบระดับข้างเคียงก่อนหน้า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getType()

ดึงข้อมูล ElementType ขององค์ประกอบ

ใช้ getType() เพื่อระบุประเภทที่แน่นอนขององค์ประกอบหนึ่งๆ

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.');
}

รีเทิร์น

ElementType — ประเภทองค์ประกอบ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

isAtDocumentEnd()

ระบุว่าองค์ประกอบอยู่ท้าย Document หรือไม่

รีเทิร์น

Boolean — องค์ประกอบอยู่ที่ส่วนท้ายของแท็บหรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

merge()

ผสานองค์ประกอบเข้ากับรายการก่อนหน้าที่เป็นประเภทเดียวกัน

ผสานได้เฉพาะองค์ประกอบของ ElementType เดียวกันเท่านั้น ระบบจะย้ายองค์ประกอบย่อยที่อยู่ในองค์ประกอบปัจจุบันไปยังองค์ประกอบพี่น้องก่อนหน้า

ระบบจะนำองค์ประกอบปัจจุบันออกจากเอกสาร

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();

รีเทิร์น

Element — องค์ประกอบที่ผสาน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeFromParent()

นำองค์ประกอบออกจากองค์ประกอบหลัก

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();
}

รีเทิร์น

Element — องค์ประกอบที่ถูกนำออก

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setAttributes(attributes)

ตั้งค่าแอตทริบิวต์ขององค์ประกอบ

พารามิเตอร์แอตทริบิวต์ที่ระบุต้องเป็นออบเจ็กต์ที่ชื่อพร็อพเพอร์ตี้แต่ละรายการเป็นรายการในลิสต์DocumentApp.Attribute และค่าพร็อพเพอร์ตี้แต่ละรายการเป็นค่าใหม่ที่จะใช้

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
attributesObjectแอตทริบิวต์ขององค์ประกอบ

รีเทิร์น

Element — องค์ประกอบปัจจุบัน

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับอนุญาตด้วยขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents