Html-docx-js-extension-typescript NPM

html-docx-js-extension-typescript

Modify html-docx-js-typescript with Typescript.

For previous code, I have added the setting of paper width and height. by default is A4

Convert HTML documents to docx format.

Installing

npm install html-docx-js-extension-typescript --save-dev

Usage

Support node.js and browser enviroment, including vue/react/angular.

Vue.js usage demo:

import { asBlob } from 'html-docx-js-extension-typescript'
// if you want to save the docx file, you need import 'file-saver'
import { saveAs } from 'file-saver'

const htmlString = `<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Document</title>
</head>
<body>
  <h1>Welcome</h1>
</body>
</html>`

export default {
  methods: {
    saveDocx() {
      asBlob(htmlString).then(data => {
        saveAs(data, 'file.docx') // save as docx file
      }) // asBlob() return Promise<Blob|Buffer>
    },
  },
}

And you can set options including margins and orientation and paper height and width , A4 is default.

const data = await asBlob(htmlString, { orientation: 'landscape', margins: { top: 100 } })

literal type widen issue

If you use this package in a Typescript file and declare the options to an independent Object like:

import { asBlob } from 'html-docx-js-extension-typescript'
const opt = {
  width: 11946, //A4 paper is default
  height: 16838,
  margin: {
    top: 100,
  },
  orientation: 'landscape', // type error: because typescript automatically widen this type to 'string' but not 'Orient' - 'string literal type'
}
await asBlob(html, opt)

You can use as const to avoid type widening.

const opt = {
  margin: {
    top: 100
  },
  orientation: 'landscape' as const
}

License

MIT

html-docx-js docx html typescript html-to-docx

browser-or-node jszip tslib

0.0.2

10 months ago