Text

محتوای متن

محتوای کلی متن. متن باید در یک شکل سازگار (مثلاً کادر متن یا مستطیل) یا یک سلول جدول در یک صفحه قرار گیرد.

نمایش JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
فیلدها
textElements[]

object ( TextElement )

محتوای متن به اجزای تشکیل‌دهنده‌اش، از جمله اطلاعات استایل، تجزیه می‌شود. این ویژگی فقط خواندنی است.

lists

map (key: string, value: object ( List ))

فهرست‌های نقطه‌دار موجود در این متن، که با شناسه فهرست مشخص شده‌اند.

عنصر متن

یک عنصر متن (TextElement) محتوای طیف وسیعی از شاخص‌ها را در محتوای متن یک شکل یا سلول جدول (TableCell) توصیف می‌کند.

نمایش JSON 
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
فیلدها
startIndex

integer

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

endIndex

integer

اندیس پایانی مبتنی بر صفر این عنصر متنی، منحصراً در واحدهای کد یونیکد.

فیلد Union kind . نوع متنی که این عنصر نشان می‌دهد. kind فقط می‌تواند یکی از موارد زیر باشد:
paragraphMarker

object ( ParagraphMarker )

نشانگری که آغاز یک پاراگراف جدید را نشان می‌دهد.

startIndex و endIndex این TextElement نشان دهنده محدوده پاراگراف هستند. سایر TextElement ها با محدوده اندیس موجود در محدوده این پاراگراف، بخشی از این پاراگراف در نظر گرفته می شوند. محدوده اندیس های دو پاراگراف جداگانه هرگز با هم همپوشانی نخواهند داشت.

textRun

object ( TextRun )

یک عنصر متن که نشان‌دهنده‌ی مجموعه‌ای از متن است که در آن تمام کاراکترهای موجود در آن، TextStyle یکسانی دارند.

startIndex و endIndex مربوط به TextRunها همیشه به طور کامل در محدوده‌ی اندیس یک paragraphMarker TextElement قرار می‌گیرند. به عبارت دیگر، یک TextRun هرگز چندین پاراگراف را در بر نمی‌گیرد.

autoText

object ( AutoText )

یک عنصر متن (TextElement) که نشان‌دهنده‌ی نقطه‌ای در متن است که به صورت پویا با محتوایی که می‌تواند در طول زمان تغییر کند، جایگزین می‌شود.

نشانگر پاراگراف

یک نوع TextElement که نشان دهنده شروع یک پاراگراف جدید است.

نمایش JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
فیلدها
style

object ( ParagraphStyle )

سبک پاراگراف

bullet

object ( Bullet )

علامت اختصاری برای این پاراگراف. اگر وجود نداشته باشد، پاراگراف به فهرست تعلق ندارد.

سبک پاراگراف

سبک‌هایی که برای کل یک پاراگراف اعمال می‌شوند.

اگر این متن در شکلی با یک placeholder والد قرار داشته باشد، آنگاه این سبک‌های پاراگراف ممکن است از والد به ارث برده شوند. اینکه کدام سبک‌های پاراگراف به ارث برده می‌شوند، به سطح تودرتوی لیست‌ها بستگی دارد:

  • پاراگرافی که در لیست نباشد، سبک پاراگراف خود را از پاراگرافی که در سطح تودرتوی ۰ لیست درون حفره‌ی والد قرار دارد، به ارث می‌برد.
  • یک پاراگراف در یک لیست، سبک پاراگراف خود را از پاراگرافی که در سطح تودرتوی مربوطه در لیست درون حفره یا سوراخ والد قرار دارد، به ارث می‌برد.

سبک‌های پاراگراف ارث‌بری‌شده در این پیام به صورت فیلدهای تنظیم‌نشده نمایش داده می‌شوند.

نمایش JSON 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
فیلدها
lineSpacing

number

مقدار فضای بین خطوط، به صورت درصدی از مقدار نرمال، که در آن مقدار نرمال به صورت ۱۰۰.۰ نمایش داده می‌شود. اگر مقدار آن تنظیم نشده باشد، مقدار از والد به ارث می‌رسد.

alignment

enum ( Alignment )

ترازبندی متن برای این پاراگراف.

