Commit b8747b9e by Nobuo Kihara

docs/guide/output-data-widgets.md - revised [ci skip]

parent 2081d0e8
...@@ -73,29 +73,29 @@ the data provider. The displayed table is equipped with sorting and pagination f ...@@ -73,29 +73,29 @@ the data provider. The displayed table is equipped with sorting and pagination f
Yii grid consists of a number of columns. Depending on column type and settings these are able to present data differently. Yii grid consists of a number of columns. Depending on column type and settings these are able to present data differently.
These are defined in the columns part of GridView configuration like the following: These are defined in the `columns` part of GridView configuration like the following:
```php ```php
echo GridView::widget([ echo GridView::widget([
'dataProvider' => $dataProvider, 'dataProvider' => $dataProvider,
'columns' => [ 'columns' => [
['class' => 'yii\grid\SerialColumn'], ['class' => 'yii\grid\SerialColumn'],
// A simple column defined by the data contained in $dataProvider. // Simple columns defined by the data contained in $dataProvider.
// Data from the model's column1 will be used. // Data from the model's column will be used.
'id', 'id',
'username', 'username',
// More complex one. // More complex one.
[ [
'class' => 'yii\grid\DataColumn', // can be omitted, default 'class' => 'yii\grid\DataColumn', // can be omitted, as it is the default
'value' => function ($data) { 'value' => function ($data) {
return $data->name; //$data['name'] for array data, e.g. using SqlDataProvider. return $data->name; // $data['name'] for array data, e.g. using SqlDataProvider.
}, },
], ],
], ],
]); ]);
``` ```
Note that if the columns part of the configuration isn't specified, Yii tries to show all possible data provider model columns. Note that if the `columns` part of the configuration isn't specified, Yii tries to show all possible columns of the data provider's model.
### Column classes ### Column classes
...@@ -111,9 +111,9 @@ echo GridView::widget([ ...@@ -111,9 +111,9 @@ echo GridView::widget([
], ],
``` ```
In addition to column classes provided by Yii that we'll review below you can create your own column classes. In addition to column classes provided by Yii that we'll review below, you can create your own column classes.
Each column class extends from [[\yii\grid\Column]] so there are some common options you can set while configuring Each column class extends from [[\yii\grid\Column]] so that there are some common options you can set while configuring
grid columns. grid columns.
- `header` allows to set content for header row. - `header` allows to set content for header row.
...@@ -151,7 +151,7 @@ echo GridView::widget([ ...@@ -151,7 +151,7 @@ echo GridView::widget([
], ],
[ [
'attribute' => 'birthday', 'attribute' => 'birthday',
'format' => ['date', 'Y-m-d'] 'format' => ['date', 'php:Y-m-d']
], ],
], ],
]); ]);
...@@ -159,7 +159,7 @@ echo GridView::widget([ ...@@ -159,7 +159,7 @@ echo GridView::widget([
In the above, `text` corresponds to [[\yii\i18n\Formatter::asText()]]. The value of the column is passed as the first In the above, `text` corresponds to [[\yii\i18n\Formatter::asText()]]. The value of the column is passed as the first
argument. In the second column definition, `date` corresponds to [[\yii\i18n\Formatter::asDate()]]. The value of the argument. In the second column definition, `date` corresponds to [[\yii\i18n\Formatter::asDate()]]. The value of the
column is, again, passed as the first argument while 'Y-m-d' is used as the second argument value. column is, again, passed as the first argument while 'php:Y-m-d' is used as the second argument value.
For a list of available formatters see the [section about Data Formatting](output-formatter.md). For a list of available formatters see the [section about Data Formatting](output-formatter.md).
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment