Skip to content

Browserify transform to compile html templates into angular template modules

License

Notifications You must be signed in to change notification settings

javoire/browserify-ng-html2js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

browserify-ng-html2js

Build Status Dependency Status npm

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
  });
});

License

MIT License

About

Browserify transform to compile html templates into angular template modules

Resources

License

Stars

Watchers

Forks

Packages

No packages published