Yii 2.0 权威指南
Yii 2.0 权威指南
  1. 介绍（Introduction）
    1. 关于 Yii（About Yii）
    2. 从 Yii 1.1 升级（Upgrading from Version 1.1）
  2. 入门（Getting Started）
    1. 安装 Yii（Installing Yii）
    2. 运行应用（Running Applications）
    3. 第一次问候（Saying Hello）
    4. 使用 Forms（Working with Forms）
    5. 玩转 Databases（Working with Databases）
    6. 用 Gii 生成代码（Generating Code with Gii）
    7. 更上一层楼（Looking Ahead）
  3. 应用结构（Application Structure）
    1. 结构概述（Overview）
    2. 入口脚本（Entry Scripts）
    3. 应用（Applications）
    4. 应用组件（Application Components）
    5. 控制器（Controllers）
    6. 模型（Models）
    7. 视图（Views）
    8. 模块（Modules）
    9. 过滤器（Filters）
    10. 小部件（Widgets）
    11. 前端资源（Assets）
    12. 扩展（Extensions）
  4. 请求处理（Handling Requests）
    1. 运行概述（Overview）
    2. 引导（Bootstrapping）
    3. 路由引导与创建 URL（Routing and URL Creation）
    4. 请求（Requests）
    5. 响应（Responses）
    6. Sessions and Cookies
    7. 错误处理（Handling Errors）
    8. 日志（Logging）
  5. 关键概念（Key Concepts）
    1. 组件（Components）
    2. 属性（Properties）
    3. 事件（Events）
    4. 行为（Behaviors）
    5. 配置（Configurations）
    6. 别名（Aliases）
    7. 类自动加载（Class Autoloading）
    8. 服务定位器（Service Locator）
    9. 依赖注入容器（Dependency Injection Container）
  6. 配合数据库工作（Working with Databases）
    1. 数据库访问（Data Access Objects）: 数据库连接、基本查询、事务和模式操作
    2. 查询生成器（Query Builder）: 使用简单抽象层查询数据库
    3. 活动记录（Active Record）: 活动记录对象关系映射（ORM），检索和操作记录、定义关联关系
    4. 数据库迁移（Migrations）: 在团体开发中对你的数据库使用版本控制
    5. Sphinx
    6. Redis
    7. MongoDB
    8. ElasticSearch
  7. 接收用户数据（Getting Data from Users）
    1. 创建表单（Creating Forms）
    2. 输入验证（Validating Input）
    3. 文件上传（Uploading Files）
    4. 收集列表输入（Collecting Tabular Input）
    5. 多模型同时输入（Getting Data for Multiple Models）
  8. 显示数据（Displaying Data）
    1. 格式化输出数据（Data Formatting）
    2. 分页（Pagination）
    3. 排序（Sorting）
    4. 数据提供器（Data Providers）
    5. 数据小部件（Data Widgets）
    6. 操作客户端脚本（Working with Client Scripts）
    7. 主题（Theming）
  9. 安全（Security）
    1. 认证（Authentication）
    2. 授权（Authorization）
    3. 处理密码（Working with Passwords）
    4. 客户端认证（Auth Clients）
    5. 安全领域的最佳实践（Best Practices）
  10. 缓存（Caching）
    1. 概述（Overview）
    2. 数据缓存（Data Caching）
    3. 片段缓存（Fragment Caching）
    4. 分页缓存（Page Caching）
    5. HTTP 缓存（HTTP Caching）
  11. RESTful Web 服务
    1. 快速入门（Quick Start）
    2. 资源（Resources）
    3. 控制器（Controllers）
    4. 路由（Routing）
    5. 格式化响应（Response Formatting）
    6. 授权验证（Authentication）
    7. 速率限制（Rate Limiting）
    8. 版本化（Versioning）
    9. 错误处理（Error Handling）
  12. 开发工具（Development Tools）
    1. 调试工具栏和调试器（Debug Toolbar and Debugger）
    2. 使用 Gii 生成代码（Generating Code using Gii）
    3. TBD 生成 API 文档（Generating API Documentation）
  13. 测试（Testing）
    1. 概述（Overview）
    2. 搭建测试环境（Testing environment setup）
    3. 单元测试（Unit Tests）
    4. 功能测试（Functional Tests）
    5. 验收测试（Acceptance Tests）
    6. 测试夹具（Fixtures）
  14. 高级专题（Special Topics）
    1. 高级应用模版（Advanced Project Template）
    2. 从头构建自定义模版（Building Application from Scratch）
    3. 控制台命令（Console Commands）
    4. 核心验证器（Core Validators）
    5. 国际化（Internationalization）
    6. 收发邮件（Mailing）
    7. 性能优化（Performance Tuning）
    8. 共享主机环境（Shared Hosting Environment）
    9. 模板引擎（Template Engines）
    10. 集成第三方代码（Working with Third-Party Code）
  15. 小部件（Widgets）
    1. Bootstrap 小部件（Bootstrap Widgets）
    2. jQuery UI 小部件（jQuery UI Widgets）
  16. 助手类（Helpers）
    1. 助手一览（Overview）
    2. Array 助手（ArrayHelper）
    3. Html 助手（Html）
    4. Url 助手（Url）
