Browse Source

edited sorting guide

fixes #6682
tags/2.0.2
Carsten Brandt 10 years ago
parent
commit
50ea97bd64
  1. 14
      docs/guide/output-sorting.md

14
docs/guide/output-sorting.md

@ -1,10 +1,10 @@
Sorting
=======
Sometimes data to be displayed should be sorted according to one or several attributes. If you are using
[data provider](output-data-providers.md) with one of the [data widgets](output-data-widgets.md) it is
handled for you automatically. If not, you should create [[\yii\data\Sort]] instance in controller, configure it and
apply it to the query and then pass it to the view where it can be used to create links to sort by attributes.
Sometimes the data that is to be displayed should be sorted according to one or several attributes. If you are using
a [data provider](output-data-providers.md) with one of the [data widgets](output-data-widgets.md), sorting is
handled for you automatically. If not, you should create a [[yii\data\Sort]] instance, configure it and
apply it to the query. I can also be passed to the view, where it can be used to create links to sort by certain attributes.
A typical usage example is as follows,
@ -49,4 +49,8 @@ foreach ($models as $model) {
In the above, we declare two attributes that support sorting: `name` and `age`.
We pass the sort information to the Article query so that the query results are
sorted by the orders specified by the Sort object. In the view, we show two hyperlinks
that can lead to pages with the data sorted by the corresponding attributes.
that can lead to pages with the data sorted by the corresponding attributes.
The [[yii\data\Sort|Sort]] class will optain the parameters passed with the request automatically
and adjust the sort options accordingly.
You can adjust the parameters by configuring the [[yii\data\Sort::$params|$params]] property.
Loading…
Cancel
Save