Параметры
addClasses
Значение по умолчанию: true
Если установлено в false, предотвратит добавление класса ui-draggable. Это может быть желательно для оптимизации производительности при вызове .draggable() на сотнях элементов.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром addClasses:
$( ".selector" ).draggable({
addClasses: false
}); Получите или установите параметр addClasses после инициализации:
// Getter
var addClasses = $( ".selector" ).draggable( "option", "addClasses" );
// Setter
$( ".selector" ).draggable( "option", "addClasses", false );
appendTo
Значение по умолчанию: "parent"
Элемент, к которому должен быть добавлен помощник перетаскивания во время перетаскивания.
Примечание: Параметр
appendTo работает только тогда, когда параметр
helper установлен так, чтобы не использовать исходный элемент.
Поддерживаются несколько типов: - jQuery: Объект jQuery, содержащий элемент, к которому нужно добавить помощник.
- Элемент: Элемент, к которому нужно добавить помощник.
- Селектор: Селектор, определяющий элемент, к которому нужно добавить помощник.
- Строка: Строка
"parent" приведет к тому, что помощник станет следующим за перетаскиваемым элементом.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром appendTo:
$( ".selector" ).draggable({
appendTo: "body"
}); Получите или установите параметр appendTo после инициализации:
// Getter
var appendTo = $( ".selector" ).draggable( "option", "appendTo" );
// Setter
$( ".selector" ).draggable( "option", "appendTo", "body" );
axis
Значение по умолчанию: false
Ограничивает перетаскивание осью X (горизонтальной) или осью Y (вертикальной). Возможные значения: "x", "y".
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром axis:
$( ".selector" ).draggable({
axis: "x"
}); Получите или установите параметр axis после инициализации:
// Getter
var axis = $( ".selector" ).draggable( "option", "axis" );
// Setter
$( ".selector" ).draggable( "option", "axis", "x" );
cancel
Значение по умолчанию: "input,textarea,button,select,option"
Предотвращает начало перетаскивания на указанных элементах.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром cancel:
$( ".selector" ).draggable({
cancel: ".title"
}); Получите или установите параметр cancel после инициализации:
// Getter
var cancel = $( ".selector" ).draggable( "option", "cancel" );
// Setter
$( ".selector" ).draggable( "option", "cancel", ".title" );
classes
Значение по умолчанию: {}
Укажите дополнительные классы, которые нужно добавить к элементам виджета. Любые классы, указанные в разделе Стиль, могут быть использованы в качестве ключей для переопределения их значения. Для получения дополнительной информации об этом параметре ознакомьтесь со статьей учебником о параметре classes.
Примеры кода: Инициализируйте перетаскиваемый элемент с указанным параметром classes, изменив стиль для класса ui-draggable:
$( ".selector" ).draggable({
classes: {
"ui-draggable": "highlight"
}
}); Получите или установите свойство параметра classes после инициализации, здесь читая и изменяя стиль для класса ui-draggable:
// Getter
var themeClass = $( ".selector" ).draggable( "option", "classes.ui-draggable" );
// Setter
$( ".selector" ).draggable( "option", "classes.ui-draggable", "highlight" );
connectToSortable
Значение по умолчанию: false
Разрешает перетаскивание на указанные сортируемые элементы. Если этот параметр используется, перетаскиваемый элемент может быть помещен в сортируемый список и станет его частью. Примечание: параметр
helper должен быть установлен в
"clone" для правильной работы. Требуется плагин
jQuery UI Sortable.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром connectToSortable:
$( ".selector" ).draggable({
connectToSortable: "#my-sortable"
}); Получите или установите параметр connectToSortable после инициализации:
// Getter
var connectToSortable = $( ".selector" ).draggable( "option", "connectToSortable" );
// Setter
$( ".selector" ).draggable( "option", "connectToSortable", "#my-sortable" );
containment
Значение по умолчанию: false
Ограничивает перетаскивание пределами указанного элемента или области.
Поддерживаются несколько типов: - Селектор: Перетаскиваемый элемент будет ограничен границами первого элемента, найденного по селектору. Если элемент не найден, ограничений не будет.
- Элемент: Перетаскиваемый элемент будет ограничен границами этого элемента.
- Строка: Возможные значения:
"parent", "document", "window". - Массив: Массив, определяющий ограничивающую прямоугольную область в виде
[ x1, y1, x2, y2 ].
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром containment:
$( ".selector" ).draggable({
containment: "parent"
}); Получите или установите параметр containment после инициализации:
// Getter
var containment = $( ".selector" ).draggable( "option", "containment" );
// Setter
$( ".selector" ).draggable( "option", "containment", "parent" );
cursor
Значение по умолчанию: "auto"
Курсор CSS во время операции перетаскивания.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром cursor:
$( ".selector" ).draggable({
cursor: "crosshair"
}); Получите или установите параметр cursor после инициализации:
// Getter
var cursor = $( ".selector" ).draggable( "option", "cursor" );
// Setter
$( ".selector" ).draggable( "option", "cursor", "crosshair" );
cursorAt
Значение по умолчанию: false
Устанавливает смещение помощника перетаскивания относительно курсора мыши. Координаты можно задать в виде объекта, используя комбинацию одного или двух ключей: { top, left, right, bottom }.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром cursorAt:
$( ".selector" ).draggable({
cursorAt: { left: 5 }
}); Получите или установите параметр cursorAt после инициализации:
// Getter
var cursorAt = $( ".selector" ).draggable( "option", "cursorAt" );
// Setter
$( ".selector" ).draggable( "option", "cursorAt", { left: 5 } ); delay
Значение по умолчанию: 0
Время в миллисекундах после нажатия левой кнопки мыши, до начала перетаскивания. Этот параметр может использоваться для предотвращения нежелательных перетаскиваний при нажатии на элемент. (версия устарела: 1.12)
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром delay:
$( ".selector" ).draggable({
delay: 300
}); Получите или установите параметр delay после инициализации:
// Getter
var delay = $( ".selector" ).draggable( "option", "delay" );
// Setter
$( ".selector" ).draggable( "option", "delay", 300 );
disabled
Значение по умолчанию: false
Отключает перетаскивание, если установлено в true.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром disabled:
$( ".selector" ).draggable({
disabled: true
}); Получите или установите параметр disabled после инициализации:
// Getter
var disabled = $( ".selector" ).draggable( "option", "disabled" );
// Setter
$( ".selector" ).draggable( "option", "disabled", true );
distance
Значение по умолчанию: 1
Расстояние в пикселях после нажатия левой кнопки мыши, которое должно пройти, прежде чем начнется перетаскивание. Этот параметр может использоваться для предотвращения нежелательных перетаскиваний при нажатии на элемент. (версия устарела: 1.12)
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром distance:
$( ".selector" ).draggable({
distance: 10
}); Получите или установите параметр distance после инициализации:
// Getter
var distance = $( ".selector" ).draggable( "option", "distance" );
// Setter
$( ".selector" ).draggable( "option", "distance", 10 );
grid
Значение по умолчанию: false
Фиксирует помощник перетаскивания на сетке через каждые x и y пикселей. Массив должен иметь вид [ x, y ].
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром grid:
$( ".selector" ).draggable({
grid: [ 50, 20 ]
}); Получите или установите параметр grid после инициализации:
// Getter
var grid = $( ".selector" ).draggable( "option", "grid" );
// Setter
$( ".selector" ).draggable( "option", "grid", [ 50, 20 ] );
handle
Значение по умолчанию: false
Если указано, ограничит начало перетаскивания случаем, если нажатие левой кнопки мыши произойдет на указанном элементе(ах). Допускаются только элементы, являющиеся потомками перетаскиваемого элемента.
Примеры кода:Инициализируйте перетаскиваемый элемент с указанным параметром handle:
$( ".selector" ).draggable({
handle: "h2"
}); Получите или установите параметр handle после инициализации:
// Getter
var handle = $( ".selector" ).draggable( "option", "handle" );
// Setter
$( ".selector" ).draggable( "option", "handle", "h2" );