Text

文本内容

一般性文字内容。文本必须位于兼容的形状(例如文本框或矩形)或网页中的表单元格中。

JSON 表示法
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
字段
textElements[]

object (TextElement)

将文本内容细分为组件部分,包括样式信息。此属性为只读属性。

lists

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

此文本中包含的项目符号列表,由列表 ID 键控。

文本元素

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

此文本元素的起始索引(从零开始),以 Unicode 代码单元的形式表示。

endIndex

integer

此文本元素的结束索引(从零开始,采用 Unicode 代码单元)。

联合字段 kind。此元素所代表的文本的类型。 kind 只能是下列其中一项:
paragraphMarker

object (ParagraphMarker)

表示新段落开头的标记。

此 TextElement 的 startIndexendIndex 表示段落的范围。其他索引范围包含在此段落范围内的 TextElement 会被视为此段落的一部分。两个不同段落的索引范围绝不会重叠。

textRun

object (TextRun)

一个表示文本运行的文本元素,该文本运行中的所有字符都具有相同的 TextStyle

TextRun 的 startIndexendIndex 将始终完全包含在单个 paragraphMarker TextElement 的索引范围内。换句话说,TextRun 绝不会跨越多个段落。

autoText

object (AutoText)

一个文本元素,表示文本中的一个点会动态地替换为随时间变化的内容。

ParagraphMarker

表示新段落开头的文本元素。

JSON 表示法
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
字段
style

object (ParagraphStyle)

段落的样式

bullet

object (Bullet)

此段落的项目符号。如果不存在,该段落不属于任何列表。

ParagraphStyle

适用于整个段落的样式。

如果此文本包含在具有父项 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 段落行与行末对齐。对于 LTR 文本,则为右对齐;否则为左对齐。
JUSTIFIED 段落已两端对齐。

文本方向

文本文本可以在其中流入。

枚举
TEXT_DIRECTION_UNSPECIFIED 文本方向从父项继承。
LEFT_TO_RIGHT 文本从左向右书写。
RIGHT_TO_LEFT 文本从右向左移动。

SpacingMode

段落间距的不同模式。

枚举
SPACING_MODE_UNSPECIFIED 间距模式继承自父项。
NEVER_COLLAPSE 始终会呈现段落间距。
COLLAPSE_LISTS 系统会跳过列表元素之间的段落间距。

要点

描述段落项目符号。

JSON 表示法
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
字段
listId

string

此段落所属的列表的 ID。

nestingLevel

integer

此段落在列表中的嵌套级别。

glyph

string

此段落的渲染项目符号。

bulletStyle

object (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

文本的字体系列。

字体系列可以是 Google 幻灯片中“字体”菜单中的任何字体,也可以是 Google Fonts 中的字体。如果无法识别字体名称,文本将在 Arial 中呈现。

某些字体可能会影响文本粗细。如果更新请求同时为 fontFamilybold 指定值,系统将使用明确设置的 bold 值。

fontSize

object (Dimension)

文本字体大小。读取时,系统会以点为单位指定 fontSize

baselineOffset

enum (BaselineOffset)

文本到其正常位置的垂直偏移量。

SUPERSCRIPTSUBSCRIPT 基线偏移为文本自动以较小的字号渲染,该字体根据 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 的字体系列和粗细。
  • 如果这两个字段均未设置,则字体的字体和粗细会继承父元素的字体。请注意,这些属性不能单独继承。

如果更新请求同时为 weightedFontFamilybold 指定值,则先应用 weightedFontFamily,然后再应用 bold

如果未设置 weightedFontFamily#weight,则默认为 400

如果设置了 weightedFontFamily,则还必须将 weightedFontFamily#fontFamily 设置为非空值。否则,将返回 400 错误请求错误。

OptionalColor

可以是完全不透明或完全透明的颜色。

JSON 表示法
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
字段
opaqueColor

object (OpaqueColor)

如果设置此标记,此颜色将用作不透明颜色。如果未设置,则表示透明。

BaselineOffset

文本垂直于其正常位置的方式。

枚举
BASELINE_OFFSET_UNSPECIFIED 文本的基线偏移量继承自父文本。
NONE 文本未垂直偏移。
SUPERSCRIPT 文本垂直上移(上标)。
SUBSCRIPT 文本垂直下移(下标)。

WeightedFontFamily

表示用于设置 TextRun 样式的字体系列和粗细。

JSON 表示法
{
  "fontFamily": string,
  "weight": integer
}
字段
fontFamily

string

文本的字体系列。

字体系列可以是 Google 幻灯片中“字体”菜单中的任何字体,也可以是 Google Fonts 中的字体。如果无法识别字体名称,文本将在 Arial 中呈现。

weight

integer

文本的渲染粗细。此字段的值可以是 100 100900(含)之间的任何值。此范围对应于 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_UNSPECIFIED 未指定的自动文本类型。
SLIDE_NUMBER 代表当前幻灯片编号的自动输入类型。

列表

列表描述属于列表所含段落的项目符号的外观和风格。属于某个列表的段落有隐式引用该列表的 ID。

JSON 表示法
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
字段
listId

string

列表的 ID。

nestingLevel

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

关联级别与关联级别的项目符号属性的映射。一个列表最多只能有 9 层嵌套,因此该映射的键的可能值为 0 至 8(含 0 和 8)。

NestingLevel

包含描述列表项在给定嵌套级别的外观和风格的属性。

JSON 表示法
{
  "bulletStyle": {
    object (TextStyle)
  }
}
字段
bulletStyle

object (TextStyle)

此嵌套级别的项目符号样式。