From 9dae9acb4f4a9ef2c73f50ae85df7040c6ae2dc4 Mon Sep 17 00:00:00 2001 From: Matthew Lemon Date: Fri, 21 Jun 2024 19:00:34 +0100 Subject: Update --- .../Buttons-1.6.5/js/dataTables.buttons.js | 2157 -------------------- 1 file changed, 2157 deletions(-) delete mode 100644 ctrack/static/DataTables/Buttons-1.6.5/js/dataTables.buttons.js (limited to 'ctrack/static/DataTables/Buttons-1.6.5/js/dataTables.buttons.js') diff --git a/ctrack/static/DataTables/Buttons-1.6.5/js/dataTables.buttons.js b/ctrack/static/DataTables/Buttons-1.6.5/js/dataTables.buttons.js deleted file mode 100644 index de95de2..0000000 --- a/ctrack/static/DataTables/Buttons-1.6.5/js/dataTables.buttons.js +++ /dev/null @@ -1,2157 +0,0 @@ -/*! Buttons for DataTables 1.6.5 - * ©2016-2020 SpryMedia Ltd - datatables.net/license - */ - -(function( factory ){ - if ( typeof define === 'function' && define.amd ) { - // AMD - define( ['jquery', 'datatables.net'], function ( $ ) { - return factory( $, window, document ); - } ); - } - else if ( typeof exports === 'object' ) { - // CommonJS - module.exports = function (root, $) { - if ( ! root ) { - root = window; - } - - if ( ! $ || ! $.fn.dataTable ) { - $ = require('datatables.net')(root, $).$; - } - - return factory( $, root, root.document ); - }; - } - else { - // Browser - factory( jQuery, window, document ); - } -}(function( $, window, document, undefined ) { -'use strict'; -var DataTable = $.fn.dataTable; - - -// Used for namespacing events added to the document by each instance, so they -// can be removed on destroy -var _instCounter = 0; - -// Button namespacing counter for namespacing events on individual buttons -var _buttonCounter = 0; - -var _dtButtons = DataTable.ext.buttons; - -// Allow for jQuery slim -function _fadeIn(el, duration, fn) { - if ($.fn.animate) { - el - .stop() - .fadeIn( duration, fn ); - } - else { - el.css('display', 'block'); - - if (fn) { - fn.call(el); - } - } -} - -function _fadeOut(el, duration, fn) { - if ($.fn.animate) { - el - .stop() - .fadeOut( duration, fn ); - } - else { - el.css('display', 'none'); - - if (fn) { - fn.call(el); - } - } -} - -/** - * [Buttons description] - * @param {[type]} - * @param {[type]} - */ -var Buttons = function( dt, config ) -{ - // If not created with a `new` keyword then we return a wrapper function that - // will take the settings object for a DT. This allows easy use of new instances - // with the `layout` option - e.g. `topLeft: $.fn.dataTable.Buttons( ... )`. - if ( !(this instanceof Buttons) ) { - return function (settings) { - return new Buttons( settings, dt ).container(); - }; - } - - // If there is no config set it to an empty object - if ( typeof( config ) === 'undefined' ) { - config = {}; - } - - // Allow a boolean true for defaults - if ( config === true ) { - config = {}; - } - - // For easy configuration of buttons an array can be given - if ( Array.isArray( config ) ) { - config = { buttons: config }; - } - - this.c = $.extend( true, {}, Buttons.defaults, config ); - - // Don't want a deep copy for the buttons - if ( config.buttons ) { - this.c.buttons = config.buttons; - } - - this.s = { - dt: new DataTable.Api( dt ), - buttons: [], - listenKeys: '', - namespace: 'dtb'+(_instCounter++) - }; - - this.dom = { - container: $('<'+this.c.dom.container.tag+'/>') - .addClass( this.c.dom.container.className ) - }; - - this._constructor(); -}; - - -$.extend( Buttons.prototype, { - /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - * Public methods - */ - - /** - * Get the action of a button - * @param {int|string} Button index - * @return {function} - *//** - * Set the action of a button - * @param {node} node Button element - * @param {function} action Function to set - * @return {Buttons} Self for chaining - */ - action: function ( node, action ) - { - var button = this._nodeToButton( node ); - - if ( action === undefined ) { - return button.conf.action; - } - - button.conf.action = action; - - return this; - }, - - /** - * Add an active class to the button to make to look active or get current - * active state. - * @param {node} node Button element - * @param {boolean} [flag] Enable / disable flag - * @return {Buttons} Self for chaining or boolean for getter - */ - active: function ( node, flag ) { - var button = this._nodeToButton( node ); - var klass = this.c.dom.button.active; - var jqNode = $(button.node); - - if ( flag === undefined ) { - return jqNode.hasClass( klass ); - } - - jqNode.toggleClass( klass, flag === undefined ? true : flag ); - - return this; - }, - - /** - * Add a new button - * @param {object} config Button configuration object, base string name or function - * @param {int|string} [idx] Button index for where to insert the button - * @return {Buttons} Self for chaining - */ - add: function ( config, idx ) - { - var buttons = this.s.buttons; - - if ( typeof idx === 'string' ) { - var split = idx.split('-'); - var base = this.s; - - for ( var i=0, ien=split.length-1 ; i=0 ; i-- ) { - this.remove( button.buttons[i].node ); - } - } - - // Allow the button to remove event handlers, etc - if ( button.conf.destroy ) { - button.conf.destroy.call( dt.button(node), dt, $(node), button.conf ); - } - - this._removeKey( button.conf ); - - $(button.node).remove(); - - var idx = $.inArray( button, host ); - host.splice( idx, 1 ); - - return this; - }, - - /** - * Get the text for a button - * @param {int|string} node Button index - * @return {string} Button text - *//** - * Set the text for a button - * @param {int|string|function} node Button index - * @param {string} label Text - * @return {Buttons} Self for chaining - */ - text: function ( node, label ) - { - var button = this._nodeToButton( node ); - var buttonLiner = this.c.dom.collection.buttonLiner; - var linerTag = button.inCollection && buttonLiner && buttonLiner.tag ? - buttonLiner.tag : - this.c.dom.buttonLiner.tag; - var dt = this.s.dt; - var jqNode = $(button.node); - var text = function ( opt ) { - return typeof opt === 'function' ? - opt( dt, jqNode, button.conf ) : - opt; - }; - - if ( label === undefined ) { - return text( button.conf.text ); - } - - button.conf.text = label; - - if ( linerTag ) { - jqNode.children( linerTag ).html( text(label) ); - } - else { - jqNode.html( text(label) ); - } - - return this; - }, - - - /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - * Constructor - */ - - /** - * Buttons constructor - * @private - */ - _constructor: function () - { - var that = this; - var dt = this.s.dt; - var dtSettings = dt.settings()[0]; - var buttons = this.c.buttons; - - if ( ! dtSettings._buttons ) { - dtSettings._buttons = []; - } - - dtSettings._buttons.push( { - inst: this, - name: this.c.name - } ); - - for ( var i=0, ien=buttons.length ; i'); - - built.conf._collection = built.collection; - - this._expandButton( built.buttons, built.conf.buttons, true, attachPoint ); - } - - // init call is made here, rather than buildButton as it needs to - // be selectable, and for that it needs to be in the buttons array - if ( conf.init ) { - conf.init.call( dt.button( built.node ), dt, $(built.node), conf ); - } - - buttonCounter++; - } - }, - - /** - * Create an individual button - * @param {object} config Resolved button configuration - * @param {boolean} inCollection `true` if a collection button - * @return {jQuery} Created button node (jQuery) - * @private - */ - _buildButton: function ( config, inCollection ) - { - var buttonDom = this.c.dom.button; - var linerDom = this.c.dom.buttonLiner; - var collectionDom = this.c.dom.collection; - var dt = this.s.dt; - var text = function ( opt ) { - return typeof opt === 'function' ? - opt( dt, button, config ) : - opt; - }; - - if ( inCollection && collectionDom.button ) { - buttonDom = collectionDom.button; - } - - if ( inCollection && collectionDom.buttonLiner ) { - linerDom = collectionDom.buttonLiner; - } - - // Make sure that the button is available based on whatever requirements - // it has. For example, Flash buttons require Flash - if ( config.available && ! config.available( dt, config ) ) { - return false; - } - - var action = function ( e, dt, button, config ) { - config.action.call( dt.button( button ), e, dt, button, config ); - - $(dt.table().node()).triggerHandler( 'buttons-action.dt', [ - dt.button( button ), dt, button, config - ] ); - }; - - var tag = config.tag || buttonDom.tag; - var clickBlurs = config.clickBlurs === undefined ? true : config.clickBlurs - var button = $('<'+tag+'/>') - .addClass( buttonDom.className ) - .attr( 'tabindex', this.s.dt.settings()[0].iTabIndex ) - .attr( 'aria-controls', this.s.dt.table().node().id ) - .on( 'click.dtb', function (e) { - e.preventDefault(); - - if ( ! button.hasClass( buttonDom.disabled ) && config.action ) { - action( e, dt, button, config ); - } - if( clickBlurs ) { - button.trigger('blur'); - } - } ) - .on( 'keyup.dtb', function (e) { - if ( e.keyCode === 13 ) { - if ( ! button.hasClass( buttonDom.disabled ) && config.action ) { - action( e, dt, button, config ); - } - } - } ); - - // Make `a` tags act like a link - if ( tag.toLowerCase() === 'a' ) { - button.attr( 'href', '#' ); - } - - // Button tags should have `type=button` so they don't have any default behaviour - if ( tag.toLowerCase() === 'button' ) { - button.attr( 'type', 'button' ); - } - - if ( linerDom.tag ) { - var liner = $('<'+linerDom.tag+'/>') - .html( text( config.text ) ) - .addClass( linerDom.className ); - - if ( linerDom.tag.toLowerCase() === 'a' ) { - liner.attr( 'href', '#' ); - } - - button.append( liner ); - } - else { - button.html( text( config.text ) ); - } - - if ( config.enabled === false ) { - button.addClass( buttonDom.disabled ); - } - - if ( config.className ) { - button.addClass( config.className ); - } - - if ( config.titleAttr ) { - button.attr( 'title', text( config.titleAttr ) ); - } - - if ( config.attr ) { - button.attr( config.attr ); - } - - if ( ! config.namespace ) { - config.namespace = '.dt-button-'+(_buttonCounter++); - } - - var buttonContainer = this.c.dom.buttonContainer; - var inserter; - if ( buttonContainer && buttonContainer.tag ) { - inserter = $('<'+buttonContainer.tag+'/>') - .addClass( buttonContainer.className ) - .append( button ); - } - else { - inserter = button; - } - - this._addKey( config ); - - // Style integration callback for DOM manipulation - // Note that this is _not_ documented. It is currently - // for style integration only - if( this.c.buttonCreated ) { - inserter = this.c.buttonCreated( config, inserter ); - } - - return { - conf: config, - node: button.get(0), - inserter: inserter, - buttons: [], - inCollection: inCollection, - collection: null - }; - }, - - /** - * Get the button object from a node (recursive) - * @param {node} node Button node - * @param {array} [buttons] Button array, uses base if not defined - * @return {object} Button object - * @private - */ - _nodeToButton: function ( node, buttons ) - { - if ( ! buttons ) { - buttons = this.s.buttons; - } - - for ( var i=0, ien=buttons.length ; i 30 ) { - // Protect against misconfiguration killing the browser - throw 'Buttons: Too many iterations'; - } - } - - return Array.isArray( base ) ? - base : - $.extend( {}, base ); - }; - - conf = toConfObject( conf ); - - while ( conf && conf.extend ) { - // Use `toConfObject` in case the button definition being extended - // is itself a string or a function - if ( ! _dtButtons[ conf.extend ] ) { - throw 'Cannot extend unknown button type: '+conf.extend; - } - - var objArray = toConfObject( _dtButtons[ conf.extend ] ); - if ( Array.isArray( objArray ) ) { - return objArray; - } - else if ( ! objArray ) { - // This is a little brutal as it might be possible to have a - // valid button without the extend, but if there is no extend - // then the host button would be acting in an undefined state - return false; - } - - // Stash the current class name - var originalClassName = objArray.className; - - conf = $.extend( {}, objArray, conf ); - - // The extend will have overwritten the original class name if the - // `conf` object also assigned a class, but we want to concatenate - // them so they are list that is combined from all extended buttons - if ( originalClassName && conf.className !== originalClassName ) { - conf.className = originalClassName+' '+conf.className; - } - - // Buttons to be added to a collection -gives the ability to define - // if buttons should be added to the start or end of a collection - var postfixButtons = conf.postfixButtons; - if ( postfixButtons ) { - if ( ! conf.buttons ) { - conf.buttons = []; - } - - for ( i=0, ien=postfixButtons.length ; i') - .addClass('dt-button-collection') - .addClass(options.collectionLayout) - .css('display', 'none'); - - content = $(content) - .addClass(options.contentClassName) - .attr('role', 'menu') - .appendTo(display); - - hostNode.attr( 'aria-expanded', 'true' ); - - if ( hostNode.parents('body')[0] !== document.body ) { - hostNode = document.body.lastChild; - } - - if ( options.collectionTitle ) { - display.prepend('
'+options.collectionTitle+'
'); - } - - _fadeIn( display.insertAfter( hostNode ), options.fade ); - - var tableContainer = $( hostButton.table().container() ); - var position = display.css( 'position' ); - - if ( options.align === 'dt-container' ) { - hostNode = hostNode.parent(); - display.css('width', tableContainer.width()); - } - - // Align the popover relative to the DataTables container - // Useful for wide popovers such as SearchPanes - if ( - position === 'absolute' && - ( - display.hasClass( options.rightAlignClassName ) || - display.hasClass( options.leftAlignClassName ) || - options.align === 'dt-container' - ) - ) { - - var hostPosition = hostNode.position(); - - display.css( { - top: hostPosition.top + hostNode.outerHeight(), - left: hostPosition.left - } ); - - // calculate overflow when positioned beneath - var collectionHeight = display.outerHeight(); - var tableBottom = tableContainer.offset().top + tableContainer.height(); - var listBottom = hostPosition.top + hostNode.outerHeight() + collectionHeight; - var bottomOverflow = listBottom - tableBottom; - - // calculate overflow when positioned above - var listTop = hostPosition.top - collectionHeight; - var tableTop = tableContainer.offset().top; - var topOverflow = tableTop - listTop; - - // if bottom overflow is larger, move to the top because it fits better, or if dropup is requested - var moveTop = hostPosition.top - collectionHeight - 5; - if ( (bottomOverflow > topOverflow || options.dropup) && -moveTop < tableTop ) { - display.css( 'top', moveTop); - } - - // Get the size of the container (left and width - and thus also right) - var tableLeft = tableContainer.offset().left; - var tableWidth = tableContainer.width(); - var tableRight = tableLeft + tableWidth; - - // Get the size of the popover (left and width - and ...) - var popoverLeft = display.offset().left; - var popoverWidth = display.width(); - var popoverRight = popoverLeft + popoverWidth; - - // Get the size of the host buttons (left and width - and ...) - var buttonsLeft = hostNode.offset().left; - var buttonsWidth = hostNode.outerWidth() - var buttonsRight = buttonsLeft + buttonsWidth; - - // You've then got all the numbers you need to do some calculations and if statements, - // so we can do some quick JS maths and apply it only once - // If it has the right align class OR the buttons are right aligned OR the button container is floated right, - // then calculate left position for the popover to align the popover to the right hand - // side of the button - check to see if the left of the popover is inside the table container. - // If not, move the popover so it is, but not more than it means that the popover is to the right of the table container - var popoverShuffle = 0; - if ( display.hasClass( options.rightAlignClassName )) { - popoverShuffle = buttonsRight - popoverRight; - if(tableLeft > (popoverLeft + popoverShuffle)){ - var leftGap = tableLeft - (popoverLeft + popoverShuffle); - var rightGap = tableRight - (popoverRight + popoverShuffle); - - if(leftGap > rightGap){ - popoverShuffle += rightGap; - } - else { - popoverShuffle += leftGap; - } - } - } - // else attempt to left align the popover to the button. Similar to above, if the popover's right goes past the table container's right, - // then move it back, but not so much that it goes past the left of the table container - else { - popoverShuffle = tableLeft - popoverLeft; - - if(tableRight < (popoverRight + popoverShuffle)){ - var leftGap = tableLeft - (popoverLeft + popoverShuffle); - var rightGap = tableRight - (popoverRight + popoverShuffle); - - if(leftGap > rightGap ){ - popoverShuffle += rightGap; - } - else { - popoverShuffle += leftGap; - } - - } - } - - display.css('left', display.position().left + popoverShuffle); - - } - else if (position === 'absolute') { - // Align relative to the host button - var hostPosition = hostNode.position(); - - display.css( { - top: hostPosition.top + hostNode.outerHeight(), - left: hostPosition.left - } ); - - // calculate overflow when positioned beneath - var collectionHeight = display.outerHeight(); - var top = hostNode.offset().top - var popoverShuffle = 0; - - // Get the size of the host buttons (left and width - and ...) - var buttonsLeft = hostNode.offset().left; - var buttonsWidth = hostNode.outerWidth() - var buttonsRight = buttonsLeft + buttonsWidth; - - // Get the size of the popover (left and width - and ...) - var popoverLeft = display.offset().left; - var popoverWidth = content.width(); - var popoverRight = popoverLeft + popoverWidth; - - var moveTop = hostPosition.top - collectionHeight - 5; - var tableBottom = tableContainer.offset().top + tableContainer.height(); - var listBottom = hostPosition.top + hostNode.outerHeight() + collectionHeight; - var bottomOverflow = listBottom - tableBottom; - - // calculate overflow when positioned above - var listTop = hostPosition.top - collectionHeight; - var tableTop = tableContainer.offset().top; - var topOverflow = tableTop - listTop; - - if ( (bottomOverflow > topOverflow || options.dropup) && -moveTop < tableTop ) { - display.css( 'top', moveTop); - } - - popoverShuffle = options.align === 'button-right' - ? buttonsRight - popoverRight - : buttonsLeft - popoverLeft; - - display.css('left', display.position().left + popoverShuffle); - } - else { - // Fix position - centre on screen - var top = display.height() / 2; - if ( top > $(window).height() / 2 ) { - top = $(window).height() / 2; - } - - display.css( 'marginTop', top*-1 ); - } - - if ( options.background ) { - Buttons.background( true, options.backgroundClassName, options.fade, hostNode ); - } - - // This is bonkers, but if we don't have a click listener on the - // background element, iOS Safari will ignore the body click - // listener below. An empty function here is all that is - // required to make it work... - $('div.dt-button-background').on( 'click.dtb-collection', function () {} ); - - $('body') - .on( 'click.dtb-collection', function (e) { - // andSelf is deprecated in jQ1.8, but we want 1.7 compat - var back = $.fn.addBack ? 'addBack' : 'andSelf'; - var parent = $(e.target).parent()[0]; - - if (( ! $(e.target).parents()[back]().filter( content ).length && !$(parent).hasClass('dt-buttons')) || $(e.target).hasClass('dt-button-background')) { - close(); - } - } ) - .on( 'keyup.dtb-collection', function (e) { - if ( e.keyCode === 27 ) { - close(); - } - } ); - - if ( options.autoClose ) { - setTimeout( function () { - dt.on( 'buttons-action.b-internal', function (e, btn, dt, node) { - if ( node[0] === hostNode[0] ) { - return; - } - close(); - } ); - }, 0); - } - - $(display).trigger('buttons-popover.dt'); - } -} ); - - - -/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - * Statics - */ - -/** - * Show / hide a background layer behind a collection - * @param {boolean} Flag to indicate if the background should be shown or - * hidden - * @param {string} Class to assign to the background - * @static - */ -Buttons.background = function ( show, className, fade, insertPoint ) { - if ( fade === undefined ) { - fade = 400; - } - if ( ! insertPoint ) { - insertPoint = document.body; - } - - if ( show ) { - _fadeIn( - $('
') - .addClass( className ) - .css( 'display', 'none' ) - .insertAfter( insertPoint ), - fade - ); - } - else { - _fadeOut( - $('div.'+className), - fade, - function () { - $(this) - .removeClass( className ) - .remove(); - } - ); - } -}; - -/** - * Instance selector - select Buttons instances based on an instance selector - * value from the buttons assigned to a DataTable. This is only useful if - * multiple instances are attached to a DataTable. - * @param {string|int|array} Instance selector - see `instance-selector` - * documentation on the DataTables site - * @param {array} Button instance array that was attached to the DataTables - * settings object - * @return {array} Buttons instances - * @static - */ -Buttons.instanceSelector = function ( group, buttons ) -{ - if ( group === undefined || group === null ) { - return $.map( buttons, function ( v ) { - return v.inst; - } ); - } - - var ret = []; - var names = $.map( buttons, function ( v ) { - return v.name; - } ); - - // Flatten the group selector into an array of single options - var process = function ( input ) { - if ( Array.isArray( input ) ) { - for ( var i=0, ien=input.length ; i` in IE - it has to be `` - tag: 'ActiveXObject' in window ? - 'a' : - 'button', - className: 'dt-button', - active: 'active', - disabled: 'disabled' - }, - buttonLiner: { - tag: 'span', - className: '' - } - } -}; - -/** - * Version information - * @type {string} - * @static - */ -Buttons.version = '1.6.5'; - - -$.extend( _dtButtons, { - collection: { - text: function ( dt ) { - return dt.i18n( 'buttons.collection', 'Collection' ); - }, - className: 'buttons-collection', - init: function ( dt, button, config ) { - button.attr( 'aria-expanded', false ); - }, - action: function ( e, dt, button, config ) { - e.stopPropagation(); - - if ( config._collection.parents('body').length ) { - this.popover(false, config); - } - else { - this.popover(config._collection, config); - } - }, - attr: { - 'aria-haspopup': true - } - // Also the popover options, defined in Buttons.popover - }, - copy: function ( dt, conf ) { - if ( _dtButtons.copyHtml5 ) { - return 'copyHtml5'; - } - if ( _dtButtons.copyFlash && _dtButtons.copyFlash.available( dt, conf ) ) { - return 'copyFlash'; - } - }, - csv: function ( dt, conf ) { - // Common option that will use the HTML5 or Flash export buttons - if ( _dtButtons.csvHtml5 && _dtButtons.csvHtml5.available( dt, conf ) ) { - return 'csvHtml5'; - } - if ( _dtButtons.csvFlash && _dtButtons.csvFlash.available( dt, conf ) ) { - return 'csvFlash'; - } - }, - excel: function ( dt, conf ) { - // Common option that will use the HTML5 or Flash export buttons - if ( _dtButtons.excelHtml5 && _dtButtons.excelHtml5.available( dt, conf ) ) { - return 'excelHtml5'; - } - if ( _dtButtons.excelFlash && _dtButtons.excelFlash.available( dt, conf ) ) { - return 'excelFlash'; - } - }, - pdf: function ( dt, conf ) { - // Common option that will use the HTML5 or Flash export buttons - if ( _dtButtons.pdfHtml5 && _dtButtons.pdfHtml5.available( dt, conf ) ) { - return 'pdfHtml5'; - } - if ( _dtButtons.pdfFlash && _dtButtons.pdfFlash.available( dt, conf ) ) { - return 'pdfFlash'; - } - }, - pageLength: function ( dt ) { - var lengthMenu = dt.settings()[0].aLengthMenu; - var vals = Array.isArray( lengthMenu[0] ) ? lengthMenu[0] : lengthMenu; - var lang = Array.isArray( lengthMenu[0] ) ? lengthMenu[1] : lengthMenu; - var text = function ( dt ) { - return dt.i18n( 'buttons.pageLength', { - "-1": 'Show all rows', - _: 'Show %d rows' - }, dt.page.len() ); - }; - - return { - extend: 'collection', - text: text, - className: 'buttons-page-length', - autoClose: true, - buttons: $.map( vals, function ( val, i ) { - return { - text: lang[i], - className: 'button-page-length', - action: function ( e, dt ) { - dt.page.len( val ).draw(); - }, - init: function ( dt, node, conf ) { - var that = this; - var fn = function () { - that.active( dt.page.len() === val ); - }; - - dt.on( 'length.dt'+conf.namespace, fn ); - fn(); - }, - destroy: function ( dt, node, conf ) { - dt.off( 'length.dt'+conf.namespace ); - } - }; - } ), - init: function ( dt, node, conf ) { - var that = this; - dt.on( 'length.dt'+conf.namespace, function () { - that.text( conf.text ); - } ); - }, - destroy: function ( dt, node, conf ) { - dt.off( 'length.dt'+conf.namespace ); - } - }; - } -} ); - - -/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * - * DataTables API - * - * For complete documentation, please refer to the docs/api directory or the - * DataTables site - */ - -// Buttons group and individual button selector -DataTable.Api.register( 'buttons()', function ( group, selector ) { - // Argument shifting - if ( selector === undefined ) { - selector = group; - group = undefined; - } - - this.selector.buttonGroup = group; - - var res = this.iterator( true, 'table', function ( ctx ) { - if ( ctx._buttons ) { - return Buttons.buttonSelector( - Buttons.instanceSelector( group, ctx._buttons ), - selector - ); - } - }, true ); - - res._groupSelector = group; - return res; -} ); - -// Individual button selector -DataTable.Api.register( 'button()', function ( group, selector ) { - // just run buttons() and truncate - var buttons = this.buttons( group, selector ); - - if ( buttons.length > 1 ) { - buttons.splice( 1, buttons.length ); - } - - return buttons; -} ); - -// Active buttons -DataTable.Api.registerPlural( 'buttons().active()', 'button().active()', function ( flag ) { - if ( flag === undefined ) { - return this.map( function ( set ) { - return set.inst.active( set.node ); - } ); - } - - return this.each( function ( set ) { - set.inst.active( set.node, flag ); - } ); -} ); - -// Get / set button action -DataTable.Api.registerPlural( 'buttons().action()', 'button().action()', function ( action ) { - if ( action === undefined ) { - return this.map( function ( set ) { - return set.inst.action( set.node ); - } ); - } - - return this.each( function ( set ) { - set.inst.action( set.node, action ); - } ); -} ); - -// Enable / disable buttons -DataTable.Api.register( ['buttons().enable()', 'button().enable()'], function ( flag ) { - return this.each( function ( set ) { - set.inst.enable( set.node, flag ); - } ); -} ); - -// Disable buttons -DataTable.Api.register( ['buttons().disable()', 'button().disable()'], function () { - return this.each( function ( set ) { - set.inst.disable( set.node ); - } ); -} ); - -// Get button nodes -DataTable.Api.registerPlural( 'buttons().nodes()', 'button().node()', function () { - var jq = $(); - - // jQuery will automatically reduce duplicates to a single entry - $( this.each( function ( set ) { - jq = jq.add( set.inst.node( set.node ) ); - } ) ); - - return jq; -} ); - -// Get / set button processing state -DataTable.Api.registerPlural( 'buttons().processing()', 'button().processing()', function ( flag ) { - if ( flag === undefined ) { - return this.map( function ( set ) { - return set.inst.processing( set.node ); - } ); - } - - return this.each( function ( set ) { - set.inst.processing( set.node, flag ); - } ); -} ); - -// Get / set button text (i.e. the button labels) -DataTable.Api.registerPlural( 'buttons().text()', 'button().text()', function ( label ) { - if ( label === undefined ) { - return this.map( function ( set ) { - return set.inst.text( set.node ); - } ); - } - - return this.each( function ( set ) { - set.inst.text( set.node, label ); - } ); -} ); - -// Trigger a button's action -DataTable.Api.registerPlural( 'buttons().trigger()', 'button().trigger()', function () { - return this.each( function ( set ) { - set.inst.node( set.node ).trigger( 'click' ); - } ); -} ); - -// Button resolver to the popover -DataTable.Api.register( 'button().popover()', function (content, options) { - return this.map( function ( set ) { - return set.inst._popover( content, this.button(this[0].node), options ); - } ); -} ); - -// Get the container elements -DataTable.Api.register( 'buttons().containers()', function () { - var jq = $(); - var groupSelector = this._groupSelector; - - // We need to use the group selector directly, since if there are no buttons - // the result set will be empty - this.iterator( true, 'table', function ( ctx ) { - if ( ctx._buttons ) { - var insts = Buttons.instanceSelector( groupSelector, ctx._buttons ); - - for ( var i=0, ien=insts.length ; i'+title+'' : ''; - - _fadeIn( - $('
') - .html( title ) - .append( $('
')[ typeof message === 'string' ? 'html' : 'append' ]( message ) ) - .css( 'display', 'none' ) - .appendTo( 'body' ) - ); - - if ( time !== undefined && time !== 0 ) { - _infoTimer = setTimeout( function () { - that.buttons.info( false ); - }, time ); - } - - this.on('destroy.btn-info', function () { - that.buttons.info(false); - }); - - return this; -} ); - -// Get data from the table for export - this is common to a number of plug-in -// buttons so it is included in the Buttons core library -DataTable.Api.register( 'buttons.exportData()', function ( options ) { - if ( this.context.length ) { - return _exportData( new DataTable.Api( this.context[0] ), options ); - } -} ); - -// Get information about the export that is common to many of the export data -// types (DRY) -DataTable.Api.register( 'buttons.exportInfo()', function ( conf ) { - if ( ! conf ) { - conf = {}; - } - - return { - filename: _filename( conf ), - title: _title( conf ), - messageTop: _message(this, conf.message || conf.messageTop, 'top'), - messageBottom: _message(this, conf.messageBottom, 'bottom') - }; -} ); - - - -/** - * Get the file name for an exported file. - * - * @param {object} config Button configuration - * @param {boolean} incExtension Include the file name extension - */ -var _filename = function ( config ) -{ - // Backwards compatibility - var filename = config.filename === '*' && config.title !== '*' && config.title !== undefined && config.title !== null && config.title !== '' ? - config.title : - config.filename; - - if ( typeof filename === 'function' ) { - filename = filename(); - } - - if ( filename === undefined || filename === null ) { - return null; - } - - if ( filename.indexOf( '*' ) !== -1 ) { - filename = filename.replace( '*', $('head > title').text() ).trim(); - } - - // Strip characters which the OS will object to - filename = filename.replace(/[^a-zA-Z0-9_\u00A1-\uFFFF\.,\-_ !\(\)]/g, ""); - - var extension = _stringOrFunction( config.extension ); - if ( ! extension ) { - extension = ''; - } - - return filename + extension; -}; - -/** - * Simply utility method to allow parameters to be given as a function - * - * @param {undefined|string|function} option Option - * @return {null|string} Resolved value - */ -var _stringOrFunction = function ( option ) -{ - if ( option === null || option === undefined ) { - return null; - } - else if ( typeof option === 'function' ) { - return option(); - } - return option; -}; - -/** - * Get the title for an exported file. - * - * @param {object} config Button configuration - */ -var _title = function ( config ) -{ - var title = _stringOrFunction( config.title ); - - return title === null ? - null : title.indexOf( '*' ) !== -1 ? - title.replace( '*', $('head > title').text() || 'Exported data' ) : - title; -}; - -var _message = function ( dt, option, position ) -{ - var message = _stringOrFunction( option ); - if ( message === null ) { - return null; - } - - var caption = $('caption', dt.table().container()).eq(0); - if ( message === '*' ) { - var side = caption.css( 'caption-side' ); - if ( side !== position ) { - return null; - } - - return caption.length ? - caption.text() : - ''; - } - - return message; -}; - - - - - - - -var _exportTextarea = $('