Text

Nội dung văn bản

Nội dung văn bản chung. Văn bản này phải nằm trong hình dạng tương thích (ví dụ: hộp văn bản hoặc hình chữ nhật) hoặc ô trong bảng trong trang.

Biểu diễn dưới dạng JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
Các trường
textElements[]

object (TextElement)

Nội dung văn bản được chia nhỏ thành các thành phần, bao gồm cả thông tin định kiểu. Thuộc tính này ở chế độ chỉ đọc.

lists

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

Danh sách có dấu đầu dòng nằm trong văn bản này, theo mã là danh sách.

Phần tử văn bản

TextElement mô tả nội dung của một loạt các chỉ mục trong nội dung văn bản của một Hình dạng hoặc TableCell.

Biểu diễn dưới dạng 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.
}
Các trường
startIndex

integer

Chỉ mục bắt đầu dựa trên 0 của phần tử văn bản này, bằng đơn vị mã Unicode.

endIndex

integer

Chỉ mục kết thúc dựa trên 0 của phần tử văn bản này, độc quyền, trong các đơn vị mã Unicode.

Trường nhóm kind. Loại văn bản mà phần tử này đại diện. kind chỉ có thể là một trong những loại sau đây:
paragraphMarker

object (ParagraphMarker)

Một điểm đánh dấu đại diện cho phần đầu của đoạn mới.

startIndex và endIndex của TextElement này đại diện cho phạm vi của đoạn. Các phần tử văn bản khác có phạm vi chỉ mục nằm trong phạm vi của đoạn này được coi là một phần của đoạn này. Phạm vi chỉ mục của hai đoạn riêng biệt sẽ không bao giờ trùng nhau.

textRun

object (TextRun)

Một TextElement đại diện cho một loạt văn bản trong đó tất cả các ký tự trong Run (Chạy) có cùng TextStyle.

startIndex và endIndex của TextRun sẽ luôn nằm hoàn toàn trong phạm vi chỉ mục của một paragraphMarker TextElement. Nói cách khác, TextRun sẽ không bao giờ kéo dài nhiều đoạn văn bản.

autoText

object (AutoText)

TextElement (Phần tử văn bản) đại diện cho một điểm trong văn bản được thay thế động bằng nội dung có thể thay đổi theo thời gian.

Công cụ đánh dấu đoạn

Loại TextElement đại diện cho phần đầu của đoạn mới.

Biểu diễn dưới dạng JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
Các trường
style

object (ParagraphStyle)

Kiểu của đoạn

bullet

object (Bullet)

Dấu đầu dòng cho đoạn này. Nếu không có, đoạn đó không thuộc danh sách nào.

ParagraphStyle

Kiểu áp dụng cho toàn bộ đoạn văn.

Nếu văn bản này có trong một hình dạng có phần tử mẹ placeholder, thì các kiểu đoạn văn bản này có thể được kế thừa từ phần tử mẹ. Kiểu đoạn nào được kế thừa tùy thuộc vào mức độ lồng ghép của danh sách:

  • Một đoạn không nằm trong danh sách sẽ kế thừa kiểu đoạn của đoạn đó ở cấp độ lồng 0 của danh sách bên trong phần giữ chỗ mẹ.
  • Một đoạn trong danh sách sẽ kế thừa kiểu đoạn của đoạn đó ở cấp độ lồng ghép tương ứng của danh sách bên trong phần giữ chỗ mẹ.

Kiểu đoạn thừa kế được biểu thị dưới dạng các trường chưa đặt trong thông báo này.

Biểu diễn dưới dạng 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)
}
Các trường
lineSpacing

number

Lượng khoảng cách giữa các đường, theo tỷ lệ phần trăm bình thường, trong đó đường chuẩn được biểu thị là 100,0. Nếu bạn không đặt chính sách này, giá trị sẽ được kế thừa từ cấp độ gốc.

alignment

enum (Alignment)

Căn chỉnh văn bản cho đoạn này.

indentStart

object (Dimension)

Mức thụt lề cho đoạn văn ở phía tương ứng với phần đầu của văn bản, dựa trên hướng văn bản hiện tại. Nếu bạn không đặt chính sách này, giá trị sẽ được kế thừa từ cấp độ gốc.

