テキスト範囲と段落

インデックスベースのモデル

Univer Docs はリッチテキストをネストしたツリーとして保存しません。プレーンテキストを body.dataStream¹ に保存し、インデックス範囲でスタイルや構造を関連付けます。

よく使われるインデックスベースの構造は次のとおりです。

• ITextRun: インラインテキストスタイル範囲。
• IParagraph: 段落メタデータと段落スタイル。
• ISectionBreak: セクション区切りメタデータ。

ITextRun

ITextRun は連続したテキスト範囲のスタイルを表します。

const body: IDocumentBody = {  dataStream: 'Hello Univer\r\n',  textRuns: [    {      st: 0,      ed: 5,      ts: { bl: 1 },    },    {      st: 6,      ed: 12,      ts: { cl: { rgb: '#2563eb' } },    },  ],}

この例では、Hello が太字になり、Univer が青色になります。段落区切り \r\n はスタイル範囲に含まれません。

IParagraph

IParagraph は段落レベルのメタデータを表します。startIndex は dataStream 内の段落区切り位置を指します。

const body: IDocumentBody = {  dataStream: 'Hello Univer\r\nSecond line\r\n',  paragraphs: [    {      startIndex: 12,      paragraphId: 'p-1',      paragraphStyle: {        namedStyleType: NamedStyleType.HEADING_1,      },    },    {      startIndex: 25,      paragraphId: 'p-2',    },  ],}

段落内の単語の折り返し

段落設定の単語途中での折り返しは paragraphStyle.wordWrap で制御します。BooleanNumber.TRUE は単語を行間で分割し、BooleanNumber.FALSE は単語をまとめて配置します。省略時は参照する段落スタイル、次に documentStyle.defaultParagraphStyle を継承し、どちらにも指定がなければ単語を分割しません。@univerjs/core の resolveDocumentParagraphWordWrap(document, paragraph) は、継承値をスナップショットに書き込まずに有効な値を返します。Sheets のセルの折り返しには影響しません。DOCX の w:wordWrap は逆の表現を使うため、XML の値をそのままコピーしないでください。

ISectionBreak

ISectionBreak もインデックスによってテキストストリームと関連付けられます。セクションごとにページサイズ、余白、ヘッダー/フッター、カラム、文字方向などを上書きできます。

const body: IDocumentBody = {  dataStream: 'First section\nSecond section\r\n',  sectionBreaks: [    {      startIndex: 13,      pageSize: { width: 595, height: 842 },      marginTop: 72,      marginBottom: 72,    },  ],}

注意事項

• インデックスは dataStream と一致させる必要があります。不正なインデックスは、スタイル範囲、段落、選択範囲、レンダリング状態の不整合につながります。
• 実行中のドキュメントを編集する場合は、Facade API またはコマンドを優先してください。
• スナップショットを手動生成する場合は、先に dataStream を構築し、その文字列から範囲と段落位置を計算してください。