本文へジャンプ

gulpでectを使ってみる:「gulp-ect」実践入門編

Posted by ARK

普段マークアップ関連は品質チェック中心の人間なのですが、何年ぶりかにマークアップをするとなかなかうまくいきませんね。
「知識だけあってもたまには実際に手を動かしてみないと本当の知識じゃない!」
と、つくづく頭デッカチになりかけている自分に反省しているARKです。

前置きが長くなりましたが、gulpって便利ですよね。
npmから直接叩くのもいいですが、他の人とかと合わせるには便利なものは使ってしまいたい派です。
今回はgulp-ectの導入・使い方のご紹介です。

ECTとは何ぞや?

過去記事でGrunt.jsからの使い方など紹介しているので、詳しくは見てもらえればわかると思いますが、ようはコーディングの際に共通DOMはテンプレート化しよう。ってことですね。

昔?でいう、Dreamweaverのテンプレート機能みたいなものです。
CMSのモジュールなどをイメージするとわかりやすいかもしれません。
後工程に優しく!というところからもマークアップ後にMovable TypeやWordPressを構築するときにもオススメです!

全体的な部分の記事は結構あるのですが、痒いところに届かない!
ことがあったのでそのあたりを中心にご紹介。
※あくまでその部分だけをメインに紹介してます。package.jsonすら使わない。(笑)

開発環境の準備

まずは何といっても開発環境を作りましょう。
僕はWindowsなので、コマンドプロンプトから。

  1. npm init //ひたすら「Enter」で心配しない。最後だけ「y」「Enter」。
  2. npm install gulp
  3. npm install gulp-ect

もちろんいつものpackage.jsonがある人は、npm installだけでOK。

インストールが終わったら、お決まりのgulpfile.jsを作りましょう。 今回はベタに。

  1. (function(){
  2. var _gulp = require('gulp');
  3. var _ect = require('gulp-ect');
  4.  
  5. _gulp.task('ect', function(){
  6. _gulp.src(['./src/ect/*.ect'])
  7. .pipe(_ect())
  8. .pipe(_gulp.dest('./bin/'));
  9. });
  10. })();

これで、

  1. gulp ect

を実行出来ればOKです。

ご紹介するgulp-ect機能の使い方

ECTの機能の紹介は色々な記事があるので詳しくは割愛しますが、今回はこのような機能を使う場合をご紹介。

  • 定数はまとめて定義
  • 共通パーツは一括管理
  • ページのレイアウトは一括管理
  • ページに応じて分岐・ループ処理

※なかなか情報がなかったりするので、オレオレだったりしますがもっといい方法をご存じの方は是非教えてください。(笑)

gulp-ectで定数をまとめて定義する

基本と思いきや、意外にもオフィシャルにも何も書かれていない定数。
Gruntの記事だとinitのときにセットして「<%- @const %>」みたいな感じで呼びだすようですが、gulp-ectの場合にはどうやるんだ?
gulp-ectを実行の際に「data」として渡してみたりするのですがどうも不便。
結論からいうと、gulp-ect実行時にセットするのではなく単純にgulpfile.jsからインポートしちゃいました。

具体的には、

1. _const.js という下記JSを作成する

  1. /**
  2. * 定数のセット
  3. */
  4. var config = {
  5. websiteURL:'https://www.monster-dive.com',
  6. websiteName: 'MONSTER DIVE【モンスターダイブ】',
  7. websiteKeywords:'monsterdive,モンスターダイブ,ウェブクリエイティブ,スマートフォンアプリ,CMS構築,映像製作,ライブ中継',
  8. author:'monsterdive, inc.',
  9. pageConfig:{
  10. top:{
  11. pageName:'TOP'
  12. },
  13. about:{
  14. pageName:'会社概要 | About '
  15. }
  16. },
  17. info:[
  18. {
  19. title:'ニュースタイトル1',
  20. text:'ニュースの記事1'
  21. },
  22. {
  23. title:'ニュースタイトル2',
  24. text:'ニュースの記事2'
  25. },
  26. {
  27. title:'ニュースタイトル3',
  28. text:'ニュースの記事3'
  29. },
  30. {
  31. title:'ニュースタイトル4',
  32. text:'ニュースの記事4'
  33. },
  34. {
  35. title:'ニュースタイトル5',
  36. text:'ニュースの記事5'
  37. },
  38. {
  39. title:'ニュースタイトル6',
  40. text:'ニュースの記事6'
  41. },
  42. ]
  43. };
  44. module.exports = config;

