Structures_DataGrid_Renderer

PEAR マニュアル
前のページ		次のページ

注意

このドライバは 実験的な もので、まだ正式にはリリースされていません。 CVS 版 でしか使用できません。

サポートする操作モード

このドライバは次の操作モードをサポートしています。

表 62-1このドライバがサポートする操作モード

モード	サポートしている?
コンテナのサポート	yes
出力バッファリング	yes
ダイレクトレンダリング	no
ストリーミング	no
オブジェクトの永続化	no

オプション

このドライバは、以下のオプションを受け付けます。

表 62-2このドライバのオプション

オプション	型	説明	デフォルト値
buildFooter	bool	フッタを作成するかどうか。	true
buildHeader	bool	ヘッダを作成するかどうか。	true
defaultCellValue	string	空のセルに表示するデフォルトの値。	null
defaultColumnValues	array	カラムごとに指定するセルのデフォルト値。 array(fieldName => value, ...) 形式の配列となります。	array()
encoding	string	内容のエンコーディング。mbstring 拡張モジュールが使用可能な場合、デフォルト値は mb_internal_encoding() から取得します。それ以外の場合のデフォルト値は ISO-8859-1 となります。	'ISO-8859-1'
excludeVars	array	作成される HTTP クエリから取り除く変数。	array()
extraVars	array	作成される HTTP クエリに追加される変数。	array()
fillWithEmptyRows	bool	すべてのページで行数が同じになるようにするかどうか。	false
hideColumnLinks	array	デフォルトでは、すべてのカラムで並べ替えリンクが有効になります。このオプションを使用すると、指定したカラムの並べ替えリンクを無効にできます。 array(fieldName, ...) 形式の配列で指定します。このオプションは、並べ替えをサポートしているドライバでのみ有効です。	array()
numberAlign	bool	数値を右詰めにするかどうか。	true
onMove	string	ユーザがページを移動したりデータをソートしたりしたときの onclick/onsubmit イベント発生時にコールする Javascript 関数の名前。この関数は、オブジェクトを引数として受け取ります。このオブジェクトの形式は { page: <page>, sort: [{field: <field>, direction: <direction>}, ...], data: <user_data> } のようになります。このオプションを指定しても、 href 属性は削除されないことに注意しましょう。 href を無効にしたい場合 (AJAX など……) は、ハンドラ関数内で false を返すようにしなければなりません。	null
onMoveData	string	onMove に渡す引数のオブジェクトの、"data" に渡すデータ。JSON 形式のシリアル化は行わず、そのままの形で "data" 属性に渡されます。クォートやスラッシュなどを追加する処理は、自分で行ってください。	''
textSubmit	string	送信ボタンを表すラベル。	'Submit'

例

例 62-1基本的な使用法

<?php
require_once 'Structures/DataGrid.php';

$datagrid =& new Structures_DataGrid();
$datagrid->bind(...);  // bind your data here

$datagrid->setRenderer('HTMLEditForm');

$datagrid->render();
?>

例 62-2tableless レンダラおよび DHTMLRules を使用する例

<?php
// スタイルシートをインクルードし、適切なレイアウトで表示されるようにしておきましょう

require_once 'Structures/DataGrid.php';
require_once 'HTML/QuickForm/DHTMLRulesTableless.php';
require_once 'HTML/QuickForm/Renderer/Tableless.php';

$datagrid =& new Structures_DataGrid();
$datagrid->bind(...);  // ここでデータをバインドします

// フォームオブジェクトを作成する際に DHTMLRules を使用します
$form = new HTML_QuickForm_DHTMLRulesTableless('editform', null, null,
                                               null, null, true);
$form->removeAttribute('name');  // 妥当な XHTML を作成するため

// fieldset の legend を取得するために、ヘッダ要素を追加します
$form->addElement('header', 'header', 'EditForm example');

// fill() は、レンダラで必要なフォーム要素を作成します。
$datagrid->fill($form, null, 'HTMLEditForm');

// 送信ボタンは自分で追加しなければなりません
$form->addElement('submit', null, 'Submit');

// DHTMLRules の機能を説明するため、必須ルールを追加します
// ('id' という名前の要素があるものと仮定します)
$form->addRule('id', 'Please enter the ID.', 'required', null, 'client');

// onChange/onBlur イベントで検証を行うために、以下のコールが必要です
$form->getValidationScript();

// tableless レンダラのインスタンスを作成し、フォームを出力します
$renderer =& new HTML_QuickForm_Renderer_Tableless();
$form->accept($renderer);
echo $renderer->toHtml();
?>

前のページ	ホーム	次のページ
Structures_DataGrid_Renderer_Flexy	上に戻る	Structures_DataGrid_Renderer_HTMLSortForm

Structures_DataGrid_Renderer_HTMLEditForm

注意

サポートする操作モード

オプション

例