Text

محتوای متنی

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

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

object ( TextElement )

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

lists

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

لیست های گلوله ای موجود در این متن، با شناسه لیست کلید زده شده اند.

TextElement

یک TextElement محتوای طیف وسیعی از شاخص‌ها را در محتوای متنی Shape یا 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

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

kind میدان اتحادیه . نوع متنی که این عنصر نشان می دهد. kind می تواند تنها یکی از موارد زیر باشد:
paragraphMarker

object ( ParagraphMarker )

نشانگری که شروع یک پاراگراف جدید را نشان می دهد.

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

textRun

object ( TextRun )

یک TextElement که نشان دهنده یک متن است که در آن همه کاراکترهای اجرا دارای TextStyle یکسان هستند.

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

autoText

object ( AutoText )

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

ParagraphMarker

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

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

object ( ParagraphStyle )

سبک پاراگراف

bullet

object ( Bullet )

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

سبک پاراگراف

سبک هایی که برای کل یک پاراگراف کاربرد دارند.

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

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

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

نمایندگی 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

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

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 )

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

تراز

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

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

TextDirection

متن جهت ها می تواند در آن جریان یابد.

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

فاصله فاصله

حالت های مختلف برای فاصله پاراگراف.

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

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

TextStyle

نمایانگر استایلی است که می توان روی یک TextRun اعمال کرد.

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

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

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

نمایندگی 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 اعمال می شود. در غیر این صورت یک خطای درخواست بد 400 برگردانده می شود.
  • اگر weightedFontFamily تنظیم شده باشد و fontFamily تنظیم نشده باشد، خانواده فونت و وزن weightedFontFamily اعمال می شود.
  • اگر هیچ یک از فیلدها تنظیم نشده باشد، خانواده فونت و وزن متن از والد به ارث می رسد. توجه داشته باشید که این ویژگی ها نمی توانند جدا از یکدیگر ارث ببرند.

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

اگر weightedFontFamily#weight تنظیم نشده باشد، به طور پیش فرض روی 400 تنظیم می شود.

اگر weightedFontFamily تنظیم شده باشد، پس weightedFontFamily#fontFamily نیز باید با مقدار غیر خالی تنظیم شود. در غیر این صورت یک خطای درخواست بد 400 برگردانده می شود.

رنگ اختیاری

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

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

object ( OpaqueColor )

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

آفست پایه

روش هایی که در آنها می توان متن را به صورت عمودی از موقعیت عادی خود منحرف کرد.

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

WeightedFontFamily

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

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

string

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

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

weight

integer

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

TextRun

یک نوع 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 )

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

تایپ کنید

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

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

فهرست کنید

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

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

string

شناسه لیست

nestingLevel

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

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

NestingLevel

حاوی ویژگی هایی است که ظاهر و احساس یک گلوله لیست را در سطح معینی از تودرتو توصیف می کند.

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

object ( TextStyle )

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