2. gulpfile.js から _const.js を読み込む

  1. var ectConfig = require('./src/js/include/_const.js');

3. gulp-ect 実行部分にセットする

  1. .pipe(_ect())

  1. .pipe(_ect({data: function (file, cb) {
  2. cb(ectConfig);
  3. }}))

に変更。

4. index.ect ファイル側で、呼びだす

  1. <!doctype html>
  2. <html lang="jp">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title><%- @websiteName %></title>
  6. </head>
  7. <body>
  8.  
  9. </body>
  10. </html>

gulp-ectで共通パーツは一括管理

ECTにはincludeという機能があるので、それを使います。

1. 呼び出し先となる _include/_header.ect ファイルを作成する

  1. <header>ヘッダー</header>

2. 呼び出し元の index.ect から呼び出す

  1. <% include '_include/_header' %>

3. 呼び出し先に変数を渡すとき

  1. <% include '_include/_header', {page: 'TOP'} %>

4. 呼び出し先で、変数を受け取る

  1. <header><%- @page %>のヘッダー</header>

gulp-ectでページのレイアウトは一括管理

ECTのextend機能です。

1. 呼び出し先となる、 layout/base.ext を作成する

  1. <!doctype html>
  2. <html lang="jp">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title><%- @websiteName %></title>
  6. </head>
  7. <body>
  8.  
  9. <main>
  10. <% content %>
  11. </main>
  12.  
  13. <footer>共通フッター</footer>
  14.  
  15. </body>
  16. </html>

2. 呼び出し元の index.ect を下記だけにする

  1. <% extend 'layout/base' %>
  2. <% include '_include/_header', {page: 'TOP'} %>
  3. <main>コンテンツ</main>

これで実行すると、こんな感じになれば成功です。

  1. <!doctype html>
  2. <html lang="jp">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>MONSTER DIVE【モンスターダイブ】</title>
  6. </head>
  7. <body>
  8.  
  9.  
  10. <header>TOPのヘッダー</header>
  11.  
  12. <main>コンテンツ</main>
  13.  
  14. <footer>共通フッター</footer>
  15.  
  16. </body>
  17. </html>

3. せっかくなので、親となる base.ect にも変数を渡したい

ECTのblockを使います。
index.ectを下記のように変更する。

  1. <% block 'description': %>TOPページです<% end %>
  2.  
  3. <% extend 'layout/base' %>
  4.  
  5. <% include '_include/_header', {page: 'TOP'} %>
  6.  
  7.  
  8. <main>コンテンツ</main>

base.ectに

  1. <meta name="description" content="<% content 'description' %>">

を追加。
「gulp ect」を実行し「TOPページです」が無事表示されると成功です。

4. 量産する

同じようにabout.ectを下記のように作ります。

  1. <% block 'description': %>ABOUTページです<% end %>
  2.  
  3. <% extend 'layout/base' %>
  4.  
  5. <% include '_include/_header', {page: 'ABOUT'} %>
  6.  
  7.  
  8. <main>ABOUTコンテンツ</main>

はい簡単に量産!

ページに応じて分岐・ループ処理

ここからは実践編です。
詳しい解説よりもTipsのほうがいいと思うのでどうぞ。

ループ処理1: _const.js に入れたinfoを表示

  1. <ul>
  2. <% for i in @info : %>
  3. <li>
  4. <p class="i-title"><%= i.title %></p>
  5. <p class="i-body"><%= i.text %></p>
  6. </li>
  7. <% end %>
  8. </ul>

ループ処理2: _const.js に入れたinfoを3件だけ表示

  1. <ul>
  2. <% @cnt=0 %>
  3. <% for i in @info : %>
  4. <% if @cnt<3: %>
  5. <li>
  6. <p class="i-title"><%= i.title %></p>
  7. <p class="i-body"><%= i.text %></p>
  8. </li>
  9. <% end %>
  10. <% @cnt++ %>
  11. <% end %>
  12. </ul>

分岐処理1: _header.ect での分岐

  1. <% if @page is 'TOP': %><p>TOPページだけ表示</p><% end %>

分岐処理2: base.ect での分岐

量産ページ(index.ect, about.ect)でpageを格納。

  1. <% block 'page': %>TOP<% end %>

base.ect側で、

  1. <% @page = content 'page' %>

で一旦格納したあとに、分岐させる。

  1. <% if @page is 'TOP': %>website<% else: %>article<% end %>

全部入りサンプル

