/*! © Lokesh Babu - datatables.net/license */ /** * This data rendering helper method can be useful when a hyperLink with custom * anchorText has to rendered. The data for the column is still fully searchable and sortable, based on the hyperLink value, * and sortable, based on the hyperLink value, but during display in webpage is rendered with custom placeholder * * It accepts four parameters: * * 1. 'anchorText' - type string - (optional - default `Click Here`) - The custom placeholder to display * 2. 'location' - type string - (optional - default `newTab`) * takes two values 'newTab' and 'popup' * 3. 'width' - type integer - (optional - default `600`) * The custom width of popup to display. * Value is utilised on when 'location' is given as 'popup'. * 4. 'height' - type integer - (optional - default `400`) * The custom height of popup to display. * Value is utilised on when 'location' is given as 'popup'. * * @name HyperLink * @summary Displays url data in hyperLink with custom placeholder * @author Lokesh Babu * @requires DataTables 3+ * @license MIT * * * @example * // Display the hyperlink with 'Click Here', which open hyperlink in new Tab or new Window based on Browser setting * new DataTable('#myTable', { * columnDefs: [ { * targets: 1, * render: DataTable.render.hyperLink() * } ] * } ); * * @example * // Display the hyperlink with 'Download', which open hyperlink in new Tab or new Window based on Browser setting * new DataTable('#myTable', { * columnDefs: [ { * targets: 2, * render: DataTable.render.hyperLink( 'Download' ) * } ] * } ); * * @example * // Display the hyperlink with 'Download', which open hyperlink in popup * // with size 600as width and 400 as height * new DataTable('#myTable', { * columnDefs: [ { * targets: 2, * render: DataTable.render.hyperLink( 'Download', 'popup' ) * } ] * } ); * * @example * // Display the hyperlink with 'Download', which open hyperlink in popup * // with size 1000 width and 500 as height * new DataTable('#myTable', { * columnDefs: [ { * targets: 2, * render: DataTable.render.hyperLink( 'Download', 'popup' , 1000, 500) * } ] * } ); */ import DataTable from 'datatables.net'; declare module 'datatables.net' { interface DataTablesStaticRender { /** Displays url data in hyperLink with custom plcaeholder */ hyperLink( anchorText: 'newTab' | 'popup' | string, location: string, width: number, height: number ): any; } } DataTable.render.hyperLink = function ( anchorText: string, location: string, widthIn?: number, heightIn?: number ) { var validateAndReturnDefaultIfFailed: ( item: any, defaultValue: any ) => number = function (item, defaultValue) { if (typeof item === 'number') { return item; } if (typeof item === 'string') { return parseInt(item) ? item : defaultValue; } return defaultValue; }; var anchorText = anchorText || 'Click Here'; var location = location || 'newTab'; var width = validateAndReturnDefaultIfFailed(widthIn, 600); var height = validateAndReturnDefaultIfFailed(heightIn, 400); return function (data: any, type: string, row: any) { // restriction only for table display rendering if (type !== 'display') { return data; } var url = data; try { url = new URL(data); switch (location) { case 'newTab': return ( '' + anchorText + '' ); case 'popup': return ( '' + anchorText + '' ); default: return ( '' + anchorText + '' ); } } catch (e) { return url; } }; };