<!doctype html>
<html lang="en">
<head>
- <title>jQuery UI Sortable - Default Demo</title>
+ <title>jQuery UI Sortable - Default functionality</title>
<link type="text/css" href="../../themes/base/ui.all.css" rel="stylesheet" />
<script type="text/javascript" src="../../jquery-1.3.js"></script>
<script type="text/javascript" src="../../ui/ui.core.js"></script>
<div class="demo-description">
-<p>
-
-</p>
+<p>Enable a group of DOM elements to be sortable. Click on and drag and element to a new spot within the list, and the other items will adjust to fit. By default, sortable items share <strong>draggable</strong> properties.</p>
</div><!-- End demo-description -->
<div class="demos-nav">
<h4>Examples</h4>
<ul>
- <li class="demo-config-on"><a href="default.html">Default Sortable</a></li>
- <li><a href="floating.html">Floating</a></li>
- <li><a href="placeholder.html">Placeholder</a></li>
- <li><a href="delay.html">Delay</a></li>
- <li><a href="distance.html">Distance</a></li>
- <li><a href="items.html">Excluding items</a></li>
- <li><a href="connectwith.html">Connecting two lists</a></li>
- <li><a href="droponempty.html">Dropping on empty lists</a></li>
- <li><a href="droppable.html">Connect to droppables</a></li>
- <li><a href="portlets.html">Portlets</a></li>
- <li><a href="tolerance.html">Tolerance</a></li>
+ <li class="demo-config-on"><a href="default.html">Default functionality</a></li>
+ <li><a href="tolerance.html">Drop tolerance (stickiness)</a></li>
+ <li><a href="placeholder.html">Drop placeholder</a></li>
+ <li><a href="connect-lists.html">Connect lists</a></li>
+ <li><a href="empty-lists.html">Handle empty lists</a></li>
+ <li><a href="items.html">Include / exclude items</a></li>
+ <li><a href="delay-start.html">Delay start</a></li>
+ <li><a href="display-portlets.html">Display as portlets</a></li>
+ <li><a href="display-grid.html">Display as grid</a></li>
</ul>
</div>
<!doctype html>
<html lang="en">
<head>
- <title>jQuery UI Sortable - Excluding Items Demo</title>
+ <title>jQuery UI Sortable - Include / exclude items</title>
<link type="text/css" href="../../themes/base/ui.all.css" rel="stylesheet" />
<script type="text/javascript" src="../../jquery-1.3.js"></script>
<script type="text/javascript" src="../../ui/ui.core.js"></script>
<body>
<div class="demo">
-<p>Completely exclude items from the sorting logic using the 'items' option</p>
+<h3>Specify which items are sortable:</h3>
<ul id="sortable">
<li class="ui-state-default">Item 1</li>
- <li class="ui-state-default ui-state-disabled">(I'm not sortable)</li>
- <li class="ui-state-default ui-state-disabled">(I'm not sortable)</li>
+ <li class="ui-state-default ui-state-disabled">(I'm not sortable or a drop target)</li>
+ <li class="ui-state-default ui-state-disabled">(I'm not sortable or a drop target)</li>
<li class="ui-state-default">Item 4</li>
</ul>
-<p>Keep the items as valid targets, but non-draggable, using the 'cancel' option</p>
+<h3>Cancel sorting (but keep as drop targets):</h3>
<ul id="sortable2">
<li class="ui-state-default">Item 1</li>
<div class="demo-description">
-<p>
-
-</p>
+<p>Specify which items are eligible to sort by passing a jQuery selector into the <strong>items</strong> option. Items excluded from this option are not sortable, nor are they valid targets for sortable items. </p>
+<p>To only prevent sorting on certain items, pass a jQuery selector into the <strong>cancel</strong> option. Cancelled items remain valid sort targets for others.</p>
</div><!-- End demo-description -->
<!doctype html>
<html lang="en">
<head>
- <title>jQuery UI Sortable - Placeholder Demo</title>
+ <title>jQuery UI Sortable - Drop placeholder</title>
<link type="text/css" href="../../themes/base/ui.all.css" rel="stylesheet" />
<script type="text/javascript" src="../../jquery-1.3.js"></script>
<script type="text/javascript" src="../../ui/ui.core.js"></script>
<div class="demo-description">
-<p>
-
-</p>
+<p>When dragging a sortable item to a new location, other items will make room for the that item by shifting to allow white space between them. Pass a class into the <strong>placeholder</strong> option to style that space to be visible. Use the boolean <strong>forcePlaceholderSize</strong> option to set dimensions on the placeholder.</p>
</div><!-- End demo-description -->
<!doctype html>
<html lang="en">
<head>
- <title>jQuery UI Sortable - Tolerance Demo</title>
+ <title>jQuery UI Sortable - Drop tolerance (stickiness)</title>
<link type="text/css" href="../../themes/base/ui.all.css" rel="stylesheet" />
<script type="text/javascript" src="../../jquery-1.3.js"></script>
<script type="text/javascript" src="../../ui/ui.core.js"></script>
<div class="demo-description">
-<p>
-
-</p>
+<p>Set the stickiness of drop areas using the <strong>tolerance</strong> option. Specify whether the drop should occur when either the pointer or intersection (mid-point of the sortable item) crosses the drop area's boundary. By default, the script guesses which option is best to use for each drag.</p>
</div><!-- End demo-description -->
projects / jquery-ui.git / commitdiff