Interface Element

عنصر

یک عنصر عمومی. محتویات Document به صورت عناصر نمایش داده می‌شوند. برای مثال، ListItem ، Paragraph و Table عناصر هستند و تمام متدهای تعریف شده توسط Element مانند getType() را به ارث می‌برند.

پیاده‌سازی کلاس‌ها

نام شرح مختصر
Body محتوای یک برگه در یک سند Google Docs.
Container Element یک عنصر عمومی که ممکن است شامل عناصر دیگری باشد.
Date عنصری که تاریخ قالب‌بندی شده را نشان می‌دهد
Equation عنصری که یک عبارت ریاضی را نشان می‌دهد.
Equation Function عنصری که نشان دهنده یک تابع در یک Equation ریاضی است.
Equation Function Argument Separator عنصری که جداکننده تابع را در یک Equation ریاضی نشان می‌دهد.
Equation Symbol عنصری که نمایانگر یک نماد در یک Equation ریاضی است.
Footer Section عنصری که نشان‌دهنده‌ی بخش پاورقی است.
Footnote عنصری که نشان‌دهنده‌ی یک پاورقی است.
Footnote Section عنصری که نشان‌دهنده‌ی یک بخش پاورقی است.
Header Section عنصری که نشان‌دهنده‌ی یک بخش هدر است.
Horizontal Rule عنصری که نشان دهنده یک خط افقی است.
Inline Drawing عنصری که نمایانگر یک نقاشی جاسازی‌شده است.
Inline Image عنصری که نشان دهنده یک تصویر جاسازی شده است.
List Item عنصری که یک آیتم لیست را نشان می‌دهد.
Page Break عنصری که نشان‌دهنده‌ی یک شکست صفحه است.
Paragraph عنصری که نمایانگر یک پاراگراف است.
Person عنصری که نشان‌دهنده‌ی پیوندی به یک شخص است.
Rich Link عنصری که نشان‌دهنده‌ی پیوندی به یک منبع گوگل، مانند یک فایل درایو یا یک ویدیوی یوتیوب است.
Table عنصری که نشان دهنده یک جدول است.
Table Cell عنصری که نشان‌دهنده‌ی یک سلول جدول است.
Table Of Contents عنصری که شامل فهرست مطالب است.
Table Row عنصری که نشان دهنده یک ردیف جدول است.
Text عنصری که نشان‌دهنده‌ی یک ناحیه‌ی متنی غنی است.
Unsupported Element عنصری که نشان‌دهنده‌ی ناحیه‌ای است که ناشناخته است یا نمی‌تواند تحت تأثیر یک اسکریپت قرار گیرد، مانند شماره صفحه.

روش‌ها

روش نوع بازگشتی شرح مختصر
as Body() Body عنصر فعلی را به عنوان یک Body برمی‌گرداند.
as Date() Date عنصر فعلی را به عنوان یک Date برمی‌گرداند.
as Equation() Equation عنصر فعلی را به عنوان یک Equation برمی‌گرداند.
as Equation Function() Equation Function عنصر فعلی را به عنوان یک Equation Function برمی‌گرداند.
as Equation Function Argument Separator() Equation Function Argument Separator عنصر فعلی را به عنوان Equation Function Argument Separator برمی‌گرداند.
as Equation Symbol() Equation Symbol عنصر فعلی را به عنوان Equation Symbol برمی‌گرداند.
as Footer Section() Footer Section عنصر فعلی را به عنوان یک Footer Section برمی‌گرداند.
as Footnote() Footnote عنصر فعلی را به عنوان یک Footnote برمی‌گرداند.
as Footnote Section() Footnote Section عنصر فعلی را به عنوان یک Footnote Section برمی‌گرداند.
as Header Section() Header Section عنصر فعلی را به عنوان یک Header Section برمی‌گرداند.
as Horizontal Rule() Horizontal Rule عنصر فعلی را به عنوان یک Horizontal Rule برمی‌گرداند.
as Inline Drawing() Inline Drawing عنصر فعلی را به عنوان یک Inline Drawing برمی‌گرداند.
as Inline Image() Inline Image عنصر فعلی را به عنوان یک Inline Image برمی‌گرداند.
as List Item() List Item عنصر فعلی را به عنوان یک List Item برمی‌گرداند.
as Page Break() Page Break عنصر فعلی را به عنوان یک Page Break برمی‌گرداند.
as Paragraph() Paragraph عنصر فعلی را به عنوان یک Paragraph برمی‌گرداند.
as Person() Person عنصر فعلی را به عنوان یک Person برمی‌گرداند.
as Rich Link() Rich Link عنصر فعلی را به عنوان یک Rich Link )، برای مثال، پیوندی به یک فایل Google Sheets، برمی‌گرداند.
as Table() Table عنصر فعلی را به عنوان یک Table برمی‌گرداند.
as Table Cell() Table Cell عنصر فعلی را به عنوان یک Table Cell برمی‌گرداند.
as Table Of Contents() Table Of Contents عنصر فعلی را به عنوان یک Table Of Contents برمی‌گرداند.
as Table Row() Table Row عنصر فعلی را به عنوان یک Table Row برمی‌گرداند.
as Text() Text عنصر فعلی را به عنوان یک Text برمی‌گرداند.
copy() Element یک کپی جدا و عمیق از عنصر فعلی را برمی‌گرداند.
get Attributes() Object ویژگی‌های عنصر را بازیابی می‌کند.
get Next Sibling() Element |null عنصر خواهر یا برادر بعدی عنصر را بازیابی می‌کند.
get Parent() Container Element |null عنصر والد عنصر را بازیابی می‌کند.
get Previous Sibling() Element |null عنصر خواهر و برادر قبلی عنصر را بازیابی می‌کند.
get Type() Element Type Element Type را بازیابی می‌کند.
is At Document End() Boolean تعیین می‌کند که آیا عنصر در انتهای Document قرار دارد یا خیر.
merge() Element |null عنصر را با عنصر خواهر یا برادر قبلی از همان نوع ادغام می‌کند.
remove From Parent() Element |null عنصر را از والدش حذف می‌کند.
set Attributes(attributes) Element ویژگی‌های عنصر را تنظیم می‌کند.

