This section is a work in progress.

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:

$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

XWiki Enterprise contains some third-party libraries bundled by default.

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

Library NameDescription
prototype.gifPrototype 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.pngSmartclient 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
 JQuery
 JQuery UI

Internal resources

Front-end Components

JavaScript resources

StyleSheet resources

Tags:
Created by Guillaume Lerouge on 2009/03/23
   

Get Connected