indentStart

object ( Dimension )

میزان تورفتگی پاراگراف در سمتی که مربوط به شروع متن است، بر اساس جهت متن فعلی. اگر تنظیم نشده باشد، مقدار از والد به ارث می‌رسد.

indentEnd

object ( Dimension )

میزان تورفتگی پاراگراف در سمتی که مطابق با انتهای متن است، بر اساس جهت متن فعلی. اگر تنظیم نشده باشد، مقدار از والد به ارث می‌رسد.

spaceAbove

object ( Dimension )

مقدار فضای اضافی بالای پاراگراف. اگر تنظیم نشده باشد، مقدار از والد به ارث می‌رسد.

spaceBelow

object ( Dimension )

مقدار فضای اضافی زیر پاراگراف. اگر تنظیم نشده باشد، مقدار از والد به ارث می‌رسد.

indentFirstLine

object ( Dimension )

میزان تورفتگی برای شروع خط اول پاراگراف. اگر تنظیم نشود، مقدار از والد به ارث می‌رسد.

direction

enum ( TextDirection )

جهت متن این پاراگراف. اگر تنظیم نشده باشد، مقدار پیش‌فرض LEFT_TO_RIGHT است زیرا جهت متن به ارث برده نمی‌شود.

spacingMode

enum ( SpacingMode )

حالت فاصله‌گذاری برای پاراگراف.

ترازبندی

انواع ترازبندی متن برای یک پاراگراف

انوم‌ها
ALIGNMENT_UNSPECIFIED ترازبندی پاراگراف از والد به ارث می‌رسد.
START پاراگراف با شروع خط تراز می‌شود. برای متن LTR تراز چپ و در غیر این صورت تراز راست.
CENTER پاراگراف در مرکز قرار گرفته است.
END پاراگراف تا انتهای خط تراز می‌شود. برای متن LTR تراز راست و در غیر این صورت تراز چپ.
JUSTIFIED پاراگراف توجیه شده است.

جهت متن

متن مسیرها می‌تواند وارد شود.

انوم‌ها
TEXT_DIRECTION_UNSPECIFIED جهت متن از والد به ارث می‌رسد.
LEFT_TO_RIGHT متن از چپ به راست نوشته می‌شود.
RIGHT_TO_LEFT متن از راست به چپ نوشته می‌شود.

حالت فاصله‌گذاری

حالت‌های مختلف فاصله‌گذاری پاراگراف

انوم‌ها
SPACING_MODE_UNSPECIFIED حالت فاصله‌گذاری از والد به ارث می‌رسد.
NEVER_COLLAPSE فاصله پاراگراف همیشه رندر می‌شود.
COLLAPSE_LISTS فاصله پاراگراف بین عناصر لیست نادیده گرفته می‌شود.

گلوله

خلاصه یک پاراگراف را توصیف می‌کند.

نمایش JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
فیلدها
listId

string

شناسه‌ی فهرستی که این پاراگراف به آن تعلق دارد.

nestingLevel

integer

سطح تودرتوی این پاراگراف در لیست.

glyph

string

گلیف گلوله‌ای رندر شده برای این پاراگراف.

bulletStyle

object ( TextStyle )

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

سبک متن

نشان دهنده سبکی است که می‌تواند به یک TextRun اعمال شود.

اگر این متن در شکلی با یک placeholder والد قرار داشته باشد، آنگاه این سبک‌های متنی ممکن است از والد به ارث برده شوند. اینکه کدام سبک‌های متنی به ارث برده می‌شوند، به سطح تودرتوی لیست‌ها بستگی دارد:

  • متنی که در پاراگرافی اجرا می‌شود که در لیست نیست، سبک متن خود را از کاراکتر خط جدید در پاراگراف در سطح تودرتوی ۰ لیست درون حفره یا سوراخ والد به ارث می‌برد.
  • متنی که در پاراگرافی که در یک لیست قرار دارد اجرا می‌شود، سبک متن خود را از کاراکتر خط جدید در پاراگراف در سطح تودرتوی مربوطه در لیست درون حفره یا سوراخ والد به ارث می‌برد.

