Subversion-Projekte lars-tiefland.cienc

Revision

Blame | Letzte Änderung | Log anzeigen | RSS feed

/*!
 * Flash export buttons for Buttons and DataTables.
 * 2015 SpryMedia Ltd - datatables.net/license
 *
 * ZeroClipbaord - MIT license
 * Copyright (c) 2012 Joseph Huckaby
 */

(function($, DataTable) {
"use strict";


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * ZeroClipboard dependency
 */

/*
 * ZeroClipboard 1.0.4 with modifications
 * Author: Joseph Huckaby
 * License: MIT
 *
 * Copyright (c) 2012 Joseph Huckaby
 */
var ZeroClipboard_TableTools = {
        version: "1.0.4-TableTools2",
        clients: {}, // registered upload clients on page, indexed by id
        moviePath: '', // URL to movie
        nextId: 1, // ID of next movie

        $: function(thingy) {
                // simple DOM lookup utility function
                if (typeof(thingy) == 'string') {
                        thingy = document.getElementById(thingy);
                }
                if (!thingy.addClass) {
                        // extend element with a few useful methods
                        thingy.hide = function() { this.style.display = 'none'; };
                        thingy.show = function() { this.style.display = ''; };
                        thingy.addClass = function(name) { this.removeClass(name); this.className += ' ' + name; };
                        thingy.removeClass = function(name) {
                                this.className = this.className.replace( new RegExp("\\s*" + name + "\\s*"), " ").replace(/^\s+/, '').replace(/\s+$/, '');
                        };
                        thingy.hasClass = function(name) {
                                return !!this.className.match( new RegExp("\\s*" + name + "\\s*") );
                        };
                }
                return thingy;
        },

        setMoviePath: function(path) {
                // set path to ZeroClipboard.swf
                this.moviePath = path;
        },

        dispatch: function(id, eventName, args) {
                // receive event from flash movie, send to client
                var client = this.clients[id];
                if (client) {
                        client.receiveEvent(eventName, args);
                }
        },

        register: function(id, client) {
                // register new client to receive events
                this.clients[id] = client;
        },

        getDOMObjectPosition: function(obj) {
                // get absolute coordinates for dom element
                var info = {
                        left: 0,
                        top: 0,
                        width: obj.width ? obj.width : obj.offsetWidth,
                        height: obj.height ? obj.height : obj.offsetHeight
                };

                if ( obj.style.width !== "" ) {
                        info.width = obj.style.width.replace("px","");
                }

                if ( obj.style.height !== "" ) {
                        info.height = obj.style.height.replace("px","");
                }

                while (obj) {
                        info.left += obj.offsetLeft;
                        info.top += obj.offsetTop;
                        obj = obj.offsetParent;
                }

                return info;
        },

        Client: function(elem) {
                // constructor for new simple upload client
                this.handlers = {};

                // unique ID
                this.id = ZeroClipboard_TableTools.nextId++;
                this.movieId = 'ZeroClipboard_TableToolsMovie_' + this.id;

                // register client with singleton to receive flash events
                ZeroClipboard_TableTools.register(this.id, this);

                // create movie
                if (elem) {
                        this.glue(elem);
                }
        }
};

ZeroClipboard_TableTools.Client.prototype = {

        id: 0, // unique ID for us
        ready: false, // whether movie is ready to receive events or not
        movie: null, // reference to movie object
        clipText: '', // text to copy to clipboard
        fileName: '', // default file save name
        action: 'copy', // action to perform
        handCursorEnabled: true, // whether to show hand cursor, or default pointer cursor
        cssEffects: true, // enable CSS mouse effects on dom container
        handlers: null, // user event handlers
        sized: false,

        glue: function(elem, title) {
                // glue to DOM element
                // elem can be ID or actual DOM element object
                this.domElement = ZeroClipboard_TableTools.$(elem);

                // float just above object, or zIndex 99 if dom element isn't set
                var zIndex = 99;
                if (this.domElement.style.zIndex) {
                        zIndex = parseInt(this.domElement.style.zIndex, 10) + 1;
                }

                // find X/Y position of domElement
                var box = ZeroClipboard_TableTools.getDOMObjectPosition(this.domElement);

                // create floating DIV above element
                this.div = document.createElement('div');
                var style = this.div.style;
                style.position = 'absolute';
                style.left = '0px';
                style.top = '0px';
                style.width = (box.width) + 'px';
                style.height = box.height + 'px';
                style.zIndex = zIndex;

                if ( typeof title != "undefined" && title !== "" ) {
                        this.div.title = title;
                }
                if ( box.width !== 0 && box.height !== 0 ) {
                        this.sized = true;
                }

                // style.backgroundColor = '#f00'; // debug
                if ( this.domElement ) {
                        this.domElement.appendChild(this.div);
                        this.div.innerHTML = this.getHTML( box.width, box.height ).replace(/&/g, '&');
                }
        },

        positionElement: function() {
                var box = ZeroClipboard_TableTools.getDOMObjectPosition(this.domElement);
                var style = this.div.style;

                style.position = 'absolute';
                //style.left = (this.domElement.offsetLeft)+'px';
                //style.top = this.domElement.offsetTop+'px';
                style.width = box.width + 'px';
                style.height = box.height + 'px';

                if ( box.width !== 0 && box.height !== 0 ) {
                        this.sized = true;
                } else {
                        return;
                }

                var flash = this.div.childNodes[0];
                flash.width = box.width;
                flash.height = box.height;
        },

        getHTML: function(width, height) {
                // return HTML for movie
                var html = '';
                var flashvars = 'id=' + this.id +
                        '&width=' + width +
                        '&height=' + height;

                if (navigator.userAgent.match(/MSIE/)) {
                        // IE gets an OBJECT tag
                        var protocol = location.href.match(/^https/i) ? 'https://' : 'http://';
                        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>';
                }
                else {
                        // all other browsers get an EMBED tag
                        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" />';
                }
                return html;
        },

        hide: function() {
                // temporarily hide floater offscreen
                if (this.div) {
                        this.div.style.left = '-2000px';
                }
        },

        show: function() {
                // show ourselves after a call to hide()
                this.reposition();
        },

        destroy: function() {
                // destroy control and floater
                var that = this;

                if (this.domElement && this.div) {
                        $(this.div).remove();

                        this.domElement = null;
                        this.div = null;

                        $.each( ZeroClipboard_TableTools.clients, function ( id, client ) {
                                if ( client === that ) {
                                        delete ZeroClipboard_TableTools.clients[ id ];
                                }
                        } );
                }
        },

        reposition: function(elem) {
                // reposition our floating div, optionally to new container
                // warning: container CANNOT change size, only position
                if (elem) {
                        this.domElement = ZeroClipboard_TableTools.$(elem);
                        if (!this.domElement) {
                                this.hide();
                        }
                }

                if (this.domElement && this.div) {
                        var box = ZeroClipboard_TableTools.getDOMObjectPosition(this.domElement);
                        var style = this.div.style;
                        style.left = '' + box.left + 'px';
                        style.top = '' + box.top + 'px';
                }
        },

        clearText: function() {
                // clear the text to be copy / saved
                this.clipText = '';
                if (this.ready) {
                        this.movie.clearText();
                }
        },

        appendText: function(newText) {
                // append text to that which is to be copied / saved
                this.clipText += newText;
                if (this.ready) { this.movie.appendText(newText) ;}
        },

        setText: function(newText) {
                // set text to be copied to be copied / saved
                this.clipText = newText;
                if (this.ready) { this.movie.setText(newText) ;}
        },

        setFileName: function(newText) {
                // set the file name
                this.fileName = newText;
                if (this.ready) {
                        this.movie.setFileName(newText);
                }
        },

        setAction: function(newText) {
                // set action (save or copy)
                this.action = newText;
                if (this.ready) {
                        this.movie.setAction(newText);
                }
        },

        addEventListener: function(eventName, func) {
                // add user event listener for event
                // event types: load, queueStart, fileStart, fileComplete, queueComplete, progress, error, cancel
                eventName = eventName.toString().toLowerCase().replace(/^on/, '');
                if (!this.handlers[eventName]) {
                        this.handlers[eventName] = [];
                }
                this.handlers[eventName].push(func);
        },

        setHandCursor: function(enabled) {
                // enable hand cursor (true), or default arrow cursor (false)
                this.handCursorEnabled = enabled;
                if (this.ready) {
                        this.movie.setHandCursor(enabled);
                }
        },

        setCSSEffects: function(enabled) {
                // enable or disable CSS effects on DOM container
                this.cssEffects = !!enabled;
        },

        receiveEvent: function(eventName, args) {
                var self;

                // receive event from flash
                eventName = eventName.toString().toLowerCase().replace(/^on/, '');

                // special behavior for certain events
                switch (eventName) {
                        case 'load':
                                // movie claims it is ready, but in IE this isn't always the case...
                                // bug fix: Cannot extend EMBED DOM elements in Firefox, must use traditional function
                                this.movie = document.getElementById(this.movieId);
                                if (!this.movie) {
                                        self = this;
                                        setTimeout( function() { self.receiveEvent('load', null); }, 1 );
                                        return;
                                }

                                // firefox on pc needs a "kick" in order to set these in certain cases
                                if (!this.ready && navigator.userAgent.match(/Firefox/) && navigator.userAgent.match(/Windows/)) {
                                        self = this;
                                        setTimeout( function() { self.receiveEvent('load', null); }, 100 );
                                        this.ready = true;
                                        return;
                                }

                                this.ready = true;
                                this.movie.clearText();
                                this.movie.appendText( this.clipText );
                                this.movie.setFileName( this.fileName );
                                this.movie.setAction( this.action );
                                this.movie.setHandCursor( this.handCursorEnabled );
                                break;

                        case 'mouseover':
                                if (this.domElement && this.cssEffects) {
                                        //this.domElement.addClass('hover');
                                        if (this.recoverActive) {
                                                this.domElement.addClass('active');
                                        }
                                }
                                break;

                        case 'mouseout':
                                if (this.domElement && this.cssEffects) {
                                        this.recoverActive = false;
                                        if (this.domElement.hasClass('active')) {
                                                this.domElement.removeClass('active');
                                                this.recoverActive = true;
                                        }
                                        //this.domElement.removeClass('hover');
                                }
                                break;

                        case 'mousedown':
                                if (this.domElement && this.cssEffects) {
                                        this.domElement.addClass('active');
                                }
                                break;

                        case 'mouseup':
                                if (this.domElement && this.cssEffects) {
                                        this.domElement.removeClass('active');
                                        this.recoverActive = false;
                                }
                                break;
                } // switch eventName

                if (this.handlers[eventName]) {
                        for (var idx = 0, len = this.handlers[eventName].length; idx < len; idx++) {
                                var func = this.handlers[eventName][idx];

                                if (typeof(func) == 'function') {
                                        // actual function reference
                                        func(this, args);
                                }
                                else if ((typeof(func) == 'object') && (func.length == 2)) {
                                        // PHP style object + method, i.e. [myObject, 'myMethod']
                                        func[0][ func[1] ](this, args);
                                }
                                else if (typeof(func) == 'string') {
                                        // name of function
                                        window[func](this, args);
                                }
                        } // foreach event handler defined
                } // user defined handler for event
        }
};

ZeroClipboard_TableTools.hasFlash = function ()
{
        try {
                var fo = new ActiveXObject('ShockwaveFlash.ShockwaveFlash');
                if (fo) {
                        return true;
                }
        }
        catch (e) {
                if (
                        navigator.mimeTypes &&
                        navigator.mimeTypes['application/x-shockwave-flash'] !== undefined &&
                        navigator.mimeTypes['application/x-shockwave-flash'].enabledPlugin
                ) {
                        return true;
                }
        }

        return false;
};

// For the Flash binding to work, ZeroClipboard_TableTools must be on the global
// object list
window.ZeroClipboard_TableTools = ZeroClipboard_TableTools;



/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Local (private) functions
 */

/**
 * If a Buttons instance is initlaised before it is placed into the DOM, Flash
 * won't be able to bind to it, so we need to wait until it is available, this
 * method abstracts that out.
 *
 * @param {ZeroClipboard} flash ZeroClipboard instance
 * @param {jQuery} node  Button
 */
var _glue = function ( flash, node )
{
        var id = node.attr('id');

        if ( node.parents('html').length ) {
                flash.glue( node[0], '' );
        }
        else {
                setTimeout( function () {
                        _glue( flash, node );
                }, 500 );
        }
};

/**
 * Get the title / file name for an exported file.
 *
 * @param {object}  config       Button configuration
 * @param {boolean} incExtension Include the file name extension
 */
var _filename = function ( config, incExtension )
{
        var title = config.title;

        if ( title.indexOf( '*' ) !== -1 ) {
                title = title.replace( '*', $('title').text() );
        }

        // Strip characters which the OS will object to
        title = title.replace(/[^a-zA-Z0-9_\u00A1-\uFFFF\.,\-_ !\(\)]/g, "");

        return incExtension === undefined || incExtension === true ?
                title+config.extension :
                title;
};

/**
 * Set the flash text. This has to be broken up into chunks as the Javascript /
 * Flash bridge has a size limit. There is no indication in the Flash
 * documentation what this is, and it probably depends upon the browser.
 * Experimentation shows that the point is around 50k when data starts to get
 * lost, so an 8K limit used here is safe.
 *
 * @param {ZeroClipboard} flash ZeroClipboard instance
 * @param {string}        data  Data to send to Flash
 */
var _setText = function ( flash, data )
{
        var parts = data.match(/[\s\S]{1,8192}/g) || [];

        flash.clearText();
        for ( var i=0, len=parts.length ; i<len ; i++ )
        {
                flash.appendText( parts[i] );
        }
};

/**
 * Get the newline character(s)
 *
 * @param {object}  config Button configuration
 * @return {string}        Newline character
 */
var _newLine = function ( config )
{
        return config.newline ?
                config.newline :
                navigator.userAgent.match(/Windows/) ?
                        '\r\n' :
                        '\n';
};

/**
 * Combine the data from the `buttons.exportData` method into a string that
 * will be used in the export file.
 *
 * @param  {DataTable.Api} dt     DataTables API instance
 * @param  {object}        config Button configuration
 * @return {object}               The data to export
 */
var _exportData = function ( dt, config )
{
        var newLine = _newLine( config );
        var data = dt.buttons.exportData( config.exportOptions );
        var join = function ( a ) {
                var s = '';
                var boundary = config.fieldBoundary;
                var separator = config.fieldSeparator;

                // If there is a field boundary, then we might need to escape it in
                // the source data
                for ( var i=0, ien=a.length ; i<ien ; i++ ) {
                        if ( i > 0 ) {
                                s += separator;
                        }

                        s += boundary ?
                                boundary + a[i].replace( boundary, '\\'+boundary ) + boundary :
                                a[i];
                }

                return s;
        };

        var header = config.header ? join( data.header )+newLine : '';
        var footer = config.footer ? newLine+join( data.footer ) : '';
        var body = [];

        for ( var i=0, ien=data.body.length ; i<ien ; i++ ) {
                body.push( join( data.body[i] ) );
        }

        return {
                str: header + body.join( newLine ) + footer,
                rows: body.length
        };
};


// Basic initialisation for the buttons is common between them
var flashButton = {
        available: function () {
                return ZeroClipboard_TableTools.hasFlash();
        },

        init: function ( dt, button, config ) {
                // Insert the Flash movie
                ZeroClipboard_TableTools.moviePath = DataTable.Buttons.swfPath;
                var flash = new ZeroClipboard_TableTools.Client();

                flash.setHandCursor( true );
                flash.addEventListener('mouseDown', function(client) {
                        config._fromFlash = true;
                        dt.button( button[0] ).trigger();
                        config._fromFlash = false;
                } );

                _glue( flash, button );

                config._flash = flash;
        },

        destroy: function ( dt, button, config ) {
                config._flash.destroy();
        },

        fieldSeparator: ',',

        fieldBoundary: '"',

        exportOptions: {},

        title: '*',

        extension: '.csv',

        header: true,

        footer: false
};


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * DataTables options and methods
 */

// Set the default SWF path
DataTable.Buttons.swfPath = '//cdn.datatables.net/buttons/1.0.0/swf/flashExport.swf';

// Method to allow Flash buttons to be resized when made visible - as they are
// of zero height and width if initialised hidden
DataTable.Api.register( 'buttons.resize()', function () {
        $.each( ZeroClipboard_TableTools.clients, function ( i, client ) {
                if ( client.domElement !== undefined && client.domElement.parentNode ) {
                        client.positionElement();
                }
        } );
} );


/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Button definitions
 */

// Copy to clipboard
DataTable.ext.buttons.copyFlash = $.extend( {}, flashButton, {
        className: 'buttons-copy buttons-flash',

        text: function ( dt ) {
                return dt.i18n( 'buttons.copy', 'Copy' );
        },

        action: function ( e, dt, button, config ) {
                // Check that the trigger did actually occur due to a Flash activation
                if ( ! config._fromFlash ) {
                        return;
                }

                var flash = config._flash;
                var data = _exportData( dt, config );

                flash.setAction( 'copy' );
                _setText( flash, data.str ); 

                dt.buttons.info(
                        dt.i18n( 'buttons.copyTitle', 'Copy to clipboard' ),
                        dt.i18n( 'buttons.copyInfo', {
                                _: 'Copied %d rows to clipboard',
                                1: 'Copied 1 row to clipboard'
                        }, data.rows ),
                        3000
                );
        },

        fieldSeparator: '\t',

        fieldBoundary: ''
} );

// CSV save file
DataTable.ext.buttons.csvFlash = $.extend( {}, flashButton, {
        className: 'buttons-csv buttons-flash',

        text: function ( dt ) {
                return dt.i18n( 'buttons.csv', 'CSV' );
        },

        action: function ( e, dt, button, config ) {
                // Set the text
                var flash = config._flash;
                var data = _exportData( dt, config );

                flash.setAction( 'csv' );
                flash.setFileName( _filename( config ) );
                _setText( flash, data.str );
        }
} );

// Excel save file - this is really a CSV file using UTF-8 that Excel can read
DataTable.ext.buttons.excelFlash = $.extend( {}, flashButton, {
        className: 'buttons-excel buttons-flash',

        text: function ( dt ) {
                return dt.i18n( 'buttons.excel', 'Excel' );
        },

        action: function ( e, dt, button, config ) {
                // Set the text
                var xml = '';
                var flash = config._flash;
                var data = dt.buttons.exportData( config.exportOptions );
                var addRow = function ( row ) {
                        var cells = [];

                        for ( var i=0, ien=row.length ; i<ien ; i++ ) {
                                cells.push( $.isNumeric( row[i] ) ?
                                        '<c t="n"><v>'+row[i]+'</v></c>' :
                                        '<c t="inlineStr"><is><t>'+
                                                row[i].replace(/&(?!amp;)/g, '&amp;')+
                                        '</t></is></c>'
                                );
                        }

                        return '<row>'+cells.join('')+'</row>';
                };

                if ( config.header ) {
                        xml += addRow( data.header );
                }

                for ( var i=0, ien=data.body.length ; i<ien ; i++ ) {
                        xml += addRow( data.body[i] );
                }

                if ( config.footer ) {
                        xml += addRow( data.footer );
                }

                flash.setAction( 'excel' );
                flash.setFileName( _filename( config ) );
                _setText( flash, xml );
        },

        extension: '.xlsx'
} );

// PDF export
DataTable.ext.buttons.pdfFlash = $.extend( {}, flashButton, {
        className: 'buttons-pdf buttons-flash',

        text: function ( dt ) {
                return dt.i18n( 'buttons.pdf', 'PDF' );
        },

        action: function ( e, dt, button, config ) {
                // Set the text
                var flash = config._flash;
                var data = dt.buttons.exportData( config.exportOptions );
                var totalWidth = dt.table().node().offsetWidth;

                // Calculate the column width ratios for layout of the table in the PDF
                var ratios = dt.columns( config.columns ).indexes().map( function ( idx ) {
                        return dt.column( idx ).header().offsetWidth / totalWidth;
                } );

                flash.setAction( 'pdf' );
                flash.setFileName( _filename( config ) );

                _setText( flash, JSON.stringify( {
                        title:       _filename(config, false),
                        message:     config.message,
                        colWidth:    ratios.toArray(),
                        orientation: config.orientation,
                        size:        config.pageSize,
                        header:      config.header ? data.header : null,
                        footer:      config.footer ? data.footer : null,
                        body:        data.body
                } ) );
        },

        extension: '.pdf',

        orientation: 'portrait',

        pageSize: 'A4',

        message: '',

        newline: '\n'
} );


})(jQuery, jQuery.fn.dataTable);