阅读(10.2k) 书签 赞(0) 我要纠错

操作客户端脚本（Working with Client Scripts）

2018-02-24 15:40 更新

客户端脚本使用

注意: 此部分应用于开发环境

注册脚本

你可以使用 yii\web\View 对象注册脚本。这里有两个专门的方法： （1）yii\web\View::registerJs() 用于内联脚本。 （2）yii\web\View::registerJsFile() 用于注册引入外部脚本文件。 内联脚本通常用于配置和动态生成代码。 这个方法的使用可以像下面这样：

$this->registerJs("var options = ".json_encode($options).";", View::POS_END, 'my-options');

第一个参数是我们想插入的实际JS代码。 第二个参数确定了JS代码插入页面的位置。可用的值如下：

  • yii\web\View::POS_HEAD 用在HEAD部分。
  • yii\web\View::POS_BEGIN 用在 <body> 标签的右边。
  • yii\web\View::POS_END 用在 </body> 标签的左边。
  • yii\web\View::POS_READY 为了在 ready 事件中执行代码，这里将自动注册yii\web\JqueryAsset。
  • yii\web\View::POS_LOAD 为了在 load 事件中执行代码，这里将自动注册yii\web\JqueryAsset。

最后一个参数是一个唯一的脚本ID，主要是用于标识一段代码块，在添加一段新的代码块时，如果当前页面已经存在同样ID代码块时，那么将会被新的替换。 如果你不传这个参数，JS代码本身将会作为ID来使用。

外部脚本的引入使用像下面这样：

$this->registerJsFile('http://example.com/js/main.js', ['depends' => [\yii\web\JqueryAsset::className()]]);

yii\web\View::registerJsFile() 中参数的使用与 yii\web\View::registerCssFile() 中的参数使用类似。 在上面的例子中,我们注册了main.js 文件，并且依赖于 JqueryAsset 类。这意味着 main.js 文件将被添加在 jquery.js 的后面。 如果没有这个依赖规范的话，main.js和 jquery.js 两者之间的顺序将不会被定义。

和 yii\web\View::registerCssFile() 一样，我们强烈建议您使用 asset bundles 来注册外部JS文件，而非使用 yii\web\View::registerJsFile() 来注册。

注册资源包

正如前面所提到的，我们推荐优先使用资源包而非直接使用CSS和JavaScript。 你可以在资源管理器 asset manager 部分查看更多细节。 至于怎样使用已经定义的资源包，这很简单：

\frontend\assets\AppAsset::register($this);

注册 CSS

你可以使用 yii\web\View::registerCss() 或者 yii\web\View::registerCssFile() 来注册CSS。 前者是注册一段CSS代码块，而后者则是注册引入外部的CSS文件，例如：

$this->registerCss("body { background: #f00; }");

上面的代码执行结果相当于在页面头部中添加了下面的代码：

<style>
body { background: #f00; }
</style>

如果你想指定样式标记的附加属性，通过一个名值对的数组添加到第三个参数。 如果你需要确保只有一个单样式标签，则需要使用第四个参数作为meta标签的描述。

$this->registerCssFile("http://example.com/css/themes/black-and-white.css", [
    'depends' => [BootstrapAsset::className()],
    'media' => 'print',
], 'css-print-theme');

上面的代码将在页面的头部添加一个link引入CSS文件。

  • 第一个参数指明被注册的CSS文件。
  • 第二个参数指明 <link> 标签的HTML属性，选项 depends 是专门处理指明CSS文件依赖于哪个资源包。在这种情况下，依赖资源包就是 yii\bootstrap\BootstrapAsset。这意味着CSS文件将被添加在 yii\bootstrap\BootstrapAsset 之后。
  • 最后一个参数指明一个ID来标识这个CSS文件。假如这个参数未传，CSS文件的URL将被作为ID来替代。

我们强烈建议使用 asset bundles 来注册外部CSS文件， 而非使用 yii\web\View::registerCssFile() 来注册。 使用资源包允许你合并并且压缩多个CSS文件，对于高流量的网站来说，这是比较理想的方式。

以上内容是否对您有帮助：
← 数据小部件（Data Widgets）
主题（Theming） →
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号