Sortable.create 说明
Sortable.create用此方法可以初始化一个可排序对象。表达式:Sortable.create(id_of_container,[options]);可选项:Option>DefaultDescriptiontagli设置一个可被Sortable的标签种类(应包含在表达式指定的容器中),在UL或者OL容器中,LI标签是默认值。
·
Sortable.create
用此方法可以初始化一个可排序对象。
表达式:
Sortable.create('id_of_container',[options]);
可选项:
Option | >Default | Description |
---|---|---|
tag | li | 设置一个可被Sortable的标签种类(应包含在表达式指定的容器中),在UL或者OL容器中,LI标签是默认值。 |
only | (none) | 此选项将约束指定的CSS class所在的对象才能够加载Sortable,你可以指定一个单独的class名称或者一个CSS class所组成的字符串数组。 |
overlap | vertical | 该选项有2个可选值,‘vertical’ 或者 ‘horizontal’。 对于浮动对象或者水平列表,选择‘horizontal’。 竖直的列表对象应该选择 ‘vertical’。 |
constraint | vertical | 约束可拖曳的对象的移动方向。可选值为‘vertical’ 或者 ‘horizontal’。 |
containment | () | 允许在多个Sortable对象之间进行DragAndDrop,给出一个或者多个Sortable对象的ID或ID字符组成的数组来指定发生DragAndDrop的对象。该行为发生的要点是:所有指定的ID,其容器必定要加载Sortable.create方法。(注意:如果想让拖曳的目的容器仍然具有排序功能,那在containment中必须指定好自生容器的id。) |
format | 干嘛的?我不是很清楚。 | |
handle | (none) | 和Draggable中的选项一样,选择一个对象作为拖曳出发之处。(ver 1.8.1没用?) |
hoverclass | (none) | 为创建Droppables的对象指定一个hover时的样式。 |
ghosting | false | 在拖曳时在原地产生一个克隆的拖曳对象。(ver 1.8.1中该选项在IE下有bug,期待新版本) |
dropOnEmpty | false | 如果设置为true时,这个sortable的容器会变成一个可Droppable的对象,进而该容器可以接受任何可拖曳且被容许Drop in的对象加入该容器。 |
scroll | (none) | 一大串东东,暂不理解,请看E文:When the sortable is contained in an element with style overflow:scroll , this value can be set to the ID of that container (or the container’s DOM object). The scroll position of the container will now move along when the sortable is dragged out of the viewable area. The container must have overflow:scroll set to include scroll bars. Does not yet work for scrolling the entire document. To get this to work correctly, include this line in your code before creating the sortable: Position.includeScrollOffsets = true; Update: Scrolling the whole document does work (at least on IE7 and Firefox). Use scroll: window |
scrollSensitivity | 20 | Will start scrolling when element is x pixels from the bottom, where x is the scrollSensitivity. |
scrollSpeed | 15 | Will scroll the element in increments of scrollSpeed pixels. |
tree | false | If true, sets sortable functionality to elements listed in treeTag (点解?) |
treeTag | ul | The element type tree nodes are contained in.(点解,too?) |
回调函数:
>Callback | Description |
---|---|
onChange | 当拖曳引起排序改变时该事件会被触发。当你将一个对象拖曳到另一个Sortable对象中,则该回调函数会在两个Sortable中各自触发一次。该函数默认接受参数为该被拖曳的对象。 |
onUpdate | 当一个拖曳完成并且Sortable的排序被改变时,该事件触发。同样的,如果将被拖曳对象从一个Sortable拉到另一个Sortable时,该回调函数将在各自的Sortable中触发。默认接受的参数为该Sortable容器。 |
注意:
有一点非常重要,在创建Sortable的时候允许的容器对象应该为块对象,当时基于当前浏览器的技术限制,table、tbody、tr等块对象将不被支持。
在一个嵌套在table中的Sortable对象将不能在IE浏览器下非常顺利的工作,除非为该table赋予一个position:relative的CSS属性。总之啦,尽量不要将Sortalbe容器放到table中就安拉!
如果你想生成一个带滚动条的Sortable对象,那么最好在该Sortable外嵌套一个div对象,并为该对象设置滚动样式。在IE下你还得做的一个工作就是要为该div附加一个position:relative的CSS属性。
更多推荐
已为社区贡献1条内容
所有评论(0)