In the Yii framework, GridView, ListView, and ActiveForm are important components for building page elements. 1. GridView is used to display table data, supports pagination, sorting and filtering, configure columns and render tables through dataProvider and columns; 2. ListView is suitable for flexible layout list display, use itemView to customize the display of each record, and control the overall structure through layout; 3. ActiveForm is used to create model binding forms, automatically handle verification and error prompts, and supports multiple input types and layout adjustments. Mastering these widgets can greatly improve development efficiency and enable personalized requirements through configuration.

In the Yii framework, built-in widgets (such as GridView, ListView, and ActiveForm) are very practical tools that can help you quickly build common page elements. They have been packaged with many commonly used functions and are relatively simple to use.

Use GridView to display data tables

GridView is one of the most commonly used components to display database query results. It supports pagination, sorting, filtering and other functions, and is very suitable for use in the background management interface.

The basic usage is as follows:

• Get the data provider in the controller (usually ActiveDataProvider)
• Render tables using GridView::widget() method in view

 use yii\grid\GridView;
echo GridView::widget([
    'dataProvider' => $dataProvider,
    'filterModel' => $searchModel,
    'columns' => [
        ['class' => 'yii\grid\SerialColumn'], // Automatic numbering column 'id',
        'name',
        'email:email',
        ['class' => 'yii\grid\ActionColumn'], // Operation column (View/Edit/Delete)
    ],
]);

hint:

• filterModel can be omitted if you do not need search function
• If you want to customize the display content of a column, you can use value attribute or closure function
• The default style is Bootstrap style, you can modify the template or class name through configuration

Use ListView to display list content

ListView is suitable for situations where more flexible layout is required, such as blog post lists, product displays, etc. It is not fixed in table form like GridView, but rather prefers free typography.

The basic structure is as follows:

 use yii\widgets\ListView;

echo ListView::widget([
    'dataProvider' => $dataProvider,
    'itemView' => '_item', // Point to a separate view file for rendering each record 'layout' => "{items}\n{pager}",
    'pager' => [
        'firstPageLabel' => 'Home',
        'lastPageLabel' => 'last page',
    ],
]);

Some points to note:

• _item view files usually receive a $model and $key parameters
• You can use viewParams to add extra parameters to pass into item view
• {summary} in the layout can display the data range of the current page, but sometimes it will appear redundant and can be removed according to your needs.

Build forms using ActiveForm

ActiveForm is the best choice for handling model-related forms. It automatically binds model properties, displays error messages, and integrates seamlessly with Yii's verification mechanism.

Basic writing method:

 use yii\widgets\ActiveForm;

$form = ActiveForm::begin(); 

echo $form->field($model, 'username');
echo $form->field($model, 'email')->input('email');
echo $form->field($model, 'password')->passwordInput();

echo \yii\helpers\Html::submitButton('Submit', ['class' => 'btn btn-primary']);

ActiveForm::end();

Some practical tips:

• The form field will display label and error messages by default, which can be controlled through label(false) or errorOptions
• If you want to put multiple fields in the same line, you can use ActiveForm::field($model, 'xxx')->inline(true)
• Supports multiple input types, such as dropDownList , checkboxList , fileInput , etc.

Basically that's it. These widgets are very powerful, but they are also easy to ignore some details in actual development, such as field naming rules, data format conversion, and coordination with front-end JS. However, as long as you master the basic usage, the rest can be gradually improved by checking documents and debugging.

The above is the detailed content of How do I use built-in Yii widgets (e.g., GridView, ListView, ActiveForm)?. For more information, please follow other related articles on the PHP Chinese website!