jQuery EasyUI アプリケーション -展開行詳細編集フォームを作成する CRUD アプリケーション

データグリッドビュー(datagrid view)を 'detailview' に切り替えると、ユーザーは行を展開して行の下に行の詳細を表示できます。この機能により、詳細行パネル(panel)内の編集フォーム(form)に適切なレイアウト(layout)を提供できます。このチュートリアルでは、データグリッド(datagrid)コンポーネントを使用して、編集フォーム(form)が占めるスペースを減らします。

ステップ 1:HTML タグでデータグリッド(DataGrid)を定義します

<table id="dg" title="My Users" style="width:550px;height:250px"
        url="get_users.php"
        toolbar="#toolbar"
        fitColumns="true" singleSelect="true">
    <thead>
        <tr>
            <th field="firstname" width="50">First Name</th>
            <th field="lastname" width="50">Last Name</th>
            <th field="phone" width="50">Phone</th>
            <th field="email" width="50">Email</th>
        </tr>
    </thead>
</table>
<div id="toolbar">
    <a href="../index.html" class="easyui-linkbutton" iconCls="icon-add" plain="true" onclick="newItem()">New</a>
    <a href="../index.html" class="easyui-linkbutton" iconCls="icon-remove" plain="true" onclick="destroyItem()">Destroy</a>
</div>

ステップ 2:データグリッド(DataGrid)に詳細ビューを適用します

$('#dg').datagrid({
    view: detailview,
    detailFormatter:function(index,row){
        return '<div class="ddv"></div>';
    },
    onExpandRow: function(index,row){
        var ddv = $(this).datagrid('getRowDetail',index).find('div.ddv');
        ddv.panel({
            border:false,
            cache:true,
            href:'show_form.php?index='+index,
            onLoad:function(){
                $('#dg').datagrid('fixDetailRowHeight',index);
                $('#dg').datagrid('selectRow',index);
                $('#dg').datagrid('getRowDetail',index).find('form').form('load',row);
            }
        });
        $('#dg').datagrid('fixDetailRowHeight',index);
    }
});

データグリッド(DataGrid)に詳細ビューを適用するには、html ページのヘッダーに 'datagrid-detailview.js' ファイルをインクルードします。

'detailFormatter' 関数を使用して行の詳細内容を生成します。

この場合、編集フォーム(form)を配置するための空の <div> を返します。

ユーザーが行展開ボタン('+')をクリックすると、'onExpandRow' イベントがトリガーされ、ajax を通じて編集フォーム(form)をロードします。

'getRowDetail' メソッドを呼び出して行詳細コンテナを取得するため、行詳細パネル(panel)を見つけることができます。

行詳細にパネル(panel)を作成し、'show_form.php' から返された編集フォーム(form)をロードします。

ステップ 3:編集フォーム(Form)を作成します

編集フォーム(form)はサーバーからロードされます。

show_form.php
<form method="post">
    <table class="dv-table" style="width:100%;background:#FAFAFA;padding:5px;margin-top:5px;">
        <tr>
            <td>First Name</td>
            <td><input name="firstname" class="easyui-validatebox" required="true"></input></td>
            <td>Last Name</td>
            <td><input name="lastname" class="easyui-validatebox" required="true"></input></td>
        </tr>
        <tr>
            <td>Phone</td>
            <td><input name="phone"></input></td>
            <td>Email</td>
            <td><input name="email" class="easyui-validatebox" validType="email"></input></td>
        </tr>
    </table>
    <div style="padding:5px 0;text-align:right;padding-right:30px">
        <a href="../index.html" class="easyui-linkbutton" iconCls="icon-save" plain="true" onclick="saveItem(<?php echo $_REQUEST['index'];?>)">Save</a>
        <a href="../index.html" class="easyui-linkbutton" iconCls="icon-cancel" plain="true" onclick="cancelItem(<?php echo $_REQUEST['index'];?>)">Cancel</a>
    </div>
</form>

ステップ 4:編集を保存またはキャンセルします

'saveItem' 関数を呼び出してユーザーを保存するか、'cancelItem' 関数を呼び出して編集をキャンセルします。

function saveItem(index){
    var row = $('#dg').datagrid('getRows')[index];
    var url = row.isNewRecord ? 'save_user.php' : 'update_user.php?id='+row.id;
    $('#dg').datagrid('getRowDetail',index).find('form').form('submit',{
        url: url,
        onSubmit: function(){
            return $(this).form('validate');
        },
        success: function(data){
            data = eval('('+data+')');
            data.isNewRecord = false;
            $('#dg').datagrid('collapseRow',index);
            $('#dg').datagrid('updateRow',{
                index: index,
                row: data
            });
        }
    });
}

どの URL に送信するかを決定し、フォーム(form)オブジェクトを探して、'submit' メソッドを呼び出してフォーム(form)データを送信します。データの保存が成功したら、行を折りたたんで行データを更新します。

function cancelItem(index){
    var row = $('#dg').datagrid('getRows')[index];
    if (row.isNewRecord){
        $('#dg').datagrid('deleteRow',index);
    } else {
        $('#dg').datagrid('collapseRow',index);
    }
}

編集をキャンセルするとき、その行が新しい行でまだ保存されていない場合は、その行を直接削除し、それ以外の場合はその行を折りたたみます。

jQuery EasyUI インスタンスをダウンロード

jeasyui-app-crud3.zip

その他の拡張