yii logo
Yii have CClientScript package which supports us register client script like javascript and css file in view. For better performance, we should use CClientScript to include js, css file instead of append html tag in layout.
We should do that in some cases:
  1. Write client script without using any widgets or built-in components of Yii
  2. Using ajax calling: some time we return the result in html type by using renderPartial() method. It's will return all clientscript that is written in that view, without register clientscript it will render every time we return the view
  3. Loading any yii widget with ajax request and we need to call this multiple time then what happens, ajax call each time load the js file or jquery file, which slows down your application.
So, we can do something below to get your app better:

Register core script

Yii have built-in client script packages which locate in yii/framework/web/js/source folder. The list of all supporting client script is listed in yii/framework/web/js/packages.php file. You can take a look at that file to see how to see the name of them. For example, I register 'jquery' as a core script like the followings
Yii will render jquery into /assets folder. Here is the result:
<script type="text/javascript" src="/assets/3869f222/jquery.js"></script>

Register a javascript file

For register a javascript file in Yii. We use registerScriptFile method which path of file as parameter.


You can also specific the position of include tag in script by using CClientScript:POS_* ( with * is the specific position).
- At the bottom of html page (before tag)
<script type="text/javascript" src="/themes/summer/assets/js/default.js"></script>
-At the begin of page (right after body tag)

- In the header of page :
<script type="text/javascript" src="/themes/summer/assets/plugin/jquery/datetime-ja.js"></script>
You also use POS_LOAD and POS_READY option, to include script when page loading or when all DOM is ready.

Register css file

To register a css file in Yii, you just have to use registerCssFile method of clientScript class like the followings.
As the above, we specific the path of css file as a parameter of registerCssFile method. That style.css is in /assets/css of theme folder of yii application. And the result (summer is name of current theme of app):
<link rel="stylesheet" type="text/css" href="/themes/summer/assets/css/style.css" />
We can also specific css file for media type. See more media type at: reference
For example, I include print.css file for print media type :
and here is the result:
<link rel="stylesheet" type="text/css" href="/themes/summer/assets/css/style.css" media="print" />