Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

StartIndent

StartIndentは、Tagged PDF構造においてブロックレベル要素の開始辺に適用されるインデント量を指定するレイアウト属性です。

キーワード: startindent, StartIndent

概要

StartIndentは、Tagged PDF構造においてブロックレベル要素の開始辺に適用されるインデント量を指定するレイアウト属性です。 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているように、この属性はコンテンツの開始辺と参照領域の開始辺との間の距離を制御し、アクセシブルなドキュメントにおける適切な視覚的書式設定をサポートします。「開始辺」はコンテンツの書字方向を尊重するため、左から右、右から左、および縦書きモードに適応する方向中立的なプロパティとなります ( Citation: , (). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ )

定義

StartIndentは、デフォルトユーザー空間単位(通常はポイント)で測定される数値レイアウト属性で、段落、見出し、リスト項目などのブロックレベル構造要素の開始辺におけるインデントを定義します。CSSやワードプロセッサーのマージンプロパティが常に方向固定(左、右、上、下)であるのとは異なり、StartIndentは書字方向を認識します。英語のような左から右への言語では、StartIndentは左インデントに対応し、アラビア語やヘブライ語のような右から左への言語では、右インデントに対応します。この属性はTagged PDF内のBLSE(ブロックレベル構造要素)に適用され、ブロックの最初の行のみに影響するTextIndentとは異なります。StartIndentはブロック要素全体に均一に影響し、参照領域境界からの一貫した間隔を作成します。

重要性

PDF/UA標準 ( Citation: N.A., (N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) に準拠したアクセシブルなPDFを作成する開発者にとって、StartIndentは異なる言語コンテキスト間で適切なドキュメント構造と視覚的階層を維持するために不可欠です。この属性により、開発者は国際化されたコンテンツで破綻する可能性のある方向性プロパティをハードコーディングすることなく、グローバルにアクセシブルなドキュメントを作成できます。Tagged PDFをプログラムで生成する際、StartIndent値を適切に設定することで、支援技術が障害を持つユーザーにドキュメント構造を正確に伝えることができます。また、インデントが固定位置ではなく論理的なドキュメントフローを尊重するため、PDFがリフローされたり、異なるデバイスで表示されたりする際のレイアウトの問題を防ぎます。StartIndentを正しく実装しないと、PDF/UA準拠検証に失敗し、スクリーンリーダーユーザーに対して不適切なユーザーエクスペリエンスを提供するドキュメントになる可能性があります。

仕組み

StartIndentは、Tagged PDF階層内の構造要素のレイアウト属性辞書に数値として指定されます ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。この値は、参照領域の開始辺からコンテンツが開始すべき位置までの距離を表します。PDFプロセッサーがStartIndentが定義された構造要素に遭遇すると、要素のコンテンツをレンダリングする前にこのオフセットを適用します。計算は、ドキュメントまたは構造要素のWritingMode(書字モード)属性を尊重し、適切な物理的方向に自動的にマッピングされます。たとえば、英語ドキュメントでStartIndent値36(0.5インチ)は、コンテンツを左端から36ポイントシフトしますが、アラビア語ドキュメントでは同じ値が右端から36ポイントシフトします。StartIndent値はEndIndentと組み合わせて対称または非対称の間隔を作成でき、子要素レベルでオーバーライドされない限り、構造ツリーを通じてカスケードします。この属性は、リストのようなネストされた構造で特に重要であり、各ネストレベルは通常、視覚的階層を作成するためにStartIndent値を増加させます。

関連用語

  • EndIndent – ブロック要素の終了辺におけるインデントを指定するレイアウト属性で、StartIndentと補完的
  • TextIndent – ブロック要素内の最初の行のインデントのみを制御するレイアウト属性で、ブロック全体のインデントとは異なる
  • Block-Level Structure Element(BLSE、ブロックレベル構造要素) – StartIndentが適用されるブロックレベルコンテンツを表すTagged PDF構造タイプ
  • WritingMode(書字モード) – テキストの方向(水平または垂直、左から右または右から左)を定義するレイアウト属性で、StartIndentの解釈方法を決定する
  • Layout Attributes(レイアウト属性) – アクセシビリティのための論理構造を維持しながら視覚的表現を制御するTagged PDFのプロパティの集合

出典

(N.A.) (2020)
(N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html
PDF Association (2023)
(). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/
(N.A.) (2014)
(N.A.). (). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html