编辑 | blame | 历史 | 原始文档
Error: failed to parse markup
[![npm][npm]][npm-url]
[![node]]()
[![deps][deps]][deps-url]
[![tests][tests]][tests-url]
[![coverage][cover]][cover-url]
[![chat][chat]][chat-url]



PostHTML src="http://posthtml.github.io/posthtml/logo.svg">

PostHTML Render


Renders a PostHTML Tree to HTML/XML




Install



```bash
npm i -D posthtml-render
```

> ℹ️ This module is also available for [bower](http://bower.io) and as an AMD, CommonJS and IIFE (global) module, uncompressed and compressed

Usage



### `NodeJS`

```js
const render = require('posthtml-render')

const tree = []

const node = {}

node.tag = 'ul'
node.attrs = { class: 'list' }
node.content = [
'one',
'two',
'three'
].map((content) => ({ tag: 'li', content }))

tree.push(node)

const html = render(tree, options)

```

```html

  • one

  • two

  • three


```

### `🌐 Browser`

```html



Title





```

Options



|Name|Type|Default|Description|
|:--:|:--:|:-----:|:----------|
|**[`singleTags`](#singletags)**|`{Array}`|`[]`|Specify custom single tags (self closing)|
|**[`closingSingleTag`](#closingSingleTag)**|`{String}`|[`>`](#default)|Specify the single tag closing format|
|**[`quoteAllAttributes`](#quoteAllAttributes)**|`{Boolean}`|[`true`](#default)|Put double quotes around all tags, even when not necessary.|
|**[`replaceQuote`](#replaceQuote)**|`{Boolean}`|[`true`](#default)|Replaces quotes in attribute values with `"e;`.|
|**[`quoteStyle`](#quoteStyle)**|`{0|1|2}`|[`2`](#default)|Specify the style of quote arround the attribute values|

### `singleTags`

Specify custom single tags (self closing)

### `{String}`

```js
const render = require('posthtml-render')

const tree = [ { tag: 'name' } ]
const options = { singleTags: [ 'name' ] }

const html = render(tree, options)
```

**result.html**
```html

```

#### `{RegExp}`

```js
const render = require('posthtml-render')

const tree = [ { tag: '%=title%' } ]
const options = { singleTags: [ '/^%.*%$/' ] }

const html = render(tree, options)
```

**result.html**
```html
<%=title%>
```

### `closingSingleTag`

Specify the single tag closing format

#### `Formats`

```js
const render = require('posthtml-render')

const tree = [ { tag: 'img' } ]
```

##### `'tag'`

```js
const html = render(tree, { closingSingleTag: 'tag' })
```

```html

```

##### `'slash'`

```js
const html = render(tree, { closingSingleTag: 'slash' })
```

```html

```

##### `'default' (Default)`

```js
const html = render(tree)
```

```html

```

### `quoteAllAttributes`

Specify if all attributes should be quoted.

##### `true (Default)`

```html

```

##### `false`

```html

```

### `replaceQuote`

Replaces quotes in attribute values with `"e;`.

##### `true (Default)`

```html

```

##### `false`

```html
">
```

### `quoteStyle`

##### `2 (Default)`

Attribute values are wrapped in double quotes:

```html

```

##### `1`

Attribute values are wrapped in single quote:

```html

```

##### `0`

Quote style is based on attribute values (an alternative for `replaceQuote` option):

```html

```


[npm]: https://img.shields.io/npm/v/posthtml-render.svg
[npm-url]: https://npmjs.com/package/posthtml-render

[node]: https://img.shields.io/node/v/posthtml-render.svg
[node-url]: https://img.shields.io/node/v/posthtml-render.svg

[deps]: https://david-dm.org/posthtml/posthtml-render.svg
[deps-url]: https://david-dm.org/posthtml/posthtml-render

[tests]: http://img.shields.io/travis/posthtml/posthtml-render.svg
[tests-url]: https://travis-ci.org/posthtml/posthtml-render

[cover]: https://coveralls.io/repos/github/posthtml/posthtml-render/badge.svg
[cover-url]: https://coveralls.io/github/posthtml/posthtml-render

[chat]: https://badges.gitter.im/posthtml/posthtml.svg
[chat-url]: https://gitter.im/posthtml/posthtml