ページと要素の構造
ISlidePage
ISlidePage は Univer Slides の単一ページオブジェクトを表します。通常のスライド、マスター、レイアウト、配布資料マスター、ノートマスターはすべてこの構造を使用し、pageType と任意のプロパティブロックで区別されます。
ページプロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| id | string | ページの一意な ID。 |
| pageType | PageType | SLIDE、MASTER、LAYOUT などのページ種別。 |
| zIndex | number | ページの描画順序。 |
| title | string | ページタイトル。 |
| description | string | ページ説明。 |
| pageBackgroundFill | IColorStyle | ページ背景の塗り。 |
| colorScheme? | ThemeColorType | ページが使用するテーマカラースキーム。 |
| pageElements | { [elementId: string]: IPageElement } | ページ上の要素。キーは要素 ID。 |
| slideProperties? | ISlideProperties | 通常スライドページのプロパティ。 |
| layoutProperties? | ILayoutProperties | レイアウトページのプロパティ。 |
| masterProperties? | IMasterProperties | マスターページのプロパティ。 |
IPageElement
IPageElement はページ要素の共通コンテナです。各要素は left、top、width、height、angle、scaleX、scaleY、flipX、flipY などの変換フィールドを持ち、type に応じて 1 つのコンテンツペイロードを持ちます。
| 要素タイプ | ペイロード | 説明 |
|---|---|---|
PageElementType.SHAPE | shape | プリセットまたはカスタム図形。図形テキストと図形プロパティを含みます。 |
PageElementType.IMAGE | image | 画像プロパティと任意のプレースホルダー/リンク情報。 |
PageElementType.TEXT | richText | リッチテキスト要素。rich フィールドに IDocumentData を保存できます。 |
PageElementType.SPREADSHEET | spreadsheet | 非推奨の埋め込みワークシートペイロード。 |
PageElementType.DOCUMENT | document | 非推奨の埋め込みドキュメントペイロード。 |
PageElementType.SLIDE | slide | 非推奨の埋め込みスライドペイロード。 |
例
TypeScript
const page: ISlidePage = { id: 'slide-1', pageType: PageType.SLIDE, zIndex: 10, title: 'Agenda', description: '', pageBackgroundFill: { rgb: 'rgb(255,255,255)' }, pageElements: { title: { id: 'title', zIndex: 1, left: 72, top: 64, width: 600, height: 80, title: 'Title', description: '', type: PageElementType.TEXT, richText: { text: 'Quarterly Review', }, }, },}注意
pageOrderは表示されるスライド順を制御し、zIndexは描画順序を制御します。- テキスト要素は
richText.textにプレーンテキストを、richText.richにより完全なドキュメントデータを保存できます。 - プラグイン所有の要素ペイロードには、非推奨の埋め込みペイロードではなく
customBlockを使用してください。
このガイドはいかがですか？