查看 | 历史 | 提交 | 提交对比
hjg
2024-07-09 30304784e82d4bba24121328da8eb8490aec4f4f
提交 | 用户 | 时间
58d006 1 [![Fuel UX](https://s3.amazonaws.com/fuelux/logo-gray.png)](http://exacttarget.github.com/fuelux)
A 2
3 Fuel UX extends Twitter Bootstrap with additional lightweight JavaScript controls.
4 Other benefits include easy installation into web projects, integrated scripts for customizing Bootstrap and Fuel UX,
5 simple updates, and solid optimization for deployment. All functionality is covered by live documentation and unit tests.
6
7 [![Selenium Test Status](https://saucelabs.com/buildstatus/fuelux)](https://saucelabs.com/u/fuelux)
8
9 [![Build Status](https://secure.travis-ci.org/ExactTarget/fuelux.png?branch=master)](http://travis-ci.org/ExactTarget/fuelux)
10
11 ## Features
12
13 Fuel UX provides all of the styles and plugins from the revolutionary [Twitter Bootstrap](http://twitter.github.com/bootstrap) project, with the following additions:
14
15 * Fuel UX JavaScript controls (with unit tests) [see them live](http://exacttarget.github.com/fuelux)
16   * Checkbox - _consistent cross-browser cross-platform look and feel for checkbox elements_
17   * Combobox - _combines input and dropdown for easy and flexible data selection_
18   * Datagrid - _renders data in a table with paging, sorting, and searching_
19   * Pillbox - _manages selected items with color-coded text labels_
20   * Radio - _consistent cross-browser cross-platform look and feel for radio elements_
21   * Search - _combines input and button for integrated search interaction_
22   * Select - _extends button dropdown with the ability to set and retrieve the selected item_
23   * Spinner - _provides convenient numeric input with increment and decrement buttons_
24   * Tree - _renders data in a tree, supporting caching and optional multi-selection_
25   * Wizard - _displays a multi-step process to be completed in a specific order_
26 <p>
27 * One-step installation and updates through [volo](https://github.com/volojs/volo)
28 * [AMD](http://requirejs.org/docs/whyamd.html) compatibility for modular structure and deployment optimization
29 * [Grunt](https://github.com/cowboy/grunt)-based build script to easily create custom distribution files
30 * Namespaced CSS (just add a `fuelux` class) for safe use on existing sites
31
32 ## Getting Started
33 * `git clone git://github.com/ExactTarget/fuelux.git`
34 * Default Fuel UX files for production use are located in the [dist](https://github.com/ExactTarget/fuelux/tree/master/dist) directory
35 * To customize, modify the JS and LESS files under [src](https://github.com/ExactTarget/fuelux/tree/master/src) then run `grunt` to regenerate your [dist](https://github.com/ExactTarget/fuelux/tree/master/dist) directory (more below)
36
37 ## Documentation and Examples
38
39 ### Live docs and demos
40
41 Hosted on GitHub pages: http://exacttarget.github.com/fuelux
42
43 ### Rich documentation
44
45 Hosted on our [Developer Community](http://code.exacttarget.com/devcenter/home): http://code.exacttarget.com/devcenter/fuel-ux
46
47 ## Issues and Feature Requests
48
49 ### Search for or report a bug
50
51 Use GitHub issues: https://github.com/ExactTarget/fuelux/issues
52
53 ### View the roadmap and suggest new ideas
54
55 Visit our UserVoice community: https://fuelux.uservoice.com
56
57 ## Release History
58
59 _Fuel UX is semantically versioned: <http://semver.org>_
60
61 ### Version 2.3.1 `2013-08-02`
62
63 * Reset datagrid to first page on filter change
64 * Fix datagrid operation inside HTML form
65 * Fix datagrid header wrapping for narrow columns
66 * Improve datagrid class specificity for inner controls
67 * Fix datagrid race condition with next and previous buttons
68 * Improve datagrid fault tolerance around paging operations
69 * Improve sample datasource to handle null values when searching
70 * Fix select control value selection when value contains spaces
71 * Fix checkbox operation inside datagrid
72 * Fix checkbox operation inside form-inline
73 * Fix checkbox operation for IE8
74 * Fix tree text wrapping issue
75 * Fix spinner issue when passing a string as a value
76 * Fix button group operation inside wizard step
77 * Backport tooltip options fix from Bootstrap 3
78 * Upgrade Bootstrap from 2.3.0 to 2.3.2
79
80 ### Version 2.3.0 `2013-02-18`
81
82 * Add custom filter support to datagrid
83 * Use select control for datagrid page size dropdown
84 * Add stepclick event to wizard to support canceling clicks on steps
85 * Improve rounded corners of combobox button to match Bootstrap
86 * Improve support for installation within Yeoman
87 * Upgrade Bootstrap from 2.2.2 to 2.3.0
88
89 ### Version 2.2.1 `2013-02-13`
90
91 * Fix whitespace issue in wizard
92 * Improve encapsulation of AMD globals
93 * Introduce Testem for cross-browser testing
94 * Fix tree datasource reference for local development
95 * Upgrade unit tests to be compatible with jQuery 1.9
96
97 ### Version 2.2.0 `2013-01-04`
98
99 * _New Control_ - checkbox
100 * _New Control_ - radio
101 * _New Control_ - select
102 * _New Control_ - tree
103 * _New Control_ - wizard
104 * Add stretchHeight option to datagrid
105 * Add reload method to datagrid
106 * Add enable and disable methods to search control
107 * Add enable and disable methods to combobox
108 * Add rich methods for getting/setting selected item to combobox
109 * Fix triggering of superfluous spinner events
110 * Upgrade Bootstrap from 2.2.1 to 2.2.2
111
112 ### Version 2.1.1 `2012-11-10`
113
114 * Allow setting spinner value to zero
115 * Fix search control keyboard operation in IE8
116
117 ### Version 2.1.0 `2012-10-31`
118
119 * Upgrade Bootstrap from 2.1.1 to 2.2.1
120
121 ### Version 2.0.2 `2012-10-30`
122
123 * Ignore click on disabled search button
124 * Make cursor consistent on disabled spinner buttons
125 * Improve live docs to show disabled states where available
126 * Complete datagrid unit test coverage
127
128 ### Version 2.0.1 `2012-10-05`
129
130 * Fix loader.js (used for non-AMD pages) to be synchronous
131
132 ### Version 2.0.0 `2012-09-28`
133
134 * First public release of Fuel UX
135
136 ## Contributing
137 Before writing code, we suggest you [search for issues](https://github.com/ExactTarget/fuelux/issues?state=open)
138 or [create a new one](https://github.com/ExactTarget/fuelux/issues/new) to confirm where your contribution fits into
139 our roadmap.
140
141 In lieu of a formal style guide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using [grunt](https://github.com/cowboy/grunt).
142
143 More about [Contributing to Fuel UX](https://github.com/ExactTarget/fuelux/wiki/Contributing-to-Fuel-UX)
144
145 ### Important notes
146 Please don't edit files in the `dist` directory as they are generated via grunt. You'll find source code in the `src` directory!
147
148 While grunt can run the included unit tests via PhantomJS, this isn't a substitute for the real thing. Please be sure to test the `test/*.html` unit test file(s) in real browsers as well.
149
150 More about [Installing grunt and PhantomJS](https://github.com/ExactTarget/fuelux/wiki/Installing-grunt-and-PhantomJS)
151
152 ## The Fuel UX Philosophy
153
154 Our aim is to provide a suite of related but independent projects that help web developers integrate, manage, and customize quality libraries and utilities to more efficiently develop, maintain, test, and distribute their projects.  Any improvements or fixes we make to the open source projects we use will be contributed upstream if they are useful to the rest of the community.
155
156 ## Acknowledgements
157
158 We are grateful to the maintainers, contributors, and sponsors of the following technologies which make FuelUX possible:
159
160 * [jQuery](http://jquery.com) (Library for DOM, events, animation, and AJAX)
161
162 * [Twitter Bootstrap](http://twitter.github.com/bootstrap) (Modern UI components and interactions)
163
164 * [LESS](http://lesscss.org) and [recess](http://twitter.github.com/recess) (Stylesheet definition and management)
165
166 * [RequireJS](http://requirejs.org) and [volo](https://github.com/volojs/volo) (Tools for managing modular JavaScript)
167
168 * [grunt](https://github.com/cowboy/grunt) (Build tool for JavaScript projects)
169
170 ##Authors
171
172 **Adam Alexander**
173
174 + http://twitter.com/adamalex
175 + http://github.com/adamalex
176
177 **Matt Beard**
178
179 + http://github.com/mbeard
180
181 **Bryan Kohlmeier**
182
183 + http://github.com/bkohlmeier
184
185 **Kevin Parkerson**
186
187 + http://github.com/kevinparkerson
188
189 **Christopher McCulloh**
190
191 + http://github.com/cmcculloh
192
193 **David Waltz**
194
195 + https://github.com/dwaltz
196
197 **Dustin McCormick**
198
199 + http://twitter.com/djmccormick
200 + http://github.com/djmccormick
201
202 **Scott Plumlee**
203
204 + http://twitter.com/scottplumlee
205 + http://github.com/plumlee
206
207 **Marvin Pribble**
208
209 + http://github.com/marvinpribble
210
211 ## Copyright and license
212
213 Copyright (c) 2012 ExactTarget
214
215 Licensed under the MIT License (the "License");
216 you may not use this work except in compliance with the License.
217 You may obtain a copy of the License in the COPYING file.
218
219 Unless required by applicable law or agreed to in writing, software
220 distributed under the License is distributed on an "AS IS" BASIS,
221 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
222 See the License for the specific language governing permissions and
223 limitations under the License.
224
225 [![githalytics.com alpha](https://cruel-carlota.pagodabox.com/8b519d39e18063752f24876583a6526b "githalytics.com")](http://githalytics.com/ExactTarget/fuelux)