indentEnd

object (Dimension)

Mức thụt lề cho đoạn văn tương ứng với phần cuối văn bản, dựa trên hướng văn bản hiện tại. Nếu bạn không đặt chính sách này, giá trị sẽ được kế thừa từ cấp độ gốc.

spaceAbove

object (Dimension)

Số lượng khoảng trống thừa trên đoạn. Nếu bạn không đặt chính sách này, giá trị sẽ được kế thừa từ cấp độ gốc.

spaceBelow

object (Dimension)

Số lượng khoảng trống dưới đoạn. Nếu bạn không đặt chính sách này, giá trị sẽ được kế thừa từ cấp độ gốc.

indentFirstLine

object (Dimension)

Số thụt đầu dòng đầu tiên của đoạn. Nếu bạn không đặt chính sách này, giá trị sẽ được kế thừa từ cấp độ gốc.

direction

enum (TextDirection)

Hướng văn bản của đoạn này. Nếu bạn không đặt chính sách này, giá trị mặc định sẽ là LEFT_TO_RIGHT vì hướng văn bản không được kế thừa.

spacingMode

enum (SpacingMode)

Chế độ giãn cách cho đoạn.

Căn chỉnh

Các kiểu căn chỉnh văn bản cho một đoạn văn bản.

Enum
ALIGNMENT_UNSPECIFIED Căn chỉnh đoạn được kế thừa từ cấp độ gốc.
START Đoạn văn được căn chỉnh với đầu dòng. Căn trái cho văn bản LTR, căn trái phải.
CENTER Đoạn ở giữa.
END Đoạn văn được căn chỉnh đến cuối dòng. Căn phải cho văn bản LTR, căn trái.
JUSTIFIED Đoạn văn được căn đều.

Hướng văn bản

Văn bản chỉ đường có thể được gửi tới.

Enum
TEXT_DIRECTION_UNSPECIFIED Hướng văn bản được kế thừa từ thành phần mẹ.
LEFT_TO_RIGHT Văn bản đi từ trái sang phải.
RIGHT_TO_LEFT Văn bản đi từ phải sang trái.

Chế độ giãn cách

Các chế độ giãn cách đoạn khác nhau.

Enum
SPACING_MODE_UNSPECIFIED Chế độ giãn cách được kế thừa từ thành phần mẹ.
NEVER_COLLAPSE Giãn cách đoạn luôn được hiển thị.
COLLAPSE_LISTS Giãn cách đoạn được bỏ qua giữa các phần tử danh sách.

Biểu đồ bullet

Mô tả dấu đầu dòng của một đoạn văn.

Biểu diễn dưới dạng JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
Các trường
listId

string

Mã của danh sách chứa đoạn này.

nestingLevel

integer

Mức lồng ghép của đoạn này trong danh sách.

glyph

string

Ký tự dấu đầu dòng được kết xuất cho đoạn này.

bulletStyle

object (TextStyle)

Kiểu văn bản cụ thể của đoạn được áp dụng cho dấu đầu dòng này.

TextStyle

Biểu thị kiểu có thể áp dụng cho TextRun.

Nếu văn bản này có trong một hình dạng có phần tử mẹ placeholder, thì các kiểu văn bản này có thể được kế thừa từ phần tử mẹ. Kiểu văn bản nào được kế thừa tùy thuộc vào mức độ lồng ghép của danh sách:

  • Văn bản chạy trong một đoạn không thuộc danh sách sẽ kế thừa kiểu văn bản của ký tự đó từ ký tự dòng mới trong đoạn ở cấp độ lồng 0 của danh sách bên trong phần giữ chỗ mẹ.
  • Văn bản chạy trong một đoạn nằm trong danh sách sẽ kế thừa kiểu văn bản của văn bản đó từ ký tự dòng mới trong đoạn ở cấp độ lồng tương ứng của danh sách bên trong phần giữ chỗ mẹ.

