简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)

目录搜索

阅读前篇简介 Yii 是什么从 Yii 1.1 升级入门安装 Yii 运行应用第一次问候使用Forms 数据库应用使用 Gii 生成代码进阶应用结构概述入口脚本应用（Applications）应用组件（Application Components）控制器（Controllers）模型（Models）视图（views）模块（Modules）过滤器（Filters）小部件（Widgets）前端资源（Assets）扩展（Extensions）请求处理运行概述启动引导（Bootstrapping）路由和创建URL 请求（Requests）响应（Responses） Sessions 和 Cookies 错误处理（Handling Errors）日志（Logging）关键概念组件（Component）属性（Property）事件（Events）行为（Behaviors）配置（Configurations）别名（Aliases）类自动加载（Autoloading）服务定位器（Service Locator）依赖注入容器（Dependency Injection Container）配合数据库工作数据库访问 (Data Access Objects) 查询生成器（Query Builder）活动记录（Active Record）数据库迁移（Migrations） Sphinx Redis MongoDB Elasticsearch 接收用户数据创建表单(Creating Forms) 输入验证(Validating Input) 文件上传(Uploading Files) 收集列表输入(Collecting Tabular Input) 多模型的复合表单(Getting Data for Multiple Models) 显示数据格式化输出数据（Data Formatting）分页（Pagination）排序（Sorting）数据提供器（Data Providers）数据小部件（Data Widgets）客户端脚本使用(Working with Client Scripts) 主题（Theming）安全认证（Authentication）授权（Authorization）处理密码（Working with Passwords）客户端认证（Auth Clients）最佳安全实践（Best Practices）缓存概述数据缓存片段缓存页面缓存 HTTP 缓存 RESTfull Web服务快速入门（Quick Start）资源（Resources）控制器（Controllers）路由（Routing）格式化响应（Response Formatting）授权认证（Authentication）速率限制（Rate Limiting）版本（Versioning）错误处理（Error Handling）开发工具调试工具栏和调试器使用Gii生成代码生成API文档测试概述（Overview）配置测试环境（Testing environment setup）单元测试（Unit Tests）功能测试（Function Tests）验收测试（Acceptance Tests）测试夹具（Fixtures）高级专题高级应用模板创建自定义应用程序结构控制台命令核心验证器（Core Validators）国际化收发邮件性能优化共享主机环境模板引擎集成第三方代码小部件 Bootstrap 小部件 Jquery UI 助手类概述 Array 助手(ArrayHelper) Html 助手(Html) Url 助手(Url)

文字

排序

有时显示数据会根据一个或多个属性进行排序。如果你正在使用数据提供者和数据小部件中之一，排序可以为你自动处理。否则，你应该创建一个 yii\data\Sort 实例，配置好后将其应用到查询中。也可以传递给视图，可以在视图中通过某些属性创建链接来排序。

如下是一个典型的使用范例，

function actionIndex(){
    $sort = new Sort([
        'attributes' => [
            'age',
            'name' => [
                'asc' => ['first_name' => SORT_ASC, 'last_name' => SORT_ASC],
                'desc' => ['first_name' => SORT_DESC, 'last_name' => SORT_DESC],
                'default' => SORT_DESC,
                'label' => 'Name',
            ],
        ],
    ]);

    $models = Article::find()
        ->where(['status' => 1])
        ->orderBy($sort->orders)
        ->all();

    return $this->render('index', [
         'models' => $models,
         'sort' => $sort,
    ]);
}

在视图中：

// 显示指向排序动作的链接echo $sort->link('name') . ' | ' . $sort->link('age');

foreach ($models as $model) {
    // 在这里显示 $model
}

以上，我们声明了支持了两个属性的排序：name 和 age。我们通过排序信息来查询以便于查询结果通过 Sort 对象排序后更加准确有序。在视图中，我们通过相应的属性展示了链接到页的两个超链接和数据排序。

yii\data\Sort 类将获得自动传递的请求参数并相应地调整排序选项。你可以通过配置 yii\data\Sort::$params 属性来调整参数。