-The TClientScriptLoader publish a collection of javascript files as assets. -For example, suppose we have a directory name "mylib" in -the protected/pages directory of our application.
-The PackagePath property can be an existing asset directory -or a namespace path to the directory containing javascript files. -For example, to publish the javascript files in the mylib -directory, we can specify the PackagePath as follows. -The first tag TClientScriptLoader relies on the asset template tag and -assumes that the page template containing the TClientScriptLoader tag instance -is in the protected/pages directory. -The second TClientScriptLoader tag uses the namespace notation to -specify the path. -
- --When the files in the PackagePath are published as assets, a script loader - php file "clientscripts.php" is automatically copied - to that asset directory. - The script loader, combines multiple javascript files and serve up as gzip if possible. -
--Allowable scripts and script dependencies can be grouped by using a "packages.php" file -with the following format. This "packages.php" is optional, if absent the file names -without ".js" extension are used. The "packages.php" must be in the directory given by -PackagePath. -
- -The first element of the array returned by the packages.php should -contain an array of javascripts files relative to the packages.php -that corresponds to a particular grouping. For example, in the above packages.php, -the grouping 'package1' combines two javascript files, namely, 'file1.js' -and 'file2.js'. -
- -The second element of the array returned by the packages.php should -contain an array of grouping dependencies ordered in the way that the groups should be combined. -For example, grouping 'package1' only depends on the 'package1' grouping files -(i.e. 'file1.js' and 'file2.js'). While 'package2' depends -on both 'package1' and 'package2' groupings. That is, 'package2' -will combine, in order, 'file1.js', 'file2.js', 'file3.js', and 'file4.js'. -
- -To load a particular javascript file or package, set the PackageScripts -property with value 'package1' to load the 'package1' scripts. -A maximum of 25 packages separated by commas is allowed. -Dependencies of the packages are automatically resolved by the script loader php file. -
- -Each <com:TClientScriptLoader> generates an HTML <script> -element to load the required javascript files.
- -The DebugMode property when false -removes comments and white spaces from the published javascript files. If -the DebugMode property is not set, the debug mode is determined from the -application mode. -
--The EnableGzip property (default is true) enables the -published javascripts to be served as zipped if the browser and php server allows it. -
- --TClientScriptLoader mempublikasikan koleksi file javascript sebagai assets. Contohnya, anggap kita mempunyai direktori bernama "mylib" dalam direktori protected/pages pada aplikasi kita.
-Properti PackagePath bisa berupa direktori asset yang sudah ada atau path namespace ke direktori yang berisi file javascript. Sebagai contoh, untuk mempublikasikan file javascript dalam direktori mylib, kita dapat menetapkan PackagePath sebagai berikut. -Tag pertama TClientScriptLoader tergantung pada tag template asset dan menganggap bahwa template halaman berisi turunan tag TClientScriptLoader ada dalam direktori protected/pages. -Tag kedua TClientScriptLoader menggunakan notasi namespace ke untuk menetapkan path. -
- --Ketika file dalam PackagePath dipublikasikan sebagai asset, pengambil naskah file php "clientscripts.php" secara otomatis di-copiy ke direktori asset tersebut. Pengambil naskah, menggabungkan file javascript dan bertindak sebagai gzip jika memungkinkan. -
--Naskah yang dibolehkan dan naskah ketergantungan bisa dikelompokan dengan menggunakan file "packages.php" dengan format berikut. "packages.php" ini adalah opsional, jika tidak ada nama file tanpa ekstensi ".js" yang dipakai. "packages.php" harus berada dalam direktori yang diberikan oleh PackagePath. -
- -Elemen pertama dari array yang dihasilkan oleh packages.php harus berisi sebuah array file javascripts relatif ke packages.php yang mengaitkan pengelompokan tertentu. Sebagai contoh, dalam packages.php di atas, pengelompokan 'package1' menggabungkan dua file javascript, yaitu 'file1.js' -dan 'file2.js'. -
- -Elemen kedua dari array yang dihasilkan oleh packages.php harus berisi array pengelompokan ketergantungan yang diurut dalam cara di mana grup harus digabungkan. Sebagai contoh, mengelompokan -'package1' hanya bergantung pada file pengelompokan'package1' -(misalnya 'file1.js' dan 'file2.js'). Sementara package2' tergantung pada pepngelompokan 'package1' dam 'package2'. Yakni 'package2' akan menggabung dengan urutan -'file1.js', 'file2.js', 'file3.js', dan 'file4.js'. -
- -Untuk mengambil file javascript atau paket tertentu, setel properti PackageScripts dengan nilai 'package1' guna mengambil naskah 'package1'. Maksimum 25 paket dipisahkan dengan koma yang dibolehkan. Ketergantungan paket secara otomatis dipecahkan oleh file php pengambil naskah. -
- -Setiap <com:TClientScriptLoader> membuat elemen HTML <script> untuk mengambil file javascript yang diperlukan.
- -Properti DebugMode bila false menghapus komentar dan spasi dari file javascript yang dipublikasikan. Jika properti -DebugMode tidak disetel, mode debug ditentukan dari -mode aplikasi. -
--Properti EnableGzip (standarnya true) membolehkan javascripts yang dipublikasikan untuk dilayani sebagai zipped jika browser dan server php mengijinkannya. -
- -