Text

المحتوى النصي

المحتوى النصي العام يجب أن يكون النص بتنسيق متوافق (مثل مربّع نص أو مستطيل) أو خلية في جدول في الصفحة.

تمثيل JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
الحقول
textElements[]

object (TextElement)

محتوى النص مُقسَّم إلى أجزاء المكوّنات، بما في ذلك معلومات النمط. هذا الموقع للقراءة فقط.

lists

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

القوائم النقطية المضمّنة في هذا النص، المرتبطة برقم تعريف القائمة.

عنصر نصي

يصف TextElement محتوى مجموعة من الفهارس في المحتوى النصي لأحد الأشكال أو الخلايا.

تمثيل 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 لهذا العنصر النصي نطاق الفقرة. تعتبر العناصر النصية الأخرى التي لها نطاق فهرس مضمّن في نطاق هذه الفقرة جزءًا من هذه الفقرة. لن يتداخل نطاق الفهارس من فقرتين منفصلتين مطلقًا.

textRun

object (TextRun)

عنصر نصي يمثّل جزءًا من نص حيث تكون جميع الأحرف في عامل التشغيل متطابقة مع TextStyle.

إنّ السمتَين startIndex وendIndex من TextRuns ستكون دائمًا مضمّنة بشكل كامل في نطاق الفهرس لعنصر paragraphMarker واحد. TextElement. وبعبارة أخرى، لن يمتد TextRun مطلقًا على مستوى فقرات متعددة.

autoText

object (AutoText)

عنصر نصي يمثّل موضعًا في النص يتم استبداله ديناميكيًا بمحتوى يمكن أن يتغيّر بمرور الوقت

مُحدِّد الفقرة

تمثّل هذه السمة نوع 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)

وضع التباعد للفقرة.

محاذاة

تمثّل هذه السمة أنواع محاذاة النص للفقرة.

عمليات التعداد
ALIGNMENT_UNSPECIFIED يتم اكتساب محاذاة الفقرة من العنصر الرئيسي.
START تتم محاذاة الفقرة مع بداية السطر. تمت المحاذاة إلى اليسار للنص في LTR، تمت المحاذاة إلى اليمين بدلاً من ذلك.
CENTER يتم توسيط الفقرة.
END تتم محاذاة الفقرة مع نهاية السطر. تمت المحاذاة إلى اليمين للنص من اليسار إلى اليمين، تمت المحاذاة إلى اليمين بخلاف ذلك.
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، قد يتم اكتساب هذه الأنماط النصية من العنصر الرئيسي. تعتمد أنماط النص المكتسَبة على مستوى دمج القوائم:

  • إنّ النص الذي يتم تنفيذه في فقرة غير المُدرَجة في القائمة سيكتسب نمط النص الخاص به من حرف السطر الجديد في الفقرة عند مستوى التداخل في القائمة داخل العنصر النائب الرئيسي.
  • سيكتسب النص الذي يتم تشغيله في فقرة في القائمة نمط النص الخاص به من الحرف الجديد في الفقرة في مستوى التداخل المقابل للقائمة داخل العنصر النائب الرئيسي.

يتم تمثيل أنماط النص المكتسَبة كحقول بدون ضبط في هذه الرسالة. في حال تضمين نص في شكل بدون عنصر نائب رئيسي، سيؤدي إلغاء ضبط هذه الحقول إلى إعادة النمط إلى قيمة تتطابق مع الإعدادات التلقائية في محرِّر "العروض التقديمية من Google".

تمثيل 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

مجموعة الخطوط للنص.

يمكن أن تكون مجموعة الخطوط أي خط من قائمة الخطوط في "العروض التقديمية من Google" أو من 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)

في حال ضبط السياسة، سيتم استخدام هذا اللون كلون مبهم. في حال ترك هذه السياسة بدون ضبط، يشير ذلك إلى لون شفاف.

مجموعة بيانات أساسية

الطرق التي يمكن من خلالها إزاحة النص رأسيًا من موضعه العادي.

عمليات التعداد
BASELINE_OFFSET_UNSPECIFIED تتم الاستعانة بالإزاحة المرجعية للنص من العنصر الرئيسي.
NONE لم يتم معادلة النص عموديًا.
SUPERSCRIPT تمت إزاحة النص عموديًا للأعلى (نص مرتفع).
SUBSCRIPT تتم إزاحة النص عموديًا للأسفل (نص منخفض).

عائلة من الوزن

تمثّل مجموعة خطوط ووزن مُستخدَم لإنشاء نمط TextRun.

تمثيل JSON 
{
  "fontFamily": string,
  "weight": integer
}
الحقول
fontFamily

string

مجموعة الخطوط للنص.

يمكن أن تكون مجموعة الخطوط أي خط من قائمة الخطوط في "العروض التقديمية من Google" أو من 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)

النمط الذي تم تطبيقه على عملية التشغيل هذه.

نص تلقائي

نوع عنصر نصي يمثّل النص التلقائي.

تمثيل JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
الحقول
type

enum (Type)

نوع هذا النص التلقائي.

content

string

المحتوى المعروض لهذا النص التلقائي، في حال توفره.

style

object (TextStyle)

النمط المطبّق على هذا النص التلقائي.

Type

أنواع النص التلقائي

عمليات التعداد
TYPE_UNSPECIFIED نوع نص تلقائي غير محدّد
SLIDE_NUMBER اكتب نصًا تلقائيًا يمثّل رقم الشريحة الحالية.

قائمة

توضّح القائمة شكل الرموز النقطية التي تعود إلى الفقرات المرتبطة بالقائمة ومضمونها. تتضمن الفقرة التي تكون جزءًا من قائمة مرجعًا ضمنيًا لرقم تعريف تلك القائمة.

تمثيل JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
الحقول
listId

string

رقم تعريف القائمة.

nestingLevel

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

خريطة لمستويات الدمج إلى خصائص الرمز النقطي على المستوى المرتبط. تحتوي القائمة على تسعة مستويات كحد أقصى من عمليات الدمج، لذا تتراوح القيم المحتملة لمفاتيح هذه الخريطة من 0 إلى 8، بما في ذلك القيمتين.

مستوى Nesting

تحتوي على خصائص تصف شكل وأسلوب القائمة النقطية على مستوى معيّن من التداخل.

تمثيل JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
الحقول
bulletStyle

object (TextStyle)

نمط التعداد النقطي على مستوى الدمج هذا.