Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/koa-modules/swig
Koa view render based on Swig, support tags, filters, and extensions
https://github.com/koa-modules/swig
Last synced: 24 days ago
JSON representation
Koa view render based on Swig, support tags, filters, and extensions
- Host: GitHub
- URL: https://github.com/koa-modules/swig
- Owner: koa-modules
- License: mit
- Created: 2014-03-14T15:57:59.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2017-04-17T12:34:08.000Z (over 7 years ago)
- Last Synced: 2024-11-05T08:19:10.955Z (about 1 month ago)
- Language: JavaScript
- Homepage:
- Size: 58.6 KB
- Stars: 30
- Watchers: 2
- Forks: 12
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: History.md
- License: LICENSE
Awesome Lists containing this project
- awesome-koa - koa-swig - [swig](http://paularmstrong.github.io/swig/)视图渲染中间件, 支持标签，过滤器和插件。   (仓库 / 中间件)
README
# koa-swig
[![NPM version][npm-img]][npm-url]
[![Build status][travis-img]][travis-url]
[![Test coverage][coveralls-img]][coveralls-url]
[![License][license-img]][license-url]
[![Dependency status][david-img]][david-url]
[Koa][] view render based on [Swig][], support tags, filters, and extensions.
[](https://nodei.co/npm/koa-swig/)
### Usage
* **v2.x**
```js
app.context.render = render(settings);
```
* **v1.x**
```js
render(app, settings);
```
#### Install
```
npm install koa-swig
```
#### Features
* First, automatically merge `ctx.state` from koa 0.14.
* Second, automatically merge `ctx.flash`.
* Finally, merge custom locals.
#### Example
```js
var koa = require('koa');
var render = require('koa-swig');
var app = koa();
app.context.render = render({
root: path.join(__dirname, 'views'),
autoescape: true,
cache: 'memory', // disable, set to false
ext: 'html',
locals: locals,
filters: filters,
tags: tags,
extensions: extensions
});
app.use(function *() {
yield this.render('index');
});
app.listen(2333);
```
```js
// koa v2.x
var co = require('co');
app.context.render = co.wrap(render({
// ...your setting
writeBody: false
}));
app.use(async ctx => ctx.body = await ctx.render('index'));
```
#### Settings
* [swig options](http://paularmstrong.github.io/swig/docs/api/#SwigOpts)
- autoescape
- cache
- locals
- varControls
- tagControls
- cmtControls
* filters: swig custom [filters](http://paularmstrong.github.io/swig/docs/extending/#filters)
* tags: swig custom [tags](http://paularmstrong.github.io/swig/docs/extending/#tags)
* extensions: add extensions for custom tags
* ext: default view extname
* root: view root directory
* writeBody: default(true) auto write body and response
#### Methods
* render.swig.setLocals
* render.swig.getLocals
#### Others
* [swig-extras](https://github.com/paularmstrong/swig-extras) A collection of handy tags, filters, and extensions for Swig.
### Licences
MIT
[koa]: http://koajs.com
[swig]: http://paularmstrong.github.io/swig/
[npm-img]: https://img.shields.io/npm/v/koa-swig.svg?style=flat-square
[npm-url]: https://npmjs.org/package/koa-swig
[travis-img]: https://img.shields.io/travis/koa-modules/swig.svg?style=flat-square
[travis-url]: https://travis-ci.org/koa-modules/swig
[coveralls-img]: https://img.shields.io/coveralls/koa-modules/swig.svg?style=flat-square
[coveralls-url]: https://coveralls.io/r/koa-modules/swig?branch=master
[license-img]: https://img.shields.io/badge/license-MIT-green.svg?style=flat-square
[license-url]: LICENSE
[david-img]: https://img.shields.io/david/koa-modules/swig.svg?style=flat-square
[david-url]: https://david-dm.org/koa-modules/swig