# 客戶端腳本使用
> 注意: 此部分應用于開發環境
### 注冊腳本
你可以使用 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](http://www.yiichina.com/doc/guide/2.0/structure-assets)?來注冊外部JS文件，而非使用 yii\web\View::registerJsFile() 來注冊。
### 注冊資源包
正如前面所提到的，我們推薦優先使用資源包而非直接使用CSS和JavaScript。 你可以在資源管理器?[asset manager](http://www.yiichina.com/doc/guide/2.0/structure-assets)?部分查看更多細節。 至于怎樣使用已經定義的資源包，這很簡單：
~~~
\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](http://www.yiichina.com/doc/guide/2.0/structure-assets)?來注冊外部CSS文件， 而非使用 yii\web\View::registerCssFile() 來注冊。 使用資源包允許你合并并且壓縮多個CSS文件，對于高流量的網站來說，這是比較理想的方式。
- 介紹（Introduction）
- 關于 Yii（About Yii）
- 從 Yii 1.1 升級（Upgrading from Version 1.1）
- 入門（Getting Started）
- 安裝 Yii（Installing Yii）
- 運行應用（Running Applications）
- 第一次問候（Saying Hello）
- 使用 Forms（Working with Forms）
- 玩轉 Databases（Working with Databases）
- 用 Gii 生成代碼（Generating Code with Gii）
- 更上一層樓（Looking Ahead）
- 應用結構（Application Structure）
- 結構概述（Overview）
- 入口腳本（Entry Scripts）
- 應用（Applications）
- 應用組件（Application Components）
- 控制器（Controllers）
- 模型（Models）
- 視圖（Views）
- 模塊（Modules）
- 過濾器（Filters）
- 小部件（Widgets）
- 前端資源（Assets）
- 擴展（Extensions）
- 請求處理（Handling Requests）
- 運行概述（Overview）
- 引導（Bootstrapping）
- 路由引導與創建 URL（Routing and URL Creation）
- 請求（Requests）
- 響應（Responses）
- Sessions and Cookies
- 錯誤處理（Handling Errors）
- 日志（Logging）
- 關鍵概念（Key Concepts）
- 組件（Components）
- 屬性（Properties）
- 事件（Events）
- 行為（Behaviors）
- 配置（Configurations）
- 別名（Aliases）
- 類自動加載（Class Autoloading）
- 服務定位器（Service Locator）
- 依賴注入容器（Dependency Injection Container）
- 配合數據庫工作（Working with Databases）
- 數據庫訪問（Data Access Objects）: 數據庫連接、基本查詢、事務和模式操作
- 查詢生成器（Query Builder）: 使用簡單抽象層查詢數據庫
- 活動記錄（Active Record）: 活動記錄對象關系映射（ORM），檢索和操作記錄、定義關聯關系
- 數據庫遷移（Migrations）: 在團體開發中對你的數據庫使用版本控制
- Sphinx
- Redis
- MongoDB
- ElasticSearch
- 接收用戶數據（Getting Data from Users）
- 創建表單（Creating Forms）
- 輸入驗證（Validating Input）
- 文件上傳（Uploading Files）
- 收集列表輸入（Collecting Tabular Input）
- 多模型同時輸入（Getting Data for Multiple Models）
- 顯示數據（Displaying Data）
- 格式化輸出數據（Data Formatting）
- 分頁（Pagination）
- 排序（Sorting）
- 數據提供器（Data Providers）
- 數據小部件（Data Widgets）
- 操作客戶端腳本（Working with Client Scripts）
- 主題（Theming）
- 安全（Security）
- 認證（Authentication）
- 授權（Authorization）
- 處理密碼（Working with Passwords）
- 客戶端認證（Auth Clients）
- 安全領域的最佳實踐（Best Practices）
- 緩存（Caching）
- 概述（Overview）
- 數據緩存（Data Caching）
- 片段緩存（Fragment Caching）
- 分頁緩存（Page Caching）
- HTTP 緩存（HTTP Caching）
- RESTful Web 服務
- 快速入門（Quick Start）
- 資源（Resources）
- 控制器（Controllers）
- 路由（Routing）
- 格式化響應（Response Formatting）
- 授權驗證（Authentication）
- 速率限制（Rate Limiting）
- 版本化（Versioning）
- 錯誤處理（Error Handling）
- 開發工具（Development Tools）
- 調試工具欄和調試器（Debug Toolbar and Debugger）
- 使用 Gii 生成代碼（Generating Code using Gii）
- TBD 生成 API 文檔（Generating API Documentation）
- 測試（Testing）
- 概述（Overview）
- 搭建測試環境（Testing environment setup）
- 單元測試（Unit Tests）
- 功能測試（Functional Tests）
- 驗收測試（Acceptance Tests）
- 測試夾具（Fixtures）
- 高級專題（Special Topics）
- 高級應用模版（Advanced Project Template）
- 從頭構建自定義模版（Building Application from Scratch）
- 控制臺命令（Console Commands）
- 核心驗證器（Core Validators）
- 國際化（Internationalization）
- 收發郵件（Mailing）
- 性能優化（Performance Tuning）
- 共享主機環境（Shared Hosting Environment）
- 模板引擎（Template Engines）
- 集成第三方代碼（Working with Third-Party Code）
- 小部件（Widgets）
- Bootstrap 小部件（Bootstrap Widgets）
- jQuery UI 小部件（jQuery UI Widgets）
- 助手類（Helpers）
- 助手一覽（Overview）
- Array 助手（ArrayHelper）
- Html 助手（Html）
- Url 助手（Url）