tree: db5c7b506753890f28cf7293c2cd4387000a00fe [path history] [tgz]
  1. demos/
  2. docs/
  3. external/
  4. themes/
  5. ui/
  6. AUTHORS.txt
  7. grunt.js
  8. jquery-1.8.3.js
  9. MIT-LICENSE.txt
  10. package.json
  11. README.md
  12. ui.accordion.jquery.json
  13. ui.autocomplete.jquery.json
  14. ui.button.jquery.json
  15. ui.core.jquery.json
  16. ui.datepicker.jquery.json
  17. ui.dialog.jquery.json
  18. ui.draggable.jquery.json
  19. ui.droppable.jquery.json
  20. ui.effect-blind.jquery.json
  21. ui.effect-bounce.jquery.json
  22. ui.effect-clip.jquery.json
  23. ui.effect-drop.jquery.json
  24. ui.effect-explode.jquery.json
  25. ui.effect-fade.jquery.json
  26. ui.effect-fold.jquery.json
  27. ui.effect-highlight.jquery.json
  28. ui.effect-pulsate.jquery.json
  29. ui.effect-scale.jquery.json
  30. ui.effect-shake.jquery.json
  31. ui.effect-slide.jquery.json
  32. ui.effect-transfer.jquery.json
  33. ui.effect.jquery.json
  34. ui.menu.jquery.json
  35. ui.mouse.jquery.json
  36. ui.position.jquery.json
  37. ui.progressbar.jquery.json
  38. ui.resizable.jquery.json
  39. ui.selectable.jquery.json
  40. ui.slider.jquery.json
  41. ui.sortable.jquery.json
  42. ui.spinner.jquery.json
  43. ui.tabs.jquery.json
  44. ui.tooltip.jquery.json
  45. ui.widget.jquery.json
content/development-bundle/README.md

jQuery UI - Interactions and Widgets for the web

jQuery UI provides interactions like Drag and Drop and widgets like Autocomplete, Tabs and Slider and makes these as easy to use as jQuery itself.

If you want to use jQuery UI, go to jqueryui.com to get started. Or visit the Using jQuery UI Forum for discussions and questions.

If you are interested in helping develop jQuery UI, you are in the right place. To discuss development with team members and the community, visit the Developing jQuery UI Forum or in #jquery on irc.freednode.net.

For contributors

If you want to help and provide a patch for a bugfix or new feature, please take a few minutes and look at our Getting Involved guide. In particular check out the Coding standards and Commit Message Style Guide.

In general, fork the project, create a branch for a specific change and send a pull request for that branch. Don't mix unrelated changes. You can use the commit message as the description for the pull request.

Running the Unit Tests

Run the unit tests with a local server that supports PHP. No database is required. Pre-configured php local servers are available for Windows and Mac. Here are some options:

Building jQuery UI

jQuery UI uses the grunt build system. Building jQuery UI requires node.js and a command line zip program.

Install grunt.

npm install grunt -g

Clone the jQuery UI git repo.

git clone git://github.com/jquery/jquery-ui.git

cd jquery-ui

Install node modules.

npm install

Run grunt.

grunt build

There are many other tasks that can be run through grunt. For a list of all tasks:

grunt --help

For committers

When looking at pull requests, first check for proper commit messages.

Do not merge pull requests directly through GitHub‘s interface. Most pull requests are a single commit; cherry-picking will avoid creating a merge commit. It’s also common for contributors to make minor fixes in an additional one or two commits. These should be squashed before landing in master.

Make sure the author has a valid name and email address associated with the commit.

Fetch the remote first:

git fetch [their-fork.git] [their-branch]

Then cherry-pick the commit(s):

git cherry-pick [sha-of-commit]

If you need to edit the commit message:

git cherry-pick -e [sha-of-commit]

If you need to edit the changes:

git cherry-pick -n [sha-of-commit]
# make changes
git commit --author="[author-name-and-email]"

If it should go to the stable brach, cherry-pick it to stable:

git checkout 1-8-stable
git cherry-pick -x [sha-of-commit-from-master]

NOTE: Do not cherry-pick into 1-8-stable until you have pushed the commit from master upstream.