browserify-ng-html2js
browserify-ng-html2js copied to clipboard
Browserify transform to compile html templates into angular template modules
browserify-ng-html2js
Browserify transform to compile angular templates into angular modules. Based on ng-html2js
$ npm install browserify-ng-html2js --save-dev
Usage
Use in either package.json or with gulp:
a) Package.json
Add the transform in package.json:
{
// ...
"browserify": {
"transform": ["browserify-ng-html2js"]
}
}
The templates will be available in their own modules based on their file name:
angular.module('home.html', []).run(["$templateCache", function($templateCache) {
$templateCache.put('home.html',
'<h2>Home</h2>\n' +
'<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit.</p>\n' +
'');
}]);
b) With Gulp
Add it to the browserify object and optionally specify a module name. This will attach all templates to the same module.
var gulp = require('gulp'),
browserify = require('browserify'),
ngHtml2Js = require('browserify-ng-html2js'),
source = require('vinyl-source-stream');
gulp.task('scripts', function() {
return browserify('./src/app.js')
.transform(ngHtml2Js({
module: 'templates', // optional module name
extension: 'ngt' // optionally specify what file types to look for
baseDir: "src/js" // optionally specify base directory for filename
stripPathBefore: '/templates', // optionally specify the part of the path that should be the starting point as a string or RegExp
prefix: '' // optionally specify a prefix to be added to the filename,
requireAngular: false // (default: false) optionally include `var angular = require('angular');`
// Supported in Angular 1.3.14 and above if you bundle angular with browserify
}))
.bundle()
.pipe(source('bundle.js'))
.pipe(gulp.dest('./dist'));
});
Output:
try {
module = angular.module('templates');
} catch (e) {
module = angular.module('templates', []);
}
module.run(["$templateCache", function($templateCache) {
$templateCache.put('home.html',
'<h2>Home</h2>\n' +
'<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Voluptate commodi, dolor vero. Temporibus eaque aliquam repudiandae dolore nemo, voluptas voluptatibus quod at officiis, voluptates adipisci pariatur expedita, quos ducimus inventore.</p>\n' +
'');
}]);
Example
To use the cached template in your browserified app. Simply require
it and depend on it in your angular app.
The example below illustrates the simple case (with no options) where the generated angular module containing the template is named after the filename of the template. And the name of the template that is put in angulars $templateCache
is also the filename of the template.
var angular = require('angular');
require('ui-router');
angular.module('myApp', [
'ui.router',
require('./templates/home.html') // it exports the name of the generated angular module: 'home.html'
]).config(function($stateProvider){
$stateProvider.state('home', {
url: '/',
templateUrl: 'home.html' // this is the template identifier that's put in angulars $templateCache
});
});