diff options
author | ctrlaltca <> | 2012-07-24 16:13:10 +0000 |
---|---|---|
committer | ctrlaltca <> | 2012-07-24 16:13:10 +0000 |
commit | 255db529c49ae00f5e8defb14c77461582edfd39 (patch) | |
tree | 4a1bd93054d912fcde81f87f62127c25ae98c100 /demos/quickstart | |
parent | 178a57096360c77e87f6a20e2d282b99a28a4e9c (diff) |
removed TClientScriptLoader documentation since it doesn't exists anymore in prado 3.2
Diffstat (limited to 'demos/quickstart')
4 files changed, 0 insertions, 223 deletions
diff --git a/demos/quickstart/protected/pages/Controls/ClientScriptLoader.page b/demos/quickstart/protected/pages/Controls/ClientScriptLoader.page deleted file mode 100644 index bad47959..00000000 --- a/demos/quickstart/protected/pages/Controls/ClientScriptLoader.page +++ /dev/null @@ -1,122 +0,0 @@ -<com:TContent ID="body" > - -<h1 id="62003">TClientScriptLoader</h1> - -<com:DocLink ClassPath="System.Web.UI.WebControls.TClientScriptLoader" /> - -<com:SinceVersion Version="3.1b" /> - -<p class="block-content"> -The <tt>TClientScriptLoader</tt> publish a collection of javascript files as assets. -For example, suppose we have a directory name "<tt>mylib</tt>" in -the <tt>protected/pages</tt> directory of our application.</p> -<com:TTextHighlighter Language="prado" CssClass="source block-content"> -assets/ -protected/ - pages/ - mylib/ - file1.js - file2.js - file3.js - file4.js - packages.php -</com:TTextHighlighter> - -<p class="block-content">The <tt>PackagePath</tt> 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 <tt>mylib</tt> -directory, we can specify the <tt>PackagePath</tt> as follows. -The first tag <tt>TClientScriptLoader</tt> relies on the asset template tag and -assumes that the page template containing the <tt>TClientScriptLoader</tt> tag instance -is in the <tt>protected/pages</tt> directory. -The second <tt>TClientScriptLoader</tt> tag uses the namespace notation to -specify the path. -</p> - -<com:TTextHighlighter Language="prado" CssClass="source block-content"> -<com:TClientScriptLoader PackagePath=<%~ mylib %> /> -<com:TClientScriptLoader PackagePath="Application.pages.mylib" /> -</com:TTextHighlighter> - -<p class="block-content"> -When the files in the <tt>PackagePath</tt> are published as assets, a script loader - php file "<tt>clientscripts.php</tt>" is automatically copied - to that asset directory. - The script loader, combines multiple javascript files and serve up as gzip if possible. -</p> -<h2 id="62004">Grouping Javascript Files</h2> -<p class="block-content"> -Allowable scripts and script dependencies can be grouped by using a "<tt>packages.php</tt>" file -with the following format. This "<tt>packages.php</tt>" is optional, if absent the file names -without ".js" extension are used. The "<tt>packages.php</tt>" must be in the directory given by -<tt>PackagePath</tt>. -</p> - -<com:TTextHighlighter Language="php" CssClass="source block-content"> -<?php - $packages = array( - 'package1' => array('file1.js', 'file2.js'), - 'package2' => array('file3.js', 'file4.js')); - - $deps = array( - 'package1' => array('package1'), - 'package2' => array('package1', 'package2')); //package2 requires package1 first. - - return array($packages,$deps); //must return $packages and $deps in an array -?> -</com:TTextHighlighter> - -<p class="block-content">The first element of the array returned by the <tt>packages.php</tt> should -contain an array of javascripts files relative to the <tt>packages.php</tt> -that corresponds to a particular grouping. For example, in the above <tt>packages.php</tt>, -the grouping '<tt>package1</tt>' combines two javascript files, namely, '<tt>file1.js</tt>' -and '<tt>file2.js</tt>'. -</p> - -<p class="block-content">The second element of the array returned by the <tt>packages.php</tt> should -contain an array of grouping dependencies ordered in the way that the groups should be combined. -For example, grouping '<tt>package1</tt>' only depends on the '<tt>package1</tt>' grouping files -(i.e. '<tt>file1.js</tt>' and '<tt>file2.js</tt>'). While '<tt>package2</tt>' depends -on both '<tt>package1</tt>' and '<tt>package2</tt>' groupings. That is, '<tt>package2</tt>' -will combine, in order, '<tt>file1.js</tt>', '<tt>file2.js</tt>', '<tt>file3.js</tt>', and '<tt>file4.js</tt>'. -</p> - -<h2 id="62005">Loading Javascript Packages</h2> - -<p class="block-content">To load a particular javascript file or package, set the <tt>PackageScripts</tt> -property with value '<tt>package1</tt>' to load the '<tt>package1</tt>' scripts. -A maximum of 25 packages separated by commas is allowed. -Dependencies of the packages are automatically resolved by the script loader php file. -</p> - -<com:TTextHighlighter Language="prado" CssClass="source block-content"> -<com:TClientScriptLoader PackagePath=<%~ mylib %> PackageScripts="package2" /> -<script type="text/javascript"> - //javascript code utilizing javascript code loaded in 'package2' above -</script> -</com:TTextHighlighter> - -<p id="310009" class="block-content">Each <tt><com:TClientScriptLoader></tt> generates an HTML <tt><script></tt> -element to load the required javascript files.</p> - -<h2 id="62006">Removing Javascript Comments</h2> -<p class="block-content">The <tt>DebugMode</tt> property when false -removes comments and white spaces from the published javascript files. If -the <tt>DebugMode</tt> property is not set, the debug mode is determined from the -<a href="?page=Advanced.Performance">application mode</a>. -</p> -<div class="note"><b class="note">Note:</b> -If the <tt>DebugMode</tt> is false either explicitly or when the application mode is non-debug, -then cache headers are also sent to inform the browser and proxies to cache the file. -Moreover, the post-processed (comments removed and zipped) are saved in the assets -directory for the next requests. That is, in non-debug mode the scripts are cached -in the assets directory until they are deleted. -</div> - -<h2 id="62007">Compressing Javascript with GZip</h2> -<p class="block-content"> -The <tt>EnableGzip</tt> property (default is true) enables the -published javascripts to be served as zipped if the browser and php server allows it. -</p> - -</com:TContent> diff --git a/demos/quickstart/protected/pages/Controls/Standard.page b/demos/quickstart/protected/pages/Controls/Standard.page index 9c805188..188cdd19 100644 --- a/demos/quickstart/protected/pages/Controls/Standard.page +++ b/demos/quickstart/protected/pages/Controls/Standard.page @@ -24,10 +24,6 @@ </li>
<li>
- <a href="?page=Controls.ClientScriptLoader">TClientScriptLoader</a> loads custom javascript libraries.
- </li>
-
- <li>
<a href="?page=Controls.ColorPicker">TColorPicker</a> represents an input field taking color values via a color dialog.
</li>
diff --git a/demos/quickstart/protected/pages/Controls/id/ClientScriptLoader.page b/demos/quickstart/protected/pages/Controls/id/ClientScriptLoader.page deleted file mode 100644 index e722e66d..00000000 --- a/demos/quickstart/protected/pages/Controls/id/ClientScriptLoader.page +++ /dev/null @@ -1,93 +0,0 @@ -<com:TContent ID="body" >
-
-<h1>TClientScriptLoader</h1>
-
-<com:DocLink ClassPath="System.Web.UI.WebControls.TClientScriptLoader" />
-
-<com:SinceVersion Version="3.1b" />
-
-<p class="block-content">
-<tt>TClientScriptLoader</tt> mempublikasikan koleksi file javascript sebagai assets. Contohnya, anggap kita mempunyai direktori bernama "<tt>mylib</tt>" dalam direktori <tt>protected/pages</tt> pada aplikasi kita.</p>
-<com:TTextHighlighter Language="prado" CssClass="source block-content">
-assets/
-protected/
- pages/
- mylib/
- file1.js
- file2.js
- file3.js
- file4.js
- packages.php
-</com:TTextHighlighter>
-
-<p class="block-content">Properti <tt>PackagePath</tt> bisa berupa direktori asset yang sudah ada atau path namespace ke direktori yang berisi file javascript. Sebagai contoh, untuk mempublikasikan file javascript dalam direktori <tt>mylib</tt>, kita dapat menetapkan <tt>PackagePath</tt> sebagai berikut.
-Tag pertama <tt>TClientScriptLoader</tt> tergantung pada tag template asset dan menganggap bahwa template halaman berisi turunan tag <tt>TClientScriptLoader</tt> ada dalam direktori <tt>protected/pages</tt>.
-Tag kedua <tt>TClientScriptLoader</tt> menggunakan notasi namespace ke untuk menetapkan path.
-</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content">
-<com:TClientScriptLoader PackagePath=<%~ mylib %> />
-<com:TClientScriptLoader PackagePath="Application.pages.mylib" />
-</com:TTextHighlighter>
-
-<p class="block-content">
-Ketika file dalam <tt>PackagePath</tt> dipublikasikan sebagai asset, pengambil naskah file php "<tt>clientscripts.php</tt>" secara otomatis di-copiy ke direktori asset tersebut. Pengambil naskah, menggabungkan file javascript dan bertindak sebagai gzip jika memungkinkan.
-</p>
-<h2>Mengelompokan File Javascript</h2>
-<p class="block-content">
-Naskah yang dibolehkan dan naskah ketergantungan bisa dikelompokan dengan menggunakan file "<tt>packages.php</tt>" dengan format berikut. "<tt>packages.php</tt>" ini adalah opsional, jika tidak ada nama file tanpa ekstensi ".js" yang dipakai. "<tt>packages.php</tt>" harus berada dalam direktori yang diberikan oleh <tt>PackagePath</tt>.
-</p>
-
-<com:TTextHighlighter Language="php" CssClass="source block-content">
-<?php
- $packages = array(
- 'package1' => array('file1.js', 'file2.js'),
- 'package2' => array('file3.js', 'file4.js'));
-
- $deps = array(
- 'package1' => array('package1'),
- 'package2' => array('package1', 'package2')); //package2 memerlukan package1 pertama.
-
- return array($packages,$deps); //harus mengembalikan $packages dan $deps dalam array ?>
-</com:TTextHighlighter>
-
-<p class="block-content">Elemen pertama dari array yang dihasilkan oleh <tt>packages.php</tt> harus berisi sebuah array file javascripts relatif ke <tt>packages.php</tt> yang mengaitkan pengelompokan tertentu. Sebagai contoh, dalam <tt>packages.php</tt> di atas, pengelompokan '<tt>package1</tt>' menggabungkan dua file javascript, yaitu '<tt>file1.js</tt>'
-dan '<tt>file2.js</tt>'.
-</p>
-
-<p class="block-content">Elemen kedua dari array yang dihasilkan oleh <tt>packages.php</tt> harus berisi array pengelompokan ketergantungan yang diurut dalam cara di mana grup harus digabungkan. Sebagai contoh, mengelompokan
-'<tt>package1</tt>' hanya bergantung pada file pengelompokan'<tt>package1</tt>'
-(misalnya '<tt>file1.js</tt>' dan '<tt>file2.js</tt>'). Sementara <tt>package2</tt>' tergantung pada pepngelompokan '<tt>package1</tt>' dam '<tt>package2</tt>'. Yakni '<tt>package2</tt>' akan menggabung dengan urutan
-'<tt>file1.js</tt>', '<tt>file2.js</tt>', '<tt>file3.js</tt>', dan '<tt>file4.js</tt>'.
-</p>
-
-<h2>Mengambil Paket Javascript</h2>
-
-<p class="block-content">Untuk mengambil file javascript atau paket tertentu, setel properti <tt>PackageScripts</tt> dengan nilai '<tt>package1</tt>' guna mengambil naskah '<tt>package1</tt>'. Maksimum 25 paket dipisahkan dengan koma yang dibolehkan. Ketergantungan paket secara otomatis dipecahkan oleh file php pengambil naskah.
-</p>
-
-<com:TTextHighlighter Language="prado" CssClass="source block-content">
-<com:TClientScriptLoader PackagePath=<%~ mylib %> PackageScripts="package2" />
-<script type="text/javascript">
- //kode javascript memanfaatkan kode javascript yg diambil ke dalam 'package2' di atas </script>
-</com:TTextHighlighter>
-
-<p>Setiap <tt><com:TClientScriptLoader></tt> membuat elemen HTML <tt><script></tt> untuk mengambil file javascript yang diperlukan.</p>
-
-<h2>Menghapus Komentar Javascript</h2>
-<p class="block-content">Properti <tt>DebugMode</tt> bila false menghapus komentar dan spasi dari file javascript yang dipublikasikan. Jika properti
-<tt>DebugMode</tt> tidak disetel, mode debug ditentukan dari
-<a href="?page=Advanced.Performance">mode aplikasi</a>.
-</p>
-<div class="note"><b class="note">Catatan:</b>
-Jika <tt>DebugMode</tt> adalah false baik secara eksplisit ataupun ketika mode aplikasi adalah non-debug, maka header cache juga dikirimkan untuk memberitahu
-browser dan proxy untuk melakukan cache file.
-Lebih lanjut, pasca proses (komentar dihapus dan di-zip) disimpan dalam direktori asset untuk permintaan berikutnya. Yaitu mode non-debug, naskah di-cache dalam direktori asset sampai ia dihapus.
-</div>
-
-<h2>Memadatkan Javascript dengan GZip</h2>
-<p class="block-content">
-Properti <tt>EnableGzip</tt> (standarnya true) membolehkan javascripts yang dipublikasikan untuk dilayani sebagai zipped jika browser dan server php mengijinkannya.
-</p>
-
-</com:TContent>
diff --git a/demos/quickstart/protected/pages/Controls/id/Standard.page b/demos/quickstart/protected/pages/Controls/id/Standard.page index 9069b5a1..5e9f76d8 100644 --- a/demos/quickstart/protected/pages/Controls/id/Standard.page +++ b/demos/quickstart/protected/pages/Controls/id/Standard.page @@ -19,10 +19,6 @@ <a href="?page=Controls.ClientScript">TClientScript</a> menambahkan kode javascript ke halaman.
</li>
- <li>
- <a href="?page=Controls.ClientScriptLoader">TClientScriptLoader</a> mengambil pustaka javascript kustom.
- </li>
-
<li>*
<a href="?page=Controls.ColorPicker">TColorPicker</a> mewakili field input yang mengambil nilai warna via dialog warna.
</li>
|