Text

Contenu textuel

Contenu textuel général. Le texte doit se trouver dans une forme compatible (zone de texte ou rectangle, par exemple) ou dans une cellule de tableau d'une page.

Représentation JSON
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Champs
textElements[]

object (TextElement)

Le contenu textuel se compose de ses différentes parties, y compris les informations de style. Cette propriété est en lecture seule.

lists

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

Liste à puces contenue dans ce texte, associée à un ID de liste.

TextElement

Un élément TextElement décrit le contenu d'une plage d'indices dans le contenu textuel d'une forme ou d'une table.

Représentation 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.
}
Champs
startIndex

integer

Index de début de base zéro de cet élément textuel, en unités de code Unicode.

endIndex

integer

Index de fin basé sur zéro de cet élément textuel, exclusif, en unités de code Unicode.

Champ d'union kind. Type de texte représenté par cet élément. kind ne peut être que l'un des éléments suivants:
paragraphMarker

object (ParagraphMarker)

Repère représentant le début d'un nouveau paragraphe.

Les startIndex et endIndex de cet élément TextElement représentent la plage du paragraphe. Les autres éléments TextElement dont la plage d'index est comprise dans la plage de ce paragraphe sont considérés comme faisant partie de ce paragraphe. La plage d'index de deux paragraphes distincts ne se chevauchera jamais.

textRun

object (TextRun)

Élément TextText représentant une exécution de texte dont tous les caractères de l'exécution ont le même TextStyle.

Les startIndex et endIndex de TextRuns seront toujours entièrement incluses dans la plage d'index d'un seul élément de texte paragraphMarker. En d'autres termes, un TextRun ne couvre jamais plusieurs paragraphes.

autoText

object (AutoText)

Élément TextElement représentant un espace dans le texte qui est remplacé dynamiquement par un contenu qui peut changer au fil du temps.

Paragraphe

Genre TextElement représentant le début d'un nouveau paragraphe.

Représentation JSON
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Champs
style

object (ParagraphStyle)

Style du paragraphe

bullet

object (Bullet)

Puce pour ce paragraphe. S'il n'est pas présent, le paragraphe n'appartient pas à une liste.

ParagraphStyle

Styles qui s'appliquent à un paragraphe entier.

Si ce texte est contenu dans une forme ayant un placeholder parent, ces styles de paragraphe peuvent être hérités du parent. Les styles de paragraphe hérités dépendent du niveau d'imbrication des listes:

  • Un paragraphe qui n'apparaît pas dans une liste hérite du style de paragraphe appliqué au niveau d'imbrication 0 de la liste dans l'espace réservé parent.
  • Un paragraphe hérite du style qui lui est associé à partir du paragraphe, au niveau d'imbrication correspondant dans l'espace réservé parent.

Les styles de paragraphe hérités sont représentés par des champs non définis dans ce message.

Représentation 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)
}
Champs
lineSpacing

number

Quantité d'espace entre des lignes, sous la forme d'un pourcentage de normal, le normal étant représenté par 100.0. Si cette règle n'est pas configurée, la valeur est héritée du parent.

alignment

enum (Alignment)

Alignement du texte pour ce paragraphe.

indentStart

object (Dimension)

Nombre de retraits du paragraphe sur le côté correspondant au début du texte, en fonction de la direction actuelle du texte. Si cette règle n'est pas configurée, la valeur est héritée du parent.

indentEnd

object (Dimension)

Nombre de retraits du paragraphe sur le côté correspondant à la fin du texte, en fonction de la direction actuelle du texte. Si cette règle n'est pas configurée, la valeur est héritée du parent.

spaceAbove

object (Dimension)

Il s'agit de la quantité d'espace supplémentaire au-dessus du paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

spaceBelow

object (Dimension)

Il s'agit de la quantité d'espace supplémentaire sous le paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

indentFirstLine

object (Dimension)

Niveau de retrait du début de la première ligne du paragraphe. Si cette règle n'est pas configurée, la valeur est héritée du parent.

direction

enum (TextDirection)

Sens du texte de ce paragraphe. Si cette valeur n'est pas définie, la valeur par défaut est LEFT_TO_RIGHT, car l'orientation du texte n'est pas héritée.

spacingMode

enum (SpacingMode)

Mode d'espacement pour le paragraphe.

Alignement

Types d'alignement du texte d'un paragraphe.

