Yii の精神修行への道 (1) @View ビュー レンダリング

簡単な説明

View モジュールは、Yii の MVC アーキテクチャの V モジュールであり、主にデータの表示、テンプレート ファイルのレンダリング、およびデータ コンテンツの表示を担当します。

基本概念

MVC には Yii に Views フォルダーがあり、プロジェクトのビュー ファイルを保存し、データ コンテンツを表示します。

1. まず、ビューのレンダリング表示を実装するための簡単なコントローラー操作メソッドを示します。最初のメソッドは、ビュー ファイルをレンダリングするために renderPartial() を呼び出します。これはコントローラーにちなんで名付けられたフォルダー内にあり、2 番目のファイル名はレンダリング ビューのデータであり、配列である必要があります。

2. これはビュー スクリプト php であり、いくつかのコントローラーからのデータを表示し、いくつかのプラグインを呼び出してデータ フィルタリングなどのいくつかの機能を実行することもできます。

3. レイアウト ファイルを使用してビューを処理する まず、ビュー ディレクトリ内のレイアウト フォルダーにカスタム名のレイアウト ファイルを作成します。

4. その後、 render() メソッドを使用してレイアウト ファイルをレンダリングして表示することができ、インデックス ビューのコンテンツ データが $content の形式でレイアウト ファイルに埋め込まれます。もちろん、render メソッドの 2 番目のパラメータは配列であり、データをビューにレンダリングして表示するために使用できます。

5. さらに、複数のビュー ファイルをビューに導入できます。これも render メソッドを通じて実装されます。

レイアウト ファイルのデータはデフォルトで $content に表示され、データ ブロックの形式でビューにレンダリングすることもできます。

一般的なページ インタラクション

HTML で if else の判断を行う:

<?php if ($user->status == 1): ?>    <td class="td-status"><span class="label label-success radius">已启用</span></td><?php else: ?>    <td class="td-status"><span class="label label-success radius">已禁用</span></td><?php endif; ?>

HTML にいくつかの特別なボタンを表示する:

    <?= GridView::widget([        'dataProvider' => $dataProvider,        'filterModel' => $searchModel,        'columns' => [            [                'class' => 'yii\grid\ActionColumn',                'buttons' => [                    'layoutContent' => function ($url, $model){                        /**                         * @var $model Service                         */                        return Html::a('查看服务单信息', Url::to(['jlerp-service-order/view', 'id' => $model->id]), [                            'class' => 'btn btn-success btn-xs', 'target' => '__blank'                        ]);                    }                ],                'template' => '{layoutContent}',                'options' => [                    'style' => 'width:100px'                ],            ]        ],    ]); ?>

いくつかのボタンの実装Html で一般的に使用される

    <div id="confirm-form">        <input type="text" id="version" name="version" placeholder="输入配置版本号">        <button onclick="confirm()" id='confirm-index' class='btn btn-info' type="submit">预览首页效果</button>    </div>    <br>    <div>        <p><font color=red>注意</font></p>        <p>每次修改完首页配置后，先预览查看效果，没问题后才确认生成。</p>        <p>可以根据输入的配置版本号预览查看相应的布局效果。</p>        <p><strong>必须要确认生成一次，才会正式生成新首页。</strong></p>    </div>    <div>        <p><font color=red>预览方法</font></p>        <p>输入版本号，点击预览首页效果，进入预览效果页，然后：</p>        <p>如果是火狐浏览器，按Ctrl+Shift+M进入响应式设计图模式。</p>        <p>如果是谷歌浏览器，按F12，再按Ctrl+Shift+M。</p>    </div>    <hr>    <p>        <?= Html::a('创建布局配置', ['create'], ['class' => 'btn btn-success']) ?>        <?= Html::a('确认布局生效', ['build-index'], ['class' => 'btn btn-danger', 'data-confirm' => '确认布局生效？']) ?>    </p>

GirdView の使用法

GridView の一般的な使用例をいくつか紹介します。

• • Drop-下方検索

  • 日付の書式設定と日付の検索機能

  • パラメータに基づいた表示

  • リンクは次のとおりですクリックしてジャンプ

  • 画像を表示

  • HTMLレンダリング

  • カスタムボタン

  • 幅とその他のスタイルを設定します

  • カスタムフィールド

  • カスタム行スタイル

  • js オペレーションを呼び出すボタンを追加します

  • グリッドビューを使用してバッチ削除を実装します