Kiểu văn bản kế thừa được thể hiện dưới dạng các trường chưa được đặt trong thông báo này. Nếu văn bản có trong một hình dạng không có phần giữ chỗ chính, việc hủy đặt các trường này sẽ hoàn nguyên kiểu về một giá trị khớp với giá trị mặc định trong trình chỉnh sửa Trang trình bày.

Biểu diễn dưới dạng 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)
  }
}
Các trường
backgroundColor

object (OptionalColor)

Màu nền của văn bản. Nếu bạn đặt giá trị này, màu sắc có thể mờ hoặc trong suốt, tuỳ thuộc vào việc trường opaqueColor trong đó có được đặt hay không.

foregroundColor

object (OptionalColor)

Màu của chính văn bản đó. Nếu bạn đặt giá trị này, màu sắc có thể mờ hoặc trong suốt, tuỳ thuộc vào việc trường opaqueColor trong đó có được đặt hay không.

bold

boolean

Liệu văn bản có hiển thị dưới dạng in đậm hay không.

italic

boolean

Liệu văn bản có được in nghiêng hay không.

fontFamily

string

Họ phông chữ của văn bản.

Bộ phông chữ có thể là bất kỳ phông chữ nào trong trình đơn Phông chữ trong Trang trình bày hoặc trong Google Fonts. Nếu không nhận ra tên phông chữ, văn bản sẽ xuất hiện trong Arial.

Một số phông chữ có thể ảnh hưởng đến độ đậm của văn bản. Nếu yêu cầu cập nhật chỉ định giá trị cho cả fontFamily và bold, thì giá trị bold được đặt rõ ràng sẽ được sử dụng.

fontSize

object (Dimension)

Kích thước phông chữ của văn bản. Khi được đọc, fontSize sẽ được chỉ định bằng điểm.

baselineOffset

enum (BaselineOffset)

Độ lệch dọc của văn bản so với vị trí thông thường.

Văn bản có độ lệch đường cơ sở SUPERSCRIPT hoặc SUBSCRIPT sẽ tự động hiển thị ở cỡ chữ nhỏ hơn, được tính toán dựa trên trường fontSize. Bản thân fontSize không chịu ảnh hưởng của những thay đổi trong trường này.

smallCaps

boolean

Dù chữ có được viết hoa hay không.

strikethrough

boolean

Cho dù văn bản có bị gạch ngang chữ hay không.

underline

boolean

Liệu văn bản có được gạch dưới hay không.

weightedFontFamily

object (WeightedFontFamily)

Họ phông chữ và độ đậm của văn bản.

Trường này là phần mở rộng của fontFamily nhằm hỗ trợ độ đậm phông chữ rõ ràng mà không phá vỡ khả năng tương thích ngược. Do đó, khi đọc kiểu của một dải văn bản, giá trị của weightedFontFamily#fontFamily sẽ luôn bằng với giá trị của fontFamily. Tuy nhiên, khi viết, nếu cả hai trường đều được thêm vào mặt nạ trường (rõ ràng hoặc thông qua ký tự đại diện "*"), thì giá trị của các trường đó sẽ được điều chỉnh như sau:

  • Nếu bạn đặt fontFamily và weightedFontFamily chưa được đặt, giá trị của fontFamily sẽ được áp dụng với trọng số 400 ("bình thường").
  • Nếu bạn đặt cả hai trường, giá trị của fontFamily phải khớp với giá trị của weightedFontFamily#fontFamily. Nếu có, bộ phông chữ và độ đậm của weightedFontFamily sẽ được áp dụng. Nếu không, hệ thống sẽ trả về lỗi yêu cầu không hợp lệ 400.
  • Nếu bạn đặt weightedFontFamily và fontFamily chưa được đặt, thì bộ phông chữ và độ đậm của weightedFontFamily sẽ được áp dụng.
  • Nếu bạn không đặt trường nào, họ phông chữ và độ đậm của văn bản sẽ kế thừa từ cấp độ gốc. Xin lưu ý rằng các thuộc tính này không thể kế thừa riêng.

Nếu yêu cầu cập nhật chỉ định các giá trị cho cả weightedFontFamily và bold, thì weightedFontFamily sẽ được áp dụng đầu tiên, sau đó là bold.

