/library/javascripts/jquery/jquery.ui/ReadMe.html

Important Note

JQUERY UI HAS NOT YET BEEN APPROVED FOR USE AT THE SBA.

Directory Structure

In general, jQuery UI will be 2 directories down from jquery.js, the second of which is a version number. In addition, there is also a "theme" under the /css subdirectory, which is currently /start. as in the following example:

    <cfset Variables.LibURL          = "/library">
    <cfset Variables.LibJsURL        = "#Variables.LibURL#/javascripts">
    <cfset Variables.LibJqURL        = "#Variables.LibJsURL#/jquery">
    <cfset Variables.LibUiURL        = "#Variables.LibJqURL#/jquery.ui/1.8.16">
    <cfset Variables.LibUiCssURL     = "#Variables.LibUiURL#/css/start">
    <cfset Variables.LibUiDevURL     = "#Variables.LibUiURL#/development-bundle">
    <cfset Variables.LibUiJsURL      = "#Variables.LibUiURL#/js">

In addition, there are symbolic links defined in the version-number/css/start and version-number/js subdirectories, to deal with the fact that there are version numbers in the filenames of the 2 main files. This allows you to always say the following, no matter which version or theme you choose:

    <link href="#Variables.LibUiCssURL#/jquery.ui.css" rel="stylesheet" type="text/css" />
    <script src="#Variables.LibUiJsURL#/jquery.ui.js"></script>

"Best Practices"

In this example, when a new version of jQuery UI comes along, all you would have to change is "LibUiURL", and all of your Css, Dev and Js URLs would be repointed to the new version automatically. This imposes too much of a maintenance burden on the developers, so there will always be a symbolic link under the /library/javascripts/jquery/jquery.ui directory called "current" that will point to the current version of jQuery UI we're using. The same goes for the "Start" theme. There will always be a symbolic link under the /css subdirectory called "current" that will point to the current theme If you use these symbolic links, you won't ever have to change the subdirectory names to pick up the current version or theme. Using "current" is PREFERRED. For example:

    <cfset Variables.LibUiURL        = "#Variables.LibJqURL#/jquery.ui/current">
    <cfset Variables.LibUiCssURL     = "#Variables.LibUiURL#/css/current">

Or, if you want to keep with the latest-and-greatest version, even if we haven't declared it to be our current version yet, there will also be "latest" symbolic links as well:

    <cfset Variables.LibUiURL        = "#Variables.LibJqURL#/jquery.ui/latest">
    <cfset Variables.LibUiCssURL     = "#Variables.LibUiURL#/css/latest">

Current State of Testing

Currently, both "current" and "latest" are pointing to version 1.8.16 using the "Start" theme. The "Start" theme is very close to SBA Look-and-Feel's current use of blues and greens. To prove to yourself (if you need convincing) that all of these symbolic links work, try visiting the "Welcome to jQuery UI" home page by clicking on any of the following, all of which open a new window: