Project

General

Profile

Statistics
| Revision:

root / trunk / web / dojo / dojox / widget / README @ 13

History | View | Annotate | Download (6.23 KB)

1
-------------------------------------------------------------------------------
2
dojox.widget Collection
3
-------------------------------------------------------------------------------
4
Version 1.0
5
Release date: 10/31/2007
6
-------------------------------------------------------------------------------
7
Project state:
8

    
9
[Calendar]	experimental
10
[CalendarFx]	experimental
11
[ColorPicker]	beta
12
[Dialog]	experimental
13
[FeedPortlet]	experimental
14
[FilePicker]	experimental
15
[FisheyeList]	experimental
16
[FisheyeLite]	beta
17
[Iterator]	experimental
18
[Loader]	experimental
19
[Pager]		experimental
20
[Portlet]	experimental
21
[PlaceholderMenuItem]	experimental
22
[Roller]	experimental
23
[RollingList]	experimental
24
[SortList]	experimental
25
[Toaster]	experimental
26
[Wizard]	experimental
27
[AnalogGauge]   experimental
28
[BarGauge]      experimental
29
[Standby]	experimental
30
-------------------------------------------------------------------------------
31
Credits:
32

    
33
[Calendar] Shane O'Sullivan
34
[CalendarFx] Shane O'Sullivan
35
[ColorPicker] Peter Higgins (dante)
36
[Dialog] Peter Higgins (dante)
37
[FeedPortlet] Shane O'Sullivan
38
[FilePicker] Nathan Toone (toonetown)
39
[FisheyeList] Karl Tiedt (kteidt)
40
[FisheyeLite] Peter Higgins (dante)
41
[Iterator] Alex Russell (slightlyoff)
42
[Loader] Peter Higgins (dante)
43
[Pager] Nikolai Onken (nonken), Peter Higgins (dante);
44
[PlaceholderMenuItem] Nathan Toone (toonetown)
45
[Portlet] Shane O'Sullivan
46
[Roller] Peter Higgins (dante)
47
[RollingList] Nathan Toone (toonetown)
48
[SortList] Peter Higgins (dante)
49
[Toaster] Adam Peller (peller)
50
[Wizard] Peter Higgins (dante)
51
[AnalogGauge] Benjamin Schell (bmschell) CCLA
52
[BarGauge] Benjamin Schell (bmschell) CCLA 
53
[Standby] Jared Jurkiewicz (jaredj) CCLA 
54
[UpgradeBar] Mike Wilcox (mwilcox), Revin Guillen
55

    
56
-------------------------------------------------------------------------------
57
Project description
58

    
59
	This is a collection of standalone widgets for use in
60
	your website.  Each individual widget is independent
61
	of the others.
62
	
63
-------------------------------------------------------------------------------
64
Dependencies:
65

    
66
	Each widget has it's own requirements and dependencies.
67
	Most inherit from dijit base-classes such as dijit._Widget,
68
	dijit._Templated, etc ... So we will assume the availablility
69
	of dojo (core), and dijit packages.
70
	
71
	Each individual component stores resources in a folder that shares 
72
	a name with the Widget. For instance:
73
	
74
	the Dialog lives in 
75
	dojox/widget/Dialog.js ... 
76

    
77
	and the folder:
78
	dojox/widget/Dialog/ 	contains a 'Dialog.css', the required 
79
	styles for that particular widget. All required templates and 
80
	images reside in the folder. 
81
	
82
	This differs slightly from the rest of DojoX in that each other
83
	project uses a shared resources/ folder in the project folder,
84
	though uses the same naming convention for stylesheets and templates.
85

    
86
	eg:
87
	dojox/layout/resources/ExpandoPane.css
88
	dojox.layout.ExpandoPane
89
	
90
-------------------------------------------------------------------------------
91
Documentation
92

    
93
	Please refer to the API-tool, or in-line documentation. All of these
94
	widgets are of varying use, quality, and documentation completion.
95
	
96
-------------------------------------------------------------------------------
97
Installation instructions
98

    
99
	These are standalone Widgets, so putting the [widget].js file 
100
	in your dojox/widget folder, and copying any files in the
101
	/dojox/widget/[widget]/ folder as supplements/templates/etc
102
	should be all you need to do.
103

    
104
	eg: FisheyeList:
105
	/dojox/widget/FisheyeList.js
106
	/dojox/widget/FisheyeList/FisheyeList.css
107

    
108
	should be all you need to use the Fisheye widget.	
109
	
110
	you can safely import the whole widget project into your 
111
	dojox/ root directory from the following SVN url:
112

    
113
	http://svn.dojotoolkit.org/src/dojox/trunk/widget
114

    
115
-------------------------------------------------------------------------------
116
Other Notes (Brief widget list):
117

    
118
    * ColorPicker - An HSV ColorPicker intended to be a drop down
119

    
120
	* Calendar - An extension on the dijit._Calendar providing a different UI
121
	* CalendarFx - additional mixable FX for transitions in dojox.widget.Calendar
122

    
123
	* Dialog - An extended version of dijit.Dialog with man options and transition.
124

    
125
	* FilePicker - a widget for browsing server-side file systems (can use
126
		dojox.data.FileStore as backend store)
127

    
128
	* FisheyeList - the classic FishEye Picker (abandoned)
129

    
130
	* FisheyeLite - A partial replacement for the FisheyeList - serious performance
131
		gains, and entirely more extensible in that it simply animates defined
132
		properties, relying on the natural styling as a foundation.
133

    
134
	* Iterator - Basic array and data store iterator class
135
	
136
	* Loader - an experimental Class that listens to XHR 
137
		connections in the background, and displays 
138
		a loading indicator. Loader will be removed in 1.3, and is (abandoned).
139

    
140
	* PlaceholderMenuItem - a menu item that can be used to inject other menu
141
		items at a given location. Extends dijit.Menu directly. 
142

    
143
	* Roller - A component to show many lines of text in a single area, rotating
144
		through the options available. Also provides RollerSlide, an extension
145
		to the stock fading roller to add a slide animation to the transition.
146

    
147
	* RollingList - A component of the FilePicker widget
148

    
149
	* SortList - a degradable UL with a fixed header, scrolling,
150
		and sorting. Can be the direct descendant of a
151
		LayoutContainer and will size to fit.
152

    
153
	* Toaster - a messaging system to display unobtrusive 
154
		alerts on screen.
155

    
156
	* Wizard - a StackContainer with built-in navigation to
157
		ease in the creation of 'step-based' content.
158
		Requires dojo >= 1.1 
159
                
160
	* AnalogGauge - an analog style customizable gauge for displaying values in an
161
		animated fashion and with multiple indicators.  Supports easings for 
162
		indicator animations, transparent overlays, etc.  Very flexible.
163
		Requires dojo >= 1.3
164
	
165
	* BarGauge - a bar style gauge for displaying values in an animated fashion 
166
		and with multiple indicators.  Supports easings for indicator animations,
167
		etc.  Very flexible.
168
		Requires dojo >= 1.3
169

    
170
	* Standby - a 'blocker' style widget to overlay a translucent div + image over a DOM node/widget to indicate busy.
171
		Overlay color, image, and alt text can all be customized.
172
		Requires dojo >= 1.3
173

    
174
	* UpgradeBar - Displays the "yellow bar" at the top of a page to indicate the user
175
 		needs to upgrade their browser or a plugin
176
		Requires dojo >= 1.3