./gulpfile.js

  1. (function(){
  2. var _gulp = require('gulp');
  3. var _ect = require('gulp-ect');
  4. var ectConfig = require('./src/js/include/_const.js');
  5. //■ECT
  6. _gulp.task('ect', function(){
  7. _gulp.src(['./src/ect/*.ect'])
  8. .pipe(_ect({data: function (file, cb) {
  9. cb(ectConfig);
  10. }}))
  11. .pipe(_gulp.dest('./bin/'));
  12. });
  13. })();

./src/js/include/_const.js

  1. /**
  2. * 定数のセット
  3. */
  4. var config = {
  5. websiteURL:'https://www.monster-dive.com',
  6. websiteName: 'MONSTER DIVE【モンスターダイブ】',
  7. websiteKeywords:'monsterdive,モンスターダイブ,ウェブクリエイティブ,スマートフォンアプリ,CMS構築,映像製作,ライブ中継',
  8. author:'monsterdive, inc.',
  9. pageConfig:{
  10. top:{
  11. pageName:'TOP'
  12. },
  13. about:{
  14. pageName:'会社概要 | About '
  15. }
  16. },
  17. info:[
  18. {
  19. title:'ニュースタイトル1',
  20. text:'ニュースの記事1'
  21. },
  22. {
  23. title:'ニュースタイトル2',
  24. text:'ニュースの記事2'
  25. },
  26. {
  27. title:'ニュースタイトル3',
  28. text:'ニュースの記事3'
  29. },
  30. {
  31. title:'ニュースタイトル4',
  32. text:'ニュースの記事4'
  33. },
  34. {
  35. title:'ニュースタイトル5',
  36. text:'ニュースの記事5'
  37. },
  38. {
  39. title:'ニュースタイトル6',
  40. text:'ニュースの記事6'
  41. },
  42. ]
  43. };
  44. module.exports = config;

./src/ect/_include/_header.ect

  1. <header>
  2. <p><%- @page %>のヘッダー</p>
  3. <% if @page is 'TOP': %><p>TOPページだけ表示</p><% end %>
  4. </header>

./src/ect/layout/base.ect

  1. <!doctype html>
  2. <html lang="jp">
  3. <head><% @page = content 'page' %>
  4. <meta charset="UTF-8">
  5. <title><%- @websiteName %></title>
  6. <meta name="description" content="<% content 'description' %>">
  7. <meta property="og:type" content="<% if @page is 'TOP': %>website<% else: %>article<% end %>">
  8. </head>
  9. <body>
  10. <% content %>
  11. <footer>共通フッター</footer>
  12. </body>
  13. </html>

./src/ect/index.ect

  1. <% block 'page': %>TOP<% end %>
  2. <% block 'description': %>TOPページです<% end %>
  3. <% extend 'layout/base' %>
  4. <% include '_include/_header', {page: 'TOP'} %>
  5. <main>
  6. <ul>
  7. <% @cnt=0 %>
  8. <% for i in @info : %>
  9. <% if @cnt<3: %>
  10. <li>
  11. <p class="i-title"><%= i.title %></p>
  12. <p class="i-body"><%= i.text %></p>
  13. </li>
  14. <% end %>
  15. <% @cnt++ %>
  16. <% end %>
  17. </ul>
  18. </main>

./src/ect/about.ect

  1. <% block 'page': %>ABOUT<% end %>
  2. <% block 'description': %>ABOUTページです<% end %>
  3. <% extend 'layout/base' %>
  4. <% include '_include/_header', {page: 'ABOUT'} %>
  5. <main>ABOUTコンテンツ</main>

まとめ

定数を使うことにより、

  • ディレクターさんでもテキスト更新だけでページがどのような状態になるか確認できたり、
  • アシスタントの人に手伝ってもらいやすくなったり、

モジュール化することにより、

  • 使いまわすので同じ修正を何度もすることがなくなり、
  • CMSへの受け渡しなど意図が伝えやすくなり、

レイアウトを共通化することにより、

  • 量産に手間をかけることもなくなり、
  • 分岐、ループもあるので、各ページ固有の処理はちゃんと書ける。

いいこと三昧ですね。
導入ハードルも低いので是非試してもらえればと思います。

このようにいかに前工程後ろ工程に優しく、自動化効率化できるところは楽にして、頭を使うところに注力しようと頑張っています!
といった会社アピールでした。(笑)

よきgulp-ectタイムを。

Recent Entries
MD EVENT REPORT
What's Hot?