发布于 2015-08-01 11:24:17 | 349 次阅读 | 评论: 0 | 来源: 网络整理
Note: This section is under development.
With the yiiwebView object you can register scripts. There are two dedicated methods for it: yiiwebView::registerJs() for inline scripts and yiiwebView::registerJsFile() for external scripts. Inline scripts are useful for configuration and dynamically generated code. The method for adding these can be used as follows:
$this->registerJs("var options = ".json_encode($options).";", View::POS_END, 'my-options');
The first argument is the actual JS code we want to insert into the page. The second argument determines where script should be inserted into the page. Possible values are:
<body>.</body>.ready event. This will register yiiwebJqueryAsset automatically.load event. This will register yiiwebJqueryAsset automatically.The last argument is a unique script ID that is used to identify code block and replace existing one with the same ID instead of adding a new one. If you don't provide it, the JS code itself will be used as the ID.
An external script can be added like the following:
$this->registerJsFile('http://example.com/js/main.js', ['depends' => [yiiwebJqueryAsset::className()]]);
The arguments for yiiwebView::registerJsFile() are similar to those for yiiwebView::registerCssFile(). In the above example, we register the main.js file with the dependency on JqueryAsset. This means the main.js file will be added AFTER jquery.js. Without this dependency specification, the relative order between main.js and jquery.js would be undefined.
Like for yiiwebView::registerCssFile(), it is also highly recommended that you use asset bundles to register external JS files rather than using yiiwebView::registerJsFile().
As was mentioned earlier it's preferred to use asset bundles instead of using CSS and JavaScript directly. You can get details on how to define asset bundles in asset manager section of the guide. As for using already defined asset bundle, it's very straightforward:
frontendassetsAppAsset::register($this);
You can register CSS using yiiwebView::registerCss() or yiiwebView::registerCssFile(). The former registers a block of CSS code while the latter registers an external CSS file. For example,
$this->registerCss("body { background: #f00; }");
The code above will result in adding the following to the head section of the page:
<style>
body { background: #f00; }
</style>
If you want to specify additional properties of the style tag, pass an array of name-values to the third argument. If you need to make sure there's only a single style tag use fourth argument as was mentioned in meta tags description.
$this->registerCssFile("http://example.com/css/themes/black-and-white.css", [
'depends' => [BootstrapAsset::className()],
'media' => 'print',
], 'css-print-theme');
The code above will add a link to CSS file to the head section of the page.
<link> tag. The option depends is specially handled. It specifies which asset bundles this CSS file depends on. In this case, the dependent asset bundle is yiibootstrapBootstrapAsset. This means the CSS file will be added after the CSS files in yiibootstrapBootstrapAsset.It is highly recommended that you use asset bundles to register external CSS files rather than using yiiwebView::registerCssFile(). Using asset bundles allows you to combine and compress multiple CSS files, which is desirable for high traffic websites.