- Add toHtml method to convert data to HTML table format

   - Applies `mso-number-format:'\@'` style to cells to prevent Excel from changing formats
   - Supports configurable table class, cell styling, and header row options
   - Properly escapes HTML special characters in cell content
 - Add new format options to `toBlob` and `download` methods:
   - `format: 'html'` - outputs HTML table with MIME type `text/html` and `.html` extension
   - `format: 'xls-html'` - outputs HTML table with BOM and MIME type `application/vnd.ms-excel` for Excel compatibility with `.xls` extension
   - HTML options can be passed via `options.html` object
 - bump version

Author: zbryikt

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Change Logs
 
+## v0.4.1
+
+ - Add `toHtml` method to convert data to HTML table format
+   - Applies `mso-number-format:'\@'` style to cells to prevent Excel from changing formats
+   - Supports configurable table class, cell styling, and header row options
+   - Properly escapes HTML special characters in cell content
+ - Add new format options to `toBlob` and `download` methods:
+   - `format: 'html'` - outputs HTML table with MIME type `text/html` and `.html` extension
+   - `format: 'xls-html'` - outputs HTML table with BOM and MIME type `application/vnd.ms-excel` for Excel compatibility with `.xls` extension
+   - HTML options can be passed via `options.html` object
+
+
 ## v0.4.0
 
  - **BREAKING CHANGE**: Add option to choose between comma and tab as delimiter

README.md

@@ -31,16 +31,27 @@ csv4xls provides following APIs:
  - `toXlsx(data)` - convert given 2D array to XLSX workbook (requires XLSX library).
  - `toBlob(data, options = {delimiter: '\t', format: 'auto'})` - convert data to blob with specified format.
    - If `format` is `'xlsx'`, returns XLSX blob (requires XLSX library)
+   - If `format` is `'html'`, returns HTML table as blob with MIME type `text/html`
+   - If `format` is `'xls-html'`, returns HTML table with BOM as blob with MIME type `application/vnd.ms-excel`
+     - Uses `mso-number-format:'\@'` style to prevent Excel from changing formats
    - If `format` is `'auto'` (default), uses XLSX if available, otherwise falls back to CSV/TSV
    - If XLSX is not available or fails, falls back to CSV/TSV based on delimiter
+   - HTML options can be passed via `options.html` object (see `toHtml` for available options)
  - `toHref(data, options = {delimiter: '\t', format: 'auto'})` - same as `toBlob` but return a corresponding object url.
+ - `toHtml(data, options = {})` - convert given 2D array to HTML table format.
+   - `options.tableClass` - CSS class for the table (default: 'csv4xls-table')
+   - `options.cellStyle` - Whether to apply `mso-number-format:'\@'` style to cells to prevent Excel from changing formats (default: true)
+   - `options.headerRow` - Whether to treat the first row as a header row using `<th>` tags (default: false)
  - `download(data, name = "data", options = {delimiter: '\t', format: 'auto'})` - trigger file download
    - If `format` is `'xlsx'`, file extension will be `.xlsx` (requires XLSX library)
+   - If `format` is `'html'`, file extension will be `.html`
+   - If `format` is `'xls-html'`, file extension will be `.xls` (HTML with BOM that Excel can open)
    - If `format` is `'auto'` (default), uses XLSX if available, otherwise falls back to CSV/TSV
    - If using CSV/TSV: delimiter `','` → `.csv`, delimiter `'\t'` → `.tsv`
 
 
 ## Limitation
+
 - CSV/TSV format only works with Excel if file is opened directly. Doesn't work when importing with text import wizard.
 - Default delimiter is tab (`'\t'`), which creates TSV files.
 - File extension and MIME type are automatically set based on the format and delimiter:

dist/index.js

