Trang, phần tử trang và thuộc tính

Để sử dụng API Trang trình bày một cách hiệu quả, bạn cần hiểu rõ cấu trúc của các bản trình bày và các thành phần của chúng cũng như các tương tác giữa các thành phần này. Trang này cung cấp thông tin tổng quan chi tiết về chủ đề:

• Mô hình khái niệm của các thành phần trong bản trình bày
• Cách API biểu thị những thành phần này
• Thuộc tính tạo kiểu của thành phần

Đọc nội dung này và các tài liệu tổng quan khác về khái niệm sẽ giúp bạn dễ hiểu hơn và xem hướng dẫn cách thực hiện, tài liệu tham khảo tài liệu và công thức mẫu.

Bản trình bày, trang và phần tử trang

Phần tử vùng chứa ngoài cùng trong Google Trang trình bày là bản trình bày. Đây là đơn vị có thể được lưu trong Google Drive, chia sẻ với người dùng khác, v.v.

Mỗi bản trình bày chứa nhiều loại trang. Một loại trang là trang trình bày, là các trang mà người dùng xem và lật giữa thời điểm kết xuất bản trình bày trên màn hình.

Mỗi trang chứa một số phần tử trang, cùng tạo thành nội dung của trang, như được thể hiện trong sơ đồ sau:

Ngoài trang trình bày, có các loại trang khác cho phép bạn áp dụng thiết kế vào nhiều trang trình bày khác nhau, tạo nên một hình thức nhất quán. Các loại trang khác này là chính và bố cục cũng như các thuộc tính của chúng xác định cách các trang trình bày được được hiển thị, như minh hoạ trong sơ đồ sau:

Trang chính — Trang chính phục vụ hai mục đích. Phần giữ chỗ trên trang cái chứa giá trị mặc định cho kiểu văn bản được sử dụng trong toàn bộ bản trình bày. Chiến lược phát hành đĩa đơn nền và mọi hình dạng khác trên trang trình bày chính sẽ tạo thành hình dạng mặc định màu nền của tất cả các trang trình bày dựa trên trang cái đó. Nếu bạn có biểu trưng công ty mà bạn muốn xuất hiện trên mọi trang trình bày trong bản trình bày, hãy đặt nó lên trang cái.

Bố cục – Mẫu bố cục xác định cách sắp xếp nội dung trên từng loại của trang trình bày. Nếu bạn muốn tất cả các trang trình bày tiêu đề trông theo một cách cụ thể, ví dụ ví dụ: bạn có thể chỉnh sửa mẫu bố cục tiêu đề.

Có hai loại trang khác là trang ghi chú và trang chính ghi chú chủ yếu là phù hợp khi xử lý ghi chú của người thuyết trình.

Các kiểu và cấu trúc biểu diễn API

Phần này mô tả cách mô hình khái niệm của Google Trang trình bày, như được mô tả nêu trên, được thể hiện trong API Trang trình bày.

Sơ đồ dưới đây mô tả mối quan hệ giữa các bản trình bày, trang, và các phần tử trang dưới dạng các loại trong API Trang trình bày:

Các phần sau đây cho thấy cách những loại này được biểu thị trong JSON.

Bản trình bày

Bản trình bày bao gồm số lượng tài sản và chứa các trang có trong đó:

{
  "presentationId": string,
  "pageSize": { object(Size) },
  "slides": [ { object(Page) } ],
  "title": string,
  "masters": [ { object(Page) } ],
  "layouts": [ { object(Page) } ],
  "notesMaster": object(Page),
  "locale": string,
}

Pages

Một trang bao gồm một tập hợp và chứa các phần tử trang có trong đó:

{
  "objectId": string,
  "pageType": enum(PageType),
  "pageElements": [ { object(PageElement) } ],
  "pageProperties": { object(PageProperties) },

  // Union field properties can be only one of the following:
  "slideProperties": { object(SlideProperties) },
  "layoutProperties": { object(LayoutProperties) },
  "notesProperties": { object(NotesProperties) },
  // End of list of possible types for union field properties.
}

Phần tử trang

Phần tử trang là các thành phần hình ảnh được đặt trên trang. Một phần tử trang trong API chứa nhiều thuộc tính, bao gồm một trường thay đổi tuỳ theo loại phần tử trang:

