Параметры
classes
По умолчанию: {
"ui-tooltip": "ui-corner-all ui-widget-shadow"
} Укажите дополнительные классы, которые нужно добавить к элементам виджета. Любой из классов, указанных в разделе Тема, может использоваться в качестве ключа для переопределения его значения. Чтобы узнать больше об этом параметре, ознакомьтесь со статьей учебник о параметре classes.
Примеры кода: Инициализируйте всплывающую подсказку с указанным параметром classes, изменяя тему для класса ui-tooltip:
$( ".selector" ).tooltip({
classes: {
"ui-tooltip": "highlight"
}
}); Получите или задайте свойство параметра classes, после инициализации, здесь читаем и изменяем тему для класса ui-tooltip:
// Getter
var themeClass = $( ".selector" ).tooltip( "option", "classes.ui-tooltip" );
// Setter
$( ".selector" ).tooltip( "option", "classes.ui-tooltip", "highlight" );
content
По умолчанию: function returning the title attribute
Содержимое всплывающей подсказки.
При изменении этого параметра, вероятно, также необходимо изменить параметр items.
Поддерживаются несколько типов: - Функция: Обратный вызов, который может либо вернуть содержимое непосредственно, либо вызвать первый аргумент, передав содержимое, например, для содержимого Ajax.
- Строка: Строка HTML для использования в качестве содержимого всплывающей подсказки.
- Элемент: Элемент DOM для использования в качестве содержимого всплывающей подсказки.
- jQuery: Объект jQuery для использования в качестве содержимого всплывающей подсказки.
Примеры кода:Инициализируйте всплывающую подсказку с указанным параметром content:
$( ".selector" ).tooltip({
content: "Awesome title!"
}); Получите или задайте параметр content, после инициализации:
// Getter
var content = $( ".selector" ).tooltip( "option", "content" );
// Setter
$( ".selector" ).tooltip( "option", "content", "Awesome title!" );
disabled
По умолчанию: false
Отключает всплывающую подсказку, если установлено значение true.
Примеры кода:Инициализируйте всплывающую подсказку с указанным параметром disabled:
$( ".selector" ).tooltip({
disabled: true
}); Получите или задайте параметр disabled, после инициализации:
// Getter
var disabled = $( ".selector" ).tooltip( "option", "disabled" );
// Setter
$( ".selector" ).tooltip( "option", "disabled", true );
hide
По умолчанию: true
Как и когда анимировать скрытие всплывающей подсказки.
Поддерживаются несколько типов: - Булево: При установке значения
false, анимация не будет использоваться, и всплывающая подсказка будет скрыта немедленно. При установке значения true, всплывающая подсказка будет скрываться с плавным эффектом с заданной по умолчанию продолжительностью и плавностью. - Число: Всплывающая подсказка будет скрываться с плавным эффектом с заданной продолжительностью и плавностью по умолчанию.
- Строка: Всплывающая подсказка будет скрываться с заданным эффектом. Значение может быть именем встроенного метода анимации jQuery, например,
"slideUp", или именем эффекта jQuery UI, например, "fold". В обоих случаях эффект будет использован с продолжительностью и плавностью по умолчанию. - Объект: Если значение является объектом, то свойства
effect, delay, duration, и easing могут быть предоставлены. Если свойство effect содержит имя метода jQuery, то будет использован этот метод; в противном случае предполагается, что это имя эффекта jQuery UI. При использовании эффекта jQuery UI, поддерживающего дополнительные настройки, вы можете включить эти настройки в объект, и они будут переданы эффекту. Если duration или easing отсутствуют, будут использованы значения по умолчанию. Если effect отсутствует, будет использовано значение "fadeOut". Если delay отсутствует, задержка не используется.
Примеры кода:Инициализируйте всплывающую подсказку с указанным параметром hide:
$( ".selector" ).tooltip({
hide: { effect: "explode", duration: 1000 }
}); Получите или задайте параметр hide, после инициализации:
// Getter
var hide = $( ".selector" ).tooltip( "option", "hide" );
// Setter
$( ".selector" ).tooltip( "option", "hide", { effect: "explode", duration: 1000 } ); items
По умолчанию: [title]
Селектор, указывающий, какие элементы должны отображать всплывающие подсказки. Настройте, если вы используете что-то другое, чем атрибут title для содержимого всплывающей подсказки, или если вам нужен другой селектор для делегирования событий.
При изменении этого параметра, вероятно, также необходимо изменить параметр content.
Примеры кода:Инициализируйте всплывающую подсказку с указанным параметром items:
$( ".selector" ).tooltip({
items: "img[alt]"
}); Получите или задайте параметр items, после инициализации:
// Getter
var items = $( ".selector" ).tooltip( "option", "items" );
// Setter
$( ".selector" ).tooltip( "option", "items", "img[alt]" );
position
По умолчанию: { my: "left top+15", at: "left bottom", collision: "flipfit" }
Определяет положение всплывающей подсказки относительно связанного целевого элемента. Параметр of по умолчанию устанавливается на целевой элемент, но вы можете указать другой элемент для позиционирования. Подробнее о различных параметрах см. в разделе jQuery UI Position.
Примеры кода:Инициализируйте всплывающую подсказку с указанным параметром position:
$( ".selector" ).tooltip({
position: { my: "left+15 center", at: "right center" }
}); Получите или задайте параметр position, после инициализации:
// Getter
var position = $( ".selector" ).tooltip( "option", "position" );
// Setter
$( ".selector" ).tooltip( "option", "position", { my: "left+15 center", at: "right center" } ); show
По умолчанию: true
Как и когда анимировать отображение всплывающей подсказки.
Поддерживаются несколько типов: - Булево: При установке значения
false, анимация не будет использоваться, и всплывающая подсказка будет отображена немедленно. При установке значения true, всплывающая подсказка будет отображаться с плавным эффектом с заданной по умолчанию продолжительностью и плавностью. - Число: Всплывающая подсказка будет отображаться с плавным эффектом с заданной продолжительностью и плавностью по умолчанию.
- Строка: Всплывающая подсказка будет отображаться с заданным эффектом. Значение может быть именем встроенного метода анимации jQuery, например,
"slideDown", или именем эффекта jQuery UI, например, "fold". В обоих случаях эффект будет использован с продолжительностью и плавностью по умолчанию. - Объект: Если значение является объектом, то свойства
effect, delay, duration, и easing могут быть предоставлены. Если свойство effect содержит имя метода jQuery, то будет использован этот метод; в противном случае предполагается, что это имя эффекта jQuery UI. При использовании эффекта jQuery UI, поддерживающего дополнительные настройки, вы можете включить эти настройки в объект, и они будут переданы эффекту. Если duration или easing отсутствуют, будут использованы значения по умолчанию. Если effect отсутствует, будет использовано значение "fadeIn". Если delay отсутствует, задержка не используется.
Примеры кода:Инициализируйте всплывающую подсказку с указанным параметром show:
$( ".selector" ).tooltip({
show: { effect: "blind", duration: 800 }
}); Получите или задайте параметр show, после инициализации:
// Getter
var show = $( ".selector" ).tooltip( "option", "show" );
// Setter
$( ".selector" ).tooltip( "option", "show", { effect: "blind", duration: 800 } ); track
По умолчанию: false
Следует ли всплывающей подсказке отслеживать (следовать) курсор мыши.
Примеры кода:Инициализируйте всплывающую подсказку с указанным параметром track:
$( ".selector" ).tooltip({
track: true
}); Получите или задайте параметр track, после инициализации:
// Getter
var track = $( ".selector" ).tooltip( "option", "track" );
// Setter
$( ".selector" ).tooltip( "option", "track", true );