Diligence is still under development and incomplete, and some this documentation is wrong. For a more comprehensive but experimental version download the Savory Framework, which was the preview release of Diligence.
Sencha Integration
Ext JS and Sencha Touch are both large JavaScript frameworks in their own right, and Diligence supports many of their features. For this reason, we've divided the section for Sencha Integration into several sub-sections. Still, you'll want to start here, where we go over some general usage applicable to all features.
After that, go ahead and read the sections for the following integration features:
- Grids
- Trees
- Charts
- Forms
- Ext Direct
Usage
Make sure to check out the API documentation for Diligence.Sencha.
To include Ext JS in your HTML page, you'll want to insert a scriptlet, resulting in a page template similar to this:
<html>
<head>
...
<%
document.executeOnce('/diligence/integration/frontend/sencha/')
Diligence.Sencha.extJsHead(conversation, 'ext-all-gray')
%>
</head>
<body>
...
</body>
<script type="text/javascript">
Ext.onReady(function() {
...
});
</script>
</html>
Notes:
- The "extJsHead" method uses "conversation.pathToBase" to make sure that the correct relative URL is inserted. Be aware of this if you intend to cache that fragment for all URLs.
- The second argument is the theme: it will be "ext-all" if not provided.
-
This also includes Diligence's Ext JS client-side helper library. You don't have to use it, but it can make your life easier. You can find it under "/libraries/web/scripts/diligence/integration/ext-js.js". The library enhances Ext JS via:
- JSON Readers and Writers that support MongoDB's extended JSON format. This will allow you to automatically translate $date, $long and other JSON extensions. Even without using MongoDB, this is a very useful format.
- A data Proxy that automatically uses the extended JSON Reader and Writer, and builds URLs in Diligence's default structure.
The Diligence Manual is provided for you under the terms of the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License. The complete manual is available for download as a PDF.