Nếu bạn không đặt weightedFontFamily#weight, thì giá trị mặc định sẽ là 400.

Nếu bạn đặt weightedFontFamily, thì weightedFontFamily#fontFamily cũng phải được đặt với giá trị không trống. Nếu không, hệ thống sẽ trả về lỗi yêu cầu không hợp lệ 400.

Màu tùy chọn

Màu có thể hoàn toàn mờ đục hoặc hoàn toàn trong suốt.

Biểu diễn dưới dạng JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
Các trường
opaqueColor

object (OpaqueColor)

Nếu được đặt, thì thành phần này sẽ được dùng làm màu đục. Nếu bạn không đặt chính sách này, thì giá trị này thể hiện màu trong suốt.

Mức chênh lệch cơ sở

Các cách mà văn bản có thể được bù trừ theo chiều dọc so với vị trí thông thường.

Enum
BASELINE_OFFSET_UNSPECIFIED Độ lệch cơ sở của văn bản được kế thừa từ chế độ xem mẹ.
NONE Văn bản không được bù trừ theo chiều dọc.
SUPERSCRIPT Văn bản được bù trừ theo chiều dọc lên trên (chỉ số trên).
SUBSCRIPT Văn bản được bù trừ theo chiều dọc xuống dưới (chỉ số dưới).

Phông chữ có trọng số

Đại diện cho họ phông chữ và độ đậm dùng để tạo kiểu cho TextRun.

Biểu diễn dưới dạng JSON 
{
  "fontFamily": string,
  "weight": integer
}
Các trường
fontFamily

string

Họ phông chữ của văn bản.

Bộ phông chữ có thể là bất kỳ phông chữ nào trong trình đơn Phông chữ trong Trang trình bày hoặc trong Google Fonts. Nếu không nhận ra tên phông chữ, văn bản sẽ xuất hiện trong Arial.

weight

integer

Độ đậm của văn bản được hiển thị. Trường này có thể có bất kỳ giá trị nào là bội số của 100 từ 100 đến 900. Dải ô này tương ứng với các giá trị số được mô tả trong Đặc tả CSS 2.1, phần 15.6, với các giá trị không phải là số được phép. Các trọng số lớn hơn hoặc bằng 700 được coi là chữ đậm và trọng số nhỏ hơn 700 không được in đậm. Giá trị mặc định là 400 ("bình thường").

Chạy văn bản

Một loại TextElement đại diện cho một loạt văn bản có cùng kiểu định dạng.

Biểu diễn dưới dạng JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Các trường
content

string

Văn bản của lần chạy này.

style

object (TextStyle)

Kiểu được áp dụng cho lần chạy này.

Văn bản tự động

Một loại TextElement đại diện cho văn bản tự động.

Biểu diễn dưới dạng JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
Các trường
type

enum (Type)

Loại văn bản tự động này.

content

string

Nội dung hiển thị của văn bản tự động này, nếu có.

style

object (TextStyle)

Kiểu được áp dụng cho văn bản tự động này.

Loại

Các loại văn bản tự động

Enum
TYPE_UNSPECIFIED Loại văn bản tự động không xác định.
SLIDE_NUMBER Nhập văn bản tự động biểu thị số trang trình bày hiện tại.

Danh sách

Danh sách mô tả giao diện của dấu đầu dòng thuộc về các đoạn văn được liên kết với một danh sách. Một đoạn thuộc danh sách có một tham chiếu ngầm đến mã nhận dạng của danh sách đó.

Biểu diễn dưới dạng JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
Các trường
listId

string

Mã của danh sách.

nestingLevel

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

Bản đồ các lồng ghép với thuộc tính của dấu đầu dòng ở cấp được liên kết. Một danh sách có tối đa 9 cấp độ lồng ghép, vì vậy giá trị của các khóa của bản đồ này là từ 0 đến 8.

Cấp độ lồng ghép

Chứa các thuộc tính mô tả giao diện của dấu đầu dòng danh sách ở cấp lồng nhất định.

Biểu diễn dưới dạng JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
Các trường
bulletStyle

object (TextStyle)

Kiểu của một dấu đầu dòng ở cấp độ lồng này.