Riot.jsでSPAを作る

Riot.jsの基礎とRiot.jsでSPAを作るときの基礎です

Transcript

1. Riot.jsでSPAを作る 2018/12/13 fun-tech #7 @khdd-mks
2. 自己紹介 ・北島久資 (@khdd-mks) ・オープンストリーム所属 アーキテクト ・ fun-tech 運営 ・ Scala が好きですが 仕事では Golang, Python, javascript とかやってます …
3. Riot.js
4. https://riot.js.org/
5. Riot.js ・ Web 上の UI コンポーネントを作るためのライブラリ ・要するに React.js や Vue.js と同じような領域のライブラリ ・ React.js や Vue.js よりも軽量でシンプルなのが特徴
6. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML 内にカスタムタグのマウント場所を用意する 4. HTML でカスタムタグファイルを読み込み、マウントする
7. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML 内にカスタムタグのマウント場所を用意する 4. HTML でカスタムタグファイルを読み込み、マウントする
8. <todo> <h3>{ opts.title }</h3> <ul> <li each={ item, i in items }>{ item }</li> </ul> <form onsubmit={ add }> <input ref="input"> <button>Add #{ items.length + 1 }</button> </form> <!-- 本当はこの辺りにcss(<style>～</style>)を指定 --> <script> this.items = [] add(e) { e.preventDefault() var input = this.refs.input this.items.push(input.value) input.value = '' } </script> </todo>
9. <todo> <h3>{ opts.title }</h3> <ul> <li each={ item, i in items }>{ item }</li> </ul> <form onsubmit={ add }> <input ref="input"> <button>Add #{ items.length + 1 }</button> </form> <!-- 本当はこの辺りにcss(<style>～</style>)を指定 --> <script> this.items = [] add(e) { e.preventDefault() var input = this.refs.input this.items.push(input.value) input.value = '' } </script> </todo> 全体をカスタムタグ名で囲む
10. <todo> <h3>{ opts.title }</h3> <ul> <li each={ item, i in items }>{ item }</li> </ul> <form onsubmit={ add }> <input ref="input"> <button>Add #{ items.length + 1 }</button> </form> <!-- 本当はこの辺りにcss(<style>～</style>)を指定 --> <script> this.items = [] add(e) { e.preventDefault() var input = this.refs.input this.items.push(input.value) input.value = '' } </script> </todo> HTMLを記述する 変数の埋め込みとかあるけど 何となく分かる感じ
11. <todo> <h3>{ opts.title }</h3> <ul> <li each={ item, i in items }>{ item }</li> </ul> <form onsubmit={ add }> <input ref="input"> <button>Add #{ items.length + 1 }</button> </form> <!-- 本当はこの辺りにcss(<style>～</style>)を指定 --> <script> this.items = [] add(e) { e.preventDefault() var input = this.refs.input this.items.push(input.value) input.value = '' } </script> </todo> CSSを記述する 普通に <style> h3 { font-size: 14px; } </style> みたいな感じで記述
12. <todo> <h3>{ opts.title }</h3> <ul> <li each={ item, i in items }>{ item }</li> </ul> <form onsubmit={ add }> <input ref="input"> <button>Add #{ items.length + 1 }</button> </form> <!-- 本当はこの辺りにcss(<style>～</style>)を指定 --> <script> this.items = [] add(e) { e.preventDefault() var input = this.refs.input this.items.push(input.value) input.value = '' } </script> </todo> 処理を記述する thisでカスタムタグ自身にアクセスできる メソッドを定義してHTML側のイベントハンドラ に指定する等が可能
13. <todo> <h3>{ opts.title }</h3> <ul> <li each={ item, i in items }>{ item }</li> </ul> <form onsubmit={ add }> <input ref="input"> <button>Add #{ items.length + 1 }</button> </form> <!-- 本当はこの辺りにcss(<style>～</style>)を指定 --> <script> this.items = [] add(e) { e.preventDefault() var input = this.refs.input this.items.push(input.value) input.value = '' } </script> </todo> カスタムタグに関する内容が 全て同じ場所に記述されているので 分かりやすい
14. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML 内にカスタムタグのマウント場所を用意する 4. HTML でカスタムタグファイルを読み込み、マウントする
15. <html> <head> <title>Hello Riot.</title> </head> <body> <todo></todo> <script type="riot/tag" src="todo.tag"></script> <script src="https://cdn.jsdelivr.net/npm/riot@3.13/riot+compiler.min.js"></script> <script>riot.mount('todo')</script> </body> </html>
16. <html> <head> <title>Hello Riot.</title> </head> <body> <todo></todo> <script type="riot/tag" src="todo.tag"></script> <script src="https://cdn.jsdelivr.net/npm/riot@3.13/riot+compiler.min.js"></script> <script>riot.mount('todo')</script> </body> </html> コンパイラ付のRiot.js クライアント側でカスタムタグをjavascriptに変換して実行す る
17. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML 内にカスタムタグのマウント場所を用意する 4. HTML でカスタムタグファイルを読み込み、マウントする
18. <html> <head> <title>Hello Riot.</title> </head> <body> <todo></todo> <script type="riot/tag" src="todo.tag"></script> <script src="https://cdn.jsdelivr.net/npm/riot@3.13/riot+compiler.min.js"></script> <script>riot.mount('todo')</script> </body> </html> カスタムタグ名そのままのタグを用 意するのが簡単 マウント方法が若干変わるが divタグ等でも可能
19. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML 内にカスタムタグのマウント場所を用意する 4. HTML でカスタムタグファイルを読み込み、マウントする
20. <html> <head> <title>Hello Riot.</title> </head> <body> <todo></todo> <script type="riot/tag" src="todo.tag"></script> <script src="https://cdn.jsdelivr.net/npm/riot@3.13/riot+compiler.min.js"></script> <script>riot.mount('todo')</script> </body> </html> カスタムタグファイルは普通にスクリプト タグで読み込めばいい riot.mount(‘todo’) で <todo></todo>にtodoタグの内容が埋 め込まれる
21. webpack のようなビルドシステムを 使わなくても普通にできる すごく簡単！！
22. |ﾟдﾟ) ＜ とか言って 実システムで webpack とか使 おうとすると逆に困るんだろ、 騙されんぞ
23. |ﾟдﾟ) ＜ とか言って 実システムで webpack とか使 おうとすると逆に困るんだろ、 騙されんぞ 大丈夫です
24. ビルドシステムを使用する場合 ・ webpack であれば riot-tag-loader 等の loader を使えば問題ない ・仮に他のビルドシステムを使用しており、そのビルドシステム用のものが 存在しなかったとしても $ riot --esm [カスタムタグのあるディレクトリ] [出力先のディレクトリ] でESモジュールに変換できるので、変換後のファイルを使用すればいい
25. ビルドシステムを使用する場合 // エントリポイントのjavascriptファイル import riot from 'riot'; require('./tags/todo.tag'); riot.mount('todo');
26. …require?
27. ビルドシステムを使用する場合 // エントリポイントのjavascriptファイル import riot from 'riot'; require('./tags/todo.tag'); riot.mount('todo'); Riot.jsは内部的に カスタムタグ名とその内容を対応付けて管理している (のでマウント時にカスタムタグ名しか指定していない) → ESモジュールに変換しても何もexportしないのでimportで はなくrequire
28. Riot.js の基本は分かった というわけで
29. SPA ※ここからが本題です
30. SPA SPA(SinglePageApplication) ・1つのページでアプリケーション全体を構築する手法 ・利点：ページ遷移を伴わないので高速化・通信量削減が期待できる ・欠点：クライアントサイドが複雑化しやすい
31. SPA に欠かせないのが 「見た目上ページ遷移して いるように見える機能」
32. Riot.js の場合 何を使用することも可能だが 特にこだわりが無いのであれば Riot.js の補助ライブラリである
33. Riot-Route
34. Riot-Route ・Riot.jsに標準では組み込まれていない → 別のものを使ってもいい ・特にRiot.jsと相乗効果は無い → Vue.jsのRouter (「Vue.js のコアと深く深く統合されており」とか紹介されている) 等とは真逆の発想 ・Riot.jsと同じくシンプル
35. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML で Riot-Router のスクリプトを読み込む 4. HTML 内に各ページ用のカスタムタグのマウント場所を用意する 5. HTML でカスタムタグファイルを読み込むが、直接マウントしない 6. Riot-Route の設定を行い、ルーティングを開始する
36. ちなみに webpack とか使わなくても できると思うけど ここでは webpack 使う前提で
37. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML で Riot-Router のスクリプトを読み込む 4. HTML 内に各ページ用のカスタムタグのマウント場所を用意する 5. HTML でカスタムタグファイルを読み込むが、直接マウントしない 6. Riot-Route の設定を行い、ルーティングを開始する
38. import riot from 'riot'; import route from 'riot-route'; import todoRoute from './router/todo'; import todo2Route from './router/todo2'; import todo3Route from './router/todo3'; require('./tags/menu.tag'); riot.mount('menu'); route.base('/'); // ホスト名以下の部分を #hoge -> /hoge で表示するのに必要 const subRoutes = [todoRoute, todo2Route, todo3Route]; for (const subRoute of subRoutes) { subRoute('div#main'); } route('', () => { route('/todo'); }) route.start(true); 普通にnpm install --save riot-route
39. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML で Riot-Router のスクリプトを読み込む 4. HTML 内に各ページ用のカスタムタグのマウント場所を用意する 5. HTML でカスタムタグファイルを読み込むが、直接マウントしない 6. Riot-Route の設定を行い、ルーティングを開始する
40. <html lang="ja"> <head> <meta charset="utf-8"> <title>Hello Riot.</title> <script src="js/app.js" defer></script> </head> <body> <menu></menu> <div id="main"></div> </body> </html> 複数のタグ(各ページ用のタグ)を マウントするため divタグで定義
41. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML で Riot-Router のスクリプトを読み込む 4. HTML 内に各ページ用のカスタムタグのマウント場所を用意する 5. HTML でカスタムタグファイルを読み込むが、直接マウントしない 6. Riot-Route の設定を行い、ルーティングを開始する
42. import riot from 'riot'; import route from 'riot-route'; import todoRoute from './router/todo'; import todo2Route from './router/todo2'; import todo3Route from './router/todo3'; require('./tags/menu.tag'); riot.mount('menu'); route.base('/'); // ホスト名以下の部分を #hoge -> /hoge で表示するのに必要 const subRoutes = [todoRoute, todo2Route, todo3Route]; for (const subRoute of subRoutes) { subRoute('div#main'); } route('', () => { route('/todo'); }) route.start(true); // ./router/todo.js import riot from 'riot'; import route from 'riot-route'; require('../tags/todo.tag'); // 直接マウントはしない export default function(mainSelector) { const todoRoute = route.create(); todoRoute('/todo', () => { riot.mount(mainSelector, 'todo'); }); return todoRoute; }
43. 基本 1. カスタムタグファイルを作る 2. HTML で Riot.js のスクリプトを読み込む ( コンパイラ含む ) 3. HTML で Riot-Router のスクリプトを読み込む 4. HTML 内に各ページ用のカスタムタグのマウント場所を用意する 5. HTML でカスタムタグファイルを読み込むが、直接マウントしない 6. Riot-Route の設定を行い、ルーティングを開始する
44. import riot from 'riot'; import route from 'riot-route'; import todoRoute from './router/todo'; import todo2Route from './router/todo2'; import todo3Route from './router/todo3'; require('./tags/menu.tag'); riot.mount('menu'); route.base('/'); // ホスト名以下の部分を #hoge -> /hoge で表示するのに必要 const subRoutes = [todoRoute, todo2Route, todo3Route]; for (const subRoute of subRoutes) { subRoute('div#main'); } route('', () => { route('/todo'); }) route.start(true); // ./router/todo.js import riot from 'riot'; import route from 'riot-route'; require('../tags/todo.tag'); export default function(mainSelector) { const todoRoute = route.create(); todoRoute('/todo', () => { // URLが /todo のとき riot.mount(mainSelector, 'todo'); // div#main にtodoタグをマウント }); return todoRoute; }
45. import riot from 'riot'; import route from 'riot-route'; import todoRoute from './router/todo'; import todo2Route from './router/todo2'; import todo3Route from './router/todo3'; require('./tags/menu.tag'); riot.mount('menu'); route.base('/'); // ホスト名以下の部分を #hoge -> /hoge で表示するのに必要 const subRoutes = [todoRoute, todo2Route, todo3Route]; for (const subRoute of subRoutes) { subRoute('div#main'); } route('', () => { route('/todo'); }) route.start(true); ルーティング開始
46. あと どのエンドポイントを呼ばれても 同じ HTML を返すように サーバー側を設定したりする必要がある が割愛
47. デモ ( 時間あれば )
48. ちなみに このスライド内のコードの完全版は $ git clone https://github.com/khdd-mks/funtech.git で見れます
49. ご清聴ありがとうございました