jQueryUI предоставляет метод button () для преобразования элементов HTML (таких как кнопки, входы и привязки) в тематические кнопки с автоматическим управлением движениями мыши на них, все прозрачно управляется пользовательским интерфейсом jQuery.
Чтобы сгруппировать переключатели, Button также предоставляет дополнительный виджет, называемый Buttonset . Buttonset используется путем выбора элемента контейнера (который содержит переключатели) и вызова .buttonset () .
Синтаксис
Метод button () можно использовать в двух формах:
Метод $ (селектор, контекст) .button (опции)
Метод $ (селектор, контекст) .button («действие», params)
Метод $ (селектор, контекст) .button (опции)
Метод button (options) объявляет, что HTML-элемент должен рассматриваться как кнопка. Параметр options — это объект, который определяет поведение и внешний вид кнопки.
Синтаксис
$(selector, context).button (options);
Вы можете предоставить один или несколько параметров одновременно, используя объект Javascript. Если нужно указать несколько параметров, разделите их запятой следующим образом:
$(selector, context).button({option1: value1, option2: value2..... });
В следующей таблице перечислены различные параметры, которые можно использовать с этим методом —
Sr.No. | Вариант и описание |
---|---|
1 | отключен
Эта опция отключает кнопку, установленную в true . По умолчанию его значение равно false . |
2 | иконки
Этот параметр указывает, что один или два значка должны отображаться на кнопке: основные значки слева, дополнительные значки справа. Основной значок идентифицируется основным свойством объекта, а дополнительный значок идентифицируется вторичным свойством. По умолчанию его значение является первичным: null, вторичным: null . |
3 | этикетка
Этот параметр указывает текст, отображаемый на кнопке, которая переопределяет естественную метку. Если опущено, отображается естественная метка для элемента. В случае переключателей и флажков естественная метка является элементом <label>, связанным с элементом управления. По умолчанию его значение равно нулю . |
4 | текст
Эта опция указывает, должен ли текст отображаться на кнопке. Если указано значение false , текст подавляется, если (и только если) параметр значков указывает хотя бы один значок. По умолчанию его значение равно true . |
Эта опция отключает кнопку, установленную в true . По умолчанию его значение равно false .
Опция — отключена
Эта опция отключает кнопку, установленную в true . По умолчанию его значение равно false .
Синтаксис
Этот параметр указывает, что один или два значка должны отображаться на кнопке: основные значки слева, дополнительные значки справа. Основной значок идентифицируется основным свойством объекта, а дополнительный значок идентифицируется вторичным свойством. По умолчанию его значение является первичным: null, вторичным: null .
Вариант — иконки
Этот параметр указывает, что один или два значка должны отображаться на кнопке: основные значки слева, дополнительные значки справа. Основной значок идентифицируется основным свойством объекта, а дополнительный значок идентифицируется вторичным свойством. По умолчанию его значение является первичным: null, вторичным: null .
Синтаксис
Этот параметр указывает текст, отображаемый на кнопке, которая переопределяет естественную метку. Если опущено, отображается естественная метка для элемента. В случае переключателей и флажков естественная метка является элементом <label>, связанным с элементом управления. По умолчанию его значение равно нулю .
Вариант — этикетка
Этот параметр указывает текст, отображаемый на кнопке, которая переопределяет естественную метку. Если опущено, отображается естественная метка для элемента. В случае переключателей и флажков естественная метка является элементом <label>, связанным с элементом управления. По умолчанию его значение равно нулю .
Синтаксис
Эта опция указывает, должен ли текст отображаться на кнопке. Если указано значение false , текст подавляется, если (и только если) параметр значков указывает хотя бы один значок. По умолчанию его значение равно true .
Вариант — текст
Эта опция указывает, должен ли текст отображаться на кнопке. Если указано значение false , текст подавляется, если (и только если) параметр значков указывает хотя бы один значок. По умолчанию его значение равно true .
Синтаксис
Функциональность по умолчанию
В следующем примере демонстрируется простой пример функциональности виджета кнопки без передачи параметров методу button () .
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Buttons functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <script> $(function() { $( "#button-1, #button-2, #button-3, #button-4" ).button(); $( "#button-5" ).buttonset(); }); </script> </head> <body> <button id = "button-1">A button element</button> <input id = "button-2" type = "submit" value = "A submit button"> <a id = "button-3" href = "">An anchor</a> <input type = "checkbox" id = "button-4" > <label for = "button-4">Toggle</label> <br><br> <div id = "button-5"> <input type = "checkbox" id = "check1"> <label for = "check1">Left</label> <input type = "checkbox" id = "check2"> <label for = "check2">Middle</label> <input type = "checkbox" id = "check3"> <label for = "check3">Right</label> </div> </body> </html>
Давайте сохраним приведенный выше код в HTML-файле buttonexample.htm и откроем его в стандартном браузере, который поддерживает javascript, вы должны увидеть следующий вывод. Теперь вы можете играть с результатом —
В этом примере демонстрируется разметка, которая может использоваться для кнопок: элемент кнопки, ввод типа submit и привязка.
Использование иконок, текста и отключено
В следующем примере демонстрируется использование двух значков параметров, текстовых и отключенных, в функции кнопок JqueryUI.
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Buttons functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <script> $(function() { $( "#button-6" ).button({ icons: { primary: "ui-icon-locked" }, text: false }); $( "#button-7" ).button({ disabled:true }); $( "#button-8" ).button({ icons: { primary: "ui-icon-gear", secondary: "ui-icon-triangle-1-s" } }); }); </script> </head> <body> <button id = "button-6"> Button with icon only </button> <button id = "button-7"> Button Disabled </button> <button id = "button-8"> Button with two icons </button> </body> </html>
Давайте сохраним приведенный выше код в HTML-файле buttonexample.htm и откроем его в стандартном браузере, который поддерживает javascript, вы должны увидеть следующий вывод. Теперь вы можете играть с результатом —
Здесь вы можете увидеть кнопку с одним значком, кнопку с двумя значками и отключенную кнопку.
Метод $ (селектор, контекст) .button («действие», params)
Метод button («action», params) может выполнять действие над кнопками, например отключение кнопки. Действие указывается в виде строки в первом аргументе (например, «отключить», чтобы отключить кнопку). Проверьте действия, которые можно передать, в следующей таблице.
Синтаксис
$(selector, context).button ("action", params);
В следующей таблице перечислены различные действия, которые можно использовать с этим методом —
Sr.No. | Действие и описание |
---|---|
1 | уничтожить
Это действие полностью удаляет функциональность кнопки элемента. Элементы возвращаются в состояние до инициализации. Этот метод не принимает никаких аргументов. |
2 | запрещать
Это действие отключает функциональность кнопки элемента. Этот метод не принимает никаких аргументов. |
3 | включить
Это действие включает функциональность кнопки элемента. Этот метод не принимает никаких аргументов. |
4 | опция (optionName)
Это действие возвращает значение параметра, указанного в optionName . Где optionName — это строка. |
5 | вариант
Это действие извлекает объект, содержащий пары ключ / значение, представляющие текущий хэш параметров кнопки. |
6 | опция (optionName, значение)
Это действие устанавливает значение опции кнопки, связанной с указанным optionName . |
7 | вариант (варианты)
Это действие устанавливает один или несколько параметров для кнопки. Где параметры — это карта пар «значение-значение» для установки. |
8 | обновление
Это действие обновляет отображение кнопки. Это полезно, когда кнопки обрабатываются программой, и дисплей не обязательно соответствует внутреннему состоянию. Этот метод не принимает никаких аргументов. |
9 | виджет
Это действие возвращает объект jQuery, содержащий элемент кнопки. Этот метод не принимает никаких аргументов. |
Это действие полностью удаляет функциональность кнопки элемента. Элементы возвращаются в состояние до инициализации. Этот метод не принимает никаких аргументов.
Действие — уничтожить
Это действие полностью удаляет функциональность кнопки элемента. Элементы возвращаются в состояние до инициализации. Этот метод не принимает никаких аргументов.
Синтаксис
Это действие отключает функциональность кнопки элемента. Этот метод не принимает никаких аргументов.
Действие — отключить
Это действие отключает функциональность кнопки элемента. Этот метод не принимает никаких аргументов.
Синтаксис
Это действие включает функциональность кнопки элемента. Этот метод не принимает никаких аргументов.
Действие — включить
Это действие включает функциональность кнопки элемента. Этот метод не принимает никаких аргументов.
Синтаксис
Это действие возвращает значение параметра, указанного в optionName . Где optionName — это строка.
Действие — опция (optionName)
Это действие возвращает значение параметра, указанного в optionName . Где optionName — это строка.
Синтаксис
Это действие извлекает объект, содержащий пары ключ / значение, представляющие текущий хэш параметров кнопки.
Действие — опция
Это действие извлекает объект, содержащий пары ключ / значение, представляющие текущий хэш параметров кнопки.
Синтаксис
Это действие устанавливает значение опции кнопки, связанной с указанным optionName .
Действие — опция (optionName, value)
Это действие устанавливает значение опции кнопки, связанной с указанным optionName . Где optionName — это имя параметра, который нужно установить, а значение — это значение, которое нужно установить для параметра.
Синтаксис
Это действие устанавливает один или несколько параметров для кнопки. Где параметры — это карта пар «значение-значение» для установки.
Действие — опция (варианты)
Это действие устанавливает один или несколько параметров для кнопки. Где параметры — это карта пар «значение-значение» для установки.
Синтаксис
Это действие обновляет отображение кнопки. Это полезно, когда кнопки обрабатываются программой, и дисплей не обязательно соответствует внутреннему состоянию. Этот метод не принимает никаких аргументов.
Действие — обновить
Это действие обновляет отображение кнопки. Это полезно, когда кнопки обрабатываются программой, и дисплей не обязательно соответствует внутреннему состоянию. Этот метод не принимает никаких аргументов.
Синтаксис
Это действие возвращает объект jQuery, содержащий элемент кнопки. Этот метод не принимает никаких аргументов.
Действие — виджет
Это действие возвращает объект jQuery, содержащий элемент кнопки. Этот метод не принимает никаких аргументов.
Синтаксис
пример
Теперь давайте посмотрим на пример, используя действия из таблицы выше. В следующем примере демонстрируется использование методов destroy () и disable () .
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Buttons functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <script> $(function() { $( "#button-9" ).button({ text: false, icons: { primary: "ui-icon-seek-start" } }); $( "#button-9" ).button('destroy'); $( "#button-10" ).button({ icons: { primary: "ui-icon-seek-prev" } }); $( "#button-10" ).button('disable'); $( "#button-11" ).button({ text: false, icons: { primary: "ui-icon-play" } }); }); </script> </head> <body> <button id = "button-9"> I'm destroyed </button> <button id = "button-10"> I'm disabled </button> <button id = "button-11"> play </button> </body> </html>
Давайте сохраним приведенный выше код в HTML-файле buttonexample.htm и откроем его в стандартном браузере, который поддерживает javascript, вы должны увидеть следующий вывод:
Управление событиями на кнопках
В дополнение к методу кнопки (опции), который мы видели в предыдущих разделах, JqueryUI предоставляет методы события, которые запускаются для определенного события. Эти методы событий перечислены ниже —
Sr.No. | Метод и описание события |
---|---|
1 | создать (событие, пользовательский интерфейс)
Это событие срабатывает при создании кнопки. Где событие имеет тип события , а пользовательский интерфейс имеет тип объекта . |
Это событие срабатывает при создании кнопки. Где событие имеет тип события , а пользовательский интерфейс имеет тип объекта .
Событие — создать (событие, пользовательский интерфейс)
Это событие срабатывает при создании элемента кнопки. Где событие имеет тип события , а пользовательский интерфейс имеет тип объекта .
Синтаксис
пример
В следующем примере демонстрируется использование метода события для функциональности виджета кнопки. Этот пример демонстрирует использование события create .
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Buttons functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <style> .resultarea { background: #cedc98; border-top: 1px solid #000000; border-bottom: 1px solid #000000; color: #333333; font-size:14px; } </style> <script> $(function() { $( "#button-12" ).button({ create: function() { $("p#result").html ($("p#result") .html () + "<b>created</b><br>"); } }); }); </script> </head> <body> <button id = "button-12"> A button element </button> <p class = "resultarea" id = result></p> </body> </html>
Давайте сохраним приведенный выше код в HTML-файле buttonexample.htm и откроем его в стандартном браузере, который поддерживает javascript, вы также должны увидеть следующий вывод: