ハイブリッドなモバイルアプリを開発する際には、UIフレームワークの導入が欠かせません。
Monacaでは公式にOnsenUIを提供していますが、他にも選択肢があります。バージョンアップが頻繁に行われており、高機能なUIフレームワークとして注目されているのがFramework7です。
Framework7を使ってUIを作るのは簡単です。まず基本となるルーティングやイベントなどを押さえておく必要があるでしょう。この記事では、Framework7の基礎について解説します。
記事では、Framework7のバージョン6を対象としています。以前、またはバージョン7以降では使い方が変わる可能性がありますのでご注意ください。
また、今回は素のJavaScript(Vanilla JS)を対象としています。VueやReactなどのフレームワークは利用していません。
Framework7の導入
Framework7は 、「framework7.min.css」 と 「framework7.min.js」 を読み込んで利用します。このファイルは、Framework7 CLIにて新規でアプリケーションを作成し、作成完了後に 「npm run postinstall」 を実行すると 「www/framework7」 以下に作成されます。
ファイルを直接アプリ内に配置しないでCDNを利用する場合は、次のように設定することでFramework7を利用できます。
そして、HTMLにFramework7用のDOMを用意します。一般的に #app
と設定します。
HTMLのDOMの操作は、Framework7で提供されているDom7というDOM操作用のライブラリをローカル変数に展開するのが一般的です。
Dom7は、jQueryライクにクラスを追加したり、要素を変更したりできます。簡単な使い方は後述しますが、詳しくはDom7 - カスタムDOMライブラリ | Framework7 Documentationを参照してください。
そして、JavaScriptにてFramework7を次のように初期化します。
ここまでで初期化が終了します。
後は index.html
の #app
の中にframework7のルールに合わせてHTMLを記述していきます。
ルーティング
※ ルーターの日本語公式ドキュメントは、ルーター | Framework7 Documentationを参照してください。
Framework7を使う際に、少し難しくなる概念として「ルーティング」があります。
先ほど初期化する際に routes
で指定していた変数です。たとえば次のような形で定義されます。
path
キーで指定された形でアクセスがあると、 url
で指定されたページを表示します。
たとえば、パス「/about」にアクセスがあると、urlで指定しているpagesディレクトリ配下にある「about.html」が表示されます。
パス「/about」にリンクするaタグを次のように記述します。ここでは、JavaScriptを記述する必要はありません。
そして、 pages/about.html
では、 div.page
の中でFramework7のHTMLを記述します。
ここまでの準備で、パス「/about」にリンクする aタグをクリックすると、「pages/about.html」が表示されるようになります。
補足となりますが、この url
キーで指定したページの場合、JavaScriptを実行したり、前の画面から情報を引き継いで表示を変更したりできません。
JavaScriptを利用する場合には、次に紹介する componentUrl を使います。
コンポーネント実行
※ ルーターコンポーネントの日本語公式ドキュメントは、ルーターコンポーネント | Framework7 Documentationを参照してください。
動的にページ内容を構築したり、ページ内でクリックなどのイベントを使いたい場合には componentUrl
を使います。ルーティングのファイル内に、次のように記述します。
この componentUrl
を使った場合、componentUrlで指定したHTMLページの基本形は、次のようになります。この形は固定と考えてください。
export default function (props, {$f7, $on}) {
では $f7
と $on
しか取得していませんが、他にも以下のような変数が取得できます。
変数名 | 内容 |
---|---|
$ | Dom7ライブラリです。 |
$el | valueプロパティがページのDom7インスタンスを持ったオブジェクトです。 |
$emit | カスタムイベントを発行するのに使います。 |
$f7 | Framework7アプリのインスタンスです。 |
$f7ready | アプリが初期化された際に実行されます。 |
$f7route | 現在のページのルーティング情報です。 |
$f7router | ページナビゲーションを行うためのルーティングオブジェクトです。 |
$h | Framework7に適したHTMLを生成する際に利用します。 |
$on | ページに関連したイベントを設定します(詳細は後述) |
$onBeforeMount | ライフサイクルです(詳細は後述) |
$onBeforeUnmount | ライフサイクルです(詳細は後述) |
$onBeforeUpdate | ライフサイクルです(詳細は後述) |
$onMounted | ライフサイクルです(詳細は後述) |
$onUnmounted | ライフサイクルです(詳細は後述) |
$onUpdated | ライフサイクルです(詳細は後述) |
$once | ページに関連したイベントを設定します(詳細は後述) |
$store | アプリ全体での変数を管理するストアのオブジェクトです。 |
$theme | iOS/Androidで切り替えるのに利用します。 |
$tick | 表示が更新されたのを通知します。 |
$update | 表示を強制更新する際に実行します。 |
return $renderの意味
componentUrlでは return $render
という処理が出てきます。
この $render
という変数はどこにも存在しませんが、実際にはFramework7側で次のような内容に書き換えられ処理が実行されます。
ライフサイクル&ページイベント
ページをマウントしたり、DOMから削除したりする際に実行されるのがライフサイクルイベントです。
ライフサイクルに合わせて呼び出される順番があります。次の表の上から順番に呼ばれます。
変数名・指定法 | 内容 |
---|---|
$onBeforeMount | DOMがマウントされる前 |
$onMounted | DOMがマウントされた後 |
$on('pageInit') | ページが初期化された後 |
$on('pageBeforeIn') | ページが呼び出される前 |
$on('pageAfterIn') | ページが呼び出された後 |
$on('pageBeforeOut') | ページから移動する前 |
$on('pageAfterOut') | ページから移動した後 |
$on('pageBeforeRemove') | ページがDOMから削除される前 |
$onBeforeUnmount | DOMがアンマウントされる前 |
$onUnmounted | DOMがアンマウントされた後 |
HTML内での動的な表示
templateタグ内は、JavaScriptのテンプレートリテラルとなっています。
templateタグ内で、 ${}
を利用することで変数を表示できます。以下の例では Hello という文字列を出力します。
ボタンなどのイベント実行
template内でのイベント(ボタンを押した、項目が変わったなど)でJavaScriptを呼び出す場合には、「@」 以降にイベント名を指定することで実装します。 「@change」 や 「@keyup」 などが利用できます。
非同期処理
ページ遷移するタイミングで、アプリの外部からデータを取得してから画面遷移させることもできます。
それが async
になります。これはルーティングで次のように書きます。
上記の関数で取得できるのは次の変数になります。
変数名 | 内容 |
---|---|
app | Framework7アプリ |
direction | "forward" または "backward" |
from | 遷移元の画面の情報 |
to | 遷移先の画面の情報 |
router | ルーターインスタンス |
reject | 非同期処理に失敗した場合にはこの関数を呼び出します |
resolve | 非同期処理が成功して画面遷移を行う時にはこの関数を呼び出します |
from
や to
は次の内容を持っています。
変数名 | 内容 |
---|---|
hash | URLのhash(アンカー) |
name | ルーティングで定義した名前 |
params | URLパターンで定義したパラメータとその値 |
parentPath | 入れ子の場合、親URL |
path | アクセスしているパス |
query | クエリストリング |
route | ルーティングインスタンス |
url | アクセスしているURL |
なお、非同期処理を実行している時には画面遷移せずに止まってしまうため、ローディングアイコンを表示するとユーザビリティーが高くなるでしょう。そのためのメソッドとしてpreloaderが用意されています。
非同期処理が完了したら resolve
関数を呼び出します。その際にはルーティングのようにURL情報を送信します。
JavaScriptで画面遷移を行う場合
これまでは a
タグを使って画面遷移を行っていましたが、JavaScriptから画面遷移させる場面も多いでしょう。その時には、 $f7router
を使います。この時、propsを使ってオブジェクトを渡すこともできます。
なお、これはcomponentUrlでの利用に限定されます。
propsを使う利点としては、一覧画面で取得したデータを詳細画面に引き渡すのに利用できます。詳細画面側では、データを再取得する必要がないので、表示が高速に行えるでしょう。
URLではなく name
を使った画面遷移も可能です。この場合、ルーティング時にあらかじめ name
を決めておきます。
たとえば、以下のようなルーティングを作成したとします。
この場合のプロダクト画面への遷移は次のようになります。
戻る機能
前の画面に戻る場合には、次のようにします。
HTMLの場合は、aタグのclass内に .back
を指定することで、戻る機能を実現できます。
DOM
※ DOMの日本語公式ドキュメントは、DOM7 | Framework7 Documentationを参照してください。
Framework7におけるDOMの扱い方です。
まず、jQuery風にDOMを扱えるDom7が用意されています。 $$
にするのがお勧めされています。
Dom7は、jQueryライクにDOM操作が可能です。たとえば次のようなメソッドが用意されています。これはjQueryを使ったことがあればすぐに使い方が分かるでしょう。
- addClass
- removeClass
- hasClass
- toggleClass
- append
- appendTo
- prepend
- prependTo
- insertBefore
- insertAfter
- next
- prev
- parent
- parents
- find
- children
- remove
- empty
さらに値を取得する、設定するのに便利なメソッドもあります。
- prop
- attr
- removeAttr
- val
- data
- removeData
- html
- text
CSSを使ったトランスフォームも可能です。
- transform
- transition
イベント系メソッドも用意されています。
- on
- once
- off
- trigger
- transitionEnd
- animationEnd
- click
- focus
- keyup
- keydown
- change
- submit
- touchstart
- touchend
- touchmove
他にも多くのメソッドが用意されています。これだけあれば、DOM操作はとても簡単にできるでしょう。
$hを利用する
componentUrlで動的に画面描画を行う際には、 $h
を使います。
ストア
※ ストアの日本語公式ドキュメントは、ストア | Framework7 Documentationを参照してください。
ストアは、状態管理用のオブジェクトです。主にアプリ内で共通する情報を管理するのに利用します。JavaScriptではグローバル変数を定義できますが、様々な場所から変更してしまうと、その状態が思いも寄らぬ動作を引き起こすことがあります。そうした誤動作を防ぐ意味でもストアの利用をお勧めします。
まず createStore
関数を使ってストアを定義します。
state
ストアで管理する状態を定義(初期化)します。
getters
データを取得するためのメソッドを定義します。
このように定義することで、次のようにアクセスできます。
actions
データを追加したり、削除したりするようなメソッドを定義します。既存データに対しては state.products
のようにしてアクセスできます。
このメソッドに対しては次のようにアクセスできます。
ストア | Framework7 Documentationでは、ストア内のデータを変更することで画面の表示結果を更新する例があります。アプリ全体での状態管理を行うことで、DOM管理やデータ管理を容易にできるでしょう。
まとめ
Framework7の基本動作としては、ルーティング、DOM、ストアを押さえておけば十分でしょう。後は便利なコンポーネントやアイコン表示を覚えれば、リッチなアプリが開発できるようになります。ぜひFramework7を使いこなして、高機能なハイブリッドアプリを開発してください。
Framework7 - Full Featured Framework For Building iOS, Android & Desktop Apps