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

ColumnWidths

ColumnWidthsは、Tagged PDFにおけるオプション属性で、複数列のテーブルレイアウトにおける各列の明示的な幅の値を指定します。

キーワード: columnwidths, ColumnWidths

概要

ColumnWidthsは、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 ) 。適切に実装された場合、ColumnWidthsは、テーブル構造を機械可読にすることで、PDFドキュメントがアクセシビリティ標準を満たすことを保証します ( 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 )

定義

ColumnWidthsは、Tagged PDFドキュメントのテーブル構造要素に適用できる配列属性です。配列内の各エントリは、テーブル内の列に対応し、その幅を指定します。幅は通常、デフォルトユーザー空間単位(ポイント)で表現されます。コンテンツに基づいて列幅を自動的に調整する可能性のある視覚的なテーブルレンダリングとは異なり、ColumnWidths属性は、論理構造ツリーの一部として各列の意図された幅を明示的に宣言します ( Citation: , (). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ )

この属性は、ドキュメントの構造ツリー内にメタデータとして埋め込まれるため、純粋に視覚的なテーブルフォーマットとは異なります。これにより、視覚的な表現が実際の列の寸法を隠したり変更したりする場合でも、支援技術が利用できるようになります。ColumnWidths属性はテーブルレベルで定義され、より特定のセルレベル属性によって上書きされない限り、そのテーブル構造内のすべての行に適用されます。

重要性

アクセシブルなPDFドキュメントを作成する開発者にとって、ColumnWidths属性は、視覚的な表現を認識できないユーザーに対してテーブルレイアウトを正確に伝えるために、支援技術が依存する重要な構造情報を提供します。スクリーンリーダーやその他のアクセシビリティツールは、この情報を使用して列の位置を通知し、特に結合されたセルや不規則な構造を持つ複雑なテーブルにおいて、意味のある方法でセル間を移動します。

明示的な列幅情報がない場合、支援技術は視覚的な配置のみからテーブル構造を推測しようとする必要があり、テーブルの関係性の誤った解釈や混乱を招くナビゲーション体験につながる可能性があります。ColumnWidthsの実装は、正確な構造情報が基本的な要件であるPDF/UA(Universal Accessibility)標準 ( 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生成または修正時にColumnWidthsを適切に定義することは、ドキュメントが可能な限り幅広いオーディエンスにアクセシブルであることを保証し、多くの法域における法的なアクセシビリティ要件を満たすのに役立ちます。

仕組み

ColumnWidths属性は、テーブル構造要素の属性辞書内の数値配列として実装されます。配列内のエントリ数は、テーブル内の列数と一致する必要があります。たとえば、3列のテーブルには[144 216 144]のようなColumnWidths配列があり、それぞれ2インチ、3インチ、2インチの列を示します(72ポイント/インチ単位)。

PDFプロセッサまたは支援技術がColumnWidths属性を持つテーブル構造要素に遭遇すると、実際のコンテンツストリームを分析することなく、これらの値を使用してテーブルの空間的な構成を理解できます。これは、以下のような場合に特に有用です:

  • テーブルセルが複数の列にまたがる場合(colspan状況)
  • 列の配置が行によって異なる場合
  • 視覚的なフォーマットが構造的な区切りとして誤解される可能性のある間隔を使用している場合

この属性は通常、PDF作成時またはタグ付け/修正プロセスの一部として設定されます。Tagged PDF作成をサポートするほとんどのPDFライブラリとオーサリングツールは、テーブル構造を定義する際にColumnWidthsを指定するためのAPIを提供しています。開発者は、最終的なレンダリングされた外観に基づいてではなく、テーブルの意図された論理構造に基づいてこれらの値を計算し設定する必要があります。目標は、ピクセル完璧なレイアウトではなく、セマンティックな関係性を伝えることです。

PDF 2.0では、ColumnWidths属性は標準的なテーブル構造属性の一部として引き続きサポートされており ( 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バージョンとの一貫性を維持しています。

関連用語

  • Table Structure Elements(テーブル構造要素) – Tagged PDFで表形式データを整理する親コンテナ要素
  • Structure Attributes(構造属性) – 構造要素にセマンティックおよびレイアウト情報を提供するキーと値のペア
  • Assistive Technology(支援技術) – 障害を持つユーザーがデジタルコンテンツにアクセスするのを支援するソフトウェアおよびデバイス
  • PDF/UA – PDFドキュメントにおけるユニバーサルアクセシビリティのためのISO標準
  • Role Mapping(ロールマッピング) – 構造要素をそのセマンティックな意味および表示ロールに関連付けるプロセス

出典

(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