مستندات دقیق

asBody()

عنصر فعلی را به عنوان یک Body برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

Body - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asDate()

عنصر فعلی را به عنوان یک Date برمی‌گرداند.

وقتی می‌دانید که یک عنصر از Date است، از این متد برای تنظیم نوع آن به عنوان Date استفاده کنید. انجام این کار به شما اجازه می‌دهد تا تکمیل خودکار در ویرایشگر Apps Script متدهایی را که می‌توانید با Date استفاده کنید، به شما نشان دهد.

بازگشت

Date - عنصر فعلی که نوع آن به صورت Date تنظیم شده است.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asEquation()

عنصر فعلی را به عنوان یک Equation برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

Equation - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asEquationFunction()

عنصر فعلی را به عنوان یک EquationFunction برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

EquationFunction - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asEquationFunctionArgumentSeparator()

عنصر فعلی را به عنوان یک EquationFunctionArgumentSeparator برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

EquationFunctionArgumentSeparator - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asEquationSymbol()

عنصر فعلی را به عنوان یک EquationSymbol برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

EquationSymbol - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asFooterSection()

عنصر فعلی را به عنوان یک FooterSection برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

FooterSection - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asFootnote()

عنصر فعلی را به عنوان یک Footnote برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

Footnote — عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asFootnoteSection()

عنصر فعلی را به عنوان یک FootnoteSection برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

FootnoteSection - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asHeaderSection()

عنصر فعلی را به عنوان یک HeaderSection برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

HeaderSection — عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asHorizontalRule()

عنصر فعلی را به عنوان یک HorizontalRule برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

HorizontalRule - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asInlineDrawing()

عنصر فعلی را به عنوان یک InlineDrawing برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

InlineDrawing - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asInlineImage()

عنصر فعلی را به عنوان یک InlineImage برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

InlineImage - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asListItem()

عنصر فعلی را به عنوان یک ListItem برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

ListItem - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asPageBreak()

عنصر فعلی را به عنوان یک PageBreak برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

PageBreak - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asParagraph()

عنصر فعلی را به عنوان یک Paragraph برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

Paragraph - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asPerson()

عنصر فعلی را به عنوان یک Person برمی‌گرداند.

وقتی می‌دانید یک عنصر از Person است، از این متد برای تنظیم نوع آن به عنوان person استفاده کنید. انجام این کار به شما اجازه می‌دهد تا تکمیل خودکار در ویرایشگر Apps Script متدهایی را که می‌توانید با یک عنصر person استفاده کنید، به شما نشان دهد.

بازگشت

Person - عنصر فعلی که نوع آن Person تعیین شده است.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

عنصر فعلی را به عنوان یک RichLink برمی‌گرداند، برای مثال، یک لینک به یک فایل Google Sheets.

وقتی می‌دانید یک عنصر RichLink است، از این متد برای تنظیم نوع آن به عنوان RichLink استفاده کنید. انجام این کار به شما اجازه می‌دهد تا تکمیل خودکار در ویرایشگر Apps Script متدهایی را که می‌توانید با RichLink استفاده کنید، به شما نشان دهد.

بازگشت

RichLink - عنصر فعلی که نوع آن RichLink تعیین شده است.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asTable()

عنصر فعلی را به عنوان یک Table برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

Table - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asTableCell()

عنصر فعلی را به عنوان یک TableCell برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

TableCell - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asTableOfContents()

عنصر فعلی را به عنوان یک TableOfContents برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

TableOfContents - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asTableRow()

عنصر فعلی را به عنوان یک TableRow برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

TableRow - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

asText()

عنصر فعلی را به عنوان یک Text برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی باشد، استفاده کنید.

بازگشت

Text - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

copy()

یک کپی جدا و عمیق از عنصر فعلی را برمی‌گرداند.

هر عنصر فرزندی که در عنصر وجود داشته باشد نیز کپی می‌شود. عنصر جدید والد ندارد.

بازگشت

Element - نسخه جدید.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

  • 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 - ویژگی‌های عنصر.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

getNextSibling()

عنصر خواهر یا برادر بعدی عنصر را بازیابی می‌کند.

خواهر یا برادر بعدی، والد یکسانی دارد و عنصر فعلی را دنبال می‌کند.

بازگشت

Element |null — عنصر خواهر یا برادر بعدی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

getParent()

عنصر والد عنصر را بازیابی می‌کند.

عنصر والد شامل عنصر فعلی است.

بازگشت

ContainerElement |null — عنصر والد.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

getPreviousSibling()

عنصر خواهر و برادر قبلی عنصر را بازیابی می‌کند.

عنصر خواهر یا برادر قبلی، والد یکسانی دارد و قبل از عنصر فعلی قرار می‌گیرد.

بازگشت

Element |null — عنصر خواهر یا برادر قبلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

  • 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 - نوع عنصر.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

isAtDocumentEnd()

تعیین می‌کند که آیا عنصر در انتهای Document قرار دارد یا خیر.

بازگشت

Boolean - اینکه آیا عنصر در انتهای تب قرار دارد یا خیر.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

  • 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 |null — عنصر ادغام شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

  • 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 |null — عنصر حذف شده.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

پارامترها

نام نوع توضیحات
attributes Object ویژگی‌های عنصر.

بازگشت

Element - عنصر فعلی.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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