-
-
Notifications
You must be signed in to change notification settings - Fork 33.6k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
78 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,81 @@ | ||
# vue-template-compiler | ||
|
||
> This package is auto-generated. For pull requests please see `src/entries/web-compiler.js` | ||
> This package is auto-generated. For pull requests please see [src/entries/web-compiler.js](https://github.com/vuejs/vue/blob/next/src/entries/web-compiler.js). | ||
Documentation coming soon. | ||
This package can be used to pre-compile Vue 2.0 templates into render functions to avoid runtime-compilation overhead and CSP restrictions. You will only need it if you are writing build tools with very specific needs. In most cases you should be using [vue-loader](https://github.com/vuejs/vue-loader) or [vueify](https://github.com/vuejs/vueify) instead, both of which use this package internally. | ||
|
||
## Installation | ||
|
||
``` bash | ||
npm install vue-template-compiler | ||
``` | ||
|
||
``` js | ||
var compiler = require('vue-template-compiler') | ||
``` | ||
|
||
## API | ||
|
||
### compiler.compile(template, [options]) | ||
|
||
Compiles a template string and returns compiled JavaScript code. The returned result is an object of the following format: | ||
|
||
``` js | ||
{ | ||
render: string, // main render function code | ||
staticRenderFns: Array<string>, // render code for static sub trees, if any | ||
errors: Array<string> // template syntax errors, if any | ||
} | ||
``` | ||
|
||
Note the returned function code uses `with` and thus cannot be used in strict mode code. | ||
|
||
**Options** | ||
|
||
The optional `options` object can contain the following: | ||
|
||
- `modules` | ||
|
||
An array of compiler modules. For details on compiler modules, refer to its [type definition](https://github.com/vuejs/vue/blob/next/flow/compiler.js#L31) and the [built-in modules](https://github.com/vuejs/vue/tree/next/src/platforms/web/compiler/modules). | ||
|
||
- `directives` | ||
|
||
An object where the key is the directive name and the value is a function that transforms an template AST node. For example: | ||
|
||
``` js | ||
compiler.compile('<div v-test></div>', { | ||
directives: { | ||
test (node, directiveMeta) { | ||
// transform node based on directiveMeta | ||
} | ||
}) | ||
``` | ||
By default, a compile-time directive will extract the directive and the directive will not be present at runtime. If you want the directive to also be handled by a runtime definition, return `true` in the transform function. | ||
Refer to the implementation of some [built-in compile-time directives](https://github.com/vuejs/vue/tree/next/src/platforms/web/compiler/directives). | ||
--- | ||
### compiler.compileToFunctions(template) | ||
Similar to `compiler.compile`, but directly returns instantiated functions: | ||
``` js | ||
{ | ||
render: Function, | ||
staticRenderFns: Array<Function> | ||
} | ||
``` | ||
This is only useful at runtime with pre-configured builds, so it doesn't accept any compile-time options. In addition, this method uses `new Function()` so it is not CSP-compliant. | ||
--- | ||
### compiler.parseComponent(file, [options]) | ||
Parse a SFC (single-file component, or `*.vue` file) into a [descriptor](https://github.com/vuejs/vue/blob/next/flow/compiler.js#L131). This is used in SFC build tools like `vue-loader` and `vueify`. | ||
**Options** | ||
- `pad`: with `{ pad: true }`, the extracted content for each block will be padded with newlines to ensure that the line numbers align with the original file. This is useful when you are piping the extracted content into other pre-processors, as you will get correct line numbers if there are any syntax errors. |