سبک‌های متن ارث‌بری‌شده در این پیام به صورت فیلدهای تنظیم‌نشده نمایش داده می‌شوند. اگر متن در شکلی بدون مکان‌نمای والد قرار داشته باشد، غیرفعال کردن این فیلدها، سبک را به مقداری مطابق با پیش‌فرض‌ها در ویرایشگر اسلایدها برمی‌گرداند.

نمایش JSON 
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
فیلدها
backgroundColor

object ( OptionalColor )

رنگ پس‌زمینه متن. در صورت تنظیم، بسته به اینکه فیلد opaqueColor در آن تنظیم شده باشد یا خیر، رنگ مات یا شفاف خواهد بود.

foregroundColor

object ( OptionalColor )

رنگ خود متن. در صورت تنظیم، بسته به اینکه فیلد opaqueColor در آن تنظیم شده باشد یا خیر، رنگ مات یا شفاف خواهد بود.

bold

boolean

اینکه متن به صورت پررنگ (بولد) نمایش داده شود یا خیر.

italic

boolean

اینکه متن به صورت مورب نوشته شود یا نه.

fontFamily

string

خانواده فونت متن.

خانواده فونت می‌تواند هر فونتی از منوی فونت در اسلایدها یا از فونت‌های گوگل باشد. اگر نام فونت شناسایی نشود، متن با Arial نمایش داده می‌شود.

برخی از فونت‌ها می‌توانند بر وزن متن تأثیر بگذارند. اگر درخواست به‌روزرسانی مقادیری را برای هر دو ویژگی fontFamily و bold مشخص کند، از مقدار bold که به صراحت تنظیم شده است استفاده می‌شود.

fontSize

object ( Dimension )

اندازه فونت متن. هنگام خواندن، fontSize بر حسب نقطه مشخص می‌شود.

baselineOffset

enum ( BaselineOffset )

انحراف عمودی متن از موقعیت عادی آن.

متن با آفست‌های خط پایه SUPERSCRIPT یا SUBSCRIPT به طور خودکار با اندازه فونت کوچکتری که بر اساس فیلد fontSize محاسبه می‌شود، رندر می‌شود. خود fontSize تحت تأثیر تغییرات در این فیلد قرار نمی‌گیرد.

smallCaps

boolean

اینکه متن با حروف بزرگ کوچک نوشته شود یا نه.

strikethrough

boolean

اینکه آیا متن خط خورده است یا خیر.

underline

boolean

اینکه آیا متن زیرخط‌دار است یا خیر.

weightedFontFamily

object ( WeightedFontFamily )

خانواده فونت و وزن رندر شده متن.

این فیلد، افزونه‌ای از fontFamily است که برای پشتیبانی از وزن‌های صریح فونت بدون نقض سازگاری معکوس در نظر گرفته شده است. به این ترتیب، هنگام خواندن سبک یک محدوده از متن، مقدار weightedFontFamily#fontFamily همیشه برابر با مقدار fontFamily خواهد بود. با این حال، هنگام نوشتن، اگر هر دو فیلد در ماسک فیلد گنجانده شده باشند (چه به صراحت و چه از طریق علامت "*" )، مقادیر آنها به شرح زیر تطبیق داده می‌شوند:

  • اگر fontFamily تنظیم شده باشد و weightedFontFamily تنظیم نشده باشد، مقدار fontFamily با وزن 400 ("عادی") اعمال می‌شود.
  • اگر هر دو فیلد تنظیم شده باشند، مقدار fontFamily باید با مقدار weightedFontFamily#fontFamily مطابقت داشته باشد. در این صورت، خانواده فونت و وزن weightedFontFamily اعمال می‌شود. در غیر این صورت، خطای درخواست بد ۴۰۰ بازگردانده می‌شود.
  • اگر weightedFontFamily تنظیم شده باشد و fontFamily تنظیم نشده باشد، خانواده فونت و وزن weightedFontFamily اعمال می‌شود.
  • اگر هیچ‌کدام از فیلدها تنظیم نشده باشند، خانواده فونت و وزن متن از والد به ارث می‌رسند. توجه داشته باشید که این ویژگی‌ها نمی‌توانند جداگانه از یکدیگر به ارث برسند.

