JQuery UI API - Button компонента (кнопка Widget)
категория
использование
Описание: themable кнопки и кнопки.
Новая версия: 1.8
Компонент Button (кнопка Widget) усилить функциональность стандартных элементов формы, такие как кнопки (кнопка), вход (вход), якоря (анкер), с соответствующим висения (зависания) и активации (активного) стиля к теме кнопки.
В дополнение к основным кнопкам, радио-кнопки и флажки (тип ввода радио и поле для галочки) также могут быть преобразованы в кнопки. Связанные теги (метки) предназначен стили кнопок, обновить основной вход щелкнул. Для того , чтобы работать должным образом , вам потребуется ввести id
атрибута, и указать на этикетке (ярлыке) является for
собственности. Не вводите на этикетке (этикетке) внутри, иначе это будет вызывать проблемы доступности .
Для кнопок пакетной радиопередачи, Кнопка также предоставляет дополнительный виджет под названием Buttonset. Buttonset, выбрав элемент контейнера ( в том числе радио - кнопки) и вызовите .buttonset()
, чтобы использовать. Buttonset также обеспечивает визуальную группировку, поэтому, когда есть кнопка может рассмотреть вопрос об использовании его. Он выбирает всех потомков и их применение .button()
. Вы можете включить и отключить набор кнопок, которые будут включать и отключать все кнопки. Разрушение Кнопка вызова ралли каждой кнопки destroy
метод. Для переключателей и флажков кнопку Группировка рекомендуется использовать с legend
о fieldset
, чтобы обеспечить доступную метку пакета.
При использовании типа кнопки, или нажмите кнопку сброса на вход, поддержка ограничивается простым текстом без подписи к значкам.
Тематизация
Кнопка компонента (кнопка Widget) с помощью рамки JQuery UI CSS , чтобы определить внешний вид и его стиль. Если вам необходимо использовать указанные кнопки стиля, вы можете использовать следующее имя класса CSS:
-
ui-button
: DOM элементов , представляющих собой кнопку. Этот элемент будет основан на тексте и иконки , чтобы добавить один из следующих вариантов класса:ui-button-text-only
дляui-button-icon-only
ui-button-icons-only
ui-button-text-icons
ui-button-text-only
,ui-button-icon-only
,ui-button-icons-only
,ui-button-text-icons
.-
ui-button-icon-primary
: основные элементы иконки кнопок для отображения. Только тогда , когда главная иконка иконки предоставляют возможности при представлении. -
ui-button-text
: контейнер вокруг текстового содержимого кнопки. -
ui-button-icon-secondary
: вторичного отображения кнопки для иконок. Только тогда , когда вторичные значок иконки предоставляют возможности при представлении.
-
-
ui-buttonset
: Buttonset внешнего контейнера.
полагаться
дополнительная информация
- Часть требует некоторой функциональной CSS, в противном случае она не будет работать. Если вы создаете собственную тему, используйте виджет указанный файл CSS в качестве отправной точки.
Быстрая навигация
选项 | 方法 | 事件 |
---|---|---|
选项 | 类型 | 描述 | 默认值 |
---|---|---|---|
disabled | Boolean | 如果设置为 true ,则禁用该 button。代码实例: 初始化带有指定 $( ".selector" ).button({ disabled: true }); 在初始化后,获取或设置 // getter var disabled = $( ".selector" ).button( "option", "disabled" ); // setter $( ".selector" ).button( "option", "disabled", true ); |
false |
icons | Object | 要显示的图标,包括带有文本的图标和不带有文本的图标(查看 text 选项)。默认情况下 ,主图标显示在标签文本的左边,副图标显示在右边。显示位置可通过 CSS 进行控制。 代码实例: 初始化带有指定 $( ".selector" ).button({ icons: { primary: "ui-icon-gear", secondary: "ui-icon-triangle-1-s" } }); 在初始化后,获取或设置 // getter var icons = $( ".selector" ).button( "option", "icons" ); // setter $( ".selector" ).button( "option", "icons", { primary: "ui-icon-gear", secondary: "ui-icon-triangle-1-s" } ); |
{ primary: null, secondary: null } |
label | String | 要显示在按钮中的文本。当未指定时( null ),则使用元素的 HTML 内容,或者如果元素是一个 submit 或 reset 类型的 input 元素,则使用它的 value 属性,或者如果元素是一个 radio 或 checkbox 类型的 input 元素,则使用相关的 label 元素的 HTML 内容。代码实例: 初始化带有指定 $( ".selector" ).button({ label: "custom label" }); 在初始化后,获取或设置 // getter var label = $( ".selector" ).button( "option", "label" ); // setter $( ".selector" ).button( "option", "label", "custom label" ); |
null |
text | Boolean | 是否显示标签。当设置为 false 时,不显示文本,但是此时必须启用 icons 选项,否则 text 选项将被忽略。 代码实例: 初始化带有指定 $( ".selector" ).button({ text: false }); 在初始化后,获取或设置 // getter var text = $( ".selector" ).button( "option", "text" ); // setter $( ".selector" ).button( "option", "text", false ); |
true |
方法 | 返回 | 描述 |
---|---|---|
destroy() | jQuery (plugin only) | 完全移除 button 功能。这会把元素返回到它的预初始化状态。
代码实例: 调用 destroy 方法: $( ".selector" ).button( "destroy" ); |
disable() | jQuery (plugin only) | 禁用 button。
代码实例: 调用 disable 方法: $( ".selector" ).button( "disable" ); |
enable() | jQuery (plugin only) | 启用 button。
代码实例: 调用 enable 方法: $( ".selector" ).button( "enable" ); |
option( optionName ) | Object | 获取当前与指定的 optionName 关联的值。
代码实例: 调用该方法: var isDisabled = $( ".selector" ).button( "option", "disabled" ); |
option() | PlainObject | 获取一个包含键/值对的对象,键/值对表示当前 button 选项哈希。
代码实例: 调用该方法: var options = $( ".selector" ).button( "option" ); |
option( optionName, value ) | jQuery (plugin only) | 设置与指定的 optionName 关联的 button 选项的值。
代码实例: 调用该方法: $( ".selector" ).button( "option", "disabled", true ); |
option( options ) | jQuery (plugin only) | 为 button 设置一个或多个选项。
代码实例: 调用该方法: $( ".selector" ).button( "option", { disabled: true } ); |
refresh() | jQuery (plugin only) | 刷新按钮的视觉状态。用于在以编程方式改变原生元素的选中状态或禁用状态后更新按钮状态。
代码实例: 调用 refresh 方法: $( ".selector" ).button( "refresh" ); |
widget() | jQuery | 返回一个包含 button 的 jQuery 对象。
代码实例: 调用 widget 方法: var widget = $( ".selector" ).button( "widget" ); |
事件 | 类型 | 描述 |
---|---|---|
create( event, ui ) | buttoncreate | 当创建按钮 button 时触发。
注意: 代码实例: 初始化带有指定 create 回调的 button: $( ".selector" ).button({ create: function( event, ui ) {} }); 绑定一个事件监听器到 buttoncreate 事件: $( ".selector" ).on( "buttoncreate", function( event, ui ) {} ); |
примеров
Пример 1:Простая кнопка JQuery UI (кнопка).
<! DOCTYPE HTML> <HTML LANG = "EN"> <Head> <Meta Charset = "UTF-8"> <Title> член (кнопка Widget) Demo </ title> <Link отн = "таблица стилей" HREF = "// code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> <Script SRC = "// code.jquery.com/jquery-1.10.2.js"> </ скрипт> <Script SRC = "// code.jquery.com/ui/1.10.4/jquery-ui.js"> </ скрипт> </ Head> <Body> <Кнопка> Метка кнопки </ кнопка> <Script> $ ( "Button") .button (); </ Script> </ Body> </ HTML>Пример 2:
Простой JQuery UI кнопки набора (Buttonset).
<! DOCTYPE HTML> <HTML LANG = "EN"> <Head> <Meta Charset = "UTF-8"> <Title> член (кнопка Widget) Demo </ title> <Link отн = "таблица стилей" HREF = "// code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css"> <Script SRC = "// code.jquery.com/jquery-1.10.2.js"> </ скрипт> <Script SRC = "// code.jquery.com/ui/1.10.4/jquery-ui.js"> </ скрипт> </ Head> <Body> <Форма> <Fieldset> <Легенда> любимый проект JQuery </ легенда> <Div ID = "радио"> <Тип входного = "радио" ID = "шипение" имя = "Проект"> <Ярлык = "шипение"> Сиззле </ метка> <Тип входного = "радио" ID = "QUnit" имя = "Проект" проверено = "проверено"> <Ярлык = "QUnit"> QUnit </ метка> <Тип входного = "радио" ID = имя "цвет" = "Проект"> <Ярлык = "цвет"> Цвет </ метка> </ Div> </ Fieldset> </ Форма> <Script> $ ( "#radio") .buttonset (); </ Script> </ Body> </ HTML>