AngularJSアプリケーションにHamlを導入するメモ


前回の CoffeeScript の導入（⇒[AngularJSアプリケーションをCoffeeScriptで書くよ](http://qiita.com/hkusu/items/e7d4ef58626cdda22a59)）に引き続き、今回は [Haml](http://haml.info) を AngularJS の開発環境へ組み込んだ際のメモです。

Hamlを利用すると、次のようにすっきりした構文で HTML を書くことができます。例えば次のようなHTMLは、

```:sample.html
<section class=”container”>
  <h1><%= post.title %></h1>
  <h2><%= post.subtitle %></h2>
  <div class=”content”>
    <%= post.content %>
  </div>
</section>
```

Hamlで書くと次のような感じです（例は[Haml](http://haml.info) のサイトから引用）。

```html:sample.haml
%section.container
  %h1= post.title
  %h2= post.subtitle
  .content
    = post.content
```

AngularJSの開発環境に、Grunt のビルドプロセス含めて導入してみました。

## 前提

- 環境は Mac OS です。
- Yeoman および AngularJSのジェネレータ(generator-angular)を使います。

> もし Yeoman や ジェネレータ をまだインストールしていない場合、こちらを参考にインストールしてください → [Yeoman で AngularJS ＆ UI Bootstrap の開発環境構築](http://qiita.com/hkusu/items/7d748b55ba73cc8a3675)

## 手順

### ① Hamlのインストール

まず gem コマンドで Haml自体をインストールします。

```
# gem install haml
```

これでコマンドラインベースで Haml が実行できる状態になっています。

### ② AngularJSアプリケーションの雛型を作成

必須ではありませんが、ついでに CoffeeScript も導入しておきます。
（もし不要なら `--coffee` オプションを外してください。）

```
$ yo angular --minsafe --coffee
```

### ③ このプロジェクトへ grunt-haml を導入

Haml を Grunt と連動させたいので、[grunt-haml](https://github.com/concordusapps/grunt-haml) をインストールします。

```
$ npm install grunt-haml
```

※今回はこのプロジェクトだけに適用したいので `-g` オプションはつけません。

そうすると、`node_modules` ディレクトリ配下に、次のように配置されます。

![スクリーンショット 2014-04-07 23.32.51.png](https://qiita-image-store.s3.amazonaws.com/0/35733/4eb2364b-761a-d915-c0df-aaf364c09647.png "スクリーンショット 2014-04-07 23.32.51.png")

### ④ Gruntの設定をする

ちょっと長くなりますが、`Gruntfile.js` で 次のように５カ所を追記します。
（+で示したところです。）

```diff:Gruntfile.js
// Generated on 2014-04-07 using generator-angular 0.7.1
'use strict';

// # Globbing
// for performance reasons we're only matching one level down:
// 'test/spec/{,*/}*.js'
// use this if you want to recursively match all subfolders:
// 'test/spec/**/*.js'

module.exports = function (grunt) {

  // Load grunt tasks automatically
  require('load-grunt-tasks')(grunt);

  // Time how long tasks take. Can help when optimizing build times
  require('time-grunt')(grunt);

+  grunt.loadNpmTasks('grunt-haml');

  // Define the configuration for all the tasks
  grunt.initConfig({

    // Project settings
    yeoman: {
      // configurable paths
      app: require('./bower.json').appPath || 'app',
      dist: 'dist'
    },

    // Watches files for changes and runs tasks based on the changed files
    watch: {
      coffee: {
        files: ['<%= yeoman.app %>/scripts/{,*/}*.{coffee,litcoffee,coffee.md}'],
        tasks: ['newer:coffee:dist']
      },
      coffeeTest: {
        files: ['test/spec/{,*/}*.{coffee,litcoffee,coffee.md}'],
        tasks: ['newer:coffee:test', 'karma']
      },
+      haml: {
+        files: ['<%= yeoman.app %>/{,*/}*.haml'],
+        tasks: ['haml']
+      },
      styles: {
        files: ['<%= yeoman.app %>/styles/{,*/}*.css'],
        tasks: ['newer:copy:styles', 'autoprefixer']
      },
      gruntfile: {
        files: ['Gruntfile.js']
      },
      livereload: {
        options: {
          livereload: '<%= connect.options.livereload %>'
        },
        files: [
          '<%= yeoman.app %>/{,*/}*.html',
          '.tmp/styles/{,*/}*.css',
          '.tmp/scripts/{,*/}*.js',
          '<%= yeoman.app %>/images/{,*/}*.{png,jpg,jpeg,gif,webp,svg}'
        ]
      }
    },

    // The actual grunt server settings
    connect: {
      options: {
        port: 9000,
        // Change this to '0.0.0.0' to access the server from outside.
        hostname: 'localhost',
        livereload: 35729
      },
      livereload: {
        options: {
          open: true,
          base: [
            '.tmp',
            '<%= yeoman.app %>'
          ]
        }
      },
      test: {
        options: {
          port: 9001,
          base: [
            '.tmp',
            'test',
            '<%= yeoman.app %>'
          ]
        }
      },
      dist: {
        options: {
          base: '<%= yeoman.dist %>'
        }
      }
    },

    // Make sure code styles are up to par and there are no obvious mistakes
    jshint: {
      options: {
        jshintrc: '.jshintrc',
        reporter: require('jshint-stylish')
      },
      all: [
        'Gruntfile.js'
      ]
    },

    // Empties folders to start fresh
    clean: {
      dist: {
        files: [{
          dot: true,
          src: [
            '.tmp',
            '<%= yeoman.dist %>/*',
            '!<%= yeoman.dist %>/.git*'
          ]
        }]
      },
      server: '.tmp'
    },

    // Add vendor prefixed styles
    autoprefixer: {
      options: {
        browsers: ['last 1 version']
      },
      dist: {
        files: [{
          expand: true,
          cwd: '.tmp/styles/',
          src: '{,*/}*.css',
          dest: '.tmp/styles/'
        }]
      }
    },

    // Automatically inject Bower components into the app
    'bower-install': {
      app: {
        html: '<%= yeoman.app %>/index.html',
        ignorePath: '<%= yeoman.app %>/'
      }
    },


    // Compiles CoffeeScript to JavaScript
    coffee: {
      options: {
        sourceMap: true,
        sourceRoot: ''
      },
      dist: {
        files: [{
          expand: true,
          cwd: '<%= yeoman.app %>/scripts',
          src: '{,*/}*.coffee',
          dest: '.tmp/scripts',
          ext: '.js'
        }]
      },
      test: {
        files: [{
          expand: true,
          cwd: 'test/spec',
          src: '{,*/}*.coffee',
          dest: '.tmp/spec',
          ext: '.js'
        }]
      }
    },


+    haml: {
+      two: {
+        files: grunt.file.expandMapping(['app/views/*.haml'], './',{
+          rename: function(base, path) {
+            return base + path.replace(/\.haml$/, '.html');
+          }
+        }),
+        options: {
+          language: 'ruby'
+        }
+      }
+    },


    // Renames files for browser caching purposes
    rev: {
      dist: {
        files: {
          src: [
            '<%= yeoman.dist %>/scripts/{,*/}*.js',
            '<%= yeoman.dist %>/styles/{,*/}*.css',
            '<%= yeoman.dist %>/images/{,*/}*.{png,jpg,jpeg,gif,webp,svg}',
            '<%= yeoman.dist %>/styles/fonts/*'
          ]
        }
      }
    },

    // Reads HTML for usemin blocks to enable smart builds that automatically
    // concat, minify and revision files. Creates configurations in memory so
    // additional tasks can operate on them
    useminPrepare: {
      html: '<%= yeoman.app %>/index.html',
      options: {
        dest: '<%= yeoman.dist %>'
      }
    },

    // Performs rewrites based on rev and the useminPrepare configuration
    usemin: {
      html: ['<%= yeoman.dist %>/{,*/}*.html'],
      css: ['<%= yeoman.dist %>/styles/{,*/}*.css'],
      options: {
        assetsDirs: ['<%= yeoman.dist %>']
      }
    },

    // The following *-min tasks produce minified files in the dist folder
    imagemin: {
      dist: {
        files: [{
          expand: true,
          cwd: '<%= yeoman.app %>/images',
          src: '{,*/}*.{png,jpg,jpeg,gif}',
          dest: '<%= yeoman.dist %>/images'
        }]
      }
    },
    svgmin: {
      dist: {
        files: [{
          expand: true,
          cwd: '<%= yeoman.app %>/images',
          src: '{,*/}*.svg',
          dest: '<%= yeoman.dist %>/images'
        }]
      }
    },
    htmlmin: {
      dist: {
        options: {
          collapseWhitespace: true,
          collapseBooleanAttributes: true,
          removeCommentsFromCDATA: true,
          removeOptionalTags: true
        },
        files: [{
          expand: true,
          cwd: '<%= yeoman.dist %>',
          src: ['*.html', 'views/{,*/}*.html'],
          dest: '<%= yeoman.dist %>'
        }]
      }
    },

    // Allow the use of non-minsafe AngularJS files. Automatically makes it
    // minsafe compatible so Uglify does not destroy the ng references
    ngmin: {
      dist: {
        files: [{
          expand: true,
          cwd: '.tmp/concat/scripts',
          src: '*.js',
          dest: '.tmp/concat/scripts'
        }]
      }
    },

    // Replace Google CDN references
    cdnify: {
      dist: {
        html: ['<%= yeoman.dist %>/*.html']
      }
    },

    // Copies remaining files to places other tasks can use
    copy: {
      dist: {
        files: [{
          expand: true,
          dot: true,
          cwd: '<%= yeoman.app %>',
          dest: '<%= yeoman.dist %>',
          src: [
            '*.{ico,png,txt}',
            '.htaccess',
            '*.html',
            'views/{,*/}*.html',
            'bower_components/**/*',
            'images/{,*/}*.{webp}',
            'fonts/*'
          ]
        }, {
          expand: true,
          cwd: '.tmp/images',
          dest: '<%= yeoman.dist %>/images',
          src: ['generated/*']
        }]
      },
      styles: {
        expand: true,
        cwd: '<%= yeoman.app %>/styles',
        dest: '.tmp/styles/',
        src: '{,*/}*.css'
      }
    },

    // Run some tasks in parallel to speed up the build process
    concurrent: {
      server: [
        'coffee:dist',
+        'haml',
        'copy:styles'
      ],
      test: [
        'coffee',
        'copy:styles'
      ],
      dist: [
        'coffee',
+        'haml',
        'copy:styles',
        'imagemin',
        'svgmin'
      ]
    },

    // By default, your `index.html`'s <!-- Usemin block --> will take care of
    // minification. These next options are pre-configured if you do not wish
    // to use the Usemin blocks.
    // cssmin: {
    //   dist: {
    //     files: {
    //       '<%= yeoman.dist %>/styles/main.css': [
    //         '.tmp/styles/{,*/}*.css',
    //         '<%= yeoman.app %>/styles/{,*/}*.css'
    //       ]
    //     }
    //   }
    // },
    // uglify: {
    //   dist: {
    //     files: {
    //       '<%= yeoman.dist %>/scripts/scripts.js': [
    //         '<%= yeoman.dist %>/scripts/scripts.js'
    //       ]
    //     }
    //   }
    // },
    // concat: {
    //   dist: {}
    // },

    // Test settings
    karma: {
      unit: {
        configFile: 'karma.conf.js',
        singleRun: true
      }
    }

  });


  grunt.registerTask('serve', function (target) {
    if (target === 'dist') {
      return grunt.task.run(['build', 'connect:dist:keepalive']);
    }

    grunt.task.run([
      'clean:server',
      'bower-install',
      'concurrent:server',
      'autoprefixer',
      'connect:livereload',
      'watch'
    ]);
  });

  grunt.registerTask('server', function () {
    grunt.log.warn('The `server` task has been deprecated. Use `grunt serve` to start a server.');
    grunt.task.run(['serve']);
  });

  grunt.registerTask('test', [
    'clean:server',
    'concurrent:test',
    'autoprefixer',
    'connect:test',
    'karma'
  ]);

  grunt.registerTask('build', [
    'clean:dist',
    'bower-install',
    'useminPrepare',
    'concurrent:dist',
    'autoprefixer',
    'concat',
    'ngmin',
    'copy:dist',
    'cdnify',
    'cssmin',
    'uglify',
    'rev',
    'usemin',
    'htmlmin'
  ]);

  grunt.registerTask('default', [
    'newer:jshint',
    'test',
    'build'
  ]);
};
```

- 変更箇所の説明：
	- １カ所目
		- `grunt-haml`モジュールを読み込みます。
	- ２カ所目
		- ファイル変更の監視です。`.haml` ファイルが変更されたらタスクを走らせます。
	- ３カ所目
		- grunt-haml の変換設定です。任意の `.haml` ファイルを同名の `.html` ファイルへ出力します。
			- パスを変更したい場合はここを適当に変えてください。
	- ４カ所目
		- `$ grunt serve` した時に grunt-haml を適用します。
	- ５カ所目
		- `$ grunt build` した時に grunt-haml を適用します。

以上で導入は完了です。

## 試してみる

- `main.coffee` を見ると、デフォルトで次のようになっています。このファイルは特に変更せずに、ここで定義されている `awesomeThings(配列)` の値を、ブラウザへ表示してみます。

```javascript:app/scripts/controllers/main.coffee
'use strict'

angular.module('hamlTest2App')
  .controller 'MainCtrl', ['$scope', ($scope) ->
    $scope.awesomeThings = [
      'HTML5 Boilerplate'
      'AngularJS'
      'Karma'
    ]
  ]
```

- Haml の記法に従って、`main.haml` を次のように記載します。

```javascript:app/views/main.haml
%div{"ng-controller" => "MainCtrl"}
  %span{"ng-repeat" => "awe in awesomeThings"}
    {{awe}}
    %br
```

- コマンドラインで `$ grunt serve` を実行します。そうするとブラウザへ先ほどの文字列が表示されることが確認できます。

![スクリーンショット 2014-04-08 11.33.15.png](https://qiita-image-store.s3.amazonaws.com/0/35733/a0d5a3dd-67a9-0cd3-fef8-18afdfaddf8b.png "スクリーンショット 2014-04-08 11.33.15.png")

- ディレクトリを見てみると、`main.haml` と同一ディレクトリに `main.html` が生成されているのが確認できます。

```html:app/views/main.html
<div ng-controller='MainCtrl'>
<span ng-repeat='awe in awesomeThings'>
{{awe}}
<br>
</span>
</div>
```

## 補足

- grunt-haml 以外に [grunt-contrib-haml](https://github.com/jhchen/grunt-contrib-haml)というのもあるのですが、「任意のファイル名」の `.haml` ファイルを `.html` ファイルへ変換する方法がわからず、こっちを使っています。
- Haml を導入したからといって、全てのテンプレートを Haml形式で書かなかればならないわけではありません。HTML形式のままの方が都合が良い場合は、`.haml` ファイルを作らなければいいだけです。
- いまさらですが、なんとなく AngularJS の場合、Haml で書いても記述量が減らないような..
	- Haml で `class=` を省略できても、そもそも使わないので..
	- 書き方が悪いのかな。もうちょい検証してみます^^;