Front-end Resources

Version 19.1 by Oana Florea on 2010/05/10

This section is a work in progress.

This sections 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 a lot too much things 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:

$xwiki.jsfx.use("js/scriptaculous/slider.js")

In XWiki Syntax 2.0:

{{velocity}}
$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. Almost all of the (except prototype.js) are not included by default in HTML-rendered wiki pages. 

Hereunder is a table presenting some of the external libraries XWiki comes with: 

prototype.gif smartclient.png
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 so much more. Prototype is the only JavaScript library that is systematically shipped with any wiki page in XWiki. Smartclient is an AJAX RIA system to easily develop rich interface components. Using it in XWiki, you can build powerful front-end widgets that can leverage XWiki's RESTful API.

Internal resources

Front-end Components

JavaScript resources

StyleSheet resources

Tags:
   

Get Connected