falkolab.ext3.layer 1.0.0a

<p>Zope3 UI Layer, resource and viewlets bundles for ExtJS v3 JavaScript library</p>
<div class="section" id="introduction">
<h1>Introduction</h1>
<p>Download ExtJS v3.x (<a class="reference external" href="http://extjs.com/products/extjs/download.php">http://extjs.com/products/extjs/download.php</a>)
and put it in your operating system anywhere.
For example for me it is the following path: /usr/lib/ext-3
Within this folder must be located extracted ExtJS v3 framework distribution.</p>
<p>Anywhere in you project register resource directory has named as <cite>ext-3</cite>.
For example:</p>
<pre class="literal-block">
&lt;resourceDirectory
layer=&quot;falkolab.ext3.layer.IExtJSLayer&quot;
name=&quot;ext-3&quot;
directory=&quot;/usr/lib/ext-3&quot;
/&gt;
</pre>
<p>This package will looking for the resourceDirectory named <cite>ext-3</cite>,
so it's important that you use the same <cite>name</cite> in the resourceDirectory statement.</p>
</div>
<div class="section" id="how-to-use">
<h1>How to use?</h1>
<p>This package provide two Viewlet Managers: IExtLayerCSS and IExtLayerJavaScript.
You may use it in you project skin template. For example like this:</p>
<pre class="literal-block">
&lt;!DOCTYPE html PUBLIC &quot;-//W3C//DTD XHTML 1.0 Transitional//EN&quot;
&quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&quot;&gt;
&lt;html xmlns=&quot;http://www.w3.org/1999/xhtml&quot; xml:lang=&quot;en&quot; lang=&quot;en&quot;
i18n:domain=&quot;mysite&quot;&gt;
&lt;head&gt;
...
&lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html;charset=utf-8&quot; /&gt;
&lt;meta http-equiv=&quot;cache-control&quot; content=&quot;no-cache&quot; /&gt;
&lt;meta http-equiv=&quot;pragma&quot; content=&quot;no-cache&quot; /&gt;
&lt;tal:block replace=&quot;structure provider:IExtLayerCSS&quot; /&gt;
&lt;tal:block replace=&quot;structure provider:IExtLayerJavaScript&quot; /&gt;
&lt;/head&gt;
&lt;body&gt;
...
&lt;/body&gt;
&lt;/html&gt;
</pre>
<p>Or derive/implement your own managers for falkolab.ext3.layer.IExtLayerCSS
and falkolab.ext3.layer.IExtLayerJavaScript interfaces.</p>
<p>NOTE: For necessary script including order, please use ordered manager:
zope.viewlet.manager.WeightOrderedViewletManager</p>
<p>This package contain several viewlet bunles for ExtJS. Use one of them according base
library you use:</p>
<table border="1" class="docutils">
<colgroup>
<col width="20%" />
<col width="80%" />
</colgroup>
<tbody valign="top">
<tr><td>ext-all.css</td>
<td>All ExtJS library CSS styles.</td>
</tr>
<tr><td>ext-standalone</td>
<td>ExtJS library with own adapter (without any external dependences).
IExtStandaloneLayer and IExtStandaloneDebugLayer layers.</td>
</tr>
<tr><td>ext-jquery</td>
<td>ExtJS library with jQuery adapter (WARNING: read note below).
IExtJQueryLayer and IExtJQueryDebugLayer layers.</td>
</tr>
<tr><td>ext-yui</td>
<td>ExtJS library with YUI adapter (WARNING: read note below).
IExtYUILayer and IExtYUIDebugLayer layers.</td>
</tr>
<tr><td>ext-prototype</td>
<td>ExtJS library with Prototype adapter (WARNING: read note below).
IExtPrototypeLayer and IExtPrototypeDebugLayer layers.</td>
</tr>
</tbody>
</table>
<p>NOTE: For bundles which dependet on external library jQuery, YUI or Prototype
you must manualy register corresponding resources in your project and place it to
your template before this package inclusions.
Please see <a class="reference external" href="http://extjs.com/learn/Ext_Getting_Started#What_is_the_proper_include_order_for_my_JavaScript_files.3F">http://extjs.com/learn/Ext_Getting_Started#What_is_the_proper_include_order_for_my_JavaScript_files.3F</a>
for details.</p>
<p>Skin layer system example:</p>
<pre class="literal-block">
from z3c.layer.pagelet import IPageletBrowserLayer
from zope.viewlet.interfaces import IViewletManager
from zope.publisher.interfaces.browser import IBrowserRequest
from falkolab.ext3.layer import IExtJQueryLayer, IExtJQueryDebugLayer
from falkolab.ext3.layer.interfaces import IExtLayerCSS, IExtLayerJavaScript

class myskin(IExtJQueryLayer):
&quot;&quot;&quot; layer for skin base components &quot;&quot;&quot;

class IMySkin(myskin, IPageletBrowserLayer):
&quot;&quot;&quot; IMySkin skin &quot;&quot;&quot;

class IMyDebugSkin(IExtJQueryDebugLayer, IMySkin):
&quot;&quot;&quot; IMySkin debug skin &quot;&quot;&quot;

class ITitle(IViewletManager):
&quot;&quot;&quot;Title viewlet manager.&quot;&quot;&quot;

# This two interfaces for case when you use own Viewlet Managers
# registration for combine site templete and falkolab.ext3.layer viewlets.
class ICSS(IExtLayerCSS):
&quot;&quot;&quot;CSS viewlet manager.&quot;&quot;&quot;

class IJavaScript(IExtLayerJavaScript):
&quot;&quot;&quot;JavaScript viewlet manager.&quot;&quot;&quot;
</pre>
</div>
<div class="section" id="changes">
<h1>CHANGES</h1>
<div class="section" id="a-2009-06-05">
<h2>1.0.0a (2009-06-05)</h2>
<ul class="simple">
<li>Initial release.</li>
</ul>
</div>
</div>