10.2.5 コントローラ定義ファイルcontrollers.xml

レイアウト形式について設定するファイルです。コントローラ定義ファイルには,Portal Managerを使用してレイアウト基本設定およびレイアウトパターンの設定をした際の設定内容が書き込まれます。レイアウト基本設定およびレイアウトパターンの設定については,「5.3 レイアウト形式のカスタマイズ」を参照してください。

コントローラ定義ファイルの記述形式を次に示します。日本語を使用するには,xml宣言文のencoding属性に文字コードを指定する必要があります。

<?xml version="1.0" encoding="UTF-8"?>
<registry>
 <portlet-controller-entry name="TwoColumns">
   <parameter name="sizes" value="small,large" />
   <parameter name="cols" value="2" />
   <meta-info>
    <title>Two columns (30/70)</title>
   </meta-info>
 </portlet-controller-entry>

<property>
  <parameter name="maxRow" value="3" />
  <parameter name="maxCol" value="2" />
</property>

<size>
  <parameter name="small" value="30%" />
  <parameter name="large" value="70%" />
</size>
</registry>

コントローラの定義ファイルの設定項目と内容を次の表に示します。

表10-30 コントローラ定義ファイルの設定項目と内容

設定項目設定内容
registryコントローラを定義します。parameter nameのvalueで指定する値は,sizeタグのエレメントを指定してください。
portlet-controller-entry各コントローラを定義します。
meta-infoコントローラに関する情報を定義します。portlet-controller-entryタグのエレメントとして指定されます。
parameterコントローラに関する情報を定義します。portlet-controller-entryタグのエレメントとして指定されます。
propertyプロパティを定義します。
parameterプロパティに関する情報を定義します。propertyタグのエレメントとして指定されます。
size横幅サイズを定義します。
parameter横幅サイズに関する情報を定義します。sizeタグのエレメントとして指定されます。なお,サイズはピクセルまたはパーセントのどちらかで指定します。