src/ceph/src/pybind/mgr/dashboard/static/AdminLTE-2.3.7/plugins/datatables/extensions/TableTools/js/dataTables.tableTools.js

   1 /*! TableTools 2.2.4
   2  * 2009-2015 SpryMedia Ltd - datatables.net/license
   3  *
   4  * ZeroClipboard 1.0.4
   5  * Author: Joseph Huckaby - MIT licensed
   6  */
   7
   8 /**
   9  * @summary     TableTools
  10  * @description Tools and buttons for DataTables
  11  * @version     2.2.4
  12  * @file        dataTables.tableTools.js
  13  * @author      SpryMedia Ltd (www.sprymedia.co.uk)
  14  * @contact     www.sprymedia.co.uk/contact
  15  * @copyright   Copyright 2009-2015 SpryMedia Ltd.
  16  *
  17  * This source file is free software, available under the following license:
  18  *   MIT license - http://datatables.net/license/mit
  19  *
  20  * This source file is distributed in the hope that it will be useful, but
  21  * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  22  * or FITNESS FOR A PARTICULAR PURPOSE. See the license files for details.
  23  *
  24  * For details please refer to: http://www.datatables.net
  25  */
  26
  27
  28 /* Global scope for TableTools for backwards compatibility.
  29  * Will be removed in 2.3
  30  */
  31 var TableTools;
  32
  33 (function(window, document, undefined) {
  34
  35
  36 var factory = function( $, DataTable ) {
  37 "use strict";
  38
  39
  40 //include ZeroClipboard.js
  41 /* ZeroClipboard 1.0.4
  42  * Author: Joseph Huckaby
  43  */
  44
  45 var ZeroClipboard_TableTools = {
  46
  47         version: "1.0.4-TableTools2",
  48         clients: {}, // registered upload clients on page, indexed by id
  49         moviePath: '', // URL to movie
  50         nextId: 1, // ID of next movie
  51
  52         $: function(thingy) {
  53                 // simple DOM lookup utility function
  54                 if (typeof(thingy) == 'string') {
  55                         thingy = document.getElementById(thingy);
  56                 }
  57                 if (!thingy.addClass) {
  58                         // extend element with a few useful methods
  59                         thingy.hide = function() { this.style.display = 'none'; };
  60                         thingy.show = function() { this.style.display = ''; };
  61                         thingy.addClass = function(name) { this.removeClass(name); this.className += ' ' + name; };
  62                         thingy.removeClass = function(name) {
  63                                 this.className = this.className.replace( new RegExp("\\s*" + name + "\\s*"), " ").replace(/^\s+/, '').replace(/\s+$/, '');
  64                         };
  65                         thingy.hasClass = function(name) {
  66                                 return !!this.className.match( new RegExp("\\s*" + name + "\\s*") );
  67                         };
  68                 }
  69                 return thingy;
  70         },
  71
  72         setMoviePath: function(path) {
  73                 // set path to ZeroClipboard.swf
  74                 this.moviePath = path;
  75         },
  76
  77         dispatch: function(id, eventName, args) {
  78                 // receive event from flash movie, send to client
  79                 var client = this.clients[id];
  80                 if (client) {
  81                         client.receiveEvent(eventName, args);
  82                 }
  83         },
  84
  85         register: function(id, client) {
  86                 // register new client to receive events
  87                 this.clients[id] = client;
  88         },
  89
  90         getDOMObjectPosition: function(obj) {
  91                 // get absolute coordinates for dom element
  92                 var info = {
  93                         left: 0,
  94                         top: 0,
  95                         width: obj.width ? obj.width : obj.offsetWidth,
  96                         height: obj.height ? obj.height : obj.offsetHeight
  97                 };
  98
  99                 if ( obj.style.width !== "" ) {
 100                         info.width = obj.style.width.replace("px","");
 101                 }
 102
 103                 if ( obj.style.height !== "" ) {
 104                         info.height = obj.style.height.replace("px","");
 105                 }
 106
 107                 while (obj) {
 108                         info.left += obj.offsetLeft;
 109                         info.top += obj.offsetTop;
 110                         obj = obj.offsetParent;
 111                 }
 112
 113                 return info;
 114         },
 115
 116         Client: function(elem) {
 117                 // constructor for new simple upload client
 118                 this.handlers = {};
 119
 120                 // unique ID
 121                 this.id = ZeroClipboard_TableTools.nextId++;
 122                 this.movieId = 'ZeroClipboard_TableToolsMovie_' + this.id;
 123
 124                 // register client with singleton to receive flash events
 125                 ZeroClipboard_TableTools.register(this.id, this);
 126
 127                 // create movie
 128                 if (elem) {
 129                         this.glue(elem);
 130                 }
 131         }
 132 };
 133
 134 ZeroClipboard_TableTools.Client.prototype = {
 135
 136         id: 0, // unique ID for us
 137         ready: false, // whether movie is ready to receive events or not
 138         movie: null, // reference to movie object
 139         clipText: '', // text to copy to clipboard
 140         fileName: '', // default file save name
 141         action: 'copy', // action to perform
 142         handCursorEnabled: true, // whether to show hand cursor, or default pointer cursor
 143         cssEffects: true, // enable CSS mouse effects on dom container
 144         handlers: null, // user event handlers
 145         sized: false,
 146
 147         glue: function(elem, title) {
 148                 // glue to DOM element
 149                 // elem can be ID or actual DOM element object
 150                 this.domElement = ZeroClipboard_TableTools.$(elem);
 151
 152                 // float just above object, or zIndex 99 if dom element isn't set
 153                 var zIndex = 99;
 154                 if (this.domElement.style.zIndex) {
 155                         zIndex = parseInt(this.domElement.style.zIndex, 10) + 1;
 156                 }
 157
 158                 // find X/Y position of domElement
 159                 var box = ZeroClipboard_TableTools.getDOMObjectPosition(this.domElement);
 160
 161                 // create floating DIV above element
 162                 this.div = document.createElement('div');
 163                 var style = this.div.style;
 164                 style.position = 'absolute';
 165                 style.left = '0px';
 166                 style.top = '0px';
 167                 style.width = (box.width) + 'px';
 168                 style.height = box.height + 'px';
 169                 style.zIndex = zIndex;
 170
 171                 if ( typeof title != "undefined" && title !== "" ) {
 172                         this.div.title = title;
 173                 }
 174                 if ( box.width !== 0 && box.height !== 0 ) {
 175                         this.sized = true;
 176                 }
 177
 178                 // style.backgroundColor = '#f00'; // debug
 179                 if ( this.domElement ) {
 180                         this.domElement.appendChild(this.div);
 181                         this.div.innerHTML = this.getHTML( box.width, box.height ).replace(/&/g, '&amp;');
 182                 }
 183         },
 184
 185         positionElement: function() {
 186                 var box = ZeroClipboard_TableTools.getDOMObjectPosition(this.domElement);
 187                 var style = this.div.style;
 188
 189                 style.position = 'absolute';
 190                 //style.left = (this.domElement.offsetLeft)+'px';
 191                 //style.top = this.domElement.offsetTop+'px';
 192                 style.width = box.width + 'px';
 193                 style.height = box.height + 'px';
 194
 195                 if ( box.width !== 0 && box.height !== 0 ) {
 196                         this.sized = true;
 197                 } else {
 198                         return;
 199                 }
 200
 201                 var flash = this.div.childNodes[0];
 202                 flash.width = box.width;
 203                 flash.height = box.height;
 204         },
 205
 206         getHTML: function(width, height) {
 207                 // return HTML for movie
 208                 var html = '';
 209                 var flashvars = 'id=' + this.id +
 210                         '&width=' + width +
 211                         '&height=' + height;
 212
 213                 if (navigator.userAgent.match(/MSIE/)) {
 214                         // IE gets an OBJECT tag
 215                         var protocol = location.href.match(/^https/i) ? 'https://' : 'http://';
 216                         html += '<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" codebase="'+protocol+'download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=10,0,0,0" width="'+width+'" height="'+height+'" id="'+this.movieId+'" align="middle"><param name="allowScriptAccess" value="always" /><param name="allowFullScreen" value="false" /><param name="movie" value="'+ZeroClipboard_TableTools.moviePath+'" /><param name="loop" value="false" /><param name="menu" value="false" /><param name="quality" value="best" /><param name="bgcolor" value="#ffffff" /><param name="flashvars" value="'+flashvars+'"/><param name="wmode" value="transparent"/></object>';
 217                 }
 218                 else {
 219                         // all other browsers get an EMBED tag
 220                         html += '<embed id="'+this.movieId+'" src="'+ZeroClipboard_TableTools.moviePath+'" loop="false" menu="false" quality="best" bgcolor="#ffffff" width="'+width+'" height="'+height+'" name="'+this.movieId+'" align="middle" allowScriptAccess="always" allowFullScreen="false" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer" flashvars="'+flashvars+'" wmode="transparent" />';
 221                 }
 222                 return html;
 223         },
 224
 225         hide: function() {
 226                 // temporarily hide floater offscreen
 227                 if (this.div) {
 228                         this.div.style.left = '-2000px';
 229                 }
 230         },
 231
 232         show: function() {
 233                 // show ourselves after a call to hide()
 234                 this.reposition();
 235         },
 236
 237         destroy: function() {
 238                 // destroy control and floater
 239                 if (this.domElement && this.div) {
 240                         this.hide();
 241                         this.div.innerHTML = '';
 242
 243                         var body = document.getElementsByTagName('body')[0];
 244                         try { body.removeChild( this.div ); } catch(e) {}
 245
 246                         this.domElement = null;
 247                         this.div = null;
 248                 }
 249         },
 250
 251         reposition: function(elem) {
 252                 // reposition our floating div, optionally to new container
 253                 // warning: container CANNOT change size, only position
 254                 if (elem) {
 255                         this.domElement = ZeroClipboard_TableTools.$(elem);
 256                         if (!this.domElement) {
 257                                 this.hide();
 258                         }
 259                 }
 260
 261                 if (this.domElement && this.div) {
 262                         var box = ZeroClipboard_TableTools.getDOMObjectPosition(this.domElement);
 263                         var style = this.div.style;
 264                         style.left = '' + box.left + 'px';
 265                         style.top = '' + box.top + 'px';
 266                 }
 267         },
 268
 269         clearText: function() {
 270                 // clear the text to be copy / saved
 271                 this.clipText = '';
 272                 if (this.ready) {
 273                         this.movie.clearText();
 274                 }
 275         },
 276
 277         appendText: function(newText) {
 278                 // append text to that which is to be copied / saved
 279                 this.clipText += newText;
 280                 if (this.ready) { this.movie.appendText(newText) ;}
 281         },
 282
 283         setText: function(newText) {
 284                 // set text to be copied to be copied / saved
 285                 this.clipText = newText;
 286                 if (this.ready) { this.movie.setText(newText) ;}
 287         },
 288
 289         setCharSet: function(charSet) {
 290                 // set the character set (UTF16LE or UTF8)
 291                 this.charSet = charSet;
 292                 if (this.ready) { this.movie.setCharSet(charSet) ;}
 293         },
 294
 295         setBomInc: function(bomInc) {
 296                 // set if the BOM should be included or not
 297                 this.incBom = bomInc;
 298                 if (this.ready) { this.movie.setBomInc(bomInc) ;}
 299         },
 300
 301         setFileName: function(newText) {
 302                 // set the file name
 303                 this.fileName = newText;
 304                 if (this.ready) {
 305                         this.movie.setFileName(newText);
 306                 }
 307         },
 308
 309         setAction: function(newText) {
 310                 // set action (save or copy)
 311                 this.action = newText;
 312                 if (this.ready) {
 313                         this.movie.setAction(newText);
 314                 }
 315         },
 316
 317         addEventListener: function(eventName, func) {
 318                 // add user event listener for event
 319                 // event types: load, queueStart, fileStart, fileComplete, queueComplete, progress, error, cancel
 320                 eventName = eventName.toString().toLowerCase().replace(/^on/, '');
 321                 if (!this.handlers[eventName]) {
 322                         this.handlers[eventName] = [];
 323                 }
 324                 this.handlers[eventName].push(func);
 325         },
 326
 327         setHandCursor: function(enabled) {
 328                 // enable hand cursor (true), or default arrow cursor (false)
 329                 this.handCursorEnabled = enabled;
 330                 if (this.ready) {
 331                         this.movie.setHandCursor(enabled);
 332                 }
 333         },
 334
 335         setCSSEffects: function(enabled) {
 336                 // enable or disable CSS effects on DOM container
 337                 this.cssEffects = !!enabled;
 338         },
 339
 340         receiveEvent: function(eventName, args) {
 341                 var self;
 342
 343                 // receive event from flash
 344                 eventName = eventName.toString().toLowerCase().replace(/^on/, '');
 345
 346                 // special behavior for certain events
 347                 switch (eventName) {
 348                         case 'load':
 349                                 // movie claims it is ready, but in IE this isn't always the case...
 350                                 // bug fix: Cannot extend EMBED DOM elements in Firefox, must use traditional function
 351                                 this.movie = document.getElementById(this.movieId);
 352                                 if (!this.movie) {
 353                                         self = this;
 354                                         setTimeout( function() { self.receiveEvent('load', null); }, 1 );
 355                                         return;
 356                                 }
 357
 358                                 // firefox on pc needs a "kick" in order to set these in certain cases
 359                                 if (!this.ready && navigator.userAgent.match(/Firefox/) && navigator.userAgent.match(/Windows/)) {
 360                                         self = this;
 361                                         setTimeout( function() { self.receiveEvent('load', null); }, 100 );
 362                                         this.ready = true;
 363                                         return;
 364                                 }
 365
 366                                 this.ready = true;
 367                                 this.movie.clearText();
 368                                 this.movie.appendText( this.clipText );
 369                                 this.movie.setFileName( this.fileName );
 370                                 this.movie.setAction( this.action );
 371                                 this.movie.setCharSet( this.charSet );
 372                                 this.movie.setBomInc( this.incBom );
 373                                 this.movie.setHandCursor( this.handCursorEnabled );
 374                                 break;
 375
 376                         case 'mouseover':
 377                                 if (this.domElement && this.cssEffects) {
 378                                         //this.domElement.addClass('hover');
 379                                         if (this.recoverActive) {
 380                                                 this.domElement.addClass('active');
 381                                         }
 382                                 }
 383                                 break;
 384
 385                         case 'mouseout':
 386                                 if (this.domElement && this.cssEffects) {
 387                                         this.recoverActive = false;
 388                                         if (this.domElement.hasClass('active')) {
 389                                                 this.domElement.removeClass('active');
 390                                                 this.recoverActive = true;
 391                                         }
 392                                         //this.domElement.removeClass('hover');
 393                                 }
 394                                 break;
 395
 396                         case 'mousedown':
 397                                 if (this.domElement && this.cssEffects) {
 398                                         this.domElement.addClass('active');
 399                                 }
 400                                 break;
 401
 402                         case 'mouseup':
 403                                 if (this.domElement && this.cssEffects) {
 404                                         this.domElement.removeClass('active');
 405                                         this.recoverActive = false;
 406                                 }
 407                                 break;
 408                 } // switch eventName
 409
 410                 if (this.handlers[eventName]) {
 411                         for (var idx = 0, len = this.handlers[eventName].length; idx < len; idx++) {
 412                                 var func = this.handlers[eventName][idx];
 413
 414                                 if (typeof(func) == 'function') {
 415                                         // actual function reference
 416                                         func(this, args);
 417                                 }
 418                                 else if ((typeof(func) == 'object') && (func.length == 2)) {
 419                                         // PHP style object + method, i.e. [myObject, 'myMethod']
 420                                         func[0][ func[1] ](this, args);
 421                                 }
 422                                 else if (typeof(func) == 'string') {
 423                                         // name of function
 424                                         window[func](this, args);
 425                                 }
 426                         } // foreach event handler defined
 427                 } // user defined handler for event
 428         }
 429
 430 };
 431
 432 // For the Flash binding to work, ZeroClipboard_TableTools must be on the global
 433 // object list
 434 window.ZeroClipboard_TableTools = ZeroClipboard_TableTools;
 435 //include TableTools.js
 436 /* TableTools
 437  * 2009-2015 SpryMedia Ltd - datatables.net/license
 438  */
 439
 440 /*globals TableTools,ZeroClipboard_TableTools*/
 441
 442
 443 (function($, window, document) {
 444
 445 /**
 446  * TableTools provides flexible buttons and other tools for a DataTables enhanced table
 447  * @class TableTools
 448  * @constructor
 449  * @param {Object} oDT DataTables instance. When using DataTables 1.10 this can
 450  *   also be a jQuery collection, jQuery selector, table node, DataTables API
 451  *   instance or DataTables settings object.
 452  * @param {Object} oOpts TableTools options
 453  * @param {String} oOpts.sSwfPath ZeroClipboard SWF path
 454  * @param {String} oOpts.sRowSelect Row selection options - 'none', 'single', 'multi' or 'os'
 455  * @param {Function} oOpts.fnPreRowSelect Callback function just prior to row selection
 456  * @param {Function} oOpts.fnRowSelected Callback function just after row selection
 457  * @param {Function} oOpts.fnRowDeselected Callback function when row is deselected
 458  * @param {Array} oOpts.aButtons List of buttons to be used
 459  */
 460 TableTools = function( oDT, oOpts )
 461 {
 462         /* Santiy check that we are a new instance */
 463         if ( ! this instanceof TableTools )
 464         {
 465                 alert( "Warning: TableTools must be initialised with the keyword 'new'" );
 466         }
 467
 468         // In 1.10 we can use the API to get the settings object from a number of
 469         // sources
 470         var dtSettings = $.fn.dataTable.Api ?
 471                 new $.fn.dataTable.Api( oDT ).settings()[0] :
 472                 oDT.fnSettings();
 473
 474
 475         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 476          * Public class variables
 477          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 478
 479         /**
 480          * @namespace Settings object which contains customisable information for TableTools instance
 481          */
 482         this.s = {
 483                 /**
 484                  * Store 'this' so the instance can be retrieved from the settings object
 485                  * @property that
 486                  * @type         object
 487                  * @default  this
 488                  */
 489                 "that": this,
 490
 491                 /**
 492                  * DataTables settings objects
 493                  * @property dt
 494                  * @type         object
 495                  * @default  <i>From the oDT init option</i>
 496                  */
 497                 "dt": dtSettings,
 498
 499                 /**
 500                  * @namespace Print specific information
 501                  */
 502                 "print": {
 503                         /**
 504                          * DataTables draw 'start' point before the printing display was shown
 505                          *  @property saveStart
 506                          *  @type        int
 507                          *  @default  -1
 508                          */
 509                         "saveStart": -1,
 510
 511                         /**
 512                          * DataTables draw 'length' point before the printing display was shown
 513                          *  @property saveLength
 514                          *  @type        int
 515                          *  @default  -1
 516                          */
 517                         "saveLength": -1,
 518
 519                         /**
 520                          * Page scrolling point before the printing display was shown so it can be restored
 521                          *  @property saveScroll
 522                          *  @type        int
 523                          *  @default  -1
 524                          */
 525                         "saveScroll": -1,
 526
 527                         /**
 528                          * Wrapped function to end the print display (to maintain scope)
 529                          *  @property funcEnd
 530                          *  @type        Function
 531                          *  @default  function () {}
 532                          */
 533                         "funcEnd": function () {}
 534                 },
 535
 536                 /**
 537                  * A unique ID is assigned to each button in each instance
 538                  * @property buttonCounter
 539                  *  @type        int
 540                  * @default  0
 541                  */
 542                 "buttonCounter": 0,
 543
 544                 /**
 545                  * @namespace Select rows specific information
 546                  */
 547                 "select": {
 548                         /**
 549                          * Select type - can be 'none', 'single' or 'multi'
 550                          * @property type
 551                          *  @type        string
 552                          * @default  ""
 553                          */
 554                         "type": "",
 555
 556                         /**
 557                          * Array of nodes which are currently selected
 558                          *  @property selected
 559                          *  @type        array
 560                          *  @default  []
 561                          */
 562                         "selected": [],
 563
 564                         /**
 565                          * Function to run before the selection can take place. Will cancel the select if the
 566                          * function returns false
 567                          *  @property preRowSelect
 568                          *  @type        Function
 569                          *  @default  null
 570                          */
 571                         "preRowSelect": null,
 572
 573                         /**
 574                          * Function to run when a row is selected
 575                          *  @property postSelected
 576                          *  @type        Function
 577                          *  @default  null
 578                          */
 579                         "postSelected": null,
 580
 581                         /**
 582                          * Function to run when a row is deselected
 583                          *  @property postDeselected
 584                          *  @type        Function
 585                          *  @default  null
 586                          */
 587                         "postDeselected": null,
 588
 589                         /**
 590                          * Indicate if all rows are selected (needed for server-side processing)
 591                          *  @property all
 592                          *  @type        boolean
 593                          *  @default  false
 594                          */
 595                         "all": false,
 596
 597                         /**
 598                          * Class name to add to selected TR nodes
 599                          *  @property selectedClass
 600                          *  @type        String
 601                          *  @default  ""
 602                          */
 603                         "selectedClass": ""
 604                 },
 605
 606                 /**
 607                  * Store of the user input customisation object
 608                  *  @property custom
 609                  *  @type        object
 610                  *  @default  {}
 611                  */
 612                 "custom": {},
 613
 614                 /**
 615                  * SWF movie path
 616                  *  @property swfPath
 617                  *  @type        string
 618                  *  @default  ""
 619                  */
 620                 "swfPath": "",
 621
 622                 /**
 623                  * Default button set
 624                  *  @property buttonSet
 625                  *  @type        array
 626                  *  @default  []
 627                  */
 628                 "buttonSet": [],
 629
 630                 /**
 631                  * When there is more than one TableTools instance for a DataTable, there must be a
 632                  * master which controls events (row selection etc)
 633                  *  @property master
 634                  *  @type        boolean
 635                  *  @default  false
 636                  */
 637                 "master": false,
 638
 639                 /**
 640                  * Tag names that are used for creating collections and buttons
 641                  *  @namesapce
 642                  */
 643                 "tags": {}
 644         };
 645
 646
 647         /**
 648          * @namespace Common and useful DOM elements for the class instance
 649          */
 650         this.dom = {
 651                 /**
 652                  * DIV element that is create and all TableTools buttons (and their children) put into
 653                  *  @property container
 654                  *  @type        node
 655                  *  @default  null
 656                  */
 657                 "container": null,
 658
 659                 /**
 660                  * The table node to which TableTools will be applied
 661                  *  @property table
 662                  *  @type        node
 663                  *  @default  null
 664                  */
 665                 "table": null,
 666
 667                 /**
 668                  * @namespace Nodes used for the print display
 669                  */
 670                 "print": {
 671                         /**
 672                          * Nodes which have been removed from the display by setting them to display none
 673                          *  @property hidden
 674                          *  @type        array
 675                          *  @default  []
 676                          */
 677                         "hidden": [],
 678
 679                         /**
 680                          * The information display saying telling the user about the print display
 681                          *  @property message
 682                          *  @type        node
 683                          *  @default  null
 684                          */
 685                         "message": null
 686           },
 687
 688                 /**
 689                  * @namespace Nodes used for a collection display. This contains the currently used collection
 690                  */
 691                 "collection": {
 692                         /**
 693                          * The div wrapper containing the buttons in the collection (i.e. the menu)
 694                          *  @property collection
 695                          *  @type        node
 696                          *  @default  null
 697                          */
 698                         "collection": null,
 699
 700                         /**
 701                          * Background display to provide focus and capture events
 702                          *  @property background
 703                          *  @type        node
 704                          *  @default  null
 705                          */
 706                         "background": null
 707                 }
 708         };
 709
 710         /**
 711          * @namespace Name space for the classes that this TableTools instance will use
 712          * @extends TableTools.classes
 713          */
 714         this.classes = $.extend( true, {}, TableTools.classes );
 715         if ( this.s.dt.bJUI )
 716         {
 717                 $.extend( true, this.classes, TableTools.classes_themeroller );
 718         }
 719
 720
 721         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 722          * Public class methods
 723          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 724
 725         /**
 726          * Retreieve the settings object from an instance
 727          *  @method fnSettings
 728          *  @returns {object} TableTools settings object
 729          */
 730         this.fnSettings = function () {
 731                 return this.s;
 732         };
 733
 734
 735         /* Constructor logic */
 736         if ( typeof oOpts == 'undefined' )
 737         {
 738                 oOpts = {};
 739         }
 740
 741
 742         TableTools._aInstances.push( this );
 743         this._fnConstruct( oOpts );
 744
 745         return this;
 746 };
 747
 748
 749
 750 TableTools.prototype = {
 751         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 752          * Public methods
 753          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 754
 755         /**
 756          * Retreieve the settings object from an instance
 757          *  @returns {array} List of TR nodes which are currently selected
 758          *  @param {boolean} [filtered=false] Get only selected rows which are
 759          *    available given the filtering applied to the table. By default
 760          *    this is false -  i.e. all rows, regardless of filtering are
 761               selected.
 762          */
 763         "fnGetSelected": function ( filtered )
 764         {
 765                 var
 766                         out = [],
 767                         data = this.s.dt.aoData,
 768                         displayed = this.s.dt.aiDisplay,
 769                         i, iLen;
 770
 771                 if ( filtered )
 772                 {
 773                         // Only consider filtered rows
 774                         for ( i=0, iLen=displayed.length ; i<iLen ; i++ )
 775                         {
 776                                 if ( data[ displayed[i] ]._DTTT_selected )
 777                                 {
 778                                         out.push( data[ displayed[i] ].nTr );
 779                                 }
 780                         }
 781                 }
 782                 else
 783                 {
 784                         // Use all rows
 785                         for ( i=0, iLen=data.length ; i<iLen ; i++ )
 786                         {
 787                                 if ( data[i]._DTTT_selected )
 788                                 {
 789                                         out.push( data[i].nTr );
 790                                 }
 791                         }
 792                 }
 793
 794                 return out;
 795         },
 796
 797
 798         /**
 799          * Get the data source objects/arrays from DataTables for the selected rows (same as
 800          * fnGetSelected followed by fnGetData on each row from the table)
 801          *  @returns {array} Data from the TR nodes which are currently selected
 802          */
 803         "fnGetSelectedData": function ()
 804         {
 805                 var out = [];
 806                 var data=this.s.dt.aoData;
 807                 var i, iLen;
 808
 809                 for ( i=0, iLen=data.length ; i<iLen ; i++ )
 810                 {
 811                         if ( data[i]._DTTT_selected )
 812                         {
 813                                 out.push( this.s.dt.oInstance.fnGetData(i) );
 814                         }
 815                 }
 816
 817                 return out;
 818         },
 819
 820
 821         /**
 822          * Get the indexes of the selected rows
 823          *  @returns {array} List of row indexes
 824          *  @param {boolean} [filtered=false] Get only selected rows which are
 825          *    available given the filtering applied to the table. By default
 826          *    this is false -  i.e. all rows, regardless of filtering are
 827               selected.
 828          */
 829         "fnGetSelectedIndexes": function ( filtered )
 830         {
 831                 var
 832                         out = [],
 833                         data = this.s.dt.aoData,
 834                         displayed = this.s.dt.aiDisplay,
 835                         i, iLen;
 836
 837                 if ( filtered )
 838                 {
 839                         // Only consider filtered rows
 840                         for ( i=0, iLen=displayed.length ; i<iLen ; i++ )
 841                         {
 842                                 if ( data[ displayed[i] ]._DTTT_selected )
 843                                 {
 844                                         out.push( displayed[i] );
 845                                 }
 846                         }
 847                 }
 848                 else
 849                 {
 850                         // Use all rows
 851                         for ( i=0, iLen=data.length ; i<iLen ; i++ )
 852                         {
 853                                 if ( data[i]._DTTT_selected )
 854                                 {
 855                                         out.push( i );
 856                                 }
 857                         }
 858                 }
 859
 860                 return out;
 861         },
 862
 863
 864         /**
 865          * Check to see if a current row is selected or not
 866          *  @param {Node} n TR node to check if it is currently selected or not
 867          *  @returns {Boolean} true if select, false otherwise
 868          */
 869         "fnIsSelected": function ( n )
 870         {
 871                 var pos = this.s.dt.oInstance.fnGetPosition( n );
 872                 return (this.s.dt.aoData[pos]._DTTT_selected===true) ? true : false;
 873         },
 874
 875
 876         /**
 877          * Select all rows in the table
 878          *  @param {boolean} [filtered=false] Select only rows which are available
 879          *    given the filtering applied to the table. By default this is false -
 880          *    i.e. all rows, regardless of filtering are selected.
 881          */
 882         "fnSelectAll": function ( filtered )
 883         {
 884                 this._fnRowSelect( filtered ?
 885                         this.s.dt.aiDisplay :
 886                         this.s.dt.aoData
 887                 );
 888         },
 889
 890
 891         /**
 892          * Deselect all rows in the table
 893          *  @param {boolean} [filtered=false] Deselect only rows which are available
 894          *    given the filtering applied to the table. By default this is false -
 895          *    i.e. all rows, regardless of filtering are deselected.
 896          */
 897         "fnSelectNone": function ( filtered )
 898         {
 899                 this._fnRowDeselect( this.fnGetSelectedIndexes(filtered) );
 900         },
 901
 902
 903         /**
 904          * Select row(s)
 905          *  @param {node|object|array} n The row(s) to select. Can be a single DOM
 906          *    TR node, an array of TR nodes or a jQuery object.
 907          */
 908         "fnSelect": function ( n )
 909         {
 910                 if ( this.s.select.type == "single" )
 911                 {
 912                         this.fnSelectNone();
 913                         this._fnRowSelect( n );
 914                 }
 915                 else
 916                 {
 917                         this._fnRowSelect( n );
 918                 }
 919         },
 920
 921
 922         /**
 923          * Deselect row(s)
 924          *  @param {node|object|array} n The row(s) to deselect. Can be a single DOM
 925          *    TR node, an array of TR nodes or a jQuery object.
 926          */
 927         "fnDeselect": function ( n )
 928         {
 929                 this._fnRowDeselect( n );
 930         },
 931
 932
 933         /**
 934          * Get the title of the document - useful for file names. The title is retrieved from either
 935          * the configuration object's 'title' parameter, or the HTML document title
 936          *  @param   {Object} oConfig Button configuration object
 937          *  @returns {String} Button title
 938          */
 939         "fnGetTitle": function( oConfig )
 940         {
 941                 var sTitle = "";
 942                 if ( typeof oConfig.sTitle != 'undefined' && oConfig.sTitle !== "" ) {
 943                         sTitle = oConfig.sTitle;
 944                 } else {
 945                         var anTitle = document.getElementsByTagName('title');
 946                         if ( anTitle.length > 0 )
 947                         {
 948                                 sTitle = anTitle[0].innerHTML;
 949                         }
 950                 }
 951
 952                 /* Strip characters which the OS will object to - checking for UTF8 support in the scripting
 953                  * engine
 954                  */
 955                 if ( "\u00A1".toString().length < 4 ) {
 956                         return sTitle.replace(/[^a-zA-Z0-9_\u00A1-\uFFFF\.,\-_ !\(\)]/g, "");
 957                 } else {
 958                         return sTitle.replace(/[^a-zA-Z0-9_\.,\-_ !\(\)]/g, "");
 959                 }
 960         },
 961
 962
 963         /**
 964          * Calculate a unity array with the column width by proportion for a set of columns to be
 965          * included for a button. This is particularly useful for PDF creation, where we can use the
 966          * column widths calculated by the browser to size the columns in the PDF.
 967          *  @param   {Object} oConfig Button configuration object
 968          *  @returns {Array} Unity array of column ratios
 969          */
 970         "fnCalcColRatios": function ( oConfig )
 971         {
 972                 var
 973                         aoCols = this.s.dt.aoColumns,
 974                         aColumnsInc = this._fnColumnTargets( oConfig.mColumns ),
 975                         aColWidths = [],
 976                         iWidth = 0, iTotal = 0, i, iLen;
 977
 978                 for ( i=0, iLen=aColumnsInc.length ; i<iLen ; i++ )
 979                 {
 980                         if ( aColumnsInc[i] )
 981                         {
 982                                 iWidth = aoCols[i].nTh.offsetWidth;
 983                                 iTotal += iWidth;
 984                                 aColWidths.push( iWidth );
 985                         }
 986                 }
 987
 988                 for ( i=0, iLen=aColWidths.length ; i<iLen ; i++ )
 989                 {
 990                         aColWidths[i] = aColWidths[i] / iTotal;
 991                 }
 992
 993                 return aColWidths.join('\t');
 994         },
 995
 996
 997         /**
 998          * Get the information contained in a table as a string
 999          *  @param   {Object} oConfig Button configuration object
1000          *  @returns {String} Table data as a string
1001          */
1002         "fnGetTableData": function ( oConfig )
1003         {
1004                 /* In future this could be used to get data from a plain HTML source as well as DataTables */
1005                 if ( this.s.dt )
1006                 {
1007                         return this._fnGetDataTablesData( oConfig );
1008                 }
1009         },
1010
1011
1012         /**
1013          * Pass text to a flash button instance, which will be used on the button's click handler
1014          *  @param   {Object} clip Flash button object
1015          *  @param   {String} text Text to set
1016          */
1017         "fnSetText": function ( clip, text )
1018         {
1019                 this._fnFlashSetText( clip, text );
1020         },
1021
1022
1023         /**
1024          * Resize the flash elements of the buttons attached to this TableTools instance - this is
1025          * useful for when initialising TableTools when it is hidden (display:none) since sizes can't
1026          * be calculated at that time.
1027          */
1028         "fnResizeButtons": function ()
1029         {
1030                 for ( var cli in ZeroClipboard_TableTools.clients )
1031                 {
1032                         if ( cli )
1033                         {
1034                                 var client = ZeroClipboard_TableTools.clients[cli];
1035                                 if ( typeof client.domElement != 'undefined' &&
1036                                          client.domElement.parentNode )
1037                                 {
1038                                         client.positionElement();
1039                                 }
1040                         }
1041                 }
1042         },
1043
1044
1045         /**
1046          * Check to see if any of the ZeroClipboard client's attached need to be resized
1047          */
1048         "fnResizeRequired": function ()
1049         {
1050                 for ( var cli in ZeroClipboard_TableTools.clients )
1051                 {
1052                         if ( cli )
1053                         {
1054                                 var client = ZeroClipboard_TableTools.clients[cli];
1055                                 if ( typeof client.domElement != 'undefined' &&
1056                                          client.domElement.parentNode == this.dom.container &&
1057                                          client.sized === false )
1058                                 {
1059                                         return true;
1060                                 }
1061                         }
1062                 }
1063                 return false;
1064         },
1065
1066
1067         /**
1068          * Programmatically enable or disable the print view
1069          *  @param {boolean} [bView=true] Show the print view if true or not given. If false, then
1070          *    terminate the print view and return to normal.
1071          *  @param {object} [oConfig={}] Configuration for the print view
1072          *  @param {boolean} [oConfig.bShowAll=false] Show all rows in the table if true
1073          *  @param {string} [oConfig.sInfo] Information message, displayed as an overlay to the
1074          *    user to let them know what the print view is.
1075          *  @param {string} [oConfig.sMessage] HTML string to show at the top of the document - will
1076          *    be included in the printed document.
1077          */
1078         "fnPrint": function ( bView, oConfig )
1079         {
1080                 if ( oConfig === undefined )
1081                 {
1082                         oConfig = {};
1083                 }
1084
1085                 if ( bView === undefined || bView )
1086                 {
1087                         this._fnPrintStart( oConfig );
1088                 }
1089                 else
1090                 {
1091                         this._fnPrintEnd();
1092                 }
1093         },
1094
1095
1096         /**
1097          * Show a message to the end user which is nicely styled
1098          *  @param {string} message The HTML string to show to the user
1099          *  @param {int} time The duration the message is to be shown on screen for (mS)
1100          */
1101         "fnInfo": function ( message, time ) {
1102                 var info = $('<div/>')
1103                         .addClass( this.classes.print.info )
1104                         .html( message )
1105                         .appendTo( 'body' );
1106
1107                 setTimeout( function() {
1108                         info.fadeOut( "normal", function() {
1109                                 info.remove();
1110                         } );
1111                 }, time );
1112         },
1113
1114
1115
1116         /**
1117          * Get the container element of the instance for attaching to the DOM
1118          *   @returns {node} DOM node
1119          */
1120         "fnContainer": function () {
1121                 return this.dom.container;
1122         },
1123
1124
1125
1126         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
1127          * Private methods (they are of course public in JS, but recommended as private)
1128          * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
1129
1130         /**
1131          * Constructor logic
1132          *  @method  _fnConstruct
1133          *  @param   {Object} oOpts Same as TableTools constructor
1134          *  @returns void
1135          *  @private
1136          */
1137         "_fnConstruct": function ( oOpts )
1138         {
1139                 var that = this;
1140
1141                 this._fnCustomiseSettings( oOpts );
1142
1143                 /* Container element */
1144                 this.dom.container = document.createElement( this.s.tags.container );
1145                 this.dom.container.className = this.classes.container;
1146
1147                 /* Row selection config */
1148                 if ( this.s.select.type != 'none' )
1149                 {
1150                         this._fnRowSelectConfig();
1151                 }
1152
1153                 /* Buttons */
1154                 this._fnButtonDefinations( this.s.buttonSet, this.dom.container );
1155
1156                 /* Destructor */
1157                 this.s.dt.aoDestroyCallback.push( {
1158                         "sName": "TableTools",
1159                         "fn": function () {
1160                                 $(that.s.dt.nTBody)
1161                                         .off( 'click.DTTT_Select', that.s.custom.sRowSelector )
1162                                         .off( 'mousedown.DTTT_Select', 'tr' )
1163                                         .off( 'mouseup.DTTT_Select', 'tr' );
1164
1165                                 $(that.dom.container).empty();
1166
1167                                 // Remove the instance
1168                                 var idx = $.inArray( that, TableTools._aInstances );
1169                                 if ( idx !== -1 ) {
1170                                         TableTools._aInstances.splice( idx, 1 );
1171                                 }
1172                         }
1173                 } );
1174         },
1175
1176
1177         /**
1178          * Take the user defined settings and the default settings and combine them.
1179          *  @method  _fnCustomiseSettings
1180          *  @param   {Object} oOpts Same as TableTools constructor
1181          *  @returns void
1182          *  @private
1183          */
1184         "_fnCustomiseSettings": function ( oOpts )
1185         {
1186                 /* Is this the master control instance or not? */
1187                 if ( typeof this.s.dt._TableToolsInit == 'undefined' )
1188                 {
1189                         this.s.master = true;
1190                         this.s.dt._TableToolsInit = true;
1191                 }
1192
1193                 /* We can use the table node from comparisons to group controls */
1194                 this.dom.table = this.s.dt.nTable;
1195
1196                 /* Clone the defaults and then the user options */
1197                 this.s.custom = $.extend( {}, TableTools.DEFAULTS, oOpts );
1198
1199                 /* Flash file location */
1200                 this.s.swfPath = this.s.custom.sSwfPath;
1201                 if ( typeof ZeroClipboard_TableTools != 'undefined' )
1202                 {
1203                         ZeroClipboard_TableTools.moviePath = this.s.swfPath;
1204                 }
1205
1206                 /* Table row selecting */
1207                 this.s.select.type = this.s.custom.sRowSelect;
1208                 this.s.select.preRowSelect = this.s.custom.fnPreRowSelect;
1209                 this.s.select.postSelected = this.s.custom.fnRowSelected;
1210                 this.s.select.postDeselected = this.s.custom.fnRowDeselected;
1211
1212                 // Backwards compatibility - allow the user to specify a custom class in the initialiser
1213                 if ( this.s.custom.sSelectedClass )
1214                 {
1215                         this.classes.select.row = this.s.custom.sSelectedClass;
1216                 }
1217
1218                 this.s.tags = this.s.custom.oTags;
1219
1220                 /* Button set */
1221                 this.s.buttonSet = this.s.custom.aButtons;
1222         },
1223
1224
1225         /**
1226          * Take the user input arrays and expand them to be fully defined, and then add them to a given
1227          * DOM element
1228          *  @method  _fnButtonDefinations
1229          *  @param {array} buttonSet Set of user defined buttons
1230          *  @param {node} wrapper Node to add the created buttons to
1231          *  @returns void
1232          *  @private
1233          */
1234         "_fnButtonDefinations": function ( buttonSet, wrapper )
1235         {
1236                 var buttonDef;
1237
1238                 for ( var i=0, iLen=buttonSet.length ; i<iLen ; i++ )
1239                 {
1240                         if ( typeof buttonSet[i] == "string" )
1241                         {
1242                                 if ( typeof TableTools.BUTTONS[ buttonSet[i] ] == 'undefined' )
1243                                 {
1244                                         alert( "TableTools: Warning - unknown button type: "+buttonSet[i] );
1245                                         continue;
1246                                 }
1247                                 buttonDef = $.extend( {}, TableTools.BUTTONS[ buttonSet[i] ], true );
1248                         }
1249                         else
1250                         {
1251                                 if ( typeof TableTools.BUTTONS[ buttonSet[i].sExtends ] == 'undefined' )
1252                                 {
1253                                         alert( "TableTools: Warning - unknown button type: "+buttonSet[i].sExtends );
1254                                         continue;
1255                                 }
1256                                 var o = $.extend( {}, TableTools.BUTTONS[ buttonSet[i].sExtends ], true );
1257                                 buttonDef = $.extend( o, buttonSet[i], true );
1258                         }
1259
1260                         var button = this._fnCreateButton(
1261                                 buttonDef,
1262                                 $(wrapper).hasClass(this.classes.collection.container)
1263                         );
1264
1265                         if ( button ) {
1266                                 wrapper.appendChild( button );
1267                         }
1268                 }
1269         },
1270
1271
1272         /**
1273          * Create and configure a TableTools button
1274          *  @method  _fnCreateButton
1275          *  @param   {Object} oConfig Button configuration object
1276          *  @returns {Node} Button element
1277          *  @private
1278          */
1279         "_fnCreateButton": function ( oConfig, bCollectionButton )
1280         {
1281           var nButton = this._fnButtonBase( oConfig, bCollectionButton );
1282
1283                 if ( oConfig.sAction.match(/flash/) )
1284                 {
1285                         if ( ! this._fnHasFlash() ) {
1286                                 return false;
1287                         }
1288
1289                         this._fnFlashConfig( nButton, oConfig );
1290                 }
1291                 else if ( oConfig.sAction == "text" )
1292                 {
1293                         this._fnTextConfig( nButton, oConfig );
1294                 }
1295                 else if ( oConfig.sAction == "div" )
1296                 {
1297                         this._fnTextConfig( nButton, oConfig );
1298                 }
1299                 else if ( oConfig.sAction == "collection" )
1300                 {
1301                         this._fnTextConfig( nButton, oConfig );
1302                         this._fnCollectionConfig( nButton, oConfig );
1303                 }
1304
1305                 if ( this.s.dt.iTabIndex !== -1 ) {
1306                         $(nButton)
1307                                 .attr( 'tabindex', this.s.dt.iTabIndex )
1308                                 .attr( 'aria-controls', this.s.dt.sTableId )
1309                                 .on( 'keyup.DTTT', function (e) {
1310                                         // Trigger the click event on return key when focused.
1311                                         // Note that for Flash buttons this has no effect since we
1312                                         // can't programmatically trigger the Flash export
1313                                         if ( e.keyCode === 13 ) {
1314                                                 e.stopPropagation();
1315
1316                                                 $(this).trigger( 'click' );
1317                                         }
1318                                 } )
1319                                 .on( 'mousedown.DTTT', function (e) {
1320                                         // On mousedown we want to stop the focus occurring on the
1321                                         // button, focus is used only for the keyboard navigation.
1322                                         // But using preventDefault for the flash buttons stops the
1323                                         // flash action. However, it is not the button that gets
1324                                         // focused but the flash element for flash buttons, so this
1325                                         // works
1326                                         if ( ! oConfig.sAction.match(/flash/) ) {
1327                                                 e.preventDefault();
1328                                         }
1329                                 } );
1330                 }
1331
1332                 return nButton;
1333         },
1334
1335
1336         /**
1337          * Create the DOM needed for the button and apply some base properties. All buttons start here
1338          *  @method  _fnButtonBase
1339          *  @param   {o} oConfig Button configuration object
1340          *  @returns {Node} DIV element for the button
1341          *  @private
1342          */
1343         "_fnButtonBase": function ( o, bCollectionButton )
1344         {
1345                 var sTag, sLiner, sClass;
1346
1347                 if ( bCollectionButton )
1348                 {
1349                         sTag = o.sTag && o.sTag !== "default" ? o.sTag : this.s.tags.collection.button;
1350                         sLiner = o.sLinerTag && o.sLinerTag !== "default" ? o.sLiner : this.s.tags.collection.liner;
1351                         sClass = this.classes.collection.buttons.normal;
1352                 }
1353                 else
1354                 {
1355                         sTag = o.sTag && o.sTag !== "default" ? o.sTag : this.s.tags.button;
1356                         sLiner = o.sLinerTag && o.sLinerTag !== "default" ? o.sLiner : this.s.tags.liner;
1357                         sClass = this.classes.buttons.normal;
1358                 }
1359
1360                 var
1361                   nButton = document.createElement( sTag ),
1362                   nSpan = document.createElement( sLiner ),
1363                   masterS = this._fnGetMasterSettings();
1364
1365                 nButton.className = sClass+" "+o.sButtonClass;
1366                 nButton.setAttribute('id', "ToolTables_"+this.s.dt.sInstance+"_"+masterS.buttonCounter );
1367                 nButton.appendChild( nSpan );
1368                 nSpan.innerHTML = o.sButtonText;
1369
1370                 masterS.buttonCounter++;
1371
1372                 return nButton;
1373         },
1374
1375
1376         /**
1377          * Get the settings object for the master instance. When more than one TableTools instance is
1378          * assigned to a DataTable, only one of them can be the 'master' (for the select rows). As such,
1379          * we will typically want to interact with that master for global properties.
1380          *  @method  _fnGetMasterSettings
1381          *  @returns {Object} TableTools settings object
1382          *  @private
1383          */
1384         "_fnGetMasterSettings": function ()
1385         {
1386                 if ( this.s.master )
1387                 {
1388                         return this.s;
1389                 }
1390                 else
1391                 {
1392                         /* Look for the master which has the same DT as this one */
1393                         var instances = TableTools._aInstances;
1394                         for ( var i=0, iLen=instances.length ; i<iLen ; i++ )
1395                         {
1396                                 if ( this.dom.table == instances[i].s.dt.nTable )
1397                                 {
1398                                         return instances[i].s;
1399                                 }
1400                         }
1401                 }
1402         },
1403
1404
1405
1406         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
1407          * Button collection functions
1408          */
1409
1410         /**
1411          * Create a collection button, when activated will present a drop down list of other buttons
1412          *  @param   {Node} nButton Button to use for the collection activation
1413          *  @param   {Object} oConfig Button configuration object
1414          *  @returns void
1415          *  @private
1416          */
1417         "_fnCollectionConfig": function ( nButton, oConfig )
1418         {
1419                 var nHidden = document.createElement( this.s.tags.collection.container );
1420                 nHidden.style.display = "none";
1421                 nHidden.className = this.classes.collection.container;
1422                 oConfig._collection = nHidden;
1423                 document.body.appendChild( nHidden );
1424
1425                 this._fnButtonDefinations( oConfig.aButtons, nHidden );
1426         },
1427
1428
1429         /**
1430          * Show a button collection
1431          *  @param   {Node} nButton Button to use for the collection
1432          *  @param   {Object} oConfig Button configuration object
1433          *  @returns void
1434          *  @private
1435          */
1436         "_fnCollectionShow": function ( nButton, oConfig )
1437         {
1438                 var
1439                         that = this,
1440                         oPos = $(nButton).offset(),
1441                         nHidden = oConfig._collection,
1442                         iDivX = oPos.left,
1443                         iDivY = oPos.top + $(nButton).outerHeight(),
1444                         iWinHeight = $(window).height(), iDocHeight = $(document).height(),
1445                         iWinWidth = $(window).width(), iDocWidth = $(document).width();
1446
1447                 nHidden.style.position = "absolute";
1448                 nHidden.style.left = iDivX+"px";
1449                 nHidden.style.top = iDivY+"px";
1450                 nHidden.style.display = "block";
1451                 $(nHidden).css('opacity',0);
1452
1453                 var nBackground = document.createElement('div');
1454                 nBackground.style.position = "absolute";
1455                 nBackground.style.left = "0px";
1456                 nBackground.style.top = "0px";
1457                 nBackground.style.height = ((iWinHeight>iDocHeight)? iWinHeight : iDocHeight) +"px";
1458                 nBackground.style.width = ((iWinWidth>iDocWidth)? iWinWidth : iDocWidth) +"px";
1459                 nBackground.className = this.classes.collection.background;
1460                 $(nBackground).css('opacity',0);
1461
1462                 document.body.appendChild( nBackground );
1463                 document.body.appendChild( nHidden );
1464
1465                 /* Visual corrections to try and keep the collection visible */
1466                 var iDivWidth = $(nHidden).outerWidth();
1467                 var iDivHeight = $(nHidden).outerHeight();
1468
1469                 if ( iDivX + iDivWidth > iDocWidth )
1470                 {
1471                         nHidden.style.left = (iDocWidth-iDivWidth)+"px";
1472                 }
1473
1474                 if ( iDivY + iDivHeight > iDocHeight )
1475                 {
1476                         nHidden.style.top = (iDivY-iDivHeight-$(nButton).outerHeight())+"px";
1477                 }
1478
1479                 this.dom.collection.collection = nHidden;
1480                 this.dom.collection.background = nBackground;
1481
1482                 /* This results in a very small delay for the end user but it allows the animation to be
1483                  * much smoother. If you don't want the animation, then the setTimeout can be removed
1484                  */
1485                 setTimeout( function () {
1486                         $(nHidden).animate({"opacity": 1}, 500);
1487                         $(nBackground).animate({"opacity": 0.25}, 500);
1488                 }, 10 );
1489
1490                 /* Resize the buttons to the Flash contents fit */
1491                 this.fnResizeButtons();
1492
1493                 /* Event handler to remove the collection display */
1494                 $(nBackground).click( function () {
1495                         that._fnCollectionHide.call( that, null, null );
1496                 } );
1497         },
1498
1499
1500         /**
1501          * Hide a button collection
1502          *  @param   {Node} nButton Button to use for the collection
1503          *  @param   {Object} oConfig Button configuration object
1504          *  @returns void
1505          *  @private
1506          */
1507         "_fnCollectionHide": function ( nButton, oConfig )
1508         {
1509                 if ( oConfig !== null && oConfig.sExtends == 'collection' )
1510                 {
1511                         return;
1512                 }
1513
1514                 if ( this.dom.collection.collection !== null )
1515                 {
1516                         $(this.dom.collection.collection).animate({"opacity": 0}, 500, function (e) {
1517                                 this.style.display = "none";
1518                         } );
1519
1520                         $(this.dom.collection.background).animate({"opacity": 0}, 500, function (e) {
1521                                 this.parentNode.removeChild( this );
1522                         } );
1523
1524                         this.dom.collection.collection = null;
1525                         this.dom.collection.background = null;
1526                 }
1527         },
1528
1529
1530
1531         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
1532          * Row selection functions
1533          */
1534
1535         /**
1536          * Add event handlers to a table to allow for row selection
1537          *  @method  _fnRowSelectConfig
1538          *  @returns void
1539          *  @private
1540          */
1541         "_fnRowSelectConfig": function ()
1542         {
1543                 if ( this.s.master )
1544                 {
1545                         var
1546                                 that = this,
1547                                 i, iLen,
1548                                 dt = this.s.dt,
1549                                 aoOpenRows = this.s.dt.aoOpenRows;
1550
1551                         $(dt.nTable).addClass( this.classes.select.table );
1552
1553                         // When using OS style selection, we want to cancel the shift text
1554                         // selection, but only when the shift key is used (so you can
1555                         // actually still select text in the table)
1556                         if ( this.s.select.type === 'os' ) {
1557                                 $(dt.nTBody).on( 'mousedown.DTTT_Select', 'tr', function(e) {
1558                                         if ( e.shiftKey ) {
1559
1560                                                 $(dt.nTBody)
1561                                                         .css( '-moz-user-select', 'none' )
1562                                                         .one('selectstart.DTTT_Select', 'tr', function () {
1563                                                                 return false;
1564                                                         } );
1565                                         }
1566                                 } );
1567
1568                                 $(dt.nTBody).on( 'mouseup.DTTT_Select', 'tr', function(e) {
1569                                         $(dt.nTBody).css( '-moz-user-select', '' );
1570                                 } );
1571                         }
1572
1573                         // Row selection
1574                         $(dt.nTBody).on( 'click.DTTT_Select', this.s.custom.sRowSelector, function(e) {
1575                                 var row = this.nodeName.toLowerCase() === 'tr' ?
1576                                         this :
1577                                         $(this).parents('tr')[0];
1578
1579                                 var select = that.s.select;
1580                                 var pos = that.s.dt.oInstance.fnGetPosition( row );
1581
1582                                 /* Sub-table must be ignored (odd that the selector won't do this with >) */
1583                                 if ( row.parentNode != dt.nTBody ) {
1584                                         return;
1585                                 }
1586
1587                                 /* Check that we are actually working with a DataTables controlled row */
1588                                 if ( dt.oInstance.fnGetData(row) === null ) {
1589                                     return;
1590                                 }
1591
1592                                 // Shift click, ctrl click and simple click handling to make
1593                                 // row selection a lot like a file system in desktop OSs
1594                                 if ( select.type == 'os' ) {
1595                                         if ( e.ctrlKey || e.metaKey ) {
1596                                                 // Add or remove from the selection
1597                                                 if ( that.fnIsSelected( row ) ) {
1598                                                         that._fnRowDeselect( row, e );
1599                                                 }
1600                                                 else {
1601                                                         that._fnRowSelect( row, e );
1602                                                 }
1603                                         }
1604                                         else if ( e.shiftKey ) {
1605                                                 // Add a range of rows, from the last selected row to
1606                                                 // this one
1607                                                 var rowIdxs = that.s.dt.aiDisplay.slice(); // visible rows
1608                                                 var idx1 = $.inArray( select.lastRow, rowIdxs );
1609                                                 var idx2 = $.inArray( pos, rowIdxs );
1610
1611                                                 if ( that.fnGetSelected().length === 0 || idx1 === -1 ) {
1612                                                         // select from top to here - slightly odd, but both
1613                                                         // Windows and Mac OS do this
1614                                                         rowIdxs.splice( $.inArray( pos, rowIdxs )+1, rowIdxs.length );
1615                                                 }
1616                                                 else {
1617                                                         // reverse so we can shift click 'up' as well as down
1618                                                         if ( idx1 > idx2 ) {
1619                                                                 var tmp = idx2;
1620                                                                 idx2 = idx1;
1621                                                                 idx1 = tmp;
1622                                                         }
1623
1624                                                         rowIdxs.splice( idx2+1, rowIdxs.length );
1625                                                         rowIdxs.splice( 0, idx1 );
1626                                                 }
1627
1628                                                 if ( ! that.fnIsSelected( row ) ) {
1629                                                         // Select range
1630                                                         that._fnRowSelect( rowIdxs, e );
1631                                                 }
1632                                                 else {
1633                                                         // Deselect range - need to keep the clicked on row selected
1634                                                         rowIdxs.splice( $.inArray( pos, rowIdxs ), 1 );
1635                                                         that._fnRowDeselect( rowIdxs, e );
1636                                                 }
1637                                         }
1638                                         else {
1639                                                 // No cmd or shift click. Deselect current if selected,
1640                                                 // or select this row only
1641                                                 if ( that.fnIsSelected( row ) && that.fnGetSelected().length === 1 ) {
1642                                                         that._fnRowDeselect( row, e );
1643                                                 }
1644                                                 else {
1645                                                         that.fnSelectNone();
1646                                                         that._fnRowSelect( row, e );
1647                                                 }
1648                                         }
1649                                 }
1650                                 else if ( that.fnIsSelected( row ) ) {
1651                                         that._fnRowDeselect( row, e );
1652                                 }
1653                                 else if ( select.type == "single" ) {
1654                                         that.fnSelectNone();
1655                                         that._fnRowSelect( row, e );
1656                                 }
1657                                 else if ( select.type == "multi" ) {
1658                                         that._fnRowSelect( row, e );
1659                                 }
1660
1661                                 select.lastRow = pos;
1662                         } );//.on('selectstart', function () { return false; } );
1663
1664                         // Bind a listener to the DataTable for when new rows are created.
1665                         // This allows rows to be visually selected when they should be and
1666                         // deferred rendering is used.
1667                         dt.oApi._fnCallbackReg( dt, 'aoRowCreatedCallback', function (tr, data, index) {
1668                                 if ( dt.aoData[index]._DTTT_selected ) {
1669                                         $(tr).addClass( that.classes.select.row );
1670                                 }
1671                         }, 'TableTools-SelectAll' );
1672                 }
1673         },
1674
1675         /**
1676          * Select rows
1677          *  @param   {*} src Rows to select - see _fnSelectData for a description of valid inputs
1678          *  @private
1679          */
1680         "_fnRowSelect": function ( src, e )
1681         {
1682                 var
1683                         that = this,
1684                         data = this._fnSelectData( src ),
1685                         firstTr = data.length===0 ? null : data[0].nTr,
1686                         anSelected = [],
1687                         i, len;
1688
1689                 // Get all the rows that will be selected
1690                 for ( i=0, len=data.length ; i<len ; i++ )
1691                 {
1692                         if ( data[i].nTr )
1693                         {
1694                                 anSelected.push( data[i].nTr );
1695                         }
1696                 }
1697
1698                 // User defined pre-selection function
1699                 if ( this.s.select.preRowSelect !== null && !this.s.select.preRowSelect.call(this, e, anSelected, true) )
1700                 {
1701                         return;
1702                 }
1703
1704                 // Mark them as selected
1705                 for ( i=0, len=data.length ; i<len ; i++ )
1706                 {
1707                         data[i]._DTTT_selected = true;
1708
1709                         if ( data[i].nTr )
1710                         {
1711                                 $(data[i].nTr).addClass( that.classes.select.row );
1712                         }
1713                 }
1714
1715                 // Post-selection function
1716                 if ( this.s.select.postSelected !== null )
1717                 {
1718                         this.s.select.postSelected.call( this, anSelected );
1719                 }
1720
1721                 TableTools._fnEventDispatch( this, 'select', anSelected, true );
1722         },
1723
1724         /**
1725          * Deselect rows
1726          *  @param   {*} src Rows to deselect - see _fnSelectData for a description of valid inputs
1727          *  @private
1728          */
1729         "_fnRowDeselect": function ( src, e )
1730         {
1731                 var
1732                         that = this,
1733                         data = this._fnSelectData( src ),
1734                         firstTr = data.length===0 ? null : data[0].nTr,
1735                         anDeselectedTrs = [],
1736                         i, len;
1737
1738                 // Get all the rows that will be deselected
1739                 for ( i=0, len=data.length ; i<len ; i++ )
1740                 {
1741                         if ( data[i].nTr )
1742                         {
1743                                 anDeselectedTrs.push( data[i].nTr );
1744                         }
1745                 }
1746
1747                 // User defined pre-selection function
1748                 if ( this.s.select.preRowSelect !== null && !this.s.select.preRowSelect.call(this, e, anDeselectedTrs, false) )
1749                 {
1750                         return;
1751                 }
1752
1753                 // Mark them as deselected
1754                 for ( i=0, len=data.length ; i<len ; i++ )
1755                 {
1756                         data[i]._DTTT_selected = false;
1757
1758                         if ( data[i].nTr )
1759                         {
1760                                 $(data[i].nTr).removeClass( that.classes.select.row );
1761                         }
1762                 }
1763
1764                 // Post-deselection function
1765                 if ( this.s.select.postDeselected !== null )
1766                 {
1767                         this.s.select.postDeselected.call( this, anDeselectedTrs );
1768                 }
1769
1770                 TableTools._fnEventDispatch( this, 'select', anDeselectedTrs, false );
1771         },
1772
1773         /**
1774          * Take a data source for row selection and convert it into aoData points for the DT
1775          *   @param {*} src Can be a single DOM TR node, an array of TR nodes (including a
1776          *     a jQuery object), a single aoData point from DataTables, an array of aoData
1777          *     points or an array of aoData indexes
1778          *   @returns {array} An array of aoData points
1779          */
1780         "_fnSelectData": function ( src )
1781         {
1782                 var out = [], pos, i, iLen;
1783
1784                 if ( src.nodeName )
1785                 {
1786                         // Single node
1787                         pos = this.s.dt.oInstance.fnGetPosition( src );
1788                         out.push( this.s.dt.aoData[pos] );
1789                 }
1790                 else if ( typeof src.length !== 'undefined' )
1791                 {
1792                         // jQuery object or an array of nodes, or aoData points
1793                         for ( i=0, iLen=src.length ; i<iLen ; i++ )
1794                         {
1795                                 if ( src[i].nodeName )
1796                                 {
1797                                         pos = this.s.dt.oInstance.fnGetPosition( src[i] );
1798                                         out.push( this.s.dt.aoData[pos] );
1799                                 }
1800                                 else if ( typeof src[i] === 'number' )
1801                                 {
1802                                         out.push( this.s.dt.aoData[ src[i] ] );
1803                                 }
1804                                 else
1805                                 {
1806                                         out.push( src[i] );
1807                                 }
1808                         }
1809
1810                         return out;
1811                 }
1812                 else if ( typeof src === 'number' )
1813                 {
1814                         out.push(this.s.dt.aoData[src]);
1815                 }
1816                 else
1817                 {
1818                         // A single aoData point
1819                         out.push( src );
1820                 }
1821
1822                 return out;
1823         },
1824
1825
1826         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
1827          * Text button functions
1828          */
1829
1830         /**
1831          * Configure a text based button for interaction events
1832          *  @method  _fnTextConfig
1833          *  @param   {Node} nButton Button element which is being considered
1834          *  @param   {Object} oConfig Button configuration object
1835          *  @returns void
1836          *  @private
1837          */
1838         "_fnTextConfig": function ( nButton, oConfig )
1839         {
1840                 var that = this;
1841
1842                 if ( oConfig.fnInit !== null )
1843                 {
1844                         oConfig.fnInit.call( this, nButton, oConfig );
1845                 }
1846
1847                 if ( oConfig.sToolTip !== "" )
1848                 {
1849                         nButton.title = oConfig.sToolTip;
1850                 }
1851
1852                 $(nButton).hover( function () {
1853                         if ( oConfig.fnMouseover !== null )
1854                         {
1855                                 oConfig.fnMouseover.call( this, nButton, oConfig, null );
1856                         }
1857                 }, function () {
1858                         if ( oConfig.fnMouseout !== null )
1859                         {
1860                                 oConfig.fnMouseout.call( this, nButton, oConfig, null );
1861                         }
1862                 } );
1863
1864                 if ( oConfig.fnSelect !== null )
1865                 {
1866                         TableTools._fnEventListen( this, 'select', function (n) {
1867                                 oConfig.fnSelect.call( that, nButton, oConfig, n );
1868                         } );
1869                 }
1870
1871                 $(nButton).click( function (e) {
1872                         //e.preventDefault();
1873
1874                         if ( oConfig.fnClick !== null )
1875                         {
1876                                 oConfig.fnClick.call( that, nButton, oConfig, null, e );
1877                         }
1878
1879                         /* Provide a complete function to match the behaviour of the flash elements */
1880                         if ( oConfig.fnComplete !== null )
1881                         {
1882                                 oConfig.fnComplete.call( that, nButton, oConfig, null, null );
1883                         }
1884
1885                         that._fnCollectionHide( nButton, oConfig );
1886                 } );
1887         },
1888
1889
1890
1891         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
1892          * Flash button functions
1893          */
1894
1895         /**
1896          * Check if the Flash plug-in is available
1897          *  @method  _fnHasFlash
1898          *  @returns {boolean} `true` if Flash available, `false` otherwise
1899          *  @private
1900          */
1901         "_fnHasFlash": function ()
1902         {
1903                 try {
1904                         var fo = new ActiveXObject('ShockwaveFlash.ShockwaveFlash');
1905                         if (fo) {
1906                                 return true;
1907                         }
1908                 }
1909                 catch (e) {
1910                         if (
1911                                 navigator.mimeTypes &&
1912                                 navigator.mimeTypes['application/x-shockwave-flash'] !== undefined &&
1913                                 navigator.mimeTypes['application/x-shockwave-flash'].enabledPlugin
1914                         ) {
1915                                 return true;
1916                         }
1917                 }
1918
1919                 return false;
1920         },
1921
1922
1923         /**
1924          * Configure a flash based button for interaction events
1925          *  @method  _fnFlashConfig
1926          *  @param   {Node} nButton Button element which is being considered
1927          *  @param   {o} oConfig Button configuration object
1928          *  @returns void
1929          *  @private
1930          */
1931         "_fnFlashConfig": function ( nButton, oConfig )
1932         {
1933                 var that = this;
1934                 var flash = new ZeroClipboard_TableTools.Client();
1935
1936                 if ( oConfig.fnInit !== null )
1937                 {
1938                         oConfig.fnInit.call( this, nButton, oConfig );
1939                 }
1940
1941                 flash.setHandCursor( true );
1942
1943                 if ( oConfig.sAction == "flash_save" )
1944                 {
1945                         flash.setAction( 'save' );
1946                         flash.setCharSet( (oConfig.sCharSet=="utf16le") ? 'UTF16LE' : 'UTF8' );
1947                         flash.setBomInc( oConfig.bBomInc );
1948                         flash.setFileName( oConfig.sFileName.replace('*', this.fnGetTitle(oConfig)) );
1949                 }
1950                 else if ( oConfig.sAction == "flash_pdf" )
1951                 {
1952                         flash.setAction( 'pdf' );
1953                         flash.setFileName( oConfig.sFileName.replace('*', this.fnGetTitle(oConfig)) );
1954                 }
1955                 else
1956                 {
1957                         flash.setAction( 'copy' );
1958                 }
1959
1960                 flash.addEventListener('mouseOver', function(client) {
1961                         if ( oConfig.fnMouseover !== null )
1962                         {
1963                                 oConfig.fnMouseover.call( that, nButton, oConfig, flash );
1964                         }
1965                 } );
1966
1967                 flash.addEventListener('mouseOut', function(client) {
1968                         if ( oConfig.fnMouseout !== null )
1969                         {
1970                                 oConfig.fnMouseout.call( that, nButton, oConfig, flash );
1971                         }
1972                 } );
1973
1974                 flash.addEventListener('mouseDown', function(client) {
1975                         if ( oConfig.fnClick !== null )
1976                         {
1977                                 oConfig.fnClick.call( that, nButton, oConfig, flash );
1978                         }
1979                 } );
1980
1981                 flash.addEventListener('complete', function (client, text) {
1982                         if ( oConfig.fnComplete !== null )
1983                         {
1984                                 oConfig.fnComplete.call( that, nButton, oConfig, flash, text );
1985                         }
1986                         that._fnCollectionHide( nButton, oConfig );
1987                 } );
1988
1989                 if ( oConfig.fnSelect !== null )
1990                 {
1991                         TableTools._fnEventListen( this, 'select', function (n) {
1992                                 oConfig.fnSelect.call( that, nButton, oConfig, n );
1993                         } );
1994                 }
1995
1996                 this._fnFlashGlue( flash, nButton, oConfig.sToolTip );
1997         },
1998
1999
2000         /**
2001          * Wait until the id is in the DOM before we "glue" the swf. Note that this function will call
2002          * itself (using setTimeout) until it completes successfully
2003          *  @method  _fnFlashGlue
2004          *  @param   {Object} clip Zero clipboard object
2005          *  @param   {Node} node node to glue swf to
2006          *  @param   {String} text title of the flash movie
2007          *  @returns void
2008          *  @private
2009          */
2010         "_fnFlashGlue": function ( flash, node, text )
2011         {
2012                 var that = this;
2013                 var id = node.getAttribute('id');
2014
2015                 if ( document.getElementById(id) )
2016                 {
2017                         flash.glue( node, text );
2018                 }
2019                 else
2020                 {
2021                         setTimeout( function () {
2022                                 that._fnFlashGlue( flash, node, text );
2023                         }, 100 );
2024                 }
2025         },
2026
2027
2028         /**
2029          * Set the text for the flash clip to deal with
2030          *
2031          * This function is required for large information sets. There is a limit on the
2032          * amount of data that can be transferred between Javascript and Flash in a single call, so
2033          * we use this method to build up the text in Flash by sending over chunks. It is estimated
2034          * that the data limit is around 64k, although it is undocumented, and appears to be different
2035          * between different flash versions. We chunk at 8KiB.
2036          *  @method  _fnFlashSetText
2037          *  @param   {Object} clip the ZeroClipboard object
2038          *  @param   {String} sData the data to be set
2039          *  @returns void
2040          *  @private
2041          */
2042         "_fnFlashSetText": function ( clip, sData )
2043         {
2044                 var asData = this._fnChunkData( sData, 8192 );
2045
2046                 clip.clearText();
2047                 for ( var i=0, iLen=asData.length ; i<iLen ; i++ )
2048                 {
2049                         clip.appendText( asData[i] );
2050                 }
2051         },
2052
2053
2054
2055         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2056          * Data retrieval functions
2057          */
2058
2059         /**
2060          * Convert the mixed columns variable into a boolean array the same size as the columns, which
2061          * indicates which columns we want to include
2062          *  @method  _fnColumnTargets
2063          *  @param   {String|Array} mColumns The columns to be included in data retrieval. If a string
2064          *                       then it can take the value of "visible" or "hidden" (to include all visible or
2065          *                       hidden columns respectively). Or an array of column indexes
2066          *  @returns {Array} A boolean array the length of the columns of the table, which each value
2067          *                       indicating if the column is to be included or not
2068          *  @private
2069          */
2070         "_fnColumnTargets": function ( mColumns )
2071         {
2072                 var aColumns = [];
2073                 var dt = this.s.dt;
2074                 var i, iLen;
2075                 var columns = dt.aoColumns;
2076                 var columnCount = columns.length;
2077
2078                 if ( typeof mColumns == "function" )
2079                 {
2080                         var a = mColumns.call( this, dt );
2081
2082                         for ( i=0, iLen=columnCount ; i<iLen ; i++ )
2083                         {
2084                                 aColumns.push( $.inArray( i, a ) !== -1 ? true : false );
2085                         }
2086                 }
2087                 else if ( typeof mColumns == "object" )
2088                 {
2089                         for ( i=0, iLen=columnCount ; i<iLen ; i++ )
2090                         {
2091                                 aColumns.push( false );
2092                         }
2093
2094                         for ( i=0, iLen=mColumns.length ; i<iLen ; i++ )
2095                         {
2096                                 aColumns[ mColumns[i] ] = true;
2097                         }
2098                 }
2099                 else if ( mColumns == "visible" )
2100                 {
2101                         for ( i=0, iLen=columnCount ; i<iLen ; i++ )
2102                         {
2103                                 aColumns.push( columns[i].bVisible ? true : false );
2104                         }
2105                 }
2106                 else if ( mColumns == "hidden" )
2107                 {
2108                         for ( i=0, iLen=columnCount ; i<iLen ; i++ )
2109                         {
2110                                 aColumns.push( columns[i].bVisible ? false : true );
2111                         }
2112                 }
2113                 else if ( mColumns == "sortable" )
2114                 {
2115                         for ( i=0, iLen=columnCount ; i<iLen ; i++ )
2116                         {
2117                                 aColumns.push( columns[i].bSortable ? true : false );
2118                         }
2119                 }
2120                 else /* all */
2121                 {
2122                         for ( i=0, iLen=columnCount ; i<iLen ; i++ )
2123                         {
2124                                 aColumns.push( true );
2125                         }
2126                 }
2127
2128                 return aColumns;
2129         },
2130
2131
2132         /**
2133          * New line character(s) depend on the platforms
2134          *  @method  method
2135          *  @param   {Object} oConfig Button configuration object - only interested in oConfig.sNewLine
2136          *  @returns {String} Newline character
2137          */
2138         "_fnNewline": function ( oConfig )
2139         {
2140                 if ( oConfig.sNewLine == "auto" )
2141                 {
2142                         return navigator.userAgent.match(/Windows/) ? "\r\n" : "\n";
2143                 }
2144                 else
2145                 {
2146                         return oConfig.sNewLine;
2147                 }
2148         },
2149
2150
2151         /**
2152          * Get data from DataTables' internals and format it for output
2153          *  @method  _fnGetDataTablesData
2154          *  @param   {Object} oConfig Button configuration object
2155          *  @param   {String} oConfig.sFieldBoundary Field boundary for the data cells in the string
2156          *  @param   {String} oConfig.sFieldSeperator Field separator for the data cells
2157          *  @param   {String} oConfig.sNewline New line options
2158          *  @param   {Mixed} oConfig.mColumns Which columns should be included in the output
2159          *  @param   {Boolean} oConfig.bHeader Include the header
2160          *  @param   {Boolean} oConfig.bFooter Include the footer
2161          *  @param   {Boolean} oConfig.bSelectedOnly Include only the selected rows in the output
2162          *  @returns {String} Concatenated string of data
2163          *  @private
2164          */
2165         "_fnGetDataTablesData": function ( oConfig )
2166         {
2167                 var i, iLen, j, jLen;
2168                 var aRow, aData=[], sLoopData='', arr;
2169                 var dt = this.s.dt, tr, child;
2170                 var regex = new RegExp(oConfig.sFieldBoundary, "g"); /* Do it here for speed */
2171                 var aColumnsInc = this._fnColumnTargets( oConfig.mColumns );
2172                 var bSelectedOnly = (typeof oConfig.bSelectedOnly != 'undefined') ? oConfig.bSelectedOnly : false;
2173
2174                 /*
2175                  * Header
2176                  */
2177                 if ( oConfig.bHeader )
2178                 {
2179                         aRow = [];
2180
2181                         for ( i=0, iLen=dt.aoColumns.length ; i<iLen ; i++ )
2182                         {
2183                                 if ( aColumnsInc[i] )
2184                                 {
2185                                         sLoopData = dt.aoColumns[i].sTitle.replace(/\n/g," ").replace( /<.*?>/g, "" ).replace(/^\s+|\s+$/g,"");
2186                                         sLoopData = this._fnHtmlDecode( sLoopData );
2187
2188                                         aRow.push( this._fnBoundData( sLoopData, oConfig.sFieldBoundary, regex ) );
2189                                 }
2190                         }
2191
2192                         aData.push( aRow.join(oConfig.sFieldSeperator) );
2193                 }
2194
2195                 bSelectedOnly = true;
2196
2197                 /*
2198                  * Body
2199                  */
2200                 var aDataIndex;
2201                 var aSelected = this.fnGetSelectedIndexes();
2202                 bSelectedOnly = this.s.select.type !== "none" && bSelectedOnly && aSelected.length !== 0;
2203
2204                 if ( bSelectedOnly ) {
2205                         // Use the selected indexes
2206                         aDataIndex = aSelected;
2207                 }
2208                 else if ( DataTable.Api ) {
2209                         // 1.10+ style
2210                         aDataIndex = new DataTable.Api( dt )
2211                                 .rows( oConfig.oSelectorOpts )
2212                                 .indexes()
2213                                 .flatten()
2214                                 .toArray();
2215                 }
2216                 else {
2217                         // 1.9- style
2218                         aDataIndex = dt.oInstance
2219                                 .$('tr', oConfig.oSelectorOpts)
2220                                 .map( function (id, row) {
2221                                         return dt.oInstance.fnGetPosition( row );
2222                                 } )
2223                                 .get();
2224                 }
2225
2226                 for ( j=0, jLen=aDataIndex.length ; j<jLen ; j++ )
2227                 {
2228                         tr = dt.aoData[ aDataIndex[j] ].nTr;
2229                         aRow = [];
2230
2231                         /* Columns */
2232                         for ( i=0, iLen=dt.aoColumns.length ; i<iLen ; i++ )
2233                         {
2234                                 if ( aColumnsInc[i] )
2235                                 {
2236                                         /* Convert to strings (with small optimisation) */
2237                                         var mTypeData = dt.oApi._fnGetCellData( dt, aDataIndex[j], i, 'display' );
2238                                         if ( oConfig.fnCellRender )
2239                                         {
2240                                                 sLoopData = oConfig.fnCellRender( mTypeData, i, tr, aDataIndex[j] )+"";
2241                                         }
2242                                         else if ( typeof mTypeData == "string" )
2243                                         {
2244                                                 /* Strip newlines, replace img tags with alt attr. and finally strip html... */
2245                                                 sLoopData = mTypeData.replace(/\n/g," ");
2246                                                 sLoopData =
2247                                                     sLoopData.replace(/<img.*?\s+alt\s*=\s*(?:"([^"]+)"|'([^']+)'|([^\s>]+)).*?>/gi,
2248                                                         '$1$2$3');
2249                                                 sLoopData = sLoopData.replace( /<.*?>/g, "" );
2250                                         }
2251                                         else
2252                                         {
2253                                                 sLoopData = mTypeData+"";
2254                                         }
2255
2256                                         /* Trim and clean the data */
2257                                         sLoopData = sLoopData.replace(/^\s+/, '').replace(/\s+$/, '');
2258                                         sLoopData = this._fnHtmlDecode( sLoopData );
2259
2260                                         /* Bound it and add it to the total data */
2261                                         aRow.push( this._fnBoundData( sLoopData, oConfig.sFieldBoundary, regex ) );
2262                                 }
2263                         }
2264
2265                         aData.push( aRow.join(oConfig.sFieldSeperator) );
2266
2267                         /* Details rows from fnOpen */
2268                         if ( oConfig.bOpenRows )
2269                         {
2270                                 arr = $.grep(dt.aoOpenRows, function(o) { return o.nParent === tr; });
2271
2272                                 if ( arr.length === 1 )
2273                                 {
2274                                         sLoopData = this._fnBoundData( $('td', arr[0].nTr).html(), oConfig.sFieldBoundary, regex );
2275                                         aData.push( sLoopData );
2276                                 }
2277                         }
2278                 }
2279
2280                 /*
2281                  * Footer
2282                  */
2283                 if ( oConfig.bFooter && dt.nTFoot !== null )
2284                 {
2285                         aRow = [];
2286
2287                         for ( i=0, iLen=dt.aoColumns.length ; i<iLen ; i++ )
2288                         {
2289                                 if ( aColumnsInc[i] && dt.aoColumns[i].nTf !== null )
2290                                 {
2291                                         sLoopData = dt.aoColumns[i].nTf.innerHTML.replace(/\n/g," ").replace( /<.*?>/g, "" );
2292                                         sLoopData = this._fnHtmlDecode( sLoopData );
2293
2294                                         aRow.push( this._fnBoundData( sLoopData, oConfig.sFieldBoundary, regex ) );
2295                                 }
2296                         }
2297
2298                         aData.push( aRow.join(oConfig.sFieldSeperator) );
2299                 }
2300
2301                 var _sLastData = aData.join( this._fnNewline(oConfig) );
2302                 return _sLastData;
2303         },
2304
2305
2306         /**
2307          * Wrap data up with a boundary string
2308          *  @method  _fnBoundData
2309          *  @param   {String} sData data to bound
2310          *  @param   {String} sBoundary bounding char(s)
2311          *  @param   {RegExp} regex search for the bounding chars - constructed outside for efficiency
2312          *                       in the loop
2313          *  @returns {String} bound data
2314          *  @private
2315          */
2316         "_fnBoundData": function ( sData, sBoundary, regex )
2317         {
2318                 if ( sBoundary === "" )
2319                 {
2320                         return sData;
2321                 }
2322                 else
2323                 {
2324                         return sBoundary + sData.replace(regex, sBoundary+sBoundary) + sBoundary;
2325                 }
2326         },
2327
2328
2329         /**
2330          * Break a string up into an array of smaller strings
2331          *  @method  _fnChunkData
2332          *  @param   {String} sData data to be broken up
2333          *  @param   {Int} iSize chunk size
2334          *  @returns {Array} String array of broken up text
2335          *  @private
2336          */
2337         "_fnChunkData": function ( sData, iSize )
2338         {
2339                 var asReturn = [];
2340                 var iStrlen = sData.length;
2341
2342                 for ( var i=0 ; i<iStrlen ; i+=iSize )
2343                 {
2344                         if ( i+iSize < iStrlen )
2345                         {
2346                                 asReturn.push( sData.substring( i, i+iSize ) );
2347                         }
2348                         else
2349                         {
2350                                 asReturn.push( sData.substring( i, iStrlen ) );
2351                         }
2352                 }
2353
2354                 return asReturn;
2355         },
2356
2357
2358         /**
2359          * Decode HTML entities
2360          *  @method  _fnHtmlDecode
2361          *  @param   {String} sData encoded string
2362          *  @returns {String} decoded string
2363          *  @private
2364          */
2365         "_fnHtmlDecode": function ( sData )
2366         {
2367                 if ( sData.indexOf('&') === -1 )
2368                 {
2369                         return sData;
2370                 }
2371
2372                 var n = document.createElement('div');
2373
2374                 return sData.replace( /&([^\s]*?);/g, function( match, match2 ) {
2375                         if ( match.substr(1, 1) === '#' )
2376                         {
2377                                 return String.fromCharCode( Number(match2.substr(1)) );
2378                         }
2379                         else
2380                         {
2381                                 n.innerHTML = match;
2382                                 return n.childNodes[0].nodeValue;
2383                         }
2384                 } );
2385         },
2386
2387
2388
2389         /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2390          * Printing functions
2391          */
2392
2393         /**
2394          * Show print display
2395          *  @method  _fnPrintStart
2396          *  @param   {Event} e Event object
2397          *  @param   {Object} oConfig Button configuration object
2398          *  @returns void
2399          *  @private
2400          */
2401         "_fnPrintStart": function ( oConfig )
2402         {
2403           var that = this;
2404           var oSetDT = this.s.dt;
2405
2406                 /* Parse through the DOM hiding everything that isn't needed for the table */
2407                 this._fnPrintHideNodes( oSetDT.nTable );
2408
2409                 /* Show the whole table */
2410                 this.s.print.saveStart = oSetDT._iDisplayStart;
2411                 this.s.print.saveLength = oSetDT._iDisplayLength;
2412
2413                 if ( oConfig.bShowAll )
2414                 {
2415                         oSetDT._iDisplayStart = 0;
2416                         oSetDT._iDisplayLength = -1;
2417                         if ( oSetDT.oApi._fnCalculateEnd ) {
2418                                 oSetDT.oApi._fnCalculateEnd( oSetDT );
2419                         }
2420                         oSetDT.oApi._fnDraw( oSetDT );
2421                 }
2422
2423                 /* Adjust the display for scrolling which might be done by DataTables */
2424                 if ( oSetDT.oScroll.sX !== "" || oSetDT.oScroll.sY !== "" )
2425                 {
2426                         this._fnPrintScrollStart( oSetDT );
2427
2428                         // If the table redraws while in print view, the DataTables scrolling
2429                         // setup would hide the header, so we need to readd it on draw
2430                         $(this.s.dt.nTable).bind('draw.DTTT_Print', function () {
2431                                 that._fnPrintScrollStart( oSetDT );
2432                         } );
2433                 }
2434
2435                 /* Remove the other DataTables feature nodes - but leave the table! and info div */
2436                 var anFeature = oSetDT.aanFeatures;
2437                 for ( var cFeature in anFeature )
2438                 {
2439                         if ( cFeature != 'i' && cFeature != 't' && cFeature.length == 1 )
2440                         {
2441                                 for ( var i=0, iLen=anFeature[cFeature].length ; i<iLen ; i++ )
2442                                 {
2443                                         this.dom.print.hidden.push( {
2444                                                 "node": anFeature[cFeature][i],
2445                                                 "display": "block"
2446                                         } );
2447                                         anFeature[cFeature][i].style.display = "none";
2448                                 }
2449                         }
2450                 }
2451
2452                 /* Print class can be used for styling */
2453                 $(document.body).addClass( this.classes.print.body );
2454
2455                 /* Show information message to let the user know what is happening */
2456                 if ( oConfig.sInfo !== "" )
2457                 {
2458                         this.fnInfo( oConfig.sInfo, 3000 );
2459                 }
2460
2461                 /* Add a message at the top of the page */
2462                 if ( oConfig.sMessage )
2463                 {
2464                         $('<div/>')
2465                                 .addClass( this.classes.print.message )
2466                                 .html( oConfig.sMessage )
2467                                 .prependTo( 'body' );
2468                 }
2469
2470                 /* Cache the scrolling and the jump to the top of the page */
2471                 this.s.print.saveScroll = $(window).scrollTop();
2472                 window.scrollTo( 0, 0 );
2473
2474                 /* Bind a key event listener to the document for the escape key -
2475                  * it is removed in the callback
2476                  */
2477                 $(document).bind( "keydown.DTTT", function(e) {
2478                         /* Only interested in the escape key */
2479                         if ( e.keyCode == 27 )
2480                         {
2481                                 e.preventDefault();
2482                                 that._fnPrintEnd.call( that, e );
2483                         }
2484                 } );
2485         },
2486
2487
2488         /**
2489          * Printing is finished, resume normal display
2490          *  @method  _fnPrintEnd
2491          *  @param   {Event} e Event object
2492          *  @returns void
2493          *  @private
2494          */
2495         "_fnPrintEnd": function ( e )
2496         {
2497                 var that = this;
2498                 var oSetDT = this.s.dt;
2499                 var oSetPrint = this.s.print;
2500                 var oDomPrint = this.dom.print;
2501
2502                 /* Show all hidden nodes */
2503                 this._fnPrintShowNodes();
2504
2505                 /* Restore DataTables' scrolling */
2506                 if ( oSetDT.oScroll.sX !== "" || oSetDT.oScroll.sY !== "" )
2507                 {
2508                         $(this.s.dt.nTable).unbind('draw.DTTT_Print');
2509
2510                         this._fnPrintScrollEnd();
2511                 }
2512
2513                 /* Restore the scroll */
2514                 window.scrollTo( 0, oSetPrint.saveScroll );
2515
2516                 /* Drop the print message */
2517                 $('div.'+this.classes.print.message).remove();
2518
2519                 /* Styling class */
2520                 $(document.body).removeClass( 'DTTT_Print' );
2521
2522                 /* Restore the table length */
2523                 oSetDT._iDisplayStart = oSetPrint.saveStart;
2524                 oSetDT._iDisplayLength = oSetPrint.saveLength;
2525                 if ( oSetDT.oApi._fnCalculateEnd ) {
2526                         oSetDT.oApi._fnCalculateEnd( oSetDT );
2527                 }
2528                 oSetDT.oApi._fnDraw( oSetDT );
2529
2530                 $(document).unbind( "keydown.DTTT" );
2531         },
2532
2533
2534         /**
2535          * Take account of scrolling in DataTables by showing the full table
2536          *  @returns void
2537          *  @private
2538          */
2539         "_fnPrintScrollStart": function ()
2540         {
2541                 var
2542                         oSetDT = this.s.dt,
2543                         nScrollHeadInner = oSetDT.nScrollHead.getElementsByTagName('div')[0],
2544                         nScrollHeadTable = nScrollHeadInner.getElementsByTagName('table')[0],
2545                         nScrollBody = oSetDT.nTable.parentNode,
2546                         nTheadSize, nTfootSize;
2547
2548                 /* Copy the header in the thead in the body table, this way we show one single table when
2549                  * in print view. Note that this section of code is more or less verbatim from DT 1.7.0
2550                  */
2551                 nTheadSize = oSetDT.nTable.getElementsByTagName('thead');
2552                 if ( nTheadSize.length > 0 )
2553                 {
2554                         oSetDT.nTable.removeChild( nTheadSize[0] );
2555                 }
2556
2557                 if ( oSetDT.nTFoot !== null )
2558                 {
2559                         nTfootSize = oSetDT.nTable.getElementsByTagName('tfoot');
2560                         if ( nTfootSize.length > 0 )
2561                         {
2562                                 oSetDT.nTable.removeChild( nTfootSize[0] );
2563                         }
2564                 }
2565
2566                 nTheadSize = oSetDT.nTHead.cloneNode(true);
2567                 oSetDT.nTable.insertBefore( nTheadSize, oSetDT.nTable.childNodes[0] );
2568
2569                 if ( oSetDT.nTFoot !== null )
2570                 {
2571                         nTfootSize = oSetDT.nTFoot.cloneNode(true);
2572                         oSetDT.nTable.insertBefore( nTfootSize, oSetDT.nTable.childNodes[1] );
2573                 }
2574
2575                 /* Now adjust the table's viewport so we can actually see it */
2576                 if ( oSetDT.oScroll.sX !== "" )
2577                 {
2578                         oSetDT.nTable.style.width = $(oSetDT.nTable).outerWidth()+"px";
2579                         nScrollBody.style.width = $(oSetDT.nTable).outerWidth()+"px";
2580                         nScrollBody.style.overflow = "visible";
2581                 }
2582
2583                 if ( oSetDT.oScroll.sY !== "" )
2584                 {
2585                         nScrollBody.style.height = $(oSetDT.nTable).outerHeight()+"px";
2586                         nScrollBody.style.overflow = "visible";
2587                 }
2588         },
2589
2590
2591         /**
2592          * Take account of scrolling in DataTables by showing the full table. Note that the redraw of
2593          * the DataTable that we do will actually deal with the majority of the hard work here
2594          *  @returns void
2595          *  @private
2596          */
2597         "_fnPrintScrollEnd": function ()
2598         {
2599                 var
2600                         oSetDT = this.s.dt,
2601                         nScrollBody = oSetDT.nTable.parentNode;
2602
2603                 if ( oSetDT.oScroll.sX !== "" )
2604                 {
2605                         nScrollBody.style.width = oSetDT.oApi._fnStringToCss( oSetDT.oScroll.sX );
2606                         nScrollBody.style.overflow = "auto";
2607                 }
2608
2609                 if ( oSetDT.oScroll.sY !== "" )
2610                 {
2611                         nScrollBody.style.height = oSetDT.oApi._fnStringToCss( oSetDT.oScroll.sY );
2612                         nScrollBody.style.overflow = "auto";
2613                 }
2614         },
2615
2616
2617         /**
2618          * Resume the display of all TableTools hidden nodes
2619          *  @method  _fnPrintShowNodes
2620          *  @returns void
2621          *  @private
2622          */
2623         "_fnPrintShowNodes": function ( )
2624         {
2625           var anHidden = this.dom.print.hidden;
2626
2627                 for ( var i=0, iLen=anHidden.length ; i<iLen ; i++ )
2628                 {
2629                         anHidden[i].node.style.display = anHidden[i].display;
2630                 }
2631                 anHidden.splice( 0, anHidden.length );
2632         },
2633
2634
2635         /**
2636          * Hide nodes which are not needed in order to display the table. Note that this function is
2637          * recursive
2638          *  @method  _fnPrintHideNodes
2639          *  @param   {Node} nNode Element which should be showing in a 'print' display
2640          *  @returns void
2641          *  @private
2642          */
2643         "_fnPrintHideNodes": function ( nNode )
2644         {
2645                 var anHidden = this.dom.print.hidden;
2646
2647                 var nParent = nNode.parentNode;
2648                 var nChildren = nParent.childNodes;
2649                 for ( var i=0, iLen=nChildren.length ; i<iLen ; i++ )
2650                 {
2651                         if ( nChildren[i] != nNode && nChildren[i].nodeType == 1 )
2652                         {
2653                                 /* If our node is shown (don't want to show nodes which were previously hidden) */
2654                                 var sDisplay = $(nChildren[i]).css("display");
2655                                 if ( sDisplay != "none" )
2656                                 {
2657                                         /* Cache the node and it's previous state so we can restore it */
2658                                         anHidden.push( {
2659                                                 "node": nChildren[i],
2660                                                 "display": sDisplay
2661                                         } );
2662                                         nChildren[i].style.display = "none";
2663                                 }
2664                         }
2665                 }
2666
2667                 if ( nParent.nodeName.toUpperCase() != "BODY" )
2668                 {
2669                         this._fnPrintHideNodes( nParent );
2670                 }
2671         }
2672 };
2673
2674
2675
2676 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2677  * Static variables
2678  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2679
2680 /**
2681  * Store of all instances that have been created of TableTools, so one can look up other (when
2682  * there is need of a master)
2683  *  @property _aInstances
2684  *  @type        Array
2685  *  @default  []
2686  *  @private
2687  */
2688 TableTools._aInstances = [];
2689
2690
2691 /**
2692  * Store of all listeners and their callback functions
2693  *  @property _aListeners
2694  *  @type        Array
2695  *  @default  []
2696  */
2697 TableTools._aListeners = [];
2698
2699
2700
2701 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2702  * Static methods
2703  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2704
2705 /**
2706  * Get an array of all the master instances
2707  *  @method  fnGetMasters
2708  *  @returns {Array} List of master TableTools instances
2709  *  @static
2710  */
2711 TableTools.fnGetMasters = function ()
2712 {
2713         var a = [];
2714         for ( var i=0, iLen=TableTools._aInstances.length ; i<iLen ; i++ )
2715         {
2716                 if ( TableTools._aInstances[i].s.master )
2717                 {
2718                         a.push( TableTools._aInstances[i] );
2719                 }
2720         }
2721         return a;
2722 };
2723
2724 /**
2725  * Get the master instance for a table node (or id if a string is given)
2726  *  @method  fnGetInstance
2727  *  @returns {Object} ID of table OR table node, for which we want the TableTools instance
2728  *  @static
2729  */
2730 TableTools.fnGetInstance = function ( node )
2731 {
2732         if ( typeof node != 'object' )
2733         {
2734                 node = document.getElementById(node);
2735         }
2736
2737         for ( var i=0, iLen=TableTools._aInstances.length ; i<iLen ; i++ )
2738         {
2739                 if ( TableTools._aInstances[i].s.master && TableTools._aInstances[i].dom.table == node )
2740                 {
2741                         return TableTools._aInstances[i];
2742                 }
2743         }
2744         return null;
2745 };
2746
2747
2748 /**
2749  * Add a listener for a specific event
2750  *  @method  _fnEventListen
2751  *  @param   {Object} that Scope of the listening function (i.e. 'this' in the caller)
2752  *  @param   {String} type Event type
2753  *  @param   {Function} fn Function
2754  *  @returns void
2755  *  @private
2756  *  @static
2757  */
2758 TableTools._fnEventListen = function ( that, type, fn )
2759 {
2760         TableTools._aListeners.push( {
2761                 "that": that,
2762                 "type": type,
2763                 "fn": fn
2764         } );
2765 };
2766
2767
2768 /**
2769  * An event has occurred - look up every listener and fire it off. We check that the event we are
2770  * going to fire is attached to the same table (using the table node as reference) before firing
2771  *  @method  _fnEventDispatch
2772  *  @param   {Object} that Scope of the listening function (i.e. 'this' in the caller)
2773  *  @param   {String} type Event type
2774  *  @param   {Node} node Element that the event occurred on (may be null)
2775  *  @param   {boolean} [selected] Indicate if the node was selected (true) or deselected (false)
2776  *  @returns void
2777  *  @private
2778  *  @static
2779  */
2780 TableTools._fnEventDispatch = function ( that, type, node, selected )
2781 {
2782         var listeners = TableTools._aListeners;
2783         for ( var i=0, iLen=listeners.length ; i<iLen ; i++ )
2784         {
2785                 if ( that.dom.table == listeners[i].that.dom.table && listeners[i].type == type )
2786                 {
2787                         listeners[i].fn( node, selected );
2788                 }
2789         }
2790 };
2791
2792
2793
2794
2795
2796
2797 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
2798  * Constants
2799  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2800
2801
2802
2803 TableTools.buttonBase = {
2804         // Button base
2805         "sAction": "text",
2806         "sTag": "default",
2807         "sLinerTag": "default",
2808         "sButtonClass": "DTTT_button_text",
2809         "sButtonText": "Button text",
2810         "sTitle": "",
2811         "sToolTip": "",
2812
2813         // Common button specific options
2814         "sCharSet": "utf8",
2815         "bBomInc": false,
2816         "sFileName": "*.csv",
2817         "sFieldBoundary": "",
2818         "sFieldSeperator": "\t",
2819         "sNewLine": "auto",
2820         "mColumns": "all", /* "all", "visible", "hidden" or array of column integers */
2821         "bHeader": true,
2822         "bFooter": true,
2823         "bOpenRows": false,
2824         "bSelectedOnly": false,
2825         "oSelectorOpts": undefined, // See http://datatables.net/docs/DataTables/1.9.4/#$ for full options
2826
2827         // Callbacks
2828         "fnMouseover": null,
2829         "fnMouseout": null,
2830         "fnClick": null,
2831         "fnSelect": null,
2832         "fnComplete": null,
2833         "fnInit": null,
2834         "fnCellRender": null
2835 };
2836
2837
2838 /**
2839  * @namespace Default button configurations
2840  */
2841 TableTools.BUTTONS = {
2842         "csv": $.extend( {}, TableTools.buttonBase, {
2843                 "sAction": "flash_save",
2844                 "sButtonClass": "DTTT_button_csv",
2845                 "sButtonText": "CSV",
2846                 "sFieldBoundary": '"',
2847                 "sFieldSeperator": ",",
2848                 "fnClick": function( nButton, oConfig, flash ) {
2849                         this.fnSetText( flash, this.fnGetTableData(oConfig) );
2850                 }
2851         } ),
2852
2853         "xls": $.extend( {}, TableTools.buttonBase, {
2854                 "sAction": "flash_save",
2855                 "sCharSet": "utf16le",
2856                 "bBomInc": true,
2857                 "sButtonClass": "DTTT_button_xls",
2858                 "sButtonText": "Excel",
2859                 "fnClick": function( nButton, oConfig, flash ) {
2860                         this.fnSetText( flash, this.fnGetTableData(oConfig) );
2861                 }
2862         } ),
2863
2864         "copy": $.extend( {}, TableTools.buttonBase, {
2865                 "sAction": "flash_copy",
2866                 "sButtonClass": "DTTT_button_copy",
2867                 "sButtonText": "Copy",
2868                 "fnClick": function( nButton, oConfig, flash ) {
2869                         this.fnSetText( flash, this.fnGetTableData(oConfig) );
2870                 },
2871                 "fnComplete": function(nButton, oConfig, flash, text) {
2872                         var lines = text.split('\n').length;
2873             if (oConfig.bHeader) lines--;
2874             if (this.s.dt.nTFoot !== null && oConfig.bFooter) lines--;
2875                         var plural = (lines==1) ? "" : "s";
2876                         this.fnInfo( '<h6>Table copied</h6>'+
2877                                 '<p>Copied '+lines+' row'+plural+' to the clipboard.</p>',
2878                                 1500
2879                         );
2880                 }
2881         } ),
2882
2883         "pdf": $.extend( {}, TableTools.buttonBase, {
2884                 "sAction": "flash_pdf",
2885                 "sNewLine": "\n",
2886                 "sFileName": "*.pdf",
2887                 "sButtonClass": "DTTT_button_pdf",
2888                 "sButtonText": "PDF",
2889                 "sPdfOrientation": "portrait",
2890                 "sPdfSize": "A4",
2891                 "sPdfMessage": "",
2892                 "fnClick": function( nButton, oConfig, flash ) {
2893                         this.fnSetText( flash,
2894                                 "title:"+ this.fnGetTitle(oConfig) +"\n"+
2895                                 "message:"+ oConfig.sPdfMessage +"\n"+
2896                                 "colWidth:"+ this.fnCalcColRatios(oConfig) +"\n"+
2897                                 "orientation:"+ oConfig.sPdfOrientation +"\n"+
2898                                 "size:"+ oConfig.sPdfSize +"\n"+
2899                                 "--/TableToolsOpts--\n" +
2900                                 this.fnGetTableData(oConfig)
2901                         );
2902                 }
2903         } ),
2904
2905         "print": $.extend( {}, TableTools.buttonBase, {
2906                 "sInfo": "<h6>Print view</h6><p>Please use your browser's print function to "+
2907                   "print this table. Press escape when finished.</p>",
2908                 "sMessage": null,
2909                 "bShowAll": true,
2910                 "sToolTip": "View print view",
2911                 "sButtonClass": "DTTT_button_print",
2912                 "sButtonText": "Print",
2913                 "fnClick": function ( nButton, oConfig ) {
2914                         this.fnPrint( true, oConfig );
2915                 }
2916         } ),
2917
2918         "text": $.extend( {}, TableTools.buttonBase ),
2919
2920         "select": $.extend( {}, TableTools.buttonBase, {
2921                 "sButtonText": "Select button",
2922                 "fnSelect": function( nButton, oConfig ) {
2923                         if ( this.fnGetSelected().length !== 0 ) {
2924                                 $(nButton).removeClass( this.classes.buttons.disabled );
2925                         } else {
2926                                 $(nButton).addClass( this.classes.buttons.disabled );
2927                         }
2928                 },
2929                 "fnInit": function( nButton, oConfig ) {
2930                         $(nButton).addClass( this.classes.buttons.disabled );
2931                 }
2932         } ),
2933
2934         "select_single": $.extend( {}, TableTools.buttonBase, {
2935                 "sButtonText": "Select button",
2936                 "fnSelect": function( nButton, oConfig ) {
2937                         var iSelected = this.fnGetSelected().length;
2938                         if ( iSelected == 1 ) {
2939                                 $(nButton).removeClass( this.classes.buttons.disabled );
2940                         } else {
2941                                 $(nButton).addClass( this.classes.buttons.disabled );
2942                         }
2943                 },
2944                 "fnInit": function( nButton, oConfig ) {
2945                         $(nButton).addClass( this.classes.buttons.disabled );
2946                 }
2947         } ),
2948
2949         "select_all": $.extend( {}, TableTools.buttonBase, {
2950                 "sButtonText": "Select all",
2951                 "fnClick": function( nButton, oConfig ) {
2952                         this.fnSelectAll();
2953                 },
2954                 "fnSelect": function( nButton, oConfig ) {
2955                         if ( this.fnGetSelected().length == this.s.dt.fnRecordsDisplay() ) {
2956                                 $(nButton).addClass( this.classes.buttons.disabled );
2957                         } else {
2958                                 $(nButton).removeClass( this.classes.buttons.disabled );
2959                         }
2960                 }
2961         } ),
2962
2963         "select_none": $.extend( {}, TableTools.buttonBase, {
2964                 "sButtonText": "Deselect all",
2965                 "fnClick": function( nButton, oConfig ) {
2966                         this.fnSelectNone();
2967                 },
2968                 "fnSelect": function( nButton, oConfig ) {
2969                         if ( this.fnGetSelected().length !== 0 ) {
2970                                 $(nButton).removeClass( this.classes.buttons.disabled );
2971                         } else {
2972                                 $(nButton).addClass( this.classes.buttons.disabled );
2973                         }
2974                 },
2975                 "fnInit": function( nButton, oConfig ) {
2976                         $(nButton).addClass( this.classes.buttons.disabled );
2977                 }
2978         } ),
2979
2980         "ajax": $.extend( {}, TableTools.buttonBase, {
2981                 "sAjaxUrl": "/xhr.php",
2982                 "sButtonText": "Ajax button",
2983                 "fnClick": function( nButton, oConfig ) {
2984                         var sData = this.fnGetTableData(oConfig);
2985                         $.ajax( {
2986                                 "url": oConfig.sAjaxUrl,
2987                                 "data": [
2988                                         { "name": "tableData", "value": sData }
2989                                 ],
2990                                 "success": oConfig.fnAjaxComplete,
2991                                 "dataType": "json",
2992                                 "type": "POST",
2993                                 "cache": false,
2994                                 "error": function () {
2995                                         alert( "Error detected when sending table data to server" );
2996                                 }
2997                         } );
2998                 },
2999                 "fnAjaxComplete": function( json ) {
3000                         alert( 'Ajax complete' );
3001                 }
3002         } ),
3003
3004         "div": $.extend( {}, TableTools.buttonBase, {
3005                 "sAction": "div",
3006                 "sTag": "div",
3007                 "sButtonClass": "DTTT_nonbutton",
3008                 "sButtonText": "Text button"
3009         } ),
3010
3011         "collection": $.extend( {}, TableTools.buttonBase, {
3012                 "sAction": "collection",
3013                 "sButtonClass": "DTTT_button_collection",
3014                 "sButtonText": "Collection",
3015                 "fnClick": function( nButton, oConfig ) {
3016                         this._fnCollectionShow(nButton, oConfig);
3017                 }
3018         } )
3019 };
3020 /*
3021  *  on* callback parameters:
3022  *     1. node - button element
3023  *     2. object - configuration object for this button
3024  *     3. object - ZeroClipboard reference (flash button only)
3025  *     4. string - Returned string from Flash (flash button only - and only on 'complete')
3026  */
3027
3028 // Alias to match the other plug-ins styling
3029 TableTools.buttons = TableTools.BUTTONS;
3030
3031
3032 /**
3033  * @namespace Classes used by TableTools - allows the styles to be override easily.
3034  *   Note that when TableTools initialises it will take a copy of the classes object
3035  *   and will use its internal copy for the remainder of its run time.
3036  */
3037 TableTools.classes = {
3038         "container": "DTTT_container",
3039         "buttons": {
3040                 "normal": "DTTT_button",
3041                 "disabled": "DTTT_disabled"
3042         },
3043         "collection": {
3044                 "container": "DTTT_collection",
3045                 "background": "DTTT_collection_background",
3046                 "buttons": {
3047                         "normal": "DTTT_button",
3048                         "disabled": "DTTT_disabled"
3049                 }
3050         },
3051         "select": {
3052                 "table": "DTTT_selectable",
3053                 "row": "DTTT_selected selected"
3054         },
3055         "print": {
3056                 "body": "DTTT_Print",
3057                 "info": "DTTT_print_info",
3058                 "message": "DTTT_PrintMessage"
3059         }
3060 };
3061
3062
3063 /**
3064  * @namespace ThemeRoller classes - built in for compatibility with DataTables'
3065  *   bJQueryUI option.
3066  */
3067 TableTools.classes_themeroller = {
3068         "container": "DTTT_container ui-buttonset ui-buttonset-multi",
3069         "buttons": {
3070                 "normal": "DTTT_button ui-button ui-state-default"
3071         },
3072         "collection": {
3073                 "container": "DTTT_collection ui-buttonset ui-buttonset-multi"
3074         }
3075 };
3076
3077
3078 /**
3079  * @namespace TableTools default settings for initialisation
3080  */
3081 TableTools.DEFAULTS = {
3082         "sSwfPath":        "../swf/copy_csv_xls_pdf.swf",
3083         "sRowSelect":      "none",
3084         "sRowSelector":    "tr",
3085         "sSelectedClass":  null,
3086         "fnPreRowSelect":  null,
3087         "fnRowSelected":   null,
3088         "fnRowDeselected": null,
3089         "aButtons":        [ "copy", "csv", "xls", "pdf", "print" ],
3090         "oTags": {
3091                 "container": "div",
3092                 "button": "a", // We really want to use buttons here, but Firefox and IE ignore the
3093                                  // click on the Flash element in the button (but not mouse[in|out]).
3094                 "liner": "span",
3095                 "collection": {
3096                         "container": "div",
3097                         "button": "a",
3098                         "liner": "span"
3099                 }
3100         }
3101 };
3102
3103 // Alias to match the other plug-ins
3104 TableTools.defaults = TableTools.DEFAULTS;
3105
3106
3107 /**
3108  * Name of this class
3109  *  @constant CLASS
3110  *  @type        String
3111  *  @default  TableTools
3112  */
3113 TableTools.prototype.CLASS = "TableTools";
3114
3115
3116 /**
3117  * TableTools version
3118  *  @constant  VERSION
3119  *  @type         String
3120  *  @default   See code
3121  */
3122 TableTools.version = "2.2.4";
3123
3124
3125
3126 // DataTables 1.10 API
3127 //
3128 // This will be extended in a big way in in TableTools 3 to provide API methods
3129 // such as rows().select() and rows.selected() etc, but for the moment the
3130 // tabletools() method simply returns the instance.
3131
3132 if ( $.fn.dataTable.Api ) {
3133         $.fn.dataTable.Api.register( 'tabletools()', function () {
3134                 var tt = null;
3135
3136                 if ( this.context.length > 0 ) {
3137                         tt = TableTools.fnGetInstance( this.context[0].nTable );
3138                 }
3139
3140                 return tt;
3141         } );
3142 }
3143
3144
3145
3146
3147 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
3148  * Initialisation
3149  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
3150
3151 /*
3152  * Register a new feature with DataTables
3153  */
3154 if ( typeof $.fn.dataTable == "function" &&
3155          typeof $.fn.dataTableExt.fnVersionCheck == "function" &&
3156          $.fn.dataTableExt.fnVersionCheck('1.9.0') )
3157 {
3158         $.fn.dataTableExt.aoFeatures.push( {
3159                 "fnInit": function( oDTSettings ) {
3160                         var init = oDTSettings.oInit;
3161                         var opts = init ?
3162                                 init.tableTools || init.oTableTools || {} :
3163                                 {};
3164
3165                         return new TableTools( oDTSettings.oInstance, opts ).dom.container;
3166                 },
3167                 "cFeature": "T",
3168                 "sFeature": "TableTools"
3169         } );
3170 }
3171 else
3172 {
3173         alert( "Warning: TableTools requires DataTables 1.9.0 or newer - www.datatables.net/download");
3174 }
3175
3176 $.fn.DataTable.TableTools = TableTools;
3177
3178 })(jQuery, window, document);
3179
3180 /*
3181  * Register a new feature with DataTables
3182  */
3183 if ( typeof $.fn.dataTable == "function" &&
3184          typeof $.fn.dataTableExt.fnVersionCheck == "function" &&
3185          $.fn.dataTableExt.fnVersionCheck('1.9.0') )
3186 {
3187         $.fn.dataTableExt.aoFeatures.push( {
3188                 "fnInit": function( oDTSettings ) {
3189                         var oOpts = typeof oDTSettings.oInit.oTableTools != 'undefined' ?
3190                                 oDTSettings.oInit.oTableTools : {};
3191
3192                         var oTT = new TableTools( oDTSettings.oInstance, oOpts );
3193                         TableTools._aInstances.push( oTT );
3194
3195                         return oTT.dom.container;
3196                 },
3197                 "cFeature": "T",
3198                 "sFeature": "TableTools"
3199         } );
3200 }
3201 else
3202 {
3203         alert( "Warning: TableTools 2 requires DataTables 1.9.0 or newer - www.datatables.net/download");
3204 }
3205
3206
3207 $.fn.dataTable.TableTools = TableTools;
3208 $.fn.DataTable.TableTools = TableTools;
3209
3210
3211 return TableTools;
3212 }; // /factory
3213
3214
3215 // Define as an AMD module if possible
3216 if ( typeof define === 'function' && define.amd ) {
3217         define( ['jquery', 'datatables'], factory );
3218 }
3219 else if ( typeof exports === 'object' ) {
3220     // Node/CommonJS
3221     factory( require('jquery'), require('datatables') );
3222 }
3223 else if ( jQuery && !jQuery.fn.dataTable.TableTools ) {
3224         // Otherwise simply initialise as normal, stopping multiple evaluation
3225         factory( jQuery, jQuery.fn.dataTable );
3226 }
3227
3228
3229 })(window, document);
3230