{
  "objectId": string,
  "size": { object(Size) },
  "transform": { object(AffineTransform) },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": { object(Group) },
  "shape": { object(Shape) },
  "image": { object(Image) },
  "video": { object(Video) },
  "line": { object(Line) },
  "table": { object(Table) },
  "wordArt": { object(WordArt) },
  "sheetsChart": { object(SheetsChart) },
  // End of list of possible types for union field element_kind.
}

Có một số loại phần tử trang, như được xác định bởi trường kết hợp element_kind trong định nghĩa ở trên. Các loại phần tử trang này được mô tả trong bảng sau:

Thuộc tính phần tử trang và trang

API Trang trình bày giúp bạn đọc và cập nhật giao diện của trang và trang trong bản trình bày. Hỗ trợ các thành phần trang khác nhau các thuộc tính khác nhau kiểm soát cách hiển thị phần tử trang.

Mỗi loại phần tử trang có một phần tử thuộc tính và một thuộc tính tương ứng thông báo cập nhật, ví dụ:

• Có loại phần tử trang là Hình dạng
• Trường thuộc tính của lớp này là shapeProperties
• Yêu cầu cập nhật các thuộc tính này là UpdateShapePropertiesRequest

Cùng một tập hợp phần tử/thuộc tính/yêu cầu cập nhật cho mỗi phần tử trang loại: Image/imageProperties/UpdateImageProperties, và cứ tiếp tục như vậy.

Bạn có thể đọc thuộc tính này ở bất cứ nơi nào bạn gặp thuộc tính này khi đọc element; để thay đổi các giá trị trong đó, hãy sử dụng nó với loại yêu cầu phù hợp như tải trọng cho batchUpdate để thay đổi các giá trị này trong bản trình bày.

Các loại cơ sở lưu trú

Có một số thuộc tính phổ biến giữa một số loại đối tượng trong API Trang trình bày:

Đang cập nhật các cơ sở lưu trú

Để cập nhật một thuộc tính, hãy sử dụng Yêu cầu Update...Properties trong một batchUpdate gọi – ví dụ: UpdateShapeProperties cho Hình dạng. Các yêu cầu này chấp nhận thông báo về thuộc tính đầy đủ và có thể sử dụng trường mặt nạ để xác định trường nào trong thuộc tính nên được cập nhật.

Thừa kế thuộc tính

Một trang hoặc phần tử trang có thể kế thừa các thuộc tính từ đối tượng mẹ. Một các thuộc tính của đối tượng, bao gồm các thuộc tính mà đối tượng xác định và các thuộc tính mà đối tượng đó xác định kế thừa, xác định giao diện hình ảnh cuối cùng của ứng dụng.

• Tài sản trang – Một trang kế thừa mọi tài sản mà trang đó không kế thừa nhưng được xác định trong bố cục hoặc trang cái mà dựa trên đó.
• Thuộc tính hình dạng — Hình dạng có thể được đánh dấu là phần giữ chỗ, cho phép bạn tham chiếu rõ ràng một hình dạng phần giữ chỗ khác (trên bố cục mẹ của trang hoặc tài sản chính) để kế thừa các thuộc tính.

Những ý tưởng này được giải thích kỹ hơn trong các đoạn sau.

Tính kế thừa tài sản trang

Cấu trúc của trang trình bày, bố cục và trang cái xác định một hệ phân cấp kế thừa trong bản trình bày: trang trình bày kế thừa từ bố cục, còn bố cục kế thừa từ thạc sĩ. Bố cục mẹ và trang cái của một trang trình bày được chỉ định trong phần slideProperties .

Một trang có thể kế thừa các thuộc tính, chẳng hạn như background và bảng phối màu, từ trang gốc. Để kế thừa một tài sản, trang con chỉ không đặt giá trị cho thuộc tính đó PageProperties . Bằng cách không "ghi đè" giá trị do nhà xuất bản mẹ xác định, nên trang sẽ chấp nhận giá trị kế thừa.

Sơ đồ dưới đây cho thấy một trang trình bày kế thừa các thuộc tính của một bố cục, kế thừa từ một tài sản chính:

