分页
Yii 使用yii\data\Pagination对象来代表分页方案的有关信息。
total count指定数据条目的总数。注意,这个数字通常远远大于需要在一个页面上展示的数据条目。
yii\data\Pagination::$pageSize指定每页包含多少数据条目。默认值为20。
yii\data\Pagination::$page给出当前的页码。默认值为0,表示第一页。
为了促成创建支持分页的 UI 元素,Yii 提供了yii\widgets\LinkPager挂件来展示一栏页码按钮,用户可以通过点击它来指示应该显示哪一页的数据。该挂件接收一个分页对象,因此它知道当前的页数和应该展示多少页码按钮。
手动地创建 UI 元素,可以使用yii\data\Pagintion::createUrl()来创建指向不同页面的 URLs 。该方法需要一个页码来作为参数,并且将创建一个包含页码并且格式正确的 URL。
创建分页对象时,可以通过配置pageParam属性来自定义查询参数page的名字。
排序
展示多条数据时,通常需要对数据按照用户指定的列进行排序。Yii 使用yii\data\Sort对象来代表排序。
attributes指定属性,数据按照其排序。一个属性可以就是简单的一个model attribute,也可以是结合了多个 model 属性或者 DB 列的复合属性。下面将给出更多细节。
yii\data\Sort::$attributeOrders给出每个属性当前设置的排序方向。
yii\data\Sort::$orders按照低级列的方式给出排序方向。
使用yii\data\Sort,首先要声明什么属性能进行排序。接着从yii\data\Sort::$attributeOrders或者yii\data\Sort::$orders取得当前设置的排序信息,然后使用它们来自定义数据查询。
age属性是Article与 Active Record 类中age属性对应的一个简单属性。上述声明与下述等同:
name属性是由Article的firsr_name和last_name定义的一个复合属性。使用下面的数组结构来对它进行声明:
asc和desc元素指定了如何按照该属性进行升序和降序的排序。它们的值代表数据真正地应该按照什么列和方向进行排序。你可以指定一列或多列来指出到底是简单排序还是多重排序。
default元素指定了当一次请求时,属性应该按照什么方向来进行排序。它默认为升序方向,意味着如果之前没有进行排序,并且你请求按照该属性进行排序,那么数据将按照该属性来进行升序排序。
label元素指定了调用yii\data\Sort::link()来创建一个排序链接时应该使用什么标签,如果不设置,将调用yii\helpers\Inflector::camel2words()来通过属性名生成一个标签。注意,它并不是 HTML编码的。
调用yii\data\Sort::link()来生成一个超链接,用户可以通过点击它来请求按照指定的属性对数据进行排序。你也可以调用yii\data\Sort::createUrl(来生成一个可排序的 URL。
yii\data\Sort查看sort查询参数来决定哪一个属性正在被请求来进行排序。当该参数不存在时,你可以通过yii\data\Sort::$defaultOrder来指定默认的排序。你也可以通过配置sortParam属性来自定义该查询参数的名字。
你可以将yii\data\Sort::$orders的值直接提供给数据库查询来构建其ORDER BY子句。不要使用yii\data\Sort::$attributeOrders,因为一些属性可能是复合的,是不能被数据库查询识别的。