{"id":16744,"date":"2013-03-25T21:01:05","date_gmt":"2013-03-25T13:01:05","guid":{"rendered":"https:\/\/www.hongkiat.com\/blog\/?p=16744"},"modified":"2025-04-04T01:30:28","modified_gmt":"2025-04-03T17:30:28","slug":"jquery-ui-sortable","status":"publish","type":"post","link":"https:\/\/www.hongkiat.com\/blog\/jquery-ui-sortable\/","title":{"rendered":"Web Design: Drag and Drop with jQuery UI Sortable"},"content":{"rendered":"

We have covered how to give custom style to jQuery UI<\/a>, starting from the UI Accordion, UI Slider<\/a> and the UI Date Picker<\/a>. Today we will continue our exploration on jQuery UI in theming jQuery UI Sortable<\/a>.<\/p>\n

This particular plugin will enable a group of DOM to be sortable, meaning that we are able to move the object from one to another position. The following is how the final result will look like.<\/p>\n

Let\u2019s just get started.<\/p>\n

Step 1: Preparing Essential Files<\/h2>\n

Before we start working on the code, we need to prepare a few essential things, including: the jQuery<\/a>, the jQuery UI<\/a> library, and the FontAwesome<\/a> to deliver the icon we are going to use later on.<\/p>\n

For the jQuery and the jQuery UI library, you don\u2019t have to host them on your own, the better, practical way is to link them from CDN, as follow:<\/p>\n

\r\n<script src=\"http:\/\/code.jquery.com\/jquery-1.8.2.js\"><\/script>\r\n<script src=\"http:\/\/code.jquery.com\/ui\/1.9.1\/jquery-ui.js\"><\/script>\r\n<\/pre>\n
Put those scripts inside the <head> or before the closing body tag for better load performance.<\/p>\n
Furthermore, we will not use the default styles that come with jQuery UI, so we need to create a new CSS file to store our custom styles and then link it to our document, as follows.<\/p>\n
\r\n<link rel=\"stylesheet\" href=\"style.css\" \/>\r\n<\/pre>\n
This next step is optional, you can leave is you want to. But, I prefer to normalize all the default DOM styles with noremalize.css or else you can also use CSS Reset<\/a> from Eric Mayer.<\/p>\n
Put this line inside the head before the style.css we have created previously.<\/p>\n
\r\n<link rel=\"stylesheet\" href=\"https:\/\/github.com\/necolas\/normalize.css\/2.0.1\/normalize.css\">\t\r\n<\/pre>\n
To sum up, here are all the files we link through inside the <head><\/code> tag.<\/p>\n
\r\n<link rel=\"stylesheet\" href=\"https:\/\/github.com\/necolas\/normalize.css\/2.0.1\/normalize.css\">\r\n<link rel=\"stylesheet\" href=\"style.css\" \/>\r\n<script src=\"http:\/\/code.jquery.com\/jquery-1.8.2.js\"><\/script>\r\n<script src=\"http:\/\/code.jquery.com\/ui\/1.9.1\/jquery-ui.js\"><\/script>\r\n<\/pre>\n
Recommended Reading:<\/strong> Reviewing CSS Priority Level<\/a><\/p>\n
Step 2: HTML Structure<\/h2>\n
The HTML structure for jQuery UI Sortable is quite flexible. We can use a <div><\/code> or <dt><\/code>, as long as we wrap them inside a parent element with specific id attribute.<\/p>\n
And in our case, we are going to use the <li><\/code> tag. Put all the HTML shown below inside the <body><\/code>.<\/p>\n
\r\n<ul id=\"sortable\">\r\n    <li class=\"ui-state-default\">Item 1<\/li>\r\n    <li class=\"ui-state-default\">Item 2<\/li>\r\n    <li class=\"ui-state-default\">Item 3<\/li>\r\n    <li class=\"ui-state-default\">Item 4<\/li>\r\n    <li class=\"ui-state-default\">Item 5<\/li>\r\n    <li class=\"ui-state-default\">Item 6<\/li>\r\n    <li class=\"ui-state-default\">Item 7<\/li>\r\n<\/ul>\r\n<\/pre>\n
Step 3: Activating UI Sortable<\/h2>\n
The id attribute that is attached on the parent element, as shown in the above code snippet, is important. This id<\/strong> is used for activating the DOM element to jQuery UI. To do so, put all the following script inside the <head><\/code> tag, right after all the other scripts we have added before.<\/p>\n
\r\n<script>\r\n    $(function() {\r\n        $( \"#sortable\" ).sortable({ \r\n            placeholder: \"ui-sortable-placeholder\" \r\n        });\r\n    });\r\n<\/script>\r\n<\/pre>\n
At this point, the UI Sortable should already work. You can click, hold, drag them top to bottom or vice versa. However, the presentation still looks white and plain.<\/p>\n
Step 4: Defining New Font Family<\/h2>\n
As we mentioned earlier, we will need FontAwesome to deliver an icon. Download the package here<\/a>, extract it and place all the fonts under a folder named font<\/strong>. And put these lines inside the style.css<\/code> to define new font family in our web document, FontAwesome<\/strong>.<\/p>\n
\r\n@font-face {\r\n  font-family: \"FontAwesome\";\r\n  src: url('font\/fontawesome-webfont.eot');\r\n  src: url('font\/fontawesome-webfont.eot?#iefix') format('eot'), \r\n  \t   url('font\/fontawesome-webfont.woff') format('woff'), \r\n  \t   url('font\/fontawesome-webfont.ttf') format('truetype'), \r\n  \t   url('font\/fontawesome-webfont.svg#FontAwesome') format('svg');\r\n  font-weight: normal;\r\n  font-style: normal;\r\n}\r\n<\/pre>\n
Step 5: Styling The UI Sortable<\/h2>\n
In this step, we will start off styling the UI Sortable by adding background color for the body tag as follows:<\/p>\n
\r\nbody {\r\n\tbackground-color: #333;\r\n}\r\n<\/pre>\n
Then, we specify the fix width of the UI Sortable, position it at the center of browser window as well as add  some gimmicks, like so:<\/p>\n
\r\n.ui-sortable {\r\n\twidth: 350px;\r\n\tmargin: 50px auto;\r\n\tbackground-color: #ccc;\r\n\t-webkit-box-shadow:  0px 0px 10px 1px rgba(0, 0, 0, .1);\r\n  box-shadow:  0px 0px 10px 1px rgba(0, 0, 0, .1);\r\n  list-style-type: none; \r\n  padding: 0; \r\n}<\/pre>\n
At this point, our UI Sortable will look like this screenshot below.<\/p>\n
\"preview\"<\/figure>\n
UI Default State<\/h2>\n
Next we will add the default styles for the <li><\/code> elements. These styles consist of the background gradient colors, the length of the elements, the borders, the text styles and specifically remove the border for the first child and the last child of the <li><\/code>.<\/p>\n
\r\n.ui-sortable li.ui-state-default { \r\n\tmargin: 0; \r\n\theight: 45px;\r\n\tline-height: 48px;\r\n\tfont-size: 1.4em; \r\n\tcolor: #fff;\r\n\toutline: 0;\r\n\tpadding: 0;\r\n\tmargin: 0;\r\n\ttext-indent: 15px;\r\n\tbackground: rgb(78,82,91);\r\n\tbackground: -moz-linear-gradient(top,  rgb(78,82,91) 0%, rgb(57,61,68) 100%);\r\n\tbackground: -webkit-gradient(linear, left top, left bottom, color-stop(0%,rgb(78,82,91)), color-stop(100%,rgb(57,61,68)));\r\n\tbackground: -webkit-linear-gradient(top,  rgb(78,82,91) 0%,rgb(57,61,68) 100%);\r\n\tbackground: -o-linear-gradient(top,  rgb(78,82,91) 0%,rgb(57,61,68) 100%);\r\n\tbackground: -ms-linear-gradient(top,  rgb(78,82,91) 0%,rgb(57,61,68) 100%);\r\n\tbackground: linear-gradient(to bottom,  rgb(78,82,91) 0%,rgb(57,61,68) 100%);\r\n\tborder-top: 1px solid rgba(255,255,255,.2);\r\n\tborder-bottom: 1px solid rgba(0,0,0,.5);\r\n\ttext-shadow: -1px -1px 0px rgba(0,0,0,.5);\r\n\tfont-size: 1.1em;\r\n\tposition: relative;\r\n\tcursor: pointer;\r\n}\r\n.ui-sortable li.ui-state-default:first-child {\r\n\tborder-top: 0; \r\n}\r\n.ui-sortable li.ui-state-default:last-child {\r\n\tborder-bottom: 0;\r\n}<\/pre>\n
After adding those colors, our UI will start looking better, as shown in the following screenshot.<\/p>\n
\"preview\"<\/figure>\n
Placeholder<\/h2>\n
No, this is not the Placeholder attribute for HTML5<\/a>. The placeholder in jQuery UI refers to the blank spaces where the DOM element can be placed on. In this case, we will add this area with grey background and dashed border, like so.<\/p>\n
\r\n.ui-sortable-placeholder {\r\n\tborder: 3px dashed #aaa;\r\n\theight: 45px;\r\n\twidth: 344px;\r\n\tbackground: #ccc;\r\n}<\/pre>\n
Now, when you try to replace the DOM position you should see the area as shown in this screenshot below.<\/p>\n
\"placeholder\"<\/figure>\n
\u201cMovable\u201d Icon<\/h2>\n
Lastly we will add an icon to the <li><\/code> to show that it is movable. To do so, we will add this icon through the :after<\/code> pseudo-element<\/em> and assign FontAwesome font family exclusively.<\/p>\n
\r\n.ui-sortable li.ui-state-default:after {\r\n\tcontent: \"\\f0c9\";\r\n\tdisplay: inline-block;\r\n\tfont-family: \"FontAwesome\";\r\n\tposition: absolute;\r\n\tright: 18px;\r\n\ttop: 9px;\r\n\ttext-align: center;\r\n\tline-height: 35px;\r\n\tcolor: rgba(255,255,255,.2);\r\n\ttext-shadow: 0px 0px 0px rgba(0,0,0,0);\r\n\tcursor: move;\r\n}<\/pre>\n
That\u2019s all the codes we need. Finally you can view the demo and examine the source code through the following links. We hope you enjoyed this tutorial.<\/p>\n