169 lines
5.9 KiB
Text
169 lines
5.9 KiB
Text
|
-------------------------------------------------------------------------------
|
||
|
dojox.widget Collection
|
||
|
-------------------------------------------------------------------------------
|
||
|
Version 1.0
|
||
|
Release date: 10/31/2007
|
||
|
-------------------------------------------------------------------------------
|
||
|
Project state:
|
||
|
|
||
|
[Calendar] experimental
|
||
|
[CalendarFx] experimental
|
||
|
[ColorPicker] beta
|
||
|
[Dialog] experimental
|
||
|
[FilePicker] experimental
|
||
|
[FisheyeList] experimental
|
||
|
[FisheyeLite] beta
|
||
|
[Iterator] experimental
|
||
|
[Loader] experimental
|
||
|
[Pager] experimental
|
||
|
[PlaceholderMenuItem] experimental
|
||
|
[Roller] experimental
|
||
|
[RollingList] experimental
|
||
|
[SortList] experimental
|
||
|
[Toaster] experimental
|
||
|
[Wizard] experimental
|
||
|
[AnalogGauge] experimental
|
||
|
[BarGauge] experimental
|
||
|
[Standby] experimental
|
||
|
-------------------------------------------------------------------------------
|
||
|
Credits:
|
||
|
|
||
|
[Calendar] Shane O'Sullivan
|
||
|
[CalendarFx] Shane O'Sullivan
|
||
|
[ColorPicker] Peter Higgins (dante)
|
||
|
[Dialog] Peter Higgins (dante)
|
||
|
[FilePicker] Nathan Toone (toonetown)
|
||
|
[FisheyeList] Karl Tiedt (kteidt)
|
||
|
[FisheyeLite] Peter Higgins (dante)
|
||
|
[Iterator] Alex Russell (slightlyoff)
|
||
|
[Loader] Peter Higgins (dante)
|
||
|
[Pager] Nikolai Onken (nonken), Peter Higgins (dante);
|
||
|
[PlaceholderMenuItem] Nathan Toone (toonetown)
|
||
|
[Roller] Peter Higgins (dante)
|
||
|
[RollingList] Nathan Toone (toonetown)
|
||
|
[SortList] Peter Higgins (dante)
|
||
|
[Toaster] Adam Peller (peller)
|
||
|
[Wizard] Peter Higgins (dante)
|
||
|
[AnalogGauge] Benjamin Schell (bmschell) CCLA
|
||
|
[BarGauge] Benjamin Schell (bmschell) CCLA
|
||
|
[Standby] Jared Jurkiewicz (jaredj) CCLA
|
||
|
|
||
|
-------------------------------------------------------------------------------
|
||
|
Project description
|
||
|
|
||
|
This is a collection of standalone widgets for use in
|
||
|
your website. Each individual widget is independent
|
||
|
of the others.
|
||
|
|
||
|
-------------------------------------------------------------------------------
|
||
|
Dependencies:
|
||
|
|
||
|
Each widget has it's own requirements and dependencies.
|
||
|
Most inherit from dijit base-classes such as dijit._Widget,
|
||
|
dijit._Templated, etc ... So we will assume the availablility
|
||
|
of dojo (core), and dijit packages.
|
||
|
|
||
|
Each individual component stores resources in a folder that shares
|
||
|
a name with the Widget. For instance:
|
||
|
|
||
|
the Dialog lives in
|
||
|
dojox/widget/Dialog.js ...
|
||
|
|
||
|
and the folder:
|
||
|
dojox/widget/Dialog/ contains a 'Dialog.css', the required
|
||
|
styles for that particular widget. All required templates and
|
||
|
images reside in the folder.
|
||
|
|
||
|
This differs slightly from the rest of DojoX in that each other
|
||
|
project uses a shared resources/ folder in the project folder,
|
||
|
though uses the same naming convention for stylesheets and templates.
|
||
|
|
||
|
eg:
|
||
|
dojox/layout/resources/ExpandoPane.css
|
||
|
dojox.layout.ExpandoPane
|
||
|
|
||
|
-------------------------------------------------------------------------------
|
||
|
Documentation
|
||
|
|
||
|
Please refer to the API-tool, or in-line documentation. All of these
|
||
|
widgets are of varying use, quality, and documentation completion.
|
||
|
|
||
|
-------------------------------------------------------------------------------
|
||
|
Installation instructions
|
||
|
|
||
|
These are standalone Widgets, so putting the [widget].js file
|
||
|
in your dojox/widget folder, and copying any files in the
|
||
|
/dojox/widget/[widget]/ folder as supplements/templates/etc
|
||
|
should be all you need to do.
|
||
|
|
||
|
eg: FisheyeList:
|
||
|
/dojox/widget/FisheyeList.js
|
||
|
/dojox/widget/FisheyeList/FisheyeList.css
|
||
|
|
||
|
should be all you need to use the Fisheye widget.
|
||
|
|
||
|
you can safely import the whole widget project into your
|
||
|
dojox/ root directory from the following SVN url:
|
||
|
|
||
|
http://svn.dojotoolkit.org/src/dojox/trunk/widget
|
||
|
|
||
|
-------------------------------------------------------------------------------
|
||
|
Other Notes (Brief widget list):
|
||
|
|
||
|
* ColorPicker - An HSV ColorPicker intended to be a drop down
|
||
|
|
||
|
* Calendar - An extension on the dijit._Calendar providing a different UI
|
||
|
* CalendarFx - additional mixable FX for transitions in dojox.widget.Calendar
|
||
|
|
||
|
* Dialog - An extended version of dijit.Dialog with man options and transition.
|
||
|
|
||
|
* FilePicker - a widget for browsing server-side file systems (can use
|
||
|
dojox.data.FileStore as backend store)
|
||
|
|
||
|
* FisheyeList - the classic FishEye Picker (abandoned)
|
||
|
|
||
|
* FisheyeLite - A partial replacement for the FisheyeList - serious performance
|
||
|
gains, and entirely more extensible in that it simply animates defined
|
||
|
properties, relying on the natural styling as a foundation.
|
||
|
|
||
|
* Iterator - Basic array and data store iterator class
|
||
|
|
||
|
* Loader - an experimental Class that listens to XHR
|
||
|
connections in the background, and displays
|
||
|
a loading indicator. Loader will be removed in 1.3, and is (abandoned).
|
||
|
|
||
|
* PlaceholderMenuItem - a menu item that can be used to inject other menu
|
||
|
items at a given location. Extends dijit.Menu directly.
|
||
|
|
||
|
* Roller - A component to show many lines of text in a single area, rotating
|
||
|
through the options available. Also provides RollerSlide, an extension
|
||
|
to the stock fading roller to add a slide animation to the transition.
|
||
|
|
||
|
* RollingList - A component of the FilePicker widget
|
||
|
|
||
|
* SortList - a degradable UL with a fixed header, scrolling,
|
||
|
and sorting. Can be the direct descendant of a
|
||
|
LayoutContainer and will size to fit.
|
||
|
|
||
|
* Toaster - a messaging system to display unobtrusive
|
||
|
alerts on screen.
|
||
|
|
||
|
* Wizard - a StackContainer with built-in navigation to
|
||
|
ease in the creation of 'step-based' content.
|
||
|
Requires dojo >= 1.1
|
||
|
|
||
|
* AnalogGauge - an analog style customizable gauge for displaying values in an
|
||
|
animated fashion and with multiple indicators. Supports easings for
|
||
|
indicator animations, transparent overlays, etc. Very flexible.
|
||
|
Requires dojo >= 1.3
|
||
|
|
||
|
* BarGauge - a bar style gauge for displaying values in an animated fashion
|
||
|
and with multiple indicators. Supports easings for indicator animations,
|
||
|
etc. Very flexible.
|
||
|
Requires dojo >= 1.3
|
||
|
|
||
|
* Standby - a 'blocker' style widget to overlay a translucent div + image over a DOM node/widget to indicate busy.
|
||
|
Overlay color, image, and alt text can all be customized.
|
||
|
Requires dojo >= 1.3
|
||
|
|