Enums
ALIGNMENT_UNSPECIFIED L'alignement du paragraphe est hérité de l'élément parent.
START Le paragraphe est aligné par rapport au début de la ligne. Aligné à gauche pour le texte de gauche à droite, sinon aligné à droite.
CENTER Le paragraphe est centré.
END Le paragraphe est aligné à la fin de la ligne. Aligné à droite pour le texte de gauche à droite, ou à gauche dans le cas contraire.
JUSTIFIED Le paragraphe est justifié.

Direction du texte

Le texte de l'itinéraire peut être transmis.

Enums
TEXT_DIRECTION_UNSPECIFIED L'orientation du texte est héritée de l'élément parent.
LEFT_TO_RIGHT Le texte va de gauche à droite.
RIGHT_TO_LEFT Le texte va de droite à gauche.

Mode espacement

Les différents modes d'espacement des paragraphes

Enums
SPACING_MODE_UNSPECIFIED Le mode d'espacement est hérité de l'élément parent.
NEVER_COLLAPSE L'espacement des paragraphes est toujours affiché.
COLLAPSE_LISTS L'espacement des paragraphes est ignoré entre les éléments de liste.

Puces

Décrit une puce de paragraphe.

Représentation JSON
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Champs
listId

string

ID de la liste à laquelle ce paragraphe appartient.

nestingLevel

integer

Niveau d'imbrication de ce paragraphe dans la liste.

glyph

string

Glyphe de puce affiché pour ce paragraphe.

bulletStyle

object (TextStyle)

Style de texte spécifique au paragraphe appliqué à cette puce.

TextStyle

Représente le style qui peut être appliqué à un TextRun.

Si ce texte est contenu dans une forme avec un parent placeholder, ces styles de texte peuvent être hérités du parent. Les styles de texte hérités dépendent du niveau d'imbrication des listes:

  • Un texte exécuté dans un paragraphe qui ne figure pas dans une liste héritera du style de texte du caractère de retour à la ligne dans le paragraphe au niveau d'imbrication 0 de la liste dans l'espace réservé parent.
  • Un texte exécuté dans un paragraphe qui se trouve dans une liste héritera du style de texte du caractère de retour à la ligne dans le paragraphe au niveau d'imbrication correspondant de la liste dans l'espace réservé parent.

Les styles de texte hérités sont représentés par des champs non définis dans ce message. Si le texte se trouve dans une forme sans espace réservé parent, le fait de désactiver ces champs rétablit le style à une valeur correspondant aux valeurs par défaut dans l'éditeur Slides.

Représentation 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)
  }
}
Champs
backgroundColor

object (OptionalColor)

Couleur d'arrière-plan du texte. Si cette option est définie, la couleur est opaque ou transparente, selon que le champ opaqueColor est défini ou non.

foregroundColor

object (OptionalColor)

Couleur du texte. Si cette option est définie, la couleur est opaque ou transparente, selon que le champ opaqueColor est défini ou non.

bold

boolean

Indique si le texte est en gras.

italic

boolean

Mettre le texte en italique

fontFamily

string

Famille de polices du texte.

La famille de polices peut être n'importe quelle police depuis le menu Police de Slides ou depuis Google Fonts. Si le nom de la police n'est pas reconnu, le texte est affiché dans Arial.

Certaines polices peuvent affecter l'épaisseur du texte. Si une requête de mise à jour spécifie des valeurs pour fontFamily et bold, la valeur bold définie explicitement est utilisée.

fontSize

object (Dimension)

Taille de la police du texte. Lors de sa lecture, le fontSize est spécifié en points.

baselineOffset

enum (BaselineOffset)

Décalage vertical du texte par rapport à sa position normale.

Le texte avec des décalages de référence SUPERSCRIPT ou SUBSCRIPT est automatiquement affiché dans une taille de police plus petite. Il est calculé en fonction du champ fontSize. Le fontSize lui-même n'est pas affecté par les modifications apportées à ce champ.

smallCaps

boolean

Indique si le texte est en petits caractères.

strikethrough

boolean

Indique si le texte est barré.

underline

boolean

Indique si le texte est souligné.

weightedFontFamily

object (WeightedFontFamily)

Famille de polices et épaisseur du texte affiché

Ce champ est une extension de fontFamily, conçu pour accepter les épaisseurs de police explicites sans rétrocompatibilité. Par conséquent, lorsque vous lisez le style d'une plage de texte, la valeur de weightedFontFamily#fontFamily est toujours égale à celle de fontFamily. Toutefois, lors de l'écriture, si les deux champs sont inclus dans le masque de champ (soit explicitement, soit via le caractère générique "*"), leurs valeurs sont rapprochées comme suit:

  • Si fontFamily est défini, mais que weightedFontFamily ne l'est pas, la valeur de fontFamily est appliquée avec la pondération 400 ("normal").
  • Si les deux champs sont définis, la valeur de fontFamily doit correspondre à celle de weightedFontFamily#fontFamily. Si tel est le cas, la famille de polices et l'épaisseur de la propriété weightedFontFamily sont appliquées. Sinon, une erreur 400 de requête incorrecte est renvoyée.
  • Si weightedFontFamily est défini, mais que fontFamily ne l'est pas, la famille de polices et l'épaisseur de weightedFontFamily sont appliquées.
  • Si aucun champ n'est défini, la famille de polices et l'épaisseur du texte héritent du parent. Notez que ces propriétés ne peuvent pas hériter séparément les unes des autres.

Si une requête de mise à jour spécifie des valeurs pour weightedFontFamily et bold, weightedFontFamily est appliqué en premier, puis bold.

Si weightedFontFamily#weight n'est pas défini, il est défini par défaut sur 400.

Si weightedFontFamily est défini, weightedFontFamily#fontFamily doit également être défini avec une valeur non vide. Sinon, une erreur 400 de requête incorrecte est renvoyée.

Couleur facultative

Couleur pouvant être soit opaque, soit totalement transparente.

Représentation JSON
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Champs
opaqueColor

object (OpaqueColor)

S'il est défini, il sera utilisé comme couleur opaque. Si la valeur n'est pas définie, il s'agit d'une couleur transparente.

BaselineOffset

Manières dont le texte peut être décalé verticalement de sa position normale.

Enums
BASELINE_OFFSET_UNSPECIFIED Le décalage de référence du texte est hérité de l'élément parent.
NONE Le texte n'est pas décalé verticalement.
SUPERSCRIPT Le texte est décalé verticalement vers le haut (en exposant).
SUBSCRIPT Le texte est décalé verticalement vers le bas (indice).

Famille de polices pondérées

Représente une famille de polices et l'épaisseur utilisées pour styliser un TextRun.

Représentation JSON
{
  "fontFamily": string,
  "weight": integer
}
Champs
fontFamily

string

Famille de polices du texte.

La famille de polices peut être n'importe quelle police depuis le menu Police de Slides ou depuis Google Fonts. Si le nom de la police n'est pas reconnu, le texte est affiché dans Arial.

weight

integer

Épaisseur du texte affiché. Ce champ peut contenir n'importe quelle valeur multiple d'100 comprise entre 100 et 900 inclus. Cette plage correspond aux valeurs numériques décrites dans la spécification CSS 2.1, section 15.6, avec les valeurs non numériques non autorisées. Les pondérations supérieures ou égales à 700 sont considérées comme étant en gras, contrairement à celles inférieures à 700. La valeur par défaut est 400 ("normal").

Exécution de texte

Genre TextElement représentant une exécution de texte ayant le même style.

Représentation JSON
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Champs
content

string

Texte de cette exécution.

style

object (TextStyle)

Style appliqué à cette exécution.

Texte automatique

Genre TextElement qui représente du texte automatique.

Représentation JSON
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Champs
type

enum (Type)

Type de texte automatique.

content

string

Contenu affiché de ce texte automatique, s'il est disponible.

style

object (TextStyle)

Style appliqué à ce texte automatique.

Type

Types de texte automatique

Enums
TYPE_UNSPECIFIED Type de texte automatique non spécifié.
SLIDE_NUMBER Saisissez du texte automatique qui représente le numéro de la diapositive actuelle.

Liste

Une liste décrit l'apparence des puces appartenant aux paragraphes associés. Un paragraphe qui fait partie d'une liste a une référence implicite à l'ID de la liste concernée.

Représentation JSON
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Champs
listId

string

ID de la liste.

nestingLevel

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

Carte des niveaux d'imbrication avec les propriétés des puces au niveau associé. Une liste ne comporte pas plus de neuf niveaux d'imbrication. Les valeurs possibles des clés de ce mappage sont donc comprises entre 0 et 8 inclus.

Niveau d'imbrication

Contient des propriétés décrivant l'apparence d'une liste à un niveau d'imbrication donné.

Représentation JSON
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Champs
bulletStyle

object (TextStyle)

Style de puce à ce niveau d'imbrication.