@@ -1,5 +1,5 @@
 (function(){
-  var hasXlsx, obj, csv4xls;
+  var hasXlsx, parseOption, obj, csv4xls;
   hasXlsx = function(){
     var e;
     try {
@@ -9,6 +9,16 @@
       return false;
     }
   };
+  parseOption = function(opt){
+    opt == null && (opt = {});
+    return {
+      format: opt.format || 'auto',
+      delimiter: opt.delimiter || ({
+        csv: ',',
+        tsv: 't'
+      }[opt.format] || 't')
+    };
+  };
   obj = {
     toString: function(data, delimiter){
       var str;
@@ -49,13 +59,12 @@
       return workbook;
     },
     toBlob: function(data, options){
-      var delimiter, format, workbook, buffer, e, ba, mimeType;
+      var ref$, format, delimiter, workbook, buffer, e, html, ba, i$, to$, i, mimeType;
       options == null && (options = {
-        delimiter: '\t',
+        delimiter: undefined,
         format: 'auto'
       });
-      delimiter = options.delimiter || '\t';
-      format = options.format || 'auto';
+      ref$ = parseOption(options), format = ref$.format, delimiter = ref$.delimiter;
       if (format === 'xlsx' || (format === 'auto' && hasXlsx())) {
         try {
           workbook = obj.toXlsx(data);
@@ -71,6 +80,26 @@
           console.warn("Failed to create XLSX. Falling back to CSV/TSV format.", e);
         }
       }
+      if (format === 'html') {
+        html = obj.toHtml(data, options.html || {});
+        return new Blob([html], {
+          type: "text/html"
+        });
+      }
+      if (format === 'xls-html') {
+        html = obj.toHtml(data, options.html || {});
+        ba = new Uint8Array(2 + html.length * 2);
+        ba[0] = 0xff;
+        ba[1] = 0xfe;
+        for (i$ = 0, to$ = html.length; i$ < to$; ++i$) {
+          i = i$;
+          ba[i * 2 + 2] = html.charCodeAt(i);
+          ba[i * 2 + 3] = html.charCodeAt(i) >> 8;
+        }
+        return new Blob([ba], {
+          type: "application/vnd.ms-excel"
+        });
+      }
       ba = obj.toArray(data, delimiter);
       mimeType = delimiter === ',' ? "text/csv" : "text/tab-separated-values";
       return new Blob([ba], {
@@ -80,35 +109,27 @@
     toHref: function(data, options){
       var blob;
       options == null && (options = {
-        delimiter: '\t',
+        delimiter: undefined,
         format: 'auto'
       });
       blob = obj.toBlob(data, options);
       return URL.createObjectURL(blob);
     },
     download: function(data, name, options){
-      var delimiter, format, extension, e, href, a;
+      var ref$, format, delimiter, extension, href, a;
       name == null && (name = "data");
       options == null && (options = {
-        delimiter: '\t',
+        delimiter: undefined,
         format: 'auto'
       });
-      delimiter = options.delimiter || '\t';
-      format = options.format || 'auto';
+      ref$ = parseOption(options), format = ref$.format, delimiter = ref$.delimiter;
       extension = format === 'xlsx' || (format === 'auto' && hasXlsx())
-        ? (function(){
-          try {
-            return '.xlsx';
-          } catch (e$) {
-            e = e$;
-            if (delimiter === ',') {
-              return '.csv';
-            } else {
-              return '.tsv';
-            }
-          }
-        }())
-        : delimiter === ',' ? '.csv' : '.tsv';
+        ? '.xlsx'
+        : format === 'html'
+          ? '.html'
+          : format === 'xls-html'
+            ? '.xls'
+            : delimiter === ',' ? '.csv' : '.tsv';
       href = this.toHref(data, options);
       a = document.createElement('a');
       a.setAttribute('href', href);
@@ -118,11 +139,37 @@
       document.body.appendChild(a);
       a.click();
       return document.body.removeChild(a);
+    },
+    toHtml: function(data, options){
+      var opts, html, i$, len$, i, row, isHeader, tag, j$, len1$, cell, style, safeCell;
+      options == null && (options = {});
+      opts = {
+        tableClass: options.tableClass || 'csv4xls-table',
+        cellStyle: options.cellStyle || true,
+        headerRow: options.headerRow || false
+      };
+      html = "<table class=\"" + opts.tableClass + "\">";
+      for (i$ = 0, len$ = data.length; i$ < len$; ++i$) {
+        i = i$;
+        row = data[i$];
+        isHeader = opts.headerRow && i === 0;
+        tag = isHeader ? 'th' : 'td';
+        html += "<tr>";
+        for (j$ = 0, len1$ = row.length; j$ < len1$; ++j$) {
+          cell = row[j$];
+          style = opts.cellStyle ? ' style="mso-number-format:\'\\@\';"' : '';
+          safeCell = ('' + cell).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#039;');
+          html += "<" + tag + style + ">" + safeCell + "</" + tag + ">";
+        }
+        html += "</tr>";
+      }
+      html += "</table>";
+      return html;
     }
   };
   csv4xls = function(data, options){
     options == null && (options = {
-      delimiter: '\t',
+      delimiter: undefined,
       format: 'auto'
     });
     return obj.toHref(data, options);

dist/index.min.js

@@ -8,7 +8,7 @@
     "dist/**/*"
   ],
   "description": "csv generator friendly for Microsoft Excel",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "homepage": "https://github.com/plotdb/csv4xls",
   "repository": {
     "type": "git",
@@ -19,10 +19,14 @@
   },
   "devDependencies": {
     "@loadingio/bootstrap.ext": "^0.0.12",
+    "@loadingio/debounce.js": "^1.0.1",
+    "@loadingio/ldquery": "^3.0.6",
     "@zbryikt/template": "^2.4.1",
     "bootstrap": "^4.6.1",
     "fedep": "^1.4.1",
+    "ldview": "^1.5.1",
     "livescript": ">=1.6.0",
+    "proxise": "^1.0.1",
     "uglify-js": "^3.13.1",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
@@ -31,6 +35,10 @@
     "modules": [
       "bootstrap",
       "@loadingio/bootstrap.ext",
+      "proxise",
+      "@loadingio/debounce.js",
+      "@loadingio/ldquery",
+      "ldview",
       "xlsx"
     ]
   }