# html-docx-js-typescript
[![NPM version][npm-image]][npm-url]
> Rewrite [html-docx-js](https://www.npmjs.com/package/html-docx-js) with Typescript.
Convert HTML documents to docx format.
## Installing
```
npm install html-docx-js-typescript --save-dev
```
## Usage
Support node.js and browser enviroment, including vue/react/angular.
#### Vue.js usage demo:
```js
import { asBlob } from 'html-docx-js-typescript'
// if you want to save the docx file, you need import 'file-saver'
import { saveAs } from 'file-saver'
const htmlString = `
Document
Welcome
`
export default {
methods: {
saveDocx() {
asBlob(htmlString).then(data => {
saveAs(data, 'file.docx') // save as docx file
}) // asBlob() return Promise
},
},
}
```
And you can set options including margins and orientation.
```js
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:
``` js
import { asBlob } from 'html-docx-js-typescript'
const opt = {
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.
``` js
const opt = {
margin: {
top: 100
},
orientation: 'landscape' as const
}
```
## License
MIT
[npm-image]: https://img.shields.io/npm/v/html-docx-js-typescript
[npm-url]: https://npmjs.com/package/html-docx-js-typescript