Interface Element

عنصر

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

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

نام شرح مختصر
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 ویژگی‌های عنصر را تنظیم می‌کند.

مستندات دقیق

as Body()

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

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

بازگشت

Body - عنصر فعلی.

مجوز

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

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

as Date()

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

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

بازگشت

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

مجوز

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

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

as Equation()

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

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

بازگشت

Equation - عنصر فعلی.

مجوز

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

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

as Equation Function()

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

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

بازگشت

Equation Function - عنصر فعلی.

مجوز

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

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

as Equation Function Argument Separator()

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

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

بازگشت

Equation Function Argument Separator — عنصر فعلی.

مجوز

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

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

as Equation Symbol()

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

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

بازگشت

Equation Symbol - عنصر فعلی.

مجوز

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

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

as Footer Section()

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

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

بازگشت

Footer Section - عنصر فعلی.

مجوز

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

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

as Footnote()

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

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

بازگشت

Footnote — عنصر فعلی.

مجوز

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

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

as Footnote Section()

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

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

بازگشت

Footnote Section - عنصر فعلی.

مجوز

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

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

as Header Section()

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

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

بازگشت

Header Section - عنصر فعلی.

مجوز

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

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

as Horizontal Rule()

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

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

بازگشت

Horizontal Rule - عنصر فعلی.

مجوز

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

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

as Inline Drawing()

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

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

بازگشت

Inline Drawing - عنصر فعلی.

مجوز

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

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

as Inline Image()

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

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

بازگشت

Inline Image - عنصر فعلی.

مجوز

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

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

as List Item()

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

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

بازگشت

List Item - عنصر فعلی.

مجوز

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

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

as Page Break()

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

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

بازگشت

Page Break - عنصر فعلی.

مجوز

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

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

as Paragraph()

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

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

بازگشت

Paragraph - عنصر فعلی.

مجوز

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

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

as Person()

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

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

بازگشت

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

مجوز

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

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

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

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

بازگشت

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

مجوز

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

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

as Table()

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

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

بازگشت

Table - عنصر فعلی.

مجوز

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

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

as Table Cell()

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

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

بازگشت

Table Cell - عنصر فعلی.

مجوز

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

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

as Table Of Contents()

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

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

بازگشت

Table Of Contents - عنصر فعلی.

مجوز

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

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

as Table Row()

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

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

بازگشت

Table Row - عنصر فعلی.

مجوز

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

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

as Text()

عنصر فعلی را به عنوان یک 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

get Attributes()

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

نتیجه، یک شیء حاوی یک ویژگی برای هر ویژگی عنصر معتبر است که در آن هر نام ویژگی با یک آیتم در شمارش Document App.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

get Next Sibling()

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

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

بازگشت

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

مجوز

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

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

get Parent()

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

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

بازگشت

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

مجوز

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

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

get Previous Sibling()

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

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

بازگشت

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

مجوز

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

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

get Type()

Element Type را بازیابی می‌کند.

برای تعیین نوع دقیق یک عنصر داده شده، get Type() استفاده کنید.

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

بازگشت

Element Type - نوع عنصر.

مجوز

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

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

is At Document End()

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

بازگشت

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

مجوز

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

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

merge()

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

فقط عناصری که از Element Type یکسانی هستند می‌توانند ادغام شوند. هر عنصر فرزندی که در عنصر فعلی قرار داشته باشد، به عنصر خواهر و برادر قبلی منتقل می‌شود.

عنصر فعلی از سند حذف می‌شود.

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

remove From Parent()

عنصر را از والدش حذف می‌کند.

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

set Attributes(attributes)

ویژگی‌های عنصر را تنظیم می‌کند.

پارامتر ویژگی‌های مشخص‌شده باید یک شیء باشد که در آن نام هر ویژگی، یک آیتم در شمارش Document App.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