المحتوى النصي
المحتوى النصي العام يجب أن يكون النص بتنسيق متوافق (مثل مربّع نص أو مستطيل) أو خلية في جدول في الصفحة.
تمثيل JSON |
---|
{ "textElements": [ { object ( |
الحقول | |
---|---|
textElements[]
|
محتوى النص مُقسَّم إلى أجزاء المكوّنات، بما في ذلك معلومات النمط. هذا الموقع للقراءة فقط. |
lists
|
القوائم النقطية المضمّنة في هذا النص، المرتبطة برقم تعريف القائمة. |
عنصر نصي
يصف TextElement محتوى مجموعة من الفهارس في المحتوى النصي لأحد الأشكال أو الخلايا.
تمثيل JSON |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
الحقول | |
---|---|
startIndex
|
فهرس البدء المستند إلى الصفر لهذا العنصر النصي بوحدات رموز يونيكود. |
endIndex
|
فهرس النهاية المستند إلى الصفر لهذا العنصر النصي الحصري في وحدات رموز يونيكود. |
حقل الاتحاد
kind . نوع النص الذي يمثله هذا العنصر.
يمكن أن تكون السمة kind
واحدة فقط من العناصر التالية:
|
|
paragraphMarker
|
علامة تمثّل بداية فقرة جديدة
تمثّل السمة |
textRun
|
عنصر نصي يمثّل جزءًا من نص حيث تكون جميع الأحرف في عامل التشغيل متطابقة مع
إنّ السمتَين |
autoText
|
عنصر نصي يمثّل موضعًا في النص يتم استبداله ديناميكيًا بمحتوى يمكن أن يتغيّر بمرور الوقت |
مُحدِّد الفقرة
تمثّل هذه السمة نوع TextElement الذي يمثّل بداية فقرة جديدة.
تمثيل JSON |
---|
{ "style": { object ( |
الحقول | |
---|---|
style
|
نمط الفقرة |
bullet
|
تعداد نقطي لهذه الفقرة إذا لم تكن موجودة، لا تنتمي الفقرة إلى قائمة. |
نمط الفقرة
الأنماط التي تنطبق على الفقرة بالكامل.
إذا كان هذا النص مضمّنًا في عنصر رئيسي
placeholder
، قد يتم اكتساب أنماط الفقرة هذه من العنصر الرئيسي. تعتمد أنماط الفقرة المكتسَبة على مستوى دمج القوائم:
- ستكتسب الفقرة غير الموجودة في القائمة نمط الفقرة الخاص بها من المستوى 0 لدمج القائمة في العنصر النائب الرئيسي.
- ستكتسب الفقرة المُدرجة في القائمة نمط الفقرة الخاص بها في مستوى التداخل المقابل لهذه القائمة داخل العنصر النائب الرئيسي.
يتم تمثيل أنماط الفقرة المكتسبة كحقول لم يتم ضبطها في هذه الرسالة.
تمثيل JSON |
---|
{ "lineSpacing": number, "alignment": enum ( |
الحقول | |
---|---|
lineSpacing
|
مقدار المسافة بين السطور، كنسبة مئوية، حيث يتم تمثيل الحالة على النحو التالي 100.0. في حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
alignment
|
محاذاة النص لهذه الفقرة. |
indentStart
|
مقدار المسافة البادئة للفقرة على الجانب الذي يتوافق مع بداية النص، بناءً على اتجاه النص الحالي. في حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
indentEnd
|
مقدار المسافة البادئة للفقرة على الجانب الذي يتوافق مع نهاية النص، بناءً على اتجاه النص الحالي. في حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
spaceAbove
|
مقدار المساحة الإضافية فوق الفقرة. في حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
spaceBelow
|
مقدار المساحة الإضافية أسفل الفقرة. في حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
indentFirstLine
|
مقدار المسافة البادئة لبداية السطر الأول من الفقرة. في حال ترك هذه السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي. |
direction
|
اتجاه النص في هذه الفقرة. في حال ترك السياسة بدون ضبط، يتم ضبط القيمة تلقائيًا على
|
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 (
|
الحقول | |
---|---|
listId
|
رقم تعريف القائمة التي تنتمي إليها هذه الفقرة. |
nestingLevel
|
مستوى دمج هذه الفقرة في القائمة. |
glyph
|
الرمز الرسومي المعروض للفقرة النقطية المعروضة |
bulletStyle
|
نمط النص الخاص بالفقرة الذي تم تطبيقه على عنصر القائمة النقطية هذا. |
نمط النص
تمثل النمط الذي يمكن تطبيقه على TextRun.
إذا كان هذا النص مضمّنًا في شكل رئيسي
placeholder
، قد يتم اكتساب هذه الأنماط النصية من العنصر الرئيسي. تعتمد أنماط النص المكتسَبة على مستوى دمج القوائم:
- إنّ النص الذي يتم تنفيذه في فقرة غير المُدرَجة في القائمة سيكتسب نمط النص الخاص به من حرف السطر الجديد في الفقرة عند مستوى التداخل في القائمة داخل العنصر النائب الرئيسي.
- سيكتسب النص الذي يتم تشغيله في فقرة في القائمة نمط النص الخاص به من الحرف الجديد في الفقرة في مستوى التداخل المقابل للقائمة داخل العنصر النائب الرئيسي.
يتم تمثيل أنماط النص المكتسَبة كحقول بدون ضبط في هذه الرسالة. في حال تضمين نص في شكل بدون عنصر نائب رئيسي، سيؤدي إلغاء ضبط هذه الحقول إلى إعادة النمط إلى قيمة تتطابق مع الإعدادات التلقائية في محرِّر "العروض التقديمية من Google".
تمثيل JSON |
---|
{ "backgroundColor": { object ( |
الحقول | |
---|---|
backgroundColor
|
لون خلفية النص في حال ضبط هذه السياسة، يكون اللون إما مبهمًا أو شفافًا، استنادًا إلى ما إذا كان الحقل
|
foregroundColor
|
لون النص نفسه. في حال ضبط هذه السياسة، يكون اللون إما مبهمًا أو شفافًا، استنادًا إلى ما إذا كان الحقل
|
bold
|
يشير ذلك إلى ما إذا كان النص سيظهر بخط غامق أم لا. |
italic
|
ما إذا كان النص مائلاً أم لا. |
fontFamily
|
مجموعة الخطوط للنص.
يمكن أن تكون مجموعة الخطوط أي خط من قائمة الخطوط في "العروض التقديمية من Google" أو من
Google Fonts. إذا لم يتم التعرّف على اسم الخط، يتم عرض النص باللغة
قد تؤثر بعض الخطوط في كثافة النص. إذا حدّد طلب التعديل قيمتَي
|
fontSize
|
حجم خط النص. عند القراءة، سيتم تحديد السمة |
link
|
وجهة الرابط التشعّبي للنص. وفي حال تم ترك السياسة بدون ضبط، لن يتم إدراج أي رابط. لا يتم اكتساب الروابط من النص الرئيسي. يؤدي تغيير الرابط في طلب التعديل إلى إجراء بعض التغييرات الأخرى على نمط النص في النطاق:
|
baselineOffset
|
إزاحة موضع النص من موضعه العادي.
يتم تلقائيًا عرض إزاحة خط
|
smallCaps
|
تحديد ما إذا كان النص مكتوبًا بأحرف كبيرة صغيرة أم لا. |
strikethrough
|
لتحديد ما إذا كان النص قد تعرّض لإنذارات أم لا. |
underline
|
يشير هذا إلى ما إذا كان قد تم وضع خط تحته أم لا. |
weightedFontFamily
|
مجموعة الخطوط ووزن النص المعروض.
هذا الحقل هو امتداد
إذا حدّد طلب التعديل قيمتَي
وإذا لم يتم ضبط السمة
في حال ضبط السمة |
ألوان اختيارية
لون يمكن أن يكون شفافًا أو معتمًا بالكامل
تمثيل JSON |
---|
{
"opaqueColor": {
object (
|
الحقول | |
---|---|
opaqueColor
|
في حال ضبط السياسة، سيتم استخدام هذا اللون كلون مبهم. في حال ترك هذه السياسة بدون ضبط، يشير ذلك إلى لون شفاف. |
مجموعة بيانات أساسية
الطرق التي يمكن من خلالها إزاحة النص رأسيًا من موضعه العادي.
عمليات التعداد | |
---|---|
BASELINE_OFFSET_UNSPECIFIED
|
تتم الاستعانة بالإزاحة المرجعية للنص من العنصر الرئيسي. |
NONE
|
لم يتم معادلة النص عموديًا. |
SUPERSCRIPT
|
تمت إزاحة النص عموديًا للأعلى (نص مرتفع). |
SUBSCRIPT
|
تتم إزاحة النص عموديًا للأسفل (نص منخفض). |
عائلة من الوزن
تمثّل مجموعة خطوط ووزن مُستخدَم لإنشاء نمط TextRun.
تمثيل JSON |
---|
{ "fontFamily": string, "weight": integer } |
الحقول | |
---|---|
fontFamily
|
مجموعة الخطوط للنص.
يمكن أن تكون مجموعة الخطوط أي خط من قائمة الخطوط في "العروض التقديمية من Google" أو من
Google Fonts. إذا لم يتم التعرّف على اسم الخط، يتم عرض النص باللغة
|
weight
|
تمثّل هذه السمة الحجم المعروض للنص. يمكن أن يتضمّن هذا الحقل أيًا من مضاعفات
|
تشغيل النص
تمثّل هذه السمة نوع TextElement الذي يمثّل مجموعة من النصوص لها النمط نفسه.
تمثيل JSON |
---|
{
"content": string,
"style": {
object (
|
الحقول | |
---|---|
content
|
تمثّل هذه السمة نص هذا الدور. |
style
|
النمط الذي تم تطبيقه على عملية التشغيل هذه. |
نص تلقائي
نوع عنصر نصي يمثّل النص التلقائي.
تمثيل JSON |
---|
{ "type": enum ( |
الحقول | |
---|---|
type
|
نوع هذا النص التلقائي. |
content
|
المحتوى المعروض لهذا النص التلقائي، في حال توفره. |
style
|
النمط المطبّق على هذا النص التلقائي. |
Type
أنواع النص التلقائي
عمليات التعداد | |
---|---|
TYPE_UNSPECIFIED
|
نوع نص تلقائي غير محدّد |
SLIDE_NUMBER
|
اكتب نصًا تلقائيًا يمثّل رقم الشريحة الحالية. |
قائمة
توضّح القائمة شكل الرموز النقطية التي تعود إلى الفقرات المرتبطة بالقائمة ومضمونها. تتضمن الفقرة التي تكون جزءًا من قائمة مرجعًا ضمنيًا لرقم تعريف تلك القائمة.
تمثيل JSON |
---|
{
"listId": string,
"nestingLevel": {
integer: {
object (
|
الحقول | |
---|---|
listId
|
رقم تعريف القائمة. |
nestingLevel
|
خريطة لمستويات الدمج إلى خصائص الرمز النقطي على المستوى المرتبط. تحتوي القائمة على تسعة مستويات كحد أقصى من عمليات الدمج، لذا تتراوح القيم المحتملة لمفاتيح هذه الخريطة من 0 إلى 8، بما في ذلك القيمتين. |
مستوى Nesting
تحتوي على خصائص تصف شكل وأسلوب القائمة النقطية على مستوى معيّن من التداخل.
تمثيل JSON |
---|
{
"bulletStyle": {
object (
|
الحقول | |
---|---|
bulletStyle
|
نمط التعداد النقطي على مستوى الدمج هذا. |