اگر یک درخواست به‌روزرسانی، مقادیری را برای هر دو weightedFontFamily و bold مشخص کند، ابتدا weightedFontFamily اعمال می‌شود و سپس bold .

اگر weightedFontFamily#weight تنظیم نشده باشد، مقدار پیش‌فرض آن 400 است.

اگر weightedFontFamily تنظیم شده باشد، آنگاه weightedFontFamily#fontFamily نیز باید با مقداری غیر تهی تنظیم شود. در غیر این صورت، خطای درخواست نامناسب ۴۰۰ بازگردانده می‌شود.

رنگ اختیاری

رنگی که می‌تواند کاملاً مات یا کاملاً شفاف باشد.

نمایش JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
فیلدها
opaqueColor

object ( OpaqueColor )

اگر تنظیم شود، به عنوان رنگ مات استفاده می‌شود. اگر تنظیم نشود، به عنوان رنگ شفاف استفاده می‌شود.

افست پایه

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

انوم‌ها
BASELINE_OFFSET_UNSPECIFIED انحراف خط پایه متن از والد به ارث می‌رسد.
NONE متن به صورت عمودی جابجا نشده است.
SUPERSCRIPT متن به صورت عمودی به سمت بالا (بالانویس) قرار گرفته است.
SUBSCRIPT متن به صورت عمودی به سمت پایین (زیرنویس) جابجا می‌شود.

خانواده فونت وزن‌دار

نشان دهنده یک خانواده فونت و وزن مورد استفاده برای استایل‌دهی به یک TextRun است.

نمایش JSON 
{
  "fontFamily": string,
  "weight": integer
}
فیلدها
fontFamily

string

خانواده فونت متن.

خانواده فونت می‌تواند هر فونتی از منوی فونت در اسلایدها یا از فونت‌های گوگل باشد. اگر نام فونت شناسایی نشود، متن با Arial نمایش داده می‌شود.

weight

integer

وزن متن ارائه شده. این فیلد می‌تواند هر مقداری که مضربی از 100 باشد، بین 100 تا 900 ، شامل، داشته باشد. این محدوده مطابق با مقادیر عددی شرح داده شده در مشخصات CSS 2.1، بخش ۱۵.۶ است و مقادیر غیر عددی مجاز نیستند. وزن‌های بزرگتر یا مساوی 700 پررنگ در نظر گرفته می‌شوند و وزن‌های کمتر از 700 پررنگ نیستند. مقدار پیش‌فرض 400 ("عادی") است.

متن‌ران

یک نوع TextElement که نشان‌دهنده‌ی مجموعه‌ای از متن است که همگی سبک یکسانی دارند.

نمایش JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
فیلدها
content

string

متن این اجرا.

style

object ( TextStyle )

استایلی که برای این اجرا اعمال شده است.

متن خودکار

یک نوع TextElement که متن خودکار را نشان می‌دهد.

نمایش JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
فیلدها
type

enum ( Type )

نوع این متن خودکار.

content

string

محتوای رندر شده‌ی این متن خودکار، در صورت وجود.

style

object ( TextStyle )

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

نوع

انواع متن خودکار

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

فهرست

یک لیست، ظاهر و حس نشانه‌گذاری‌های (bullets) متعلق به پاراگراف‌های مرتبط با یک لیست را توصیف می‌کند. پاراگرافی که بخشی از یک لیست است، ارجاع ضمنی به شناسه (ID) آن لیست دارد.

نمایش JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
فیلدها
listId

string

شناسه‌ی لیست.

nestingLevel

map (key: integer, value: object ( NestingLevel ))

نقشه‌ای از سطوح تودرتو برای ویژگی‌های گلوله‌ها در سطح مرتبط. یک لیست حداکثر نه سطح تودرتو دارد، بنابراین مقادیر ممکن برای کلیدهای این نقشه شامل ۰ تا ۸ است.

سطح تودرتو

شامل ویژگی‌هایی است که ظاهر و حس یک فهرست بالت‌دار را در سطح مشخصی از چیدمان تودرتو توصیف می‌کنند.

نمایش JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
فیلدها
bulletStyle

object ( TextStyle )

سبک گلوله در این سطح از تودرتو بودن.