/*global wp, Backbone, _, jQuery, WidgetCustomizer_exports */ /*exported WidgetCustomizer */ var WidgetCustomizer = ( function ($) { 'use strict'; var Widget, WidgetCollection, Sidebar, SidebarCollection, OldPreviewer, customize = wp.customize, self = { update_widget_ajax_action: null, update_widget_nonce_value: null, update_widget_nonce_post_key: null, i18n: { save_btn_label: '', save_btn_tooltip: '', remove_btn_label: '', remove_btn_tooltip: '' }, available_widgets: [], // available widgets for instantiating registered_widgets: [], // all widgets registered active_sidebar_control: null, previewer: null, saved_widget_ids: {}, registered_sidebars: [], tpl: { move_widget_area: '', widget_reorder_nav: '' } }; $.extend( self, WidgetCustomizer_exports ); // Lots of widgets expect this old ajaxurl global to be available if ( typeof window.ajaxurl === 'undefined' ) { window.ajaxurl = wp.ajax.settings.url; } // Unfortunately many widgets try to look for instances under div#widgets-right, // so we have to add that ID to a container div in the customizer for compat $( '#customize-theme-controls' ).closest( 'div:not([id])' ).attr( 'id', 'widgets-right' ); /** * Set up model */ Widget = self.Widget = Backbone.Model.extend( { id: null, temp_id: null, classname: null, control_tpl: null, description: null, is_disabled: null, is_multi: null, multi_number: null, name: null, id_base: null, transport: 'refresh', params: [], width: null, height: null } ); WidgetCollection = self.WidgetCollection = Backbone.Collection.extend( { model: Widget } ); self.available_widgets = new WidgetCollection( self.available_widgets ); Sidebar = self.Sidebar = Backbone.Model.extend( { after_title: null, after_widget: null, before_title: null, before_widget: null, 'class': null, description: null, id: null, name: null, is_rendered: false } ); SidebarCollection = self.SidebarCollection = Backbone.Collection.extend( { model: Sidebar } ); self.registered_sidebars = new SidebarCollection( self.registered_sidebars ); /** * On DOM ready, initialize some meta functionality independent of specific * customizer controls. */ self.init = function () { this.showFirstSidebarIfRequested(); this.availableWidgetsPanel.setup(); }; wp.customize.bind( 'ready', function () { self.init(); } ); /** * Listen for updates to which sidebars are rendered in the preview and toggle * the customizer sections accordingly. */ self.showFirstSidebarIfRequested = function () { if ( ! /widget-customizer=open/.test( location.search ) ) { return; } var show_first_visible_sidebar = function () { self.registered_sidebars.off( 'change:is_rendered', show_first_visible_sidebar ); var section, first_rendered_sidebar = self.registered_sidebars.find( function ( sidebar ) { return sidebar.get( 'is_rendered' ); } ); if ( ! first_rendered_sidebar ) { return; } section = $( '#accordion-section-sidebar-widgets-' + first_rendered_sidebar.get( 'id' ) ); if ( ! section.hasClass( 'open' ) ) { section.find( '.accordion-section-title' ).trigger( 'click' ); } section[0].scrollIntoView(); }; show_first_visible_sidebar = _.debounce( show_first_visible_sidebar, 100 ); // so only fires when all updated at end self.registered_sidebars.on( 'change:is_rendered', show_first_visible_sidebar ); }; /** * Sidebar Widgets control * Note that 'sidebar_widgets' must match the Sidebar_Widgets_WP_Customize_Control::$type */ customize.controlConstructor.sidebar_widgets = customize.Control.extend( { /** * Set up the control */ ready: function() { var control = this; control.control_section = control.container.closest( '.control-section' ); control.section_content = control.container.closest( '.accordion-section-content' ); control._setupModel(); control._setupSortable(); control._setupAddition(); control._applyCardinalOrderClassNames(); }, /** * Update ordering of widget control forms when the setting is updated */ _setupModel: function() { var control = this, registered_sidebar = self.registered_sidebars.get( control.params.sidebar_id ); control.setting.bind( function( new_widget_ids, old_widget_ids ) { var widget_form_controls, sidebar_widgets_add_control, final_control_containers, removed_widget_ids = _( old_widget_ids ).difference( new_widget_ids ); // Filter out any persistent widget_ids for widgets which have been deactivated new_widget_ids = _( new_widget_ids ).filter( function ( new_widget_id ) { var parsed_widget_id = parse_widget_id( new_widget_id ); return !! self.available_widgets.findWhere( { id_base: parsed_widget_id.id_base } ); } ); widget_form_controls = _( new_widget_ids ).map( function ( widget_id ) { var widget_form_control = self.getWidgetFormControlForWidget( widget_id ); if ( ! widget_form_control ) { widget_form_control = control.addWidget( widget_id ); } return widget_form_control; } ); // Sort widget controls to their new positions widget_form_controls.sort( function ( a, b ) { var a_index = new_widget_ids.indexOf( a.params.widget_id ), b_index = new_widget_ids.indexOf( b.params.widget_id ); if ( a_index === b_index ) { return 0; } return a_index < b_index ? -1 : 1; } ); sidebar_widgets_add_control = control.section_content.find( '.customize-control-sidebar_widgets' ); // Append the controls to put them in the right order final_control_containers = _( widget_form_controls ).map( function( widget_form_controls ) { return widget_form_controls.container[0]; } ); // Re-sort widget form controls (including widgets form other sidebars newly moved here) sidebar_widgets_add_control.before( final_control_containers ); control._applyCardinalOrderClassNames(); // If the widget was dragged into the sidebar, make sure the sidebar_id param is updated _( widget_form_controls ).each( function ( widget_form_control ) { widget_form_control.params.sidebar_id = control.params.sidebar_id; } ); // Cleanup after widget removal _( removed_widget_ids ).each( function ( removed_widget_id ) { // Using setTimeout so that when moving a widget to another sidebar, the other sidebars_widgets settings get a chance to update setTimeout( function () { var is_present_in_another_sidebar = false, removed_control, was_dragged_to_another_sidebar, inactive_widgets, removed_id_base, widget; // Check if the widget is in another sidebar wp.customize.each( function ( other_setting ) { if ( other_setting.id === control.setting.id || 0 !== other_setting.id.indexOf( 'sidebars_widgets[' ) || other_setting.id === 'sidebars_widgets[wp_inactive_widgets]' ) { return; } var other_sidebar_widgets = other_setting(), i; i = other_sidebar_widgets.indexOf( removed_widget_id ); if ( -1 !== i ) { is_present_in_another_sidebar = true; } } ); // If the widget is present in another sidebar, abort! if ( is_present_in_another_sidebar ) { return; } removed_control = self.getWidgetFormControlForWidget( removed_widget_id ); // Detect if widget control was dragged to another sidebar was_dragged_to_another_sidebar = ( removed_control && $.contains( document, removed_control.container[0] ) && ! $.contains( control.section_content[0], removed_control.container[0] ) ); // Delete any widget form controls for removed widgets if ( removed_control && ! was_dragged_to_another_sidebar ) { wp.customize.control.remove( removed_control.id ); removed_control.container.remove(); } // Move widget to inactive widgets sidebar (move it to trash) if has been previously saved // This prevents the inactive widgets sidebar from overflowing with throwaway widgets if ( self.saved_widget_ids[removed_widget_id] ) { inactive_widgets = wp.customize.value( 'sidebars_widgets[wp_inactive_widgets]' )().slice(); inactive_widgets.push( removed_widget_id ); wp.customize.value( 'sidebars_widgets[wp_inactive_widgets]' )( _( inactive_widgets ).unique() ); } // Make old single widget available for adding again removed_id_base = parse_widget_id( removed_widget_id ).id_base; widget = self.available_widgets.findWhere( { id_base: removed_id_base } ); if ( widget && ! widget.get( 'is_multi' ) ) { widget.set( 'is_disabled', false ); } } ); } ); } ); // Update the model with whether or not the sidebar is rendered self.previewer.bind( 'rendered-sidebars', function ( rendered_sidebars ) { var is_rendered = !! rendered_sidebars[control.params.sidebar_id]; registered_sidebar.set( 'is_rendered', is_rendered ); } ); // Show the sidebar section when it becomes visible registered_sidebar.on( 'change:is_rendered', function ( ) { var section_selector = '#accordion-section-sidebar-widgets-' + this.get( 'id' ), section; section = $( section_selector ); if ( this.get( 'is_rendered' ) ) { section.stop().slideDown( function () { $( this ).css( 'height', 'auto' ); // so that the .accordion-section-content won't overflow } ); } else { // Make sure that hidden sections get closed first if ( section.hasClass( 'open' ) ) { // it would be nice if accordionSwitch() in accordion.js was public section.find( '.accordion-section-title' ).trigger( 'click' ); } section.stop().slideUp(); } } ); }, /** * Allow widgets in sidebar to be re-ordered, and for the order to be previewed */ _setupSortable: function () { var control = this; control.is_reordering = false; /** * Update widget order setting when controls are re-ordered */ control.section_content.sortable( { items: '> .customize-control-widget_form', handle: '.widget-top', axis: 'y', connectWith: '.accordion-section-content:has(.customize-control-sidebar_widgets)', update: function () { var widget_container_ids = control.section_content.sortable( 'toArray' ), widget_ids; widget_ids = $.map( widget_container_ids, function ( widget_container_id ) { return $( '#' + widget_container_id ).find( ':input[name=widget-id]' ).val(); } ); control.setting( widget_ids ); } } ); /** * Expand other customizer sidebar section when dragging a control widget over it, * allowing the control to be dropped into another section */ control.control_section.find( '.accordion-section-title' ).droppable( { accept: '.customize-control-widget_form', over: function () { if ( ! control.control_section.hasClass( 'open' ) ) { control.control_section.addClass( 'open' ); control.section_content.toggle( false ).slideToggle( 150, function () { control.section_content.sortable( 'refreshPositions' ); } ); } } } ); /** * Keyboard-accessible reordering */ control.container.find( '.reorder-toggle' ).on( 'click keydown', function( event ) { if ( event.type === 'keydown' && ! ( event.which === 13 || event.which === 32 ) ) { // Enter or Spacebar return; } control.toggleReordering( ! control.is_reordering ); } ); }, /** * Set up UI for adding a new widget */ _setupAddition: function () { var control = this; control.container.find( '.add-new-widget' ).on( 'click keydown', function( event ) { if ( event.type === 'keydown' && ! ( event.which === 13 || event.which === 32 ) ) { // Enter or Spacebar return; } if ( control.section_content.hasClass( 'reordering' ) ) { return; } // @todo Use an control.is_adding state if ( ! $( 'body' ).hasClass( 'adding-widget' ) ) { self.availableWidgetsPanel.open( control ); } else { self.availableWidgetsPanel.close(); } } ); }, /** * Add classes to the widget_form controls to assist with styling */ _applyCardinalOrderClassNames: function () { var control = this; control.section_content.find( '.customize-control-widget_form' ) .removeClass( 'first-widget' ) .removeClass( 'last-widget' ) .find( '.move-widget-down, .move-widget-up' ).prop( 'tabIndex', 0 ); control.section_content.find( '.customize-control-widget_form:first' ) .addClass( 'first-widget' ) .find( '.move-widget-up' ).prop( 'tabIndex', -1 ); control.section_content.find( '.customize-control-widget_form:last' ) .addClass( 'last-widget' ) .find( '.move-widget-down' ).prop( 'tabIndex', -1 ); }, /*********************************************************************** * Begin public API methods **********************************************************************/ /** * Enable/disable the reordering UI * * @param {Boolean} toggle to enable/disable reordering */ toggleReordering: function ( toggle ) { var control = this; toggle = Boolean( toggle ); if ( toggle === control.section_content.hasClass( 'reordering' ) ) { return; } control.is_reordering = toggle; control.section_content.toggleClass( 'reordering', toggle ); if ( toggle ) { _( control.getWidgetFormControls() ).each( function ( form_control ) { form_control.collapseForm(); } ); } }, /** * @return {wp.customize.controlConstructor.widget_form[]} */ getWidgetFormControls: function () { var control = this, form_controls; form_controls = _( control.setting() ).map( function ( widget_id ) { var setting_id = widget_id_to_setting_id( widget_id ), form_control = customize.control( setting_id ); if ( ! form_control ) { throw new Error( 'Unable to find widget_form control for ' + widget_id ); } return form_control; } ); return form_controls; }, /** * @param {string} widget_id or an id_base for adding a previously non-existing widget * @returns {object} widget_form control instance */ addWidget: function ( widget_id ) { var control = this, control_html, customize_control_type = 'widget_form', customize_control, parsed_widget_id = parse_widget_id( widget_id ), widget_number = parsed_widget_id.number, widget_id_base = parsed_widget_id.id_base, widget = self.available_widgets.findWhere( {id_base: widget_id_base} ), setting_id, is_existing_widget, Constructor, widget_form_control, sidebar_widgets, setting_args; if ( ! widget ) { throw new Error( 'Widget unexpectedly not found.' ); } if ( widget_number && ! widget.get( 'is_multi' ) ) { throw new Error( 'Did not expect a widget number to be supplied for a non-multi widget' ); } // Set up new multi widget if ( widget.get( 'is_multi' ) && ! widget_number ) { widget.set( 'multi_number', widget.get( 'multi_number' ) + 1 ); widget_number = widget.get( 'multi_number' ); } control_html = $( '#widget-tpl-' + widget.get( 'id' ) ).html(); if ( widget.get( 'is_multi' ) ) { control_html = control_html.replace( /<[^<>]+>/g, function ( m ) { return m.replace( /__i__|%i%/g, widget_number ); } ); } else { widget.set( 'is_disabled', true ); // Prevent single widget from being added again now } customize_control = $( '
  • ' ); customize_control.addClass( 'customize-control' ); customize_control.addClass( 'customize-control-' + customize_control_type ); customize_control.append( $( control_html ) ); customize_control.find( '> .widget-icon' ).remove(); if ( widget.get( 'is_multi' ) ) { customize_control.find( 'input[name="widget_number"]' ).val( widget_number ); customize_control.find( 'input[name="multi_number"]' ).val( widget_number ); } widget_id = customize_control.find( '[name="widget-id"]' ).val(); customize_control.hide(); // to be slid-down below setting_id = 'widget_' + widget.get( 'id_base' ); if ( widget.get( 'is_multi' ) ) { setting_id += '[' + widget_number + ']'; } customize_control.attr( 'id', 'customize-control-' + setting_id.replace( /\]/g, '' ).replace( /\[/g, '-' ) ); control.container.after( customize_control ); // Only create setting if it doesn't already exist (if we're adding a pre-existing inactive widget) is_existing_widget = wp.customize.has( setting_id ); if ( ! is_existing_widget ) { setting_args = { transport: 'refresh', previewer: control.setting.previewer }; wp.customize.create( setting_id, setting_id, {}, setting_args ); } Constructor = wp.customize.controlConstructor[customize_control_type]; widget_form_control = new Constructor( setting_id, { params: { settings: { 'default': setting_id }, sidebar_id: control.params.sidebar_id, widget_id: widget_id, widget_id_base: widget.get( 'id_base' ), type: customize_control_type, is_new: ! is_existing_widget, width: widget.get( 'width' ), height: widget.get( 'height' ), is_wide: widget.get( 'is_wide' ) }, previewer: control.setting.previewer } ); wp.customize.control.add( setting_id, widget_form_control ); // Make sure widget is removed from the other sidebars wp.customize.each( function ( other_setting ) { if ( other_setting.id === control.setting.id ) { return; } if ( 0 !== other_setting.id.indexOf( 'sidebars_widgets[' ) ) { return; } var other_sidebar_widgets = other_setting().slice(), i; i = other_sidebar_widgets.indexOf( widget_id ); if ( -1 !== i ) { other_sidebar_widgets.splice( i ); other_setting( other_sidebar_widgets ); } } ); // Add widget to this sidebar sidebar_widgets = control.setting().slice(); if ( -1 === sidebar_widgets.indexOf( widget_id ) ) { sidebar_widgets.push( widget_id ); control.setting( sidebar_widgets ); } customize_control.slideDown( function () { if ( is_existing_widget ) { widget_form_control.expandForm(); widget_form_control.updateWidget( { instance: widget_form_control.setting(), complete: function ( error ) { if ( error ) { throw error; } widget_form_control.focus(); } } ); } else { widget_form_control.focus(); } } ); return widget_form_control; } } ); /** * Widget Form control * Note that 'widget_form' must match the Widget_Form_WP_Customize_Control::$type */ customize.controlConstructor.widget_form = customize.Control.extend( { /** * Set up the control */ ready: function() { var control = this; control._setupModel(); control._setupWideWidget(); control._setupControlToggle(); control._setupWidgetTitle(); control._setupReorderUI(); control._setupHighlightEffects(); control._setupUpdateUI(); control._setupRemoveUI(); control.hook( 'init' ); }, /** * Hooks for widgets to support living in the customizer control */ hooks: { _default: {}, rss: { formUpdated: function ( serialized_form ) { var control = this, old_widget_error = control.container.find( '.widget-error:first' ), new_widget_error = serialized_form.find( '.widget-error:first' ); if ( old_widget_error.length && new_widget_error.length ) { old_widget_error.replaceWith( new_widget_error ); } else if ( old_widget_error.length ) { old_widget_error.remove(); } else if ( new_widget_error.length ) { control.container.find( '.widget-content' ).prepend( new_widget_error ); } } } }, /** * Trigger an 'action' which a specific widget type can handle * * @param name */ hook: function ( name ) { var args = Array.prototype.slice.call( arguments, 1 ), handler; if ( this.hooks[this.params.widget_id_base] && this.hooks[this.params.widget_id_base][name] ) { handler = this.hooks[this.params.widget_id_base][name]; } else if ( this.hooks._default[name] ) { handler = this.hooks._default[name]; } if ( handler ) { handler.apply( this, args ); } }, /** * Handle changes to the setting */ _setupModel: function () { var control = this, remember_saved_widget_id; // Remember saved widgets so we know which to trash (move to inactive widgets sidebar) remember_saved_widget_id = function () { self.saved_widget_ids[control.params.widget_id] = true; }; wp.customize.bind( 'ready', remember_saved_widget_id ); wp.customize.bind( 'saved', remember_saved_widget_id ); control._update_count = 0; control.is_widget_updating = false; // Update widget whenever model changes control.setting.bind( function( to, from ) { if ( ! _( from ).isEqual( to ) && ! control.is_widget_updating ) { control.updateWidget( { instance: to } ); } } ); }, /** * Add special behaviors for wide widget controls */ _setupWideWidget: function () { var control = this, widget_inside, customize_sidebar, position_widget, theme_controls_container; if ( ! control.params.is_wide ) { return; } widget_inside = control.container.find( '.widget-inside' ); customize_sidebar = $( '.wp-full-overlay-sidebar-content:first' ); control.container.addClass( 'wide-widget-control' ); control.container.find( '.widget-content:first' ).css( { 'min-width': control.params.width, 'min-height': control.params.height } ); /** * Keep the widget-inside positioned so the top of fixed-positioned * element is at the same top position as the widget-top. When the * widget-top is scrolled out of view, keep the widget-top in view; * likewise, don't allow the widget to drop off the bottom of the window. */ position_widget = function () { var offset_top = control.container.offset().top, height, top, max_top; height = widget_inside.outerHeight(); top = Math.max( offset_top, 0 ); max_top = $( window ).height() - height; top = Math.min( top, max_top ); widget_inside.css( 'top', top ); }; theme_controls_container = $( '#customize-theme-controls' ); control.container.on( 'expand', function () { customize_sidebar.on( 'scroll', position_widget ); $( window ).on( 'resize', position_widget ); theme_controls_container.on( 'expanded collapsed', position_widget ); position_widget(); } ); control.container.on( 'collapsed', function () { customize_sidebar.off( 'scroll', position_widget ); theme_controls_container.off( 'expanded collapsed', position_widget ); $( window ).off( 'resize', position_widget ); } ); // Reposition whenever a sidebar's widgets are changed wp.customize.each( function ( setting ) { if ( 0 === setting.id.indexOf( 'sidebars_widgets[' ) ) { setting.bind( function () { if ( control.container.hasClass( 'expanded' ) ) { position_widget(); } } ); } } ); }, /** * Show/hide the control when clicking on the form title, when clicking * the close button */ _setupControlToggle: function() { var control = this, close_btn; control.container.find( '.widget-top' ).on( 'click', function ( e ) { e.preventDefault(); var sidebar_widgets_control = control.getSidebarWidgetsControl(); if ( sidebar_widgets_control.is_reordering ) { return; } control.toggleForm(); } ); close_btn = control.container.find( '.widget-control-close' ); // @todo Hitting Enter on this link does nothing; will be resolved in core with close_btn.on( 'click', function ( e ) { e.preventDefault(); control.collapseForm(); control.container.find( '.widget-top .widget-action:first' ).focus(); // keyboard accessibility } ); }, /** * Update the title of the form if a title field is entered */ _setupWidgetTitle: function () { var control = this, update_title; update_title = function () { var title = control.setting().title, in_widget_title = control.container.find( '.in-widget-title' ); if ( title ) { in_widget_title.text( ': ' + title ); } else { in_widget_title.text( '' ); } }; control.setting.bind( update_title ); update_title(); }, /** * Set up the widget-reorder-nav */ _setupReorderUI: function () { var control = this, select_sidebar_item, move_widget_area, reorder_nav, update_available_sidebars; /** * select the provided sidebar list item in the move widget area * * @param {jQuery} li */ select_sidebar_item = function ( li ) { li.siblings( '.selected' ).removeClass( 'selected' ); li.addClass( 'selected' ); var is_self_sidebar = ( li.data( 'id' ) === control.params.sidebar_id ); control.container.find( '.move-widget-btn' ).prop( 'disabled', is_self_sidebar ); }; /** * Add the widget reordering elements to the widget control */ control.container.find( '.widget-title-action' ).after( $( self.tpl.widget_reorder_nav ) ); move_widget_area = $( _.template( self.tpl.move_widget_area, { sidebars: _( self.registered_sidebars.toArray() ).pluck( 'attributes' ) } ) ); control.container.find( '.widget-top' ).after( move_widget_area ); /** * Update available sidebars when their rendered state changes */ update_available_sidebars = function () { var sidebar_items = move_widget_area.find( 'li' ), self_sidebar_item; self_sidebar_item = sidebar_items.filter( function(){ return $( this ).data( 'id' ) === control.params.sidebar_id; } ); sidebar_items.each( function () { var li = $( this ), sidebar_id, sidebar_model; sidebar_id = li.data( 'id' ); sidebar_model = self.registered_sidebars.get( sidebar_id ); li.toggle( sidebar_model.get( 'is_rendered' ) ); if ( li.hasClass( 'selected' ) && ! sidebar_model.get( 'is_rendered' ) ) { select_sidebar_item( self_sidebar_item ); } } ); }; update_available_sidebars(); self.registered_sidebars.on( 'change:is_rendered', update_available_sidebars ); /** * Handle clicks for up/down/move on the reorder nav */ reorder_nav = control.container.find( '.widget-reorder-nav' ); reorder_nav.find( '.move-widget, .move-widget-down, .move-widget-up' ).on( 'click keypress', function ( event ) { if ( event.type === 'keypress' && ( event.which !== 13 && event.which !== 32 ) ) { return; } $( this ).focus(); if ( $( this ).is( '.move-widget' ) ) { control.toggleWidgetMoveArea(); } else { var is_move_down = $( this ).is( '.move-widget-down' ), is_move_up = $( this ).is( '.move-widget-up' ), i = control.getWidgetSidebarPosition(); if ( ( is_move_up && i === 0 ) || ( is_move_down && i === control.getSidebarWidgetsControl().setting().length - 1 ) ) { return; } if ( is_move_up ) { control.moveUp(); } else { control.moveDown(); } $( this ).focus(); // re-focus after the container was moved } } ); /** * Handle selecting a sidebar to move to */ control.container.find( '.widget-area-select' ).on( 'click keypress', 'li', function ( e ) { if ( event.type === 'keypress' && ( event.which !== 13 && event.which !== 32 ) ) { return; } e.preventDefault(); select_sidebar_item( $( this ) ); } ); /** * Move widget to another sidebar */ control.container.find( '.move-widget-btn' ).click( function () { control.getSidebarWidgetsControl().toggleReordering( false ); var old_sidebar_id = control.params.sidebar_id, new_sidebar_id = control.container.find( '.widget-area-select li.selected' ).data( 'id' ), old_sidebar_widgets_setting, new_sidebar_widgets_setting, old_sidebar_widget_ids, new_sidebar_widget_ids, i; old_sidebar_widgets_setting = customize( 'sidebars_widgets[' + old_sidebar_id + ']' ); new_sidebar_widgets_setting = customize( 'sidebars_widgets[' + new_sidebar_id + ']' ); old_sidebar_widget_ids = Array.prototype.slice.call( old_sidebar_widgets_setting() ); new_sidebar_widget_ids = Array.prototype.slice.call( new_sidebar_widgets_setting() ); i = control.getWidgetSidebarPosition(); old_sidebar_widget_ids.splice( i, 1 ); new_sidebar_widget_ids.push( control.params.widget_id ); old_sidebar_widgets_setting( old_sidebar_widget_ids ); new_sidebar_widgets_setting( new_sidebar_widget_ids ); control.focus(); } ); }, /** * Highlight widgets in preview when interacted with in the customizer */ _setupHighlightEffects: function() { var control = this; // Highlight whenever hovering or clicking over the form control.container.on( 'mouseenter click', function () { control.highlightPreviewWidget(); } ); // Highlight when the setting is updated control.setting.bind( function () { control.scrollPreviewWidgetIntoView(); control.highlightPreviewWidget(); } ); // Highlight when the widget form is expanded control.container.on( 'expand', function () { control.scrollPreviewWidgetIntoView(); } ); }, /** * Set up event handlers for widget updating */ _setupUpdateUI: function () { var control = this, widget_content, save_btn, update_widget_debounced; widget_content = control.container.find( '.widget-content' ); // Configure update button save_btn = control.container.find( '.widget-control-save' ); save_btn.val( self.i18n.save_btn_label ); save_btn.attr( 'title', self.i18n.save_btn_tooltip ); save_btn.removeClass( 'button-primary' ).addClass( 'button-secondary' ); save_btn.on( 'click', function ( e ) { e.preventDefault(); control.updateWidget(); } ); update_widget_debounced = _.debounce( function () { // @todo For compatibility with other plugins, should we trigger a click event? What about form submit event? control.updateWidget(); }, 250 ); // Trigger widget form update when hitting Enter within an input control.container.find( '.widget-content' ).on( 'keydown', 'input', function( e ) { if ( 13 === e.which ) { // Enter e.preventDefault(); control.updateWidget( { ignore_active_element: true } ); } } ); // Handle widgets that support live previews widget_content.on( 'change input propertychange', ':input', function ( e ) { if ( e.type === 'change' ) { control.updateWidget(); } else if ( this.checkValidity && this.checkValidity() ) { update_widget_debounced(); } } ); // Remove loading indicators when the setting is saved and the preview updates control.setting.previewer.channel.bind( 'synced', function () { control.container.removeClass( 'previewer-loading' ); } ); self.previewer.bind( 'widget-updated', function ( updated_widget_id ) { if ( updated_widget_id === control.params.widget_id ) { control.container.removeClass( 'previewer-loading' ); } } ); // Update widget control to indicate whether it is currently rendered (cf. Widget Visibility) self.previewer.bind( 'rendered-widgets', function ( rendered_widgets ) { var is_rendered = !! rendered_widgets[control.params.widget_id]; control.container.toggleClass( 'widget-rendered', is_rendered ); } ); }, /** * Set up event handlers for widget removal */ _setupRemoveUI: function () { var control = this, remove_btn, replace_delete_with_remove; // Configure remove button remove_btn = control.container.find( 'a.widget-control-remove' ); // @todo Hitting Enter on this link does nothing; will be resolved in core with remove_btn.on( 'click', function ( e ) { e.preventDefault(); // Find an adjacent element to add focus to when this widget goes away var adjacent_focus_target; if ( control.container.next().is( '.customize-control-widget_form' ) ) { adjacent_focus_target = control.container.next().find( '.widget-action:first' ); } else if ( control.container.prev().is( '.customize-control-widget_form' ) ) { adjacent_focus_target = control.container.prev().find( '.widget-action:first' ); } else { adjacent_focus_target = control.container.next( '.customize-control-sidebar_widgets' ).find( '.add-new-widget:first' ); } control.container.slideUp( function() { var sidebars_widgets_control = self.getSidebarWidgetControlContainingWidget( control.params.widget_id ), sidebar_widget_ids, i; if ( ! sidebars_widgets_control ) { throw new Error( 'Unable to find sidebars_widgets_control' ); } sidebar_widget_ids = sidebars_widgets_control.setting().slice(); i = sidebar_widget_ids.indexOf( control.params.widget_id ); if ( -1 === i ) { throw new Error( 'Widget is not in sidebar' ); } sidebar_widget_ids.splice( i, 1 ); sidebars_widgets_control.setting( sidebar_widget_ids ); adjacent_focus_target.focus(); // keyboard accessibility } ); } ); replace_delete_with_remove = function () { remove_btn.text( self.i18n.remove_btn_label ); // wp_widget_control() outputs the link as "Delete" remove_btn.attr( 'title', self.i18n.remove_btn_tooltip ); }; if ( control.params.is_new ) { wp.customize.bind( 'saved', replace_delete_with_remove ); } else { replace_delete_with_remove(); } }, /** * Iterate over supplied inputs and create a signature string for all of them together. * This string can be used to compare whether or not the form has all of the same fields. * * @param {jQuery} inputs * @returns {string} * @private */ _getInputsSignature: function ( inputs ) { var inputs_signatures = _( inputs ).map( function ( input ) { input = $( input ); var signature_parts; if ( input.is( 'option' ) ) { signature_parts = [ input.prop( 'nodeName' ), input.prop( 'value' ) ]; } else if ( input.is( ':checkbox, :radio' ) ) { signature_parts = [ input.prop( 'type' ), input.attr( 'id' ), input.attr( 'name' ), input.prop( 'value' ) ]; } else { signature_parts = [ input.prop( 'nodeName' ), input.attr( 'id' ), input.attr( 'name' ), input.attr( 'type' ) ]; } return signature_parts.join( ',' ); } ); return inputs_signatures.join( ';' ); }, /** * Get the property that represents the state of an input. * * @param {jQuery|DOMElement} input * @returns {string} * @private */ _getInputStatePropertyName: function ( input ) { input = $( input ); if ( input.is( ':radio, :checkbox' ) ) { return 'checked'; } else if ( input.is( 'option' ) ) { return 'selected'; } else { return 'value'; } }, /*********************************************************************** * Begin public API methods **********************************************************************/ /** * @return {wp.customize.controlConstructor.sidebar_widgets[]} */ getSidebarWidgetsControl: function () { var control = this, setting_id, sidebar_widgets_control; setting_id = 'sidebars_widgets[' + control.params.sidebar_id + ']'; sidebar_widgets_control = customize.control( setting_id ); if ( ! sidebar_widgets_control ) { throw new Error( 'Unable to locate sidebar_widgets control for ' + control.params.sidebar_id ); } return sidebar_widgets_control; }, /** * Submit the widget form via Ajax and get back the updated instance, * along with the new widget control form to render. * * @param {object} [args] * @param {Object|null} [args.instance=null] When the model changes, the instance is sent here; otherwise, the inputs from the form are used * @param {Function|null} [args.complete=null] Function which is called when the request finishes. Context is bound to the control. First argument is any error. Following arguments are for success. * @param {Boolean} [args.ignore_active_element=false] Whether or not updating a field will be deferred if focus is still on the element. */ updateWidget: function ( args ) { var control = this, instance_override, complete_callback, update_number, widget_content, element_id_to_refocus = null, active_input_selection_start = null, active_input_selection_end = null, params, data, inputs, processing, jqxhr; args = $.extend( { instance: null, complete: null, ignore_active_element: false }, args ); instance_override = args.instance; complete_callback = args.complete; control._update_count += 1; update_number = control._update_count; widget_content = control.container.find( '.widget-content' ); // @todo Support more selectors than IDs? if ( $.contains( control.container[0], document.activeElement ) && $( document.activeElement ).is( '[id]' ) ) { element_id_to_refocus = $( document.activeElement ).prop( 'id' ); // @todo IE8 support: http://stackoverflow.com/a/4207763/93579 try { active_input_selection_start = document.activeElement.selectionStart; active_input_selection_end = document.activeElement.selectionEnd; } catch( e ) {} // catch InvalidStateError in case of checkboxes } control.container.addClass( 'widget-form-loading' ); control.container.addClass( 'previewer-loading' ); processing = wp.customize.state( 'processing' ); processing( processing() + 1 ); params = {}; params.action = self.update_widget_ajax_action; params.wp_customize = 'on'; params[self.update_widget_nonce_post_key] = self.update_widget_nonce_value; data = $.param( params ); inputs = widget_content.find( ':input, option' ); // Store the value we're submitting in data so that when the response comes back, // we know if it got sanitized; if there is no difference in the sanitized value, // then we do not need to touch the UI and mess up the user's ongoing editing. inputs.each( function () { var input = $( this ), property = control._getInputStatePropertyName( this ); input.data( 'state' + update_number, input.prop( property ) ); } ); if ( instance_override ) { data += '&' + $.param( { 'sanitized_widget_setting': JSON.stringify( instance_override ) } ); } else { data += '&' + inputs.serialize(); } data += '&' + widget_content.find( '~ :input' ).serialize(); jqxhr = $.post( wp.ajax.settings.url, data, function ( r ) { var message, sanitized_form, sanitized_inputs, has_same_inputs_in_response, is_instance_identical; if ( r.success ) { sanitized_form = $( '
    ' + r.data.form + '
    ' ); control.hook( 'formUpdate', sanitized_form ); sanitized_inputs = sanitized_form.find( ':input, option' ); has_same_inputs_in_response = control._getInputsSignature( inputs ) === control._getInputsSignature( sanitized_inputs ); if ( has_same_inputs_in_response ) { inputs.each( function ( i ) { var input = $( this ), sanitized_input = $( sanitized_inputs[i] ), property = control._getInputStatePropertyName( this ), state, sanitized_state; state = input.data( 'state' + update_number ); sanitized_state = sanitized_input.prop( property ); input.data( 'sanitized', sanitized_state ); if ( state !== sanitized_state ) { // Only update now if not currently focused on it, // so that we don't cause the cursor // it will be updated upon the change event if ( args.ignore_active_element || ! input.is( document.activeElement ) ) { input.prop( property, sanitized_state ); } control.hook( 'unsanitaryField', input, sanitized_state, state ); } else { control.hook( 'sanitaryField', input, state ); } } ); control.hook( 'formUpdated', sanitized_form ); } else { widget_content.html( sanitized_form.html() ); if ( element_id_to_refocus ) { // not using jQuery selector so we don't have to worry about escaping IDs with brackets and other characters $( document.getElementById( element_id_to_refocus ) ) .prop( { selectionStart: active_input_selection_start, selectionEnd: active_input_selection_end } ) .focus(); } control.hook( 'formRefreshed' ); } /** * If the old instance is identical to the new one, there is nothing new * needing to be rendered, and so we can preempt the event for the * preview finishing loading. */ is_instance_identical = _( control.setting() ).isEqual( r.data.instance ); if ( is_instance_identical ) { control.container.removeClass( 'previewer-loading' ); } else { control.is_widget_updating = true; // suppress triggering another updateWidget control.setting( r.data.instance ); control.is_widget_updating = false; } if ( complete_callback ) { complete_callback.call( control, null, { no_change: is_instance_identical, ajax_finished: true } ); } } else { window.console && window.console.log( r ); message = 'FAIL'; if ( r.data && r.data.message ) { message = r.data.message; } if ( complete_callback ) { complete_callback.call( control, message ); } else { throw new Error( message ); } } } ); jqxhr.fail( function ( jqXHR, textStatus ) { if ( complete_callback ) { complete_callback.call( control, textStatus ); } else { throw new Error( textStatus ); } } ); jqxhr.always( function () { control.container.removeClass( 'widget-form-loading' ); inputs.each( function () { $( this ).removeData( 'state' + update_number ); } ); processing( processing() - 1 ); } ); }, /** * Expand the accordion section containing a control * @todo it would be nice if accordion had a proper API instead of having to trigger UI events on its elements */ expandControlSection: function () { var section = this.container.closest( '.accordion-section' ); if ( ! section.hasClass( 'open' ) ) { section.find( '.accordion-section-title:first' ).trigger( 'click' ); } }, /** * Expand the widget form control */ expandForm: function () { this.toggleForm( true ); }, /** * Collapse the widget form control */ collapseForm: function () { this.toggleForm( false ); }, /** * Expand or collapse the widget control * * @param {boolean|undefined} [do_expand] If not supplied, will be inverse of current visibility */ toggleForm: function ( do_expand ) { var control = this, widget, inside, complete; widget = control.container.find( 'div.widget:first' ); inside = widget.find( '.widget-inside:first' ); if ( typeof do_expand === 'undefined' ) { do_expand = ! inside.is( ':visible' ); } // Already expanded or collapsed, so noop if ( inside.is( ':visible' ) === do_expand ) { return; } complete; if ( do_expand ) { // Close all other widget controls before expanding this one wp.customize.control.each( function ( other_control ) { if ( control.params.type === other_control.params.type && control !== other_control ) { other_control.collapseForm(); } } ); control.container.trigger( 'expand' ); control.container.addClass( 'expanding' ); complete = function () { control.container.removeClass( 'expanding' ); control.container.addClass( 'expanded' ); control.container.trigger( 'expanded' ); }; if ( control.params.is_wide ) { inside.animate( { width: 'show' }, 'fast', complete ); } else { inside.slideDown( 'fast', complete ); } } else { control.container.trigger( 'collapse' ); control.container.addClass( 'collapsing' ); complete = function () { control.container.removeClass( 'collapsing' ); control.container.removeClass( 'expanded' ); control.container.trigger( 'collapsed' ); }; if ( control.params.is_wide ) { inside.animate( { width: 'hide' }, 'fast', complete ); } else { inside.slideUp( 'fast', function() { widget.css( { width:'', margin:'' } ); complete(); } ); } } }, /** * Expand the containing sidebar section, expand the form, and focus on * the first input in the control */ focus: function () { var control = this; control.expandControlSection(); control.expandForm(); control.container.find( ':focusable:first' ).focus().trigger( 'click' ); }, /** * Get the position (index) of the widget in the containing sidebar * * @throws Error * @returns {Number} */ getWidgetSidebarPosition: function () { var control = this, sidebar_widget_ids, position; sidebar_widget_ids = control.getSidebarWidgetsControl().setting(); position = sidebar_widget_ids.indexOf( control.params.widget_id ); if ( position === -1 ) { throw new Error( 'Widget was unexpectedly not present in the sidebar.' ); } return position; }, /** * Move widget up one in the sidebar */ moveUp: function () { this._moveWidgetByOne( -1 ); }, /** * Move widget up one in the sidebar */ moveDown: function () { this._moveWidgetByOne( 1 ); }, /** * @private * * @param {Number} offset 1|-1 */ _moveWidgetByOne: function ( offset ) { var control = this, i, sidebar_widgets_setting, sidebar_widget_ids, adjacent_widget_id; i = control.getWidgetSidebarPosition(); sidebar_widgets_setting = control.getSidebarWidgetsControl().setting; sidebar_widget_ids = Array.prototype.slice.call( sidebar_widgets_setting() ); // clone adjacent_widget_id = sidebar_widget_ids[i + offset]; sidebar_widget_ids[i + offset] = control.params.widget_id; sidebar_widget_ids[i] = adjacent_widget_id; sidebar_widgets_setting( sidebar_widget_ids ); }, /** * Toggle visibility of the widget move area * * @param {Boolean} [toggle] */ toggleWidgetMoveArea: function ( toggle ) { var control = this, move_widget_area; move_widget_area = control.container.find( '.move-widget-area' ); if ( typeof toggle === 'undefined' ) { toggle = ! move_widget_area.hasClass( 'active' ); } if ( toggle ) { // reset the selected sidebar move_widget_area.find( '.selected' ).removeClass( 'selected' ); move_widget_area.find( 'li' ).filter( function () { return $( this ).data( 'id' ) === control.params.sidebar_id; } ).addClass( 'selected' ); control.container.find( '.move-widget-btn' ).prop( 'disabled', true ); } move_widget_area.toggleClass( 'active', toggle ); }, /** * Inverse of WidgetCustomizer.getControlInstanceForWidget * @return {jQuery} */ getPreviewWidgetElement: function () { var control = this, widget_customizer_preview = self.getPreviewWindow().WidgetCustomizerPreview; return widget_customizer_preview.getSidebarWidgetElement( control.params.sidebar_id, control.params.widget_id ); }, /** * Inside of the customizer preview, scroll the widget into view */ scrollPreviewWidgetIntoView: function () { // @todo scrollIntoView() provides a robust but very poor experience. Animation is needed. See https://github.com/x-team/wp-widget-customizer/issues/16 }, /** * Highlight the widget control and section */ highlightSectionAndControl: function() { var control = this, target_element; if ( control.container.is( ':hidden' ) ) { target_element = control.container.closest( '.control-section' ); } else { target_element = control.container; } $( '.widget-customizer-highlighted' ).removeClass( 'widget-customizer-highlighted' ); target_element.addClass( 'widget-customizer-highlighted' ); setTimeout( function () { target_element.removeClass( 'widget-customizer-highlighted' ); }, 500 ); }, /** * Add the widget-customizer-highlighted-widget class to the widget for 500ms */ highlightPreviewWidget: function () { var control = this, widget_el, root_el; widget_el = control.getPreviewWidgetElement(); root_el = widget_el.closest( 'html' ); root_el.find( '.widget-customizer-highlighted-widget' ).removeClass( 'widget-customizer-highlighted-widget' ); widget_el.addClass( 'widget-customizer-highlighted-widget' ); setTimeout( function () { widget_el.removeClass( 'widget-customizer-highlighted-widget' ); }, 500 ); } } ); /** * Capture the instance of the Previewer since it is private */ OldPreviewer = wp.customize.Previewer; wp.customize.Previewer = OldPreviewer.extend( { initialize: function( params, options ) { self.previewer = this; OldPreviewer.prototype.initialize.call( this, params, options ); this.bind( 'refresh', this.refresh ); } } ); /** * Given a widget control, find the sidebar widgets control that contains it. * @param {string} widget_id * @return {object|null} */ self.getSidebarWidgetControlContainingWidget = function ( widget_id ) { var found_control = null; // @todo this can use widget_id_to_setting_id(), then pass into wp.customize.control( x ).getSidebarWidgetsControl() wp.customize.control.each( function ( control ) { if ( control.params.type === 'sidebar_widgets' && -1 !== control.setting().indexOf( widget_id ) ) { found_control = control; } } ); return found_control; }; /** * Given a widget_id for a widget appearing in the preview, get the widget form control associated with it * @param {string} widget_id * @return {object|null} */ self.getWidgetFormControlForWidget = function ( widget_id ) { var found_control = null; // @todo We can just use widget_id_to_setting_id() here wp.customize.control.each( function ( control ) { if ( control.params.type === 'widget_form' && control.params.widget_id === widget_id ) { found_control = control; } } ); return found_control; }; /** * @returns {Window} */ self.getPreviewWindow = function (){ return $( '#customize-preview' ).find( 'iframe' ).prop( 'contentWindow' ); }; /** * Available Widgets Panel */ self.availableWidgetsPanel = { active_sidebar_widgets_control: null, selected_widget_tpl: null, container: null, filter_input: null, /** * Set up event listeners */ setup: function () { var panel = this, update_available_widgets_list; panel.container = $( '#available-widgets' ); panel.filter_input = $( '#available-widgets-filter' ).find( 'input' ); update_available_widgets_list = function () { self.available_widgets.each( function ( widget ) { var widget_tpl = $( '#widget-tpl-' + widget.id ); widget_tpl.toggle( ! widget.get( 'is_disabled' ) ); if ( widget.get( 'is_disabled' ) && widget_tpl.is( panel.selected_widget_tpl ) ) { panel.selected_widget_tpl = null; } } ); }; self.available_widgets.on( 'change', update_available_widgets_list ); update_available_widgets_list(); // If the available widgets panel is open and the customize controls are // interacted with (i.e. available widgets panel is blurred) then close the // available widgets panel. $( '#customize-controls' ).on( 'click keydown', function ( e ) { var is_add_new_widget_btn = $( e.target ).is( '.add-new-widget, .add-new-widget *' ); if ( $( 'body' ).hasClass( 'adding-widget' ) && ! is_add_new_widget_btn ) { panel.close(); } } ); // Close the panel if the URL in the preview changes self.previewer.bind( 'url', function () { panel.close(); } ); // Submit a selection when clicked or keypressed panel.container.find( '.widget-tpl' ).on( 'click keypress', function( event ) { // Only proceed with keypress if it is Enter or Spacebar if ( event.type === 'keypress' && ( event.which !== 13 && event.which !== 32 ) ) { return; } panel.submit( this ); } ); panel.container.liveFilter( '#available-widgets-filter input', '.widget-tpl', { filterChildSelector: '.widget-title h4', after: function () { var filter_val = panel.filter_input.val(), first_visible_widget; // Remove a widget from being selected if it is no longer visible if ( panel.selected_widget_tpl && ! panel.selected_widget_tpl.is( ':visible' ) ) { panel.selected_widget_tpl.removeClass( 'selected' ); panel.selected_widget_tpl = null; } // If a widget was selected but the filter value has been cleared out, clear selection if ( panel.selected_widget_tpl && ! filter_val ) { panel.selected_widget_tpl.removeClass( 'selected' ); panel.selected_widget_tpl = null; } // If a filter has been entered and a widget hasn't been selected, select the first one shown if ( ! panel.selected_widget_tpl && filter_val ) { first_visible_widget = panel.container.find( '> .widget-tpl:visible:first' ); if ( first_visible_widget.length ) { panel.select( first_visible_widget ); } } } } ); // Select a widget when it is focused on panel.container.find( ' > .widget-tpl' ).on( 'focus', function () { panel.select( this ); } ); panel.container.on( 'keydown', function ( event ) { var is_enter = ( event.which === 13 ), is_esc = ( event.which === 27 ), is_down = ( event.which === 40 ), is_up = ( event.which === 38 ), selected_widget_tpl = null, first_visible_widget = panel.container.find( '> .widget-tpl:visible:first' ), last_visible_widget = panel.container.find( '> .widget-tpl:visible:last' ), is_input_focused = $( event.target ).is( panel.filter_input ); if ( is_down || is_up ) { if ( is_down ) { if ( is_input_focused ) { selected_widget_tpl = first_visible_widget; } else if ( panel.selected_widget_tpl && panel.selected_widget_tpl.nextAll( '.widget-tpl:visible' ).length !== 0 ) { selected_widget_tpl = panel.selected_widget_tpl.nextAll( '.widget-tpl:visible:first' ); } } else if ( is_up ) { if ( is_input_focused ) { selected_widget_tpl = last_visible_widget; } else if ( panel.selected_widget_tpl && panel.selected_widget_tpl.prevAll( '.widget-tpl:visible' ).length !== 0 ) { selected_widget_tpl = panel.selected_widget_tpl.prevAll( '.widget-tpl:visible:first' ); } } panel.select( selected_widget_tpl ); if ( selected_widget_tpl ) { selected_widget_tpl.focus(); } else { panel.filter_input.focus(); } return; } // If enter pressed but nothing entered, don't do anything if ( is_enter && ! panel.filter_input.val() ) { return; } if ( is_enter ) { panel.submit(); } else if ( is_esc ) { panel.close( { return_focus: true } ); } } ); }, /** * @param widget_tpl */ select: function ( widget_tpl ) { var panel = this; panel.selected_widget_tpl = $( widget_tpl ); panel.selected_widget_tpl.siblings( '.widget-tpl' ).removeClass( 'selected' ); panel.selected_widget_tpl.addClass( 'selected' ); }, submit: function ( widget_tpl ) { var panel = this, widget_id, widget; if ( ! widget_tpl ) { widget_tpl = panel.selected_widget_tpl; } if ( ! widget_tpl || ! panel.active_sidebar_widgets_control ) { return; } panel.select( widget_tpl ); widget_id = $( panel.selected_widget_tpl ).data( 'widget-id' ); widget = self.available_widgets.findWhere( {id: widget_id} ); if ( ! widget ) { throw new Error( 'Widget unexpectedly not found.' ); } panel.active_sidebar_widgets_control.addWidget( widget.get( 'id_base' ) ); panel.close(); }, /** * @param sidebars_widgets_control */ open: function ( sidebars_widgets_control ) { var panel = this; panel.active_sidebar_widgets_control = sidebars_widgets_control; // Wide widget controls appear over the preview, and so they need to be collapsed when the panel opens _( sidebars_widgets_control.getWidgetFormControls() ).each( function ( control ) { if ( control.params.is_wide ) { control.collapseForm(); } } ); $( 'body' ).addClass( 'adding-widget' ); panel.container.find( '.widget-tpl' ).removeClass( 'selected' ); panel.filter_input.focus(); }, /** * Hide the panel */ close: function ( options ) { var panel = this; options = options || {}; if ( options.return_focus && panel.active_sidebar_widgets_control ) { panel.active_sidebar_widgets_control.container.find( '.add-new-widget' ).focus(); } panel.active_sidebar_widgets_control = null; panel.selected_widget_tpl = null; $( 'body' ).removeClass( 'adding-widget' ); panel.filter_input.val( '' ); } }; /** * @param {String} widget_id * @returns {Object} */ function parse_widget_id( widget_id ) { var matches, parsed = { number: null, id_base: null }; matches = widget_id.match( /^(.+)-(\d+)$/ ); if ( matches ) { parsed.id_base = matches[1]; parsed.number = parseInt( matches[2], 10 ); } else { // likely an old single widget parsed.id_base = widget_id; } return parsed; } /** * @param {String} widget_id * @returns {String} setting_id */ function widget_id_to_setting_id( widget_id ) { var parsed = parse_widget_id( widget_id ), setting_id; setting_id = 'widget_' + parsed.id_base; if ( parsed.number ) { setting_id += '[' + parsed.number + ']'; } return setting_id; } return self; }( jQuery )); /* @todo remove this dependency */ /* * jQuery.liveFilter * * Copyright (c) 2009 Mike Merritt * * Forked by Lim Chee Aun (cheeaun.com) * */ (function($){ $.fn.liveFilter = function(inputEl, filterEl, options){ var el, filter, defaults = { filterChildSelector: null, filter: function(el, val){ return $(el).text().toUpperCase().indexOf(val.toUpperCase()) >= 0; }, before: function(){}, after: function(){} }; options = $.extend(defaults, options); el = $(this).find(filterEl); if (options.filterChildSelector) { el = el.find(options.filterChildSelector); } filter = options.filter; $(inputEl).keyup(function(){ var val = $(this).val(), contains, containsNot; contains = el.filter(function(){ return filter(this, val); }); containsNot = el.not(contains); if (options.filterChildSelector){ contains = contains.parents(filterEl); containsNot = containsNot.parents(filterEl).hide(); } options.before.call(this, contains, containsNot); contains.show(); containsNot.hide(); if (val === '') { contains.show(); containsNot.show(); } options.after.call(this, contains, containsNot); }); }; })(jQuery);