ドロップダウン検索

データ テーブルにはドロップダウン効果を必要とする多くのフィールドがある可能性があることを考慮して、最初に後続の操作を容易にするメソッドをモデルに実装します。

public static function dropDown ($column, $value = null) {    $dropDownList = [        'is_delete'=> [            '0'=>'显示',            '1'=>'删除',        ],        'is_hot'=> [            '0'=>'否',            '1'=>'是',        ],        //有新的字段要实现下拉规则，可像上面这样进行添加        // ......    ];    //根据具体值显示对应的值    if ($value !== null)         return array_key_exists($column, $dropDownList) ? $dropDownList[$column][$value] : false;    //返回关联数组，用户下拉的filter实现    else        return array_key_exists($column, $dropDownList) ? $dropDownList[$column] : false;}

次にコードに進みます。ドロップダウン検索の実装方法を確認するには、次のようにします。

<?= GridView::widget([    'dataProvider' => $dataProvider,    'columns' => [        // ......        [            'attribute' => 'is_hot',            'value' => function ($model) {                return Article::dropDown('is_hot', $model->is_hot);            },            'filter' => Article::dropDown('is_hot'),        ],        [            'attribute' => 'is_delete',            'value' => function ($model) {                return Article::dropDown('is_delete', $model->is_delete);            },            'filter' => Article::dropDown('is_delete'),        ],        // ......    ],]); ?>

このように、フィルタリング機能を実装するには、このフィールドを dataProvider に追加します。

日付の形式

これはケースバイケースで議論する必要があります:

1. データベースフィールド created_at に保存されている時刻形式が日付または日時の場合非常に簡単です。上の図の右側に示すように、created_at フィールドをグリッドビューに直接出力するだけです。

2. データベースに保存されているタイムスタンプのタイプが、図の左側に示されているとおりである場合上の図では、次の出力のようにする必要があります。

[    'attribute' => 'created_at',    'value' => function ($model) {        return date('Y-m-d H:i:s', $model->created_at);    },],[    'attribute' => 'created_at',    'format' => ['date', 'Y-m-d H:i:s'],],

上記は、形式を出力する 2 つの方法を示していますが、どちらも使用できます。

ただし、検索メカニズムを実装する場合、データベースに datetime 型を格納すると、コードは次のようになります。

$query->andFilterWhere([    // ......    'created_at' => $this->created_at,    // ......]);

データベースにタイムスタンプが保存されている場合は、

最初のステップで、以下の図に示すように、対応するルールを変更します。

2 番目のステップでは、次のコードを参照して dataProvider を変更できます。

//我们搜索输入框中输入的格式一般是 2016-01-01 而非时间戳//输出2016-01-01无非是想搜索这一天的数据，因此代码如下if ($this->created_at) {    $createdAt = strtotime($this->created_at);    $createdAtEnd = $createdAt + 24*3600;    $query->andWhere("created_at >= {$createdAt} AND created_at <= {$createdAtEnd}");}

特定の列を表示するかどうか

単純なケース:

条件: get 型パラメーター type がある

要件: type の値が 1 に等しい場合のみ、列名が表示されます。それ以外の場合、列は表示されません。表示される。

コードは次のように実装されます:

[    'attribute' => 'name',    'value' => $model->name,    'visible' => intval(Yii::$app->request->get('type')) == 1,],

リンクをクリックするとジャンプできます

これは HTML レンダリングの効果と非常によく似ています。ここで説明したいのは、列の属性です。具体的な形式は、ファイル yiii18nFormatter.php にあります。

[    'attribute' => 'order_id',    'value' => function ($model) {        return Html::a($model->order_id, "/order?id={$model->order_id}", ['target' => '_blank']);    },    'format' => 'raw',],

表示イメージ

上記と同様に、ここではフォーマット形式を画像として指定するだけです。はい、format の 2 番目のパラメータで画像サイズを設定できます:

[    'label' => '头像',    'format' => [    'image',     [    'width'=>'84',    'height'=>'84'    ]    ],    'value' => function ($model) {     return $model->image;     }],

html rendering

たとえば、タイトルとしてマークされたフィールドがありますが、このタイトルにはページに表示したくない HTML タグが含まれています:

title123

这种形式，我们想要title123以p标签的形式展示，代码可参考如下，只需要指定format为raw形式即可

[    'attribute' => 'title',    'value' => function ($model) {     return Html::encode($model->title);     },    'format' => 'raw',],

自定义按钮往往列表页我们不想要删除按钮，想在增加一个比如获取xxx按钮，怎么实现？这里需要设置ActionColumn类，修改配置项template并在buttons项增加template里增加的get-xxx即可

[    'class' => 'yii\grid\ActionColumn',    'template' => '{get-xxx} {view} {update}',    'header' => '操作',    'buttons' => [        'get-xxx' => function ($url, $model, $key) {         return Html::a('获取xxx', $url, ['title' => '获取xxx'] );         },    ],],

设定宽度

举个简单的例子，我们的 title 列，太长了，能不能给我先定下这一列的宽度？

答案：能。

请看示例：

[    'attribute' => 'title',    'value' => 'title',    'headerOptions' => ['width' => '100'],],

只需要指定配置项headerOptions即可。

自定义字段

什么是自定义？这里我们是指在表格里增加一列且数据库中不存在对应的列。

假如我们新增一列 订单消费金额money且该表不存在该字段：

[    'attribute' => '消费金额',    'value' => function ($model) {        // 这里可以根据该表的其他字段进行关联获取    }],

自定义行

有小伙伴说了，gii生成的这个gridview表格呀，行跟行的颜色不明显，看着难受，我们来看看怎么定义行样式：

<?= GridView::widget([// ......    'dataProvider' => $dataProvider,    'rowOptions' => function($model, $key, $index, $grid) {        return ['class' => $index % 2 ==0 ? 'label-red' : 'label-green'];    },    // ......]); ?>

前面的操作我们都是依据列column的，这里因为是对行的控制，所以我们配置rowOptions要稍微注意一下。此外，自定义的label-red和label-green需要有对应的样式实现，这里我们看一下页面的实际效果

增加按钮调用js操作

那边产品经理走过来了，小王呀，你这个修改状态的功能很频繁，每次都要先点进详情页才能修改，能不能我在列表页面上鼠标那么一点就成功修改了呢？

其实就是一个异步请求操作了当前行的状态嘛，我们来看看gridview里面是怎么实现的。

[    'class' => 'yii\grid\ActionColumn',    'header' => '操作',    'template' => '{view} {update} {update-status}',    'buttons' => [        'update-status' => function ($url, $model, $key) {            return Html::a('更新状态', 'javascript:;',['onclick'=>'update_status(this, '.$model->id.');']);            },    ],],

还没完，我们还需要在页面写js实现方法 update_status。

常见的 Form 表单视图元素

文本框:textInput();密码框:passwordInput();单选框:radio(),radioList();复选框:checkbox(),checkboxList();下拉框:dropDownList();隐藏域:hiddenInput();文本域:textarea(['rows'=>3]);文件上传:fileInput();提交按钮:submitButton();重置按钮:resetButtun();

<?php $form= ActiveForm::begin(['action'=> ['test/post'],'method'=>'post','id'='uploadform', ]); ?>// 文本输入框<?echo$form->field($model,'username')->textInput(['maxlength'=>20])?>// 密码输入框<?echo$form->field($model,'password')->passwordInput(['maxlength'=>20])?>// 单选框<?echo$form->field($model,'sex')->radioList(['1'=>'男','0'=>'女'])?>// 下拉选择框<?echo$form->field($model,'edu')->dropDownList(['1'=>'大学','2'=>'高中'], ['prompt'=>'请选择','style'=>'width:120px'])?>// 文件上传框<?echo$form->field($model,'file')->fileInput()?>// 复选框<?echo$form->field($model,'hobby')->checkboxList(['0'=>'篮球','1'=>'足球','2'=>'羽毛球','3'=>'乒乓球'])?>// 文本输入框<?echo$form->field($model,'info')->textarea(['rows'=>3])?><?echo$form->field($model,'userid')->hiddenInput(['value'=>3])?><?echoHtml::submitButton('提交', ['class'=>'btn btn-primary','name'=>'submit-button'])?><?echoHtml::resetButton('重置', ['class'=>'btn btn-primary','name'=>'submit-button'])?><?php ActiveForm::end(); ?>