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 ( |
Các trường | |
---|---|
textElements[]
|
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
|
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 |
Các trường | |
---|---|
startIndex
|
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
|
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
|
Một điểm đánh dấu đại diện cho phần đầu của đoạn mới.
|
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
|
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 ( |
Các trường | |
---|---|
style
|
Kiểu của đoạn |
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 ( |
Các trường | |
---|---|
lineSpacing
|
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
|
Căn chỉnh văn bản cho đoạn này. |
indentStart
|
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
|
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
|
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
|
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
|
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
|
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à |
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 (
|
Các trường | |
---|---|
listId
|
Mã của danh sách chứa đoạn này. |
nestingLevel
|
Mức lồng ghép của đoạn này trong danh sách. |
glyph
|
Ký tự dấu đầu dòng được kết xuất cho đoạn này. |
bulletStyle
|
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 ( |
Các trường | |
---|---|
backgroundColor
|
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 |
foregroundColor
|
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 |
bold
|
Liệu văn bản có hiển thị dưới dạng in đậm hay không. |
italic
|
Liệu văn bản có được in nghiêng hay không. |
fontFamily
|
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
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ả |
fontSize
|
Kích thước phông chữ của văn bản. Khi được đọc, |
link
|
Đích siêu liên kết của văn bản. Nếu bạn không đặt thì sẽ không có đường liên kết. Đường liên kết không được kế thừa từ văn bản gốc. Việc thay đổi đường liên kết trong yêu cầu cập nhật gây ra một số thay đổi khác đối với kiểu văn bản của dải ô:
|
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ở |
smallCaps
|
Dù chữ có được viết hoa hay không. |
strikethrough
|
Cho dù văn bản có bị gạch ngang chữ hay không. |
underline
|
Liệu văn bản có được gạch dưới hay không. |
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
Nếu yêu cầu cập nhật chỉ định các giá trị cho cả
Nếu bạn không đặt
Nếu bạn đặt |
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 (
|
Các trường | |
---|---|
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
|
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 |
weight
|
Độ đậ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 |
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 (
|
Các trường | |
---|---|
content
|
Văn bản của lần chạy này. |
style
|
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 ( |
Các trường | |
---|---|
type
|
Loại văn bản tự động này. |
content
|
Nội dung hiển thị của văn bản tự động này, nếu có. |
style
|
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 (
|
Các trường | |
---|---|
listId
|
Mã của danh sách. |
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 (
|
Các trường | |
---|---|
bulletStyle
|
Kiểu của một dấu đầu dòng ở cấp độ lồng này. |