Các thuộc tính dùng để kết xuất trang trình bày là sự kết hợp của các thuộc tính mà trang trình bày xác định và những tài sản mà tài sản kế thừa kế thừa. Trong ví dụ này, các giá trị đã phân giải được dùng để kết xuất Trang trình bày 1 như sau:

• Thuộc tính A là "Màu đỏ".
• Thuộc tính B là "Cam".

Tính kế thừa thuộc tính hình dạng

Hình dạng có thể kế thừa các thuộc tính, chẳng hạn như màu nền, đường viền hoặc bóng từ các thuộc tính khác hình dạng. Hình dạng là phần giữ chỗ nếu hình dạng đó Shape.placeholder đã được đặt. Trường Shape.placeholder.parentObjectId của phần giữ chỗ con xác định phần giữ chỗ gốc. Khi bạn tạo trang trình bày mới dựa trên bố cục, mọi phần giữ chỗ trong bố cục đó sẽ xuất hiện dưới dạng hình dạng con trong trang trình bày mới. Tương tự, phần giữ chỗ trên trang chính có thể đóng vai trò là phần tử mẹ của bố cục phần giữ chỗ.

Với hệ thống phân cấp kế thừa đã xác định này, trang con sẽ kế thừa một tài sản theo không đặt giá trị đó trong ShapeProperties . Bằng cách không ghi đè giá trị do phần tử mẹ xác định, hình dạng con chấp nhận giá trị kế thừa.

Sơ đồ dưới đây cho thấy sự kế thừa của các thuộc tính giữa 3 thuộc tính phần giữ chỗ có trong trang trình bày, bố cục và trang cái:

Các thuộc tính dùng để hiển thị hình dạng phần giữ chỗ là sự kết hợp của các thuộc tính đó định nghĩa và những thành phần mà nó kế thừa. Trong ví dụ này, các giá trị được phân giải cho như sau:

• Phần giữ chỗ 1: thuộc tính A hiển thị màu "Vàng", thuộc tính B hiển thị màu "Xanh lục".
• Phần giữ chỗ 2: thuộc tính A hiển thị màu "Vàng", thuộc tính B hiển thị màu "Tím".
• Phần giữ chỗ 3: thuộc tính A hiển thị màu "Vàng", thuộc tính B hiển thị màu "Tím".

Hình dạng là loại phần tử trang duy nhất có thể có phần tử mẹ. Các loại khác, chẳng hạn như hình ảnh, bảng và biểu đồ, không thể là phần giữ chỗ và không thể có phụ huynh.

"Ẩn" thuộc tính bằng PropertyState

PropertyState (Trạng thái thuộc tính) liệt kê kiểm soát việc thuộc tính của một hình dạng có thực sự được sử dụng để kết xuất hay không, hoặc nếu giá trị chỉ được dùng để kế thừa bởi các hình dạng con. Cơ sở lưu trú có trạng thái thuộc tính NOT_RENDERED sẽ không được sử dụng khi kết xuất hình dạng trên Tuy nhiên, phần tử con có trạng thái sản phẩm tương ứng là RENDERED vẫn có thể kế thừa thuộc tính này.

Sơ đồ dưới đây cho thấy sự kế thừa của các thuộc tính giữa 3 thuộc tính phần giữ chỗ thao tác với trường PropertyState:

Việc hiển thị thuộc tính hình dạng có thể bị ảnh hưởng bởi trường PropertyState. Trong ví dụ này, các giá trị đã được phân giải cho các hình dạng này như sau:

• Phần giữ chỗ 1: thuộc tính A hiển thị là "Màu đỏ".
• Phần giữ chỗ 2: thuộc tính A không được hiển thị. Nếu đây là thuộc tính Outline, Placeholder2 sẽ không có đường viền.
• Phần giữ chỗ 3: thuộc tính A không được hiển thị.

Có thể có thêm một giá trị của PropertyState (Trạng thái thuộc tính) liệt kê: trạng thái thuộc tính INHERIT có nghĩa là trạng thái thuộc tính chính nó được kế thừa và giá trị của thành phần mẹ sẽ được sử dụng. Hình dạng không có phần tử mẹ không thể có trạng thái thuộc tính là INHERIT.