形式的テーブルの作成

DOM API 形式的テーブルには、ヘッダーセクションと本体セクション、フッターセクションがあります。形式的テーブルは、ヘッダーやフッターが複数行に及ぶ場合に便利です。ヘッダーセクション、本体セクション、およびフッターセクションが独立していることで、他のセクションに関わりなく、ヘッダー、本体、またはフッターに行を追加し、書式設定することが容易になります。レポート内で作成可能な他の種類のテーブルについては、作成するテーブルの種類の選択を参照してください。テーブルの書式設定の詳細については、テーブルの書式設定を参照してください。

形式的テーブルは、mlreportgen.dom.FormalTable オブジェクトで表されます。ヘッダーセクション、本体セクション、およびフッターセクションは、mlreportgen.dom.TableHeader オブジェクト、mlreportgen.dom.TableBody オブジェクト、および mlreportgen.dom.TableFooter オブジェクトでそれぞれ表されます。各セクションには、行とテーブルエントリがあります。行は、mlreportgen.dom.TableRow オブジェクトで表されます。本体セクションとフッターセクションのエントリは、mlreportgen.dom.TableEntry オブジェクトで表されます。ヘッダーのエントリは、mlreportgen.dom.TableHeaderEntry オブジェクトまたは mlreportgen.dom.TableEntry オブジェクトで表されます。

MATLAB^® 配列から形式的テーブルのセクションを作成できます。TableRow オブジェクトと TableEntry オブジェクトまたは TableHeaderEntry オブジェクトを作成する必要がないため、この方法が最も簡単です。TableRow オブジェクトと TableEntry オブジェクトまたは TableHeaderEntry オブジェクトからテーブルを構築することで、セクションを作成することもできます。この方法は、エントリが複数の列または行にまたがる場合など、書式設定の要件が複雑な場合に便利です。方法は組み合わせることができます。たとえば、配列からテーブル本体を作成し、行とエントリからヘッダーを作成することができます。

MATLAB 配列からの形式的テーブルの作成

mlreportgen.dom.FormalTable コンストラクターを使用して、形式的テーブルを作成します。コンストラクターは、本体セクション、ヘッダーセクション、およびフッターセクションに関する MATLAB データの 2 次元配列または cell 配列を、必要に応じて受け入れます。mlreportgen.dom.FormalTable リファレンスページの引数 header、body、および footer を参照してください。string 配列から形式的テーブルのヘッダーを作成し、cell 配列から形式的テーブルの本体を作成する例については、cell 配列からのテーブルの作成を参照してください。

行とエントリからの形式的テーブルの作成

テーブルエントリをテーブル行に追加し、行をセクションに追加することで、形式的テーブルのヘッダーセクション、本体セクション、またはフッターセクションを作成できます。

ヘッダーエントリを作成するには、mlreportgen.dom.TableHeaderEntry オブジェクトまたは mlreportgen.dom.TableEntry オブジェクトを使用できます。配列からヘッダーを作成する場合、DOM API はエントリを TableHeaderEntry オブジェクトとして作成します。HTML レポートで、DOM API は TableHeaderEntry オブジェクトを th (テーブルヘッダーセル) 要素としてレンダリングします。このレンダリングにおけるテーブルエントリの書式設定は、ブラウザーに依存します。Word や PDF のレポートの場合、DOM API は既定で TableHeaderEntry オブジェクトを Word または PDF の書式なしのテーブルエントリ要素としてレンダリングします。TableHeaderEntry オブジェクトのプロパティを使用して、すべての出力タイプに対して生成されたテーブルエントリを書式設定できます。たとえば、これらのプロパティを使用して、HTML レポートでブラウザーの書式設定をオーバーライドできます。

テーブル行とテーブルエントリから形式的テーブルのセクションを作成するには、FormalTable の appendHeaderRow、append、および appendFooterRow メソッドを使用して、テーブルのヘッダーセクション、本体セクション、またはフッターセクションに行を追加します。または、FormalTable オブジェクトの Header、Body、または Footer プロパティを使用してセクションにアクセスし、append メソッドを使用してセクションに行を追加することもできます。

エントリと行からヘッダーを作成する例については、Span a Table Entry Across Rows and Columnsの Formal Table を参照してください。

参考