アプリのレイアウト
アプリのために最初にすべきことは、アプリのスケルトンを含むindex.htmlファイルを作成することです。Framework7 Reactはwebpackのようなbundlerと一緒に使うことを想定しているので、index.htmlのスタイルとスクリプトは自動的に注入/生成されるはずです。
<!DOCTYPE html>
<html>
<head>
<!-- 必要なmetaタグ-->
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no, viewport-fit=cover">
<meta name="apple-mobile-web-app-capable" content="yes">
<!-- ステータスバーのカラーテーマ(Androidのみ -->
<meta name="theme-color" content="#2196f3">
<!-- アプリのタイトル -->
<title>My App</title>
<!-- Framework7のスタイル -->
<link rel="stylesheet" href="path/to/framework7-bundle.min.css">
</head>
<body>
<!-- アプリのルート要素 -->
<div id="app"></div>
<!-- スクリプトは自動的に注入されます。 -->
</body>
</html>
`は、アプリのメインとなるスケルトンを格納する場所です。このコンテンツをコンポーネントとして実装することもできますし、(例として)このdivの中にアプリの骨格を書き始めることもできます。基本的なレイアウト
非常に基本的なアプリコンポーネントのレイアウトを見てみましょう。
// App.jsx
import { App, View, Page, Navbar, Toolbar, Link } from 'framework7-react';
export default () => (
// メインのFramework7アプリコンポーネントで、Framework7のパラメータを渡します。
<App theme="auto" name="My App" id="com.demoapp.test">
{/* Your main view, should have "main" prop */}
<View main>
{/* Initial Page */}
<Page>
{/* Top Navbar */}
<Navbar title="Awesome App"></Navbar>
{/* Toolbar */}
<Toolbar bottom>
<Link>Link 1</Link>
<Link>Link 2</Link>
</Toolbar>
{/* Page Content */}
<p>Page content goes here</p>
<Link href="/about/">About App</Link>
</Page>
</View>
</App>
)
高度なレイアウト
次に、ビューやポップアップを備えたサイドパネルを追加する、より高度なレイアウトを見てみましょう。
// App.jsx
import { App, NavRight, Panel, View, Page, Navbar, Block, Row, Col, Button, Popup, Link } from 'framework7-react';
export default () => (
/* Main Framework7 App component where we pass Framework7 params */
<App theme="auto" name="My App" id="com.demoapp.test">
{/* Left Panel with "cover" effect */}
<Panel left cover>
<View>
<Page>
<Navbar title="Left Panel"></Navbar>
<Block>
<p>Here comes the left panel text</p>
</Block>
</Page>
</View>
</Panel>
{/* Right Panel with "reveal" effect */}
<Panel right reveal>
<View>
<Page>
<Navbar title="Right Panel"></Navbar>
<Block>
<p>Here comes the right panel text</p>
</Block>
</Page>
</View>
</Panel>
{/* Main view */}
<View main>
<Page>
<Navbar title="Awesome App"></Navbar>
{/* Page content */}
<Block>
<p>Here comes main view page text</p>
</Block>
{/* Buttons to open panels */}
<Row>
<Col>
<Button panelOpen="left">Left Panel</Button>
</Col>
<Col>
<Button panelOpen="right">Right Panel</Button>
</Col>
</Row>
{/* Button to open popup */}
<Button popupOpen="#my-popup">Open Popup</Button>
</Page>
</View>
{/* Popup. All modals should be outside of Views */}
<Popup id="my-popup">
<View>
<Page>
<Navbar title="Popup">
{/* Link to close popup */}
<NavRight>
<Link popupClose>Close</Link>
</NavRight>
</Navbar>
<Block>
<p>Here comes popup text</p>
</Block>
</Page>
</View>
</Popup>
</App>
)
ビュー、ナビバー、ツールバー、ページ、パネル、その他のコンポーネントについては、それぞれのセクションで詳しく説明しています。
アプリの初期化
基本的なテンプレートができたら、アプリの初期化を(例えば) my-app.js
で行う必要があります。