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

אינדקס ההתחלה מבוסס האפס של רכיב הטקסט הזה, ביחידות קוד Unicode.

endIndex

integer

אינדקס הסיום מבוסס-האפס של רכיב הטקסט הזה, בלעדי, ביחידות קוד Unicode.

שדה איחוד kind. סוג הטקסט שרכיב זה מייצג. kind יכול להיות רק אחד מהבאים:
paragraphMarker

object (ParagraphMarker)

סמן שמייצג את תחילתה של פסקה חדשה.

הערכים startIndex ו-endIndex של TextElement זה מייצגים את הטווח של הפסקה. טקסטים אחרים עם טווח אינדקסים הנכללים בטווח פסקה זו נחשבים כחלק מפסקה זו. טווח האינדקסים של שתי פסקאות נפרדות לעולם לא יחפוף.

textRun

object (TextRun)

TextElement שמייצג הפעלת טקסט שבה לכל התווים במשחק יש אותו TextStyle.

startIndex ו-endIndex של TextRuns ייכללו תמיד בטווח האינדקסים של paragraphMarker TextElement. במילים אחרות, TextRun לעולם לא תפרש כמה פסקאות.

autoText

object (AutoText)

TextElement שמייצג נקודה בטקסט שמוחלת באופן דינמי בתוכן שעשוי להשתנות עם הזמן.

סימון פסקה

סוג TextElement שמייצג את תחילתה של פסקה חדשה.

ייצוג JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
שדות
style

object (ParagraphStyle)

סגנון הפסקה

bullet

object (Bullet)

התבליט לפסקה הזו. אם היא לא קיימת, הפסקה לא שייכת לרשימה.

סגנון פסקה

סגנונות שחלים על פסקה שלמה.

אם הטקסט הזה מופיע בצורת הורה placeholder, ייתכן שסגנונות הפסקה האלה יעברו בירושה מההורה. סגנונות הפסקה שיועברו בירושה תלויים ברמת הסידור של הרשימות:

  • פסקה שלא נכללת ברשימה תורשה להעביר את סגנון הפסקה שלה מפסקה ברמה 0 בתוך הרשימה בתוך ה-placeholder של ההורה.
  • פסקה ברשימה תורשה להעביר את סגנון הפסקה שלה מפסקה לרמת הדירוג שלה ברשימה בתוך ה-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

כמות הרווח בין השורות, כאחוז מהנורמלי, כאשר נורמלי מיוצג כ-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)

מצב הריווח עבור הפסקה.

יישור

סוגי היישור של טקסט לפיסקה.

טיפוסים בני מנייה (enum)
ALIGNMENT_UNSPECIFIED יישור הפסקה בירושה בירושה מהורה.
START הפיסקה מיושרת לתחילת השורה. יישור לשמאל עבור טקסט LTR, מיושר לימין אחרת.
CENTER הפיסקה ממורכזת.
END הפיסקה מיושרת לסוף השורה. יישור לימין עבור טקסט LTR, מיושר לשמאל אחרת.
JUSTIFIED הפסקה מוצדקת.

כיוון טקסט

הטקסט של המסלול יכול להיכנס פנימה.

טיפוסים בני מנייה (enum)
TEXT_DIRECTION_UNSPECIFIED כיוון הטקסט מתקבל בירושה מהורה.
LEFT_TO_RIGHT הטקסט נכתב משמאל לימין.
RIGHT_TO_LEFT הטקסט נכתב משמאל לימין.

מצב ריווח

המצבים השונים לריווח בין פסקאות.

טיפוסים בני מנייה (enum)
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, ייתכן שסגנונות הטקסט האלה יעברו בירושה מההורה. סגנונות הטקסט שהועברו בירושה תלויים ברמת הסידור של הרשימות:

  • טקסט שירוץ בפסקה שאינה ברשימה יורש את סגנון הטקסט שלו מהתו החדש של השורה בפסקה, ברמת הסידור הפנימי של הרשימה בתוך ה-placeholder של ההורה.
  • טקסט שירוץ בפסקה בתוך רשימה יורש את סגנון הטקסט שלו מהתו החדש בפסקה, ברמת ה-name של הרשימה, בתוך ה-placeholder הראשי.

סגנונות טקסט שעברו בירושה מיוצגים כשדות לא מוגדרים בהודעה הזו. אם הטקסט כלול בצורה שלא מכילה placeholder להורה, ביטול ההגדרה של השדות האלה יחזיר את הערך לערך ברירת המחדל בעורך ה-Slides.

ייצוג 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

משפחת הגופנים של הטקסט.

משפחת הגופנים יכולה להיות כל גופן בתפריט גופנים ב-Slides או מ-Google Fonts. אם שם הגופן לא מזוהה, הטקסט יוצג בתוך 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)

אם היא מוגדרת, הצבע הזה יהיה אטום. אם המדיניות לא מוגדרת, זה מייצג צבע שקוף.

קו בסיס

הדרכים שבהן ניתן לקזז טקסט בצורה אנכית מהמיקום הרגיל שלו.

טיפוסים בני מנייה (enum)
BASELINE_OFFSET_UNSPECIFIED הסטייה הבסיסית של הטקסט עוברת בירושה מההורה.
NONE הטקסט לא מקוזז באופן אנכי.
SUPERSCRIPT הטקסט מקוזז באופן אנכי למעלה (כתב עילי).
SUBSCRIPT הטקסט מקוזז באופן אנכי כלפי מטה (כתב תחתי).

משפחת הגופנים המשוקללים

מייצג את משפחת הגופנים ואת המשקל המשמשים לסגנון טקסט.

ייצוג JSON 
{
  "fontFamily": string,
  "weight": integer
}
שדות
fontFamily

string

משפחת הגופנים של הטקסט.

משפחת הגופנים יכולה להיות כל גופן בתפריט גופנים ב-Slides או מ-Google Fonts. אם שם הגופן לא מזוהה, הטקסט יוצג בתוך Arial.

weight

integer

משקל העיבוד של הטקסט. בשדה הזה יכול להיות כל ערך שהוא מכפיל של 100 בין 100 ל-900, כולל. הטווח הזה תואם לערכים המספריים המתוארים במפרט CSS 2.1, סעיף 15.6, שבו אסור להשתמש בערכים מספריים. משקלים שגדולים מ-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

סוגי הטקסט האוטומטי

טיפוסים בני מנייה (enum)
TYPE_UNSPECIFIED סוג של טקסט אוטומטי שאינו מוגדר.
SLIDE_NUMBER מקלידים לטקסט אוטומטי שמייצג את מספר השקף הנוכחי.

רשימה

רשימה מתארת את המראה והתחושה של תבליטים שמשויכים לפסקאות המשויכות לרשימה. בפסקה שהיא חלק מרשימה יש הפניה משתמעת למזהה של הרשימה.

ייצוג JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
שדות
listId

string

המזהה של הרשימה.

nestingLevel

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

מפה של רמות קינון למאפיינים של תבליטים ברמה המשויכת. לכל רשימה יש עד 9 רמות של קינון, כך שהערכים האפשריים למפתחות של המפה הזו הם 0 עד 8, כולל.

רמת סידור פנימי

מכיל מאפיינים שמתארים את התחושה והסגנון של תבליט רשימה ברמה נתונה, בתוך לוח זמנים.

ייצוג JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
שדות
bulletStyle

object (TextStyle)

הסגנון של תבליט ברמה הזו.