reorganized/renamed sortable demos

jquery · Jan 16, 2009 · 1dfb222e4d0b300230d1f6b5922eba0b49df15ca · 1dfb222
1 parent c3591d4
commit 1dfb222e4d0b300230d1f6b5922eba0b49df15ca
Unified Split

Showing with 22 additions and 31 deletions.

+2 −4 demos/sortable/default.html

+9 −11 demos/sortable/index.html

+7 −8 demos/sortable/items.html

+2 −4 demos/sortable/placeholder.html

+2 −4 demos/sortable/tolerance.html
diff --git a/demos/sortable/default.html b/demos/sortable/default.html
@@ -1,7 +1,7 @@
 <!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>
@@ -35,9 +35,7 @@
 
 <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 -->
 

diff --git a/demos/sortable/index.html b/demos/sortable/index.html
@@ -9,17 +9,15 @@
 <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>
 

diff --git a/demos/sortable/items.html b/demos/sortable/items.html
@@ -1,7 +1,7 @@
 <!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>
@@ -25,16 +25,16 @@
 <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>
@@ -47,9 +47,8 @@
 
 <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 -->
 

diff --git a/demos/sortable/placeholder.html b/demos/sortable/placeholder.html
@@ -1,7 +1,7 @@
 <!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>
@@ -36,9 +36,7 @@
 
 <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 -->
 

diff --git a/demos/sortable/tolerance.html b/demos/sortable/tolerance.html
@@ -1,7 +1,7 @@
 <!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>
@@ -44,9 +44,7 @@
 
 <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 -->