-
Notifications
You must be signed in to change notification settings - Fork 97
/
Copy pathREADME.txt
264 lines (209 loc) · 9.76 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
Fluid Infusion 1.1.2
====================
Main Project Site: http://fluidproject.org
Documentation: http://wiki.fluidproject.org/display/fluid/Infusion+Documentation
What's New in 1.1.2
===================
This release:
* New Demo Portal with improved component demos
* Sneak Peak for Mobile FSS iPhone theme
* Improved and simplified Image Reorderer examples and documentation
* Uploader support for Firefox 3.5 and improved experience for Internet Explorer
* Other bug fixes:
* More class name normalization
* InlineEdit fixes
What's in this Release
======================
This release is available in two forms:
Deployment Bundle - infusion-1.1.2.zip
Source Code Bundle - infusion-1.1.2-src.zip
In addition to source code, samples and tests, both bundles include at the top level a single JavaScript file
InfusionAll.js
that is a combination of all other source files. Developers can include this single file in their
pages to provide all the necessary support for the Infusion component Library. In the Deployment Bundle,
this script is compressed and suitable for production use.
The Deployment Bundle also includes a WAR file suitable for deployment in Java-based containers:
fluid-components-1.1.2.war
Source Code
-----------
The organization of the full source code for the Infusion library is as follows:
components/
inlineEdit/
pager/
progress/
reorderer/
tableOfContents/
uiOptions/
undo/
uploader/
framework/
core/
fss/
renderer/
lib/
fastXmlPull/
jquery/
json/
swfobject/
swfupload/
In the Deployment Bundle, the JavaScript source has been minified: comments and whitespace have
been removed.
Developers wishing to learn about the Fluid Infusion code, or debug their applications, should use
the Source Code Bundle.
Demo Portal
-----------
The bundle now comes with a convenient one-stop-shop for seeing all components in action. It is organized as follows:
demos/
fss/
layout/
mobile/
reset/
text/
themes/
inlineEdit/
rich/
simple/
keyboard-a11y/
pager/
portal/
progress/
renderer/
reorderer/
gridReorderer/
imageReorderer/
layoutReorderer/
listReorderer/
uiOptions/
uploader/
Other Examples and Sample Code
------------------------------
Sample code illustrating how Infusion components can be used:
integration-demos/
bspace/ (showcases: Inline Edit)
sakai/ (showcases: Inline Edit, Pager, UI Options, FSS)
uportal/ (showcases: Reorderer, UI Options, FSS)
standalone-demos/
keyboard-a11y/
lib/
pager/
renderer/
reorderer/
table-of-contents/
Tests
-----
tests/
component-tests/
escalated-tests/
framework-tests/
lib/
manual-tests/
test-core/
License
-------
Fluid Infusion code is licensed under a dual ECL 2.0 / BSD license. The specific licenses can be
found in the license file:
licenses/Infusion-LICENSE.txt
Infusion also depends upon some third party open source modules. These are contained in their own
folders, and their licenses are also present in
licenses/
Third Party Software in Infusion
--------------------------------
This is a list of publicly available software that is included in the Fluid Infusion bundle, along
with their licensing terms.
* jQuery javascript library v1.3.2: http://jquery.com/ (MIT and GPL licensed http://docs.jquery.com/Licensing)
* jQuery UI javascript widget library v1.7: http://ui.jquery.com/ (MIT and GPL licensed http://docs.jquery.com/Licensing)
* jQuery QUnit testrunner r6173: http://docs.jquery.com/QUnit (MIT and GPL licensed http://docs.jquery.com/Licensing)
* jQuery Chili code highlighter http://code.google.com/p/jquery-chili-js/ (MIT licensed)
* Douglas Crockford's JSON parsing and stringifying methods (from 2007-11-06): http://www.json.org/ (Public Domain)
* SWFUpload v2.2.0.1: http://swfupload.org/ (MIT licensed http://www.opensource.org/licenses/mit-license.php)
* SWFObject v2.1: http://code.google.com/p/swfobject/ (MIT licensed http://www.opensource.org/licenses/mit-license.php)
* Sample markup and stylesheets from Sakai v2.5 (http://sakaiproject.org) and uPortal v2.6 (http://www.uportal.org/)
* FCKeditor v2.6, HTML text editor (LGPL licensed http://www.fckeditor.net/license)
Other third party software
* fastXmlPull is based on XML for Script's Fast Pull Parser v3.1
(see: http://wiki.fluidproject.org/display/fluid/Licensing+for+fastXmlPull.js )
* fluid.reset.css is based on YUI's CSS reset styling v2.5.2
see: http://developer.yahoo.com/yui/reset/ (BSD licensed http://developer.yahoo.com/yui/license.html)
Readme
------
This file.
README.txt
Documentation
=============
The Fluid Project uses a wiki for documentation and project collaboration: http://wiki.fluidproject.org.
The main Infusion documentation can be found at:
http://wiki.fluidproject.org/display/fluid/Infusion+Documentation
The documentation for Infusion consists of a number of information pages stored in the Fluid Wiki.
The pages include tutorials, API descriptions, testing procedures, and data-gathering approaches. To make the
manual pages easy to navigate we have added the following guides:
* The above-mentioned landing page, which links to all of our documentation.
* A link to the documentation appears at the top of the left-side wiki navigation
bar with the name "Infusion Documentation".
Supported Browsers
==================
Firefox 3.5: full support in Mac OS 10.5, Win XP and Win Vista
Firefox 3.0: full support in Mac OS 10.5 and Win XP
Internet Explorer 6.x: full support in Win XP
Internet Explorer 7.x: full support in Win XP and Win Vista
Safari 4: full support in Mac OS 10.4 and 10.5
Safari 3.2 (Mac OS 10.5), Opera 9.6 (Win XP): full support (except keyboard interaction, which is not supported by these browsers)
Internet Explorer 8: preliminary support
For more information on Fluid Infusion browser support, please see:
http://wiki.fluidproject.org/display/fluid/Browser+Support
Status of Components and Framework Features
===========================================
Production: supports A-Grade browsers, stable for production usage across a wide range of
applications and use cases
* Fluid Skinning System
* Infusion Framework Core
* Inline Edit: Simple Text
* Renderer
* Reorderer: List, Grid, Layout, Image
* Undo
Preview: still growing, but with broad browser support. Expect new features in upcoming releases
* Pager
* Progress
* UI Options
* Uploader
Sneak Peek: in development; APIs will change. Share your feedback, ideas, and code
* Inline Edit: Dropdown
* Inline Edit: Rich Text
* Table of Contents
Known Issues
============
The Fluid Project uses a JIRA website to track bugs: http://issues.fluidproject.org.
Some of the known issues in this release are described here:
FSS:
FLUID-2504: Flexible columns don't maintain proper alignment under certain conditions
FLUID-2434: In IE, major font size changes break text positioning within form controls
FLUID-2397: Opera doesn't seem to repaint certain css changes on the fly, requiring a refresh to see them
Framework:
FLUID-2577 Renderer performance can be slow on IE 6 and 7 in some contexts.
Inline Edit:
FLUID-1600 Pressing the "Tab" key to exit edit mode places focus on the wrong item
FLUID-2536 Inline Edit test fails using IE 8
Uploader:
FLUID-2582 Uploader is dependent on ProgressiveEnhancement.js, which is not included in InfusionAll.js
FLUID-3241 Can only tab to the "Browse Files" button once: using IE
FLUID-2052 Cannot tab away from the "Browse Files" button with Flash 10; using FF3*
* For information related to known issues with Flash 10 compatibility,
see http://wiki.fluidproject.org/x/kwZo
Layout Reorderer:
FLUID-1540 Can't use keyboard reordering to move a nested reorderer to the right column, using IE6
FLUID-2171 In IE, can't reorderer portlets containing Google components
FLUID-858 Portlet Columns load with no padding between them in IE7
Pager:
FLUID-2880 The Pager will be refactored. Note that as a result of this, there will be significant changes to the Pager API
FLUID-2329 The self-rendering mode of the Pager is not the default mode
Reorderer:
FLUID-539 Can't use the "Tab" key to navigate out of reorderable tabs
FLUID-118 Dragging an image offscreen or out of the frame has some unexpected results.
FLUID-3288 Moving an item with the keyboard "loses" the "ctrl-key is down" status
UI Options:
FLUID-2398 Minimum font size control changes the text size even when the base size is larger then the minimum.
FLUID-2481 "Links" selection does not work correctly in UIOptions
FLUID-2506 Keyboard navigation inside the dialog breaks in simple layout mode: using FF
Renderer:
FLUID-3224 If <textarea> autobound to non-existant model field, Renderer renders unclosed element
FLUID-3277 Attempt to add children to leaf component in tree results in "targetlump is undefined" error
FLUID-3276 Enclosing branch nodes within markup which has "headers" attribute causes them to become invisible to the renderer