Front-end Resources
This section aims to document all the front-end resources available in XWiki for application developers and for developers of the XWiki products. Front-end resources are of two main types:
- External Libraries
- Internal components (Based or not on some of the external libraries)
Front-end resources are mainly composed of JavaScript libraries, CSS stylesheets and their corresponding HTML reusable snippets (or velocity macro to output this snippet), and velocity macros.
Some of the resources presented in here are not included by default with all HTML-rendered wiki pages (it would be too much to send to the client!). You have to request their inclusion from a skin template or from the wiki page itself using the jsfx plugin. For example, to request the inclusion of scriptaculous slider library, you can write, in XWiki Syntax 1.0:
In XWiki Syntax 2.0:
$xwiki.jsfx.use("js/scriptaculous/slider.js")
{{/velocity}}
The path you indicate to the jsfx plugin is the relative path where the library can be found under the resources directory of the XWiki webapp. Similarly to the jsfx plugin, there is a ssfx plugin that can be used to request the inclusion of CSS stylesheets files.
External resources
External resources are third party libraries bundled with the XWiki webapp as resources developers can use for their in-wiki applications, or to enhance the wiki itself. External resources are not included by default in HTML-rendered wiki pages, except for prototype.js.
Hereunder is a table presenting some of the external libraries XWiki comes with:
Prototype is a "JavaScript framework that aims to ease development of web applications". It extends the JavaScript native objects and browser objects providing utilities for Ajax, OOP-style classes, and much more. Prototype is the only JavaScript library that is systematically shipped with any wiki page in XWiki. | Smartclient is an AJAX RIA system that allows the easy development of rich interface components. Using it in XWiki, you can build powerful front-end widgets that can leverage XWiki's RESTful API. |
- Scriptaculous
- YUI
- LiveValidation