Плагин формы jQuery EasyUI -Combo

jQuery EasyUI 插件jQuery EasyUI Плагины

Наследуется от $.fn.validatebox.defaults. Переопределите значения по умолчанию с помощью $.fn.combo.defaults.

Combo отображает редактируемое текстовое поле и выпадающую панель на HTML-странице. Это базовый компонент для создания других сложных combo-компонентов (таких как: combobox, combotree, combogrid и т. д.).

Зависимости

  • validatebox
  • panel

Использование

Combo можно создать с помощью JavaScript из элемента <select> или <input>. Обратите внимание, что создание combo из разметки недопустимо.

<input id="cc" value="001">

$('#cc').combo({
    required:true,
    multiple:true
});

Свойства

Эти свойства наследуются от validatebox. Ниже перечислены добавленные свойства для combo.

Name Type Описание Значение по умолчанию
width число Ширина компонента. auto
height число Высота компонента. Это свойство доступно начиная с версии 1.3.2. 22
panelWidth число Ширина выпадающей панели. null
panelHeight число Высота выпадающей панели. 200
multiple логическое значение Определяет, поддерживается ли множественный выбор. false
selectOnNavigation логическое значение Определяет, следует ли выбирать элемент при навигации по элементам с помощью клавиатуры. Это свойство доступно начиная с версии 1.3.3. истина
separator string Разделитель для текста, когда включён множественный выбор. ,
editable логическое значение Определяет, может ли пользователь напрямую вводить текст в текстовое поле. истина
disabled логическое значение Определяет, отключено ли текстовое поле. false
readonly логическое значение Определяет, доступен ли компонент только для чтения. Это свойство доступно начиная с версии 1.3.3. false
hasDownArrow логическое значение Определяет, показывать ли кнопку со стрелкой вниз. истина
value string Значение по умолчанию.
delay число Задерживает поиск после последнего события ввода с клавиатуры. 200
keyHandler объект Функция, вызываемая, когда пользователь нажимает клавишу. Стандартный keyHandler определён следующим образом:
keyHandler: {
    up: function(){},
    down: function(){},
    enter: function(){},
    query: function(q){}
}

Events

Name Parameters Описание
onShowPanel none Срабатывает, когда выпадающая панель показана.
onHidePanel none Срабатывает, когда выпадающая панель скрыта.
onChange newValue, oldValue Срабатывает, когда значение текстового поля изменяется.

Методы

Эти методы расширяют validatebox. Ниже приведены добавленные методы для combo.

Name Parameters Описание
options none Возвращает объект options.
panel none Возвращает объект выпадающей панели.
textbox none Возвращает объект текстового поля.
destroy none Уничтожает компонент.
resize width Настраивает ширину компонента.
showPanel none Показывает выпадающую панель.
hidePanel none Скрывает выпадающую панель.
disable none Отключает компонент.
enable none Включает компонент.
readonly mode Включает/отключает режим только для чтения. Этот метод доступен начиная с версии 1.3.3.
Пример использования:
$('#cc').combo('readonly');        // enable readonly mode
$('#cc').combo('readonly', true);    // enable readonly mode
$('#cc').combo('readonly', false);    // disable readonly mode
validate none Проверяет входное значение.
isValid none Возвращает результат проверки.
clear none Очищает значение компонента.
сброс none Сбрасывает значение компонента. Этот метод доступен начиная с версии 1.3.2.
getText none Получает введённый текст.
setText none Устанавливает текстовое значение.
getValues none Возвращает массив значений компонента.
setValues none Устанавливает массив значений компонента.
getValue none Возвращает значение компонента.
setValue none Устанавливает значение компонента.
jQuery EasyUI 插件Плагины jQuery EasyUI Другие расширения