← Back
Editing: button.js
/*! * jQuery UI Button 1.13.3 * https://jqueryui.com * * Copyright OpenJS Foundation and other contributors * Released under the MIT license. * https://jquery.org/license */ //>>label: Button //>>group: Widgets //>>description: Enhances a form with themeable buttons. //>>docs: https://api.jqueryui.com/button/ //>>demos: https://jqueryui.com/button/ //>>css.structure: ../../themes/base/core.css //>>css.structure: ../../themes/base/button.css //>>css.theme: ../../themes/base/theme.css ( function( factory ) { "use strict"; if ( typeof define === "function" && define.amd ) { // AMD. Register as an anonymous module. define( [ "jquery", // These are only for backcompat // TODO: Remove after 1.12 "./controlgroup", "./checkboxradio", "../keycode", "../widget" ], factory ); } else { // Browser globals factory( jQuery ); } } )( function( $ ) { "use strict"; $.widget( "ui.button", { version: "1.13.3", defaultElement: "<button>", options: { classes: { "ui-button": "ui-corner-all" }, disabled: null, icon: null, iconPosition: "beginning", label: null, showLabel: true }, _getCreateOptions: function() { var disabled, // This is to support cases like in jQuery Mobile where the base widget does have // an implementation of _getCreateOptions options = this._super() || {}; this.isInput = this.element.is( "input" ); disabled = this.element[ 0 ].disabled; if ( disabled != null ) { options.disabled = disabled; } this.originalLabel = this.isInput ? this.element.val() : this.element.html(); if ( this.originalLabel ) { options.label = this.originalLabel; } return options; }, _create: function() { if ( !this.option.showLabel & !this.options.icon ) { this.options.showLabel = true; } // We have to check the option again here even though we did in _getCreateOptions, // because null may have been passed on init which would override what was set in // _getCreateOptions if ( this.options.disabled == null ) { this.options.disabled = this.element[ 0 ].disabled || false; } this.hasTitle = !!this.element.attr( "title" ); // Check to see if the label needs to be set or if its already correct if ( this.options.label && this.options.label !== this.originalLabel ) { if ( this.isInput ) { this.element.val( this.options.label ); } else { this.element.html( this.options.label ); } } this._addClass( "ui-button", "ui-widget" ); this._setOption( "disabled", this.options.disabled ); this._enhance(); if ( this.element.is( "a" ) ) { this._on( { "keyup": function( event ) { if ( event.keyCode === $.ui.keyCode.SPACE ) { event.preventDefault(); // Support: PhantomJS <= 1.9, IE 8 Only // If a native click is available use it so we actually cause navigation // otherwise just trigger a click event if ( this.element[ 0 ].click ) { this.element[ 0 ].click(); } else { this.element.trigger( "click" ); } } } } ); } }, _enhance: function() { if ( !this.element.is( "button" ) ) { this.element.attr( "role", "button" ); } if ( this.options.icon ) { this._updateIcon( "icon", this.options.icon ); this._updateTooltip(); } }, _updateTooltip: function() { this.title = this.element.attr( "title" ); if ( !this.options.showLabel && !this.title ) { this.element.attr( "title", this.options.label ); } }, _updateIcon: function( option, value ) { var icon = option !== "iconPosition", position = icon ? this.options.iconPosition : value, displayBlock = position === "top" || position === "bottom"; // Create icon if ( !this.icon ) { this.icon = $( "<span>" ); this._addClass( this.icon, "ui-button-icon", "ui-icon" ); if ( !this.options.showLabel ) { this._addClass( "ui-button-icon-only" ); } } else if ( icon ) { // If we are updating the icon remove the old icon class this._removeClass( this.icon, null, this.options.icon ); } // If we are updating the icon add the new icon class if ( icon ) { this._addClass( this.icon, null, value ); } this._attachIcon( position ); // If the icon is on top or bottom we need to add the ui-widget-icon-block class and remove // the iconSpace if there is one. if ( displayBlock ) { this._addClass( this.icon, null, "ui-widget-icon-block" ); if ( this.iconSpace ) { this.iconSpace.remove(); } } else { // Position is beginning or end so remove the ui-widget-icon-block class and add the // space if it does not exist if ( !this.iconSpace ) { this.iconSpace = $( "<span> </span>" ); this._addClass( this.iconSpace, "ui-button-icon-space" ); } this._removeClass( this.icon, null, "ui-wiget-icon-block" ); this._attachIconSpace( position ); } }, _destroy: function() { this.element.removeAttr( "role" ); if ( this.icon ) { this.icon.remove(); } if ( this.iconSpace ) { this.iconSpace.remove(); } if ( !this.hasTitle ) { this.element.removeAttr( "title" ); } }, _attachIconSpace: function( iconPosition ) { this.icon[ /^(?:end|bottom)/.test( iconPosition ) ? "before" : "after" ]( this.iconSpace ); }, _attachIcon: function( iconPosition ) { this.element[ /^(?:end|bottom)/.test( iconPosition ) ? "append" : "prepend" ]( this.icon ); }, _setOptions: function( options ) { var newShowLabel = options.showLabel === undefined ? this.options.showLabel : options.showLabel, newIcon = options.icon === undefined ? this.options.icon : options.icon; if ( !newShowLabel && !newIcon ) { options.showLabel = true; } this._super( options ); }, _setOption: function( key, value ) { if ( key === "icon" ) { if ( value ) { this._updateIcon( key, value ); } else if ( this.icon ) { this.icon.remove(); if ( this.iconSpace ) { this.iconSpace.remove(); } } } if ( key === "iconPosition" ) { this._updateIcon( key, value ); } // Make sure we can't end up with a button that has neither text nor icon if ( key === "showLabel" ) { this._toggleClass( "ui-button-icon-only", null, !value ); this._updateTooltip(); } if ( key === "label" ) { if ( this.isInput ) { this.element.val( value ); } else { // If there is an icon, append it, else nothing then append the value // this avoids removal of the icon when setting label text this.element.html( value ); if ( this.icon ) { this._attachIcon( this.options.iconPosition ); this._attachIconSpace( this.options.iconPosition ); } } } this._super( key, value ); if ( key === "disabled" ) { this._toggleClass( null, "ui-state-disabled", value ); this.element[ 0 ].disabled = value; if ( value ) { this.element.trigger( "blur" ); } } }, refresh: function() { // Make sure to only check disabled if its an element that supports this otherwise // check for the disabled class to determine state var isDisabled = this.element.is( "input, button" ) ? this.element[ 0 ].disabled : this.element.hasClass( "ui-button-disabled" ); if ( isDisabled !== this.options.disabled ) { this._setOptions( { disabled: isDisabled } ); } this._updateTooltip(); } } ); // DEPRECATED if ( $.uiBackCompat !== false ) { // Text and Icons options $.widget( "ui.button", $.ui.button, { options: { text: true, icons: { primary: null, secondary: null } }, _create: function() { if ( this.options.showLabel && !this.options.text ) { this.options.showLabel = this.options.text; } if ( !this.options.showLabel && this.options.text ) { this.options.text = this.options.showLabel; } if ( !this.options.icon && ( this.options.icons.primary || this.options.icons.secondary ) ) { if ( this.options.icons.primary ) { this.options.icon = this.options.icons.primary; } else { this.options.icon = this.options.icons.secondary; this.options.iconPosition = "end"; } } else if ( this.options.icon ) { this.options.icons.primary = this.options.icon; } this._super(); }, _setOption: function( key, value ) { if ( key === "text" ) { this._super( "showLabel", value ); return; } if ( key === "showLabel" ) { this.options.text = value; } if ( key === "icon" ) { this.options.icons.primary = value; } if ( key === "icons" ) { if ( value.primary ) { this._super( "icon", value.primary ); this._super( "iconPosition", "beginning" ); } else if ( value.secondary ) { this._super( "icon", value.secondary ); this._super( "iconPosition", "end" ); } } this._superApply( arguments ); } } ); $.fn.button = ( function( orig ) { return function( options ) { var isMethodCall = typeof options === "string"; var args = Array.prototype.slice.call( arguments, 1 ); var returnValue = this; if ( isMethodCall ) { // If this is an empty collection, we need to have the instance method // return undefined instead of the jQuery instance if ( !this.length && options === "instance" ) { returnValue = undefined; } else { this.each( function() { var methodValue; var type = $( this ).attr( "type" ); var name = type !== "checkbox" && type !== "radio" ? "button" : "checkboxradio"; var instance = $.data( this, "ui-" + name ); if ( options === "instance" ) { returnValue = instance; return false; } if ( !instance ) { return $.error( "cannot call methods on button" + " prior to initialization; " + "attempted to call method '" + options + "'" ); } if ( typeof instance[ options ] !== "function" || options.charAt( 0 ) === "_" ) { return $.error( "no such method '" + options + "' for button" + " widget instance" ); } methodValue = instance[ options ].apply( instance, args ); if ( methodValue !== instance && methodValue !== undefined ) { returnValue = methodValue && methodValue.jquery ? returnValue.pushStack( methodValue.get() ) : methodValue; return false; } } ); } } else { // Allow multiple hashes to be passed on init if ( args.length ) { options = $.widget.extend.apply( null, [ options ].concat( args ) ); } this.each( function() { var type = $( this ).attr( "type" ); var name = type !== "checkbox" && type !== "radio" ? "button" : "checkboxradio"; var instance = $.data( this, "ui-" + name ); if ( instance ) { instance.option( options || {} ); if ( instance._init ) { instance._init(); } } else { if ( name === "button" ) { orig.call( $( this ), options ); return; } $( this ).checkboxradio( $.extend( { icon: false }, options ) ); } } ); } return returnValue; }; } )( $.fn.button ); $.fn.buttonset = function() { if ( !$.ui.controlgroup ) { $.error( "Controlgroup widget missing" ); } if ( arguments[ 0 ] === "option" && arguments[ 1 ] === "items" && arguments[ 2 ] ) { return this.controlgroup.apply( this, [ arguments[ 0 ], "items.button", arguments[ 2 ] ] ); } if ( arguments[ 0 ] === "option" && arguments[ 1 ] === "items" ) { return this.controlgroup.apply( this, [ arguments[ 0 ], "items.button" ] ); } if ( typeof arguments[ 0 ] === "object" && arguments[ 0 ].items ) { arguments[ 0 ].items = { button: arguments[ 0 ].items }; } return this.controlgroup.apply( this, arguments ); }; } return $.ui.button; } );
Save File
Cancel