From 0241385595b4ac1a3da04457985b78785e6ec979 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B4=94=E4=BA=AE?= Date: Sat, 17 Nov 2018 16:25:25 +0800 Subject: [PATCH] Update output-client-scripts.md --- docs/guide-zh-CN/output-client-scripts.md | 221 ++++++++++++++++------ 1 file changed, 168 insertions(+), 53 deletions(-) diff --git a/docs/guide-zh-CN/output-client-scripts.md b/docs/guide-zh-CN/output-client-scripts.md index ca138e73a5..f6a5d14637 100644 --- a/docs/guide-zh-CN/output-client-scripts.md +++ b/docs/guide-zh-CN/output-client-scripts.md @@ -1,70 +1,84 @@ 客户端脚本使用 =========================== -> Note: 此部分应用于开发环境 +现代 Web 应用程序， +除了呈现并发送到浏览器的静态 HTML 页面外， +还包含 JavaScript， +用于通过操纵现有元素或通过 AJAX 加载新内容来修改浏览器中的页面。 +本节介绍 Yii 提供的用于向网站添加 JavaScript 和 CSS 以及动态调整它们的方法。 -### 注册脚本 +## 注册脚本 -你可以使用 [[yii\web\View]] 对象注册脚本。这里有两个专门的方法： -（1）[[yii\web\View::registerJs()|registerJs()]] 用于内联脚本。 -（2）[[yii\web\View::registerJsFile()|registerJsFile()]] 用于注册引入外部脚本文件。 -内联脚本通常用于配置和动态生成代码。 -这个方法的使用可以像下面这样： +使用 [[yii\web\View]] 对象时，可以动态注册前端脚本。 +这里有两个专门的方法： + +- [[yii\web\View::registerJs()|registerJs()]] 用于内联脚本。 +- [[yii\web\View::registerJsFile()|registerJsFile()]] 用于注册引入外部脚本文件。 + +### 注册内联脚本 + +内联脚本对于配置，动态生成的代码以及由 [widgets](structure-widgets.md) 中包含的可重用前端代码创建的小片段非常有用。 +[[yii\web\View::registerJs()|registerJs()]] 添加这些方法可以像如下使用： ```php -$this->registerJs("var options = ".json_encode($options).";", View::POS_END, 'my-options'); +$this->registerJs( + "$('#myButton').on('click', function() { alert('Button clicked!'); });", + View::POS_READY, + 'my-button-handler' +); ``` -第一个参数是我们想插入的实际JS代码。 -第二个参数确定了JS代码插入页面的位置。可用的值如下： +第一个参数是我们想插入的实际 JS 代码。 +它将被包含到 `