В этой главе мы обсудим, как установить и настроить Framework7.
Вы можете скачать Framework7 двумя способами —
Загрузить из репозитория Framework7 Github
Вы можете установить Framework7, используя Bower, как показано ниже —
bower install framework7
После успешной установки Framework7 вам необходимо выполнить следующие шаги, чтобы использовать Framework7 в своем приложении —
Шаг 1 — Вам необходимо установить gulp-cli для сборки разрабатываемых и дистрибутивных версий Framework7 с помощью следующей команды.
npm install gulp-cli
Cli обозначает утилиту командной строки для Gulp.
Шаг 2 — Gulp должен быть установлен глобально с помощью следующей команды.
npm install --global gulp
Шаг 3 — Затем установите менеджер пакетов NodeJS, который устанавливает программы узлов, которые упрощают определение и связывание зависимостей. Следующая команда используется для установки npm.
npm install
Шаг 4 — Разрабатываемая версия Framework7 может быть собрана с помощью следующей команды.
npm build
Шаг 5 — Как только вы соберете версию разработки Framework7, начните сборку приложения из папки dist / с помощью следующей команды.
npm dist
Шаг 6. Сохраните папку своего приложения на сервере и выполните следующую команду для перехода между страницами своего приложения.
gulp server
Скачать библиотеку Framework7 из CDN
CDN или Сеть доставки контента — это сеть серверов, предназначенная для обслуживания файлов пользователям. Если вы используете ссылку CDN на своей веб-странице, она переносит ответственность за размещение файлов с ваших собственных серверов на ряд внешних. Это также дает преимущество в том, что если посетитель вашей веб-страницы уже загрузил копию Framework7 из той же CDN, ее не нужно будет повторно загружать. Вы можете включить следующие файлы CDN в документ HTML.
Следующие CDN используются в макете приложения iOS —
<link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.ios.min.css" />
Он используется для включения iOS7-библиотеки Framework7 в ваше приложение.
<link rel = "stylesheet" href = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.ios.colors.min.css" />
Он используется для включения в ваше приложение цветовых стилей Framework7 iOS.
Следующие CDN используются в Android / Material App Layout —
<script src = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/js/framework7.min.js"></script>
Он используется для включения библиотеки JS Framework7 в ваше приложение.
<script src = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.material.min.css"></script>
Он используется для включения в ваше приложение стилей Framework7 Material.
В этом руководстве мы используем версии библиотеки CDN. Мы используем AMPPS (AMPPS — это стек WAMP, MAMP и LAMP сервера Apache, MySQL, MongoDB, PHP, Perl & Python) для выполнения всех наших примеров.
В этом руководстве мы используем версии библиотеки CDN. Мы используем AMPPS (AMPPS — это стек WAMP, MAMP и LAMP сервера Apache, MySQL, MongoDB, PHP, Perl & Python) для выполнения всех наших примеров.
пример
В следующем примере демонстрируется использование простого приложения в Framework7, которое будет отображать окно предупреждения с настраиваемым сообщением при нажатии на панель навигации.
<!DOCTYPE html>
<html>
<head>
<meta name = "viewport" content = "width = device-width, initial-scale = 1,
maximum-scale = 1, minimum-scale = 1, user-scalable = no, minimal-ui" />
<meta name = "apple-mobile-web-app-capable" content = "yes" />
<meta name = "apple-mobile-web-app-status-bar-style" content = "black" />
<title>My App</title>
<link rel = "stylesheet"
href = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.ios.min.css" />
<link rel = "stylesheet"
href = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.ios.colors.min.css" />
</head>
<body>
//you can control the background color of the Status bar
<div class = "statusbar-overlay"></div>
<div class = "panel-overlay"></div>
<div class = "panel panel-right panel-reveal">
<div class = "content-block">
<p>Contents goes here...</p>
</div>
</div>
<div class = "views">
<div class = "view view-main">
<div class = "navbar">
<div class = "navbar-inner">
<div class = "center sliding">My App</div>
<div class = "right">
<a href = "#" class = "link icon-only open-panel">
<i class = "icon icon-bars"></i>
</a>
</div>
</div>
</div>
<div class = "pages navbar-through toolbar-through">
<div data-page = "index" class = "page">
<div class = "page-content">
<p>This is simple application...</p>
<div class = "list-block">
<ul>
<li>
<a href = "envirmnt_about.html" class = "">
<div class = "item-content">
<div class = "item-inner">
<div class = "item-title">Blog</div>
</div>
</div>
</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class = "toolbar">
<div class = "toolbar-inner">
<a href = "#" class = "link">First Link</a>
<a href = "#" class = "link">Second Link</a>
</div>
</div>
</div>
</div>
<script type = "text/javascript"
src = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/js/framework7.min.js"></script>
<script>
// here initialize the app
var myApp = new Framework7();
// If your using custom DOM library, then save it to $$ variable
var $$ = Dom7;
// Add the view
var mainView = myApp.addView('.view-main', {
// enable the dynamic navbar for this view:
dynamicNavbar: true
});
//use the 'pageInit' event handler for all pages
$$(document).on('pageInit', function (e) {
//get page data from event data
var page = e.detail.page;
if (page.name === 'blog') {
// you will get below message in alert box when page with data-page attribute is equal to "about"
myApp.alert('Here its your About page');
}
})
</script>
</body>
</html>
Затем создайте еще одну HTML-страницу, т.е. envirmnt_about.html, как показано ниже —
envirmnt_about.html
<div class = "navbar">
<div class = "navbar-inner">
<div class = "left">
<a href = "#" class = "back link">
<i class = "icon icon-back"></i>
<span>Back</span>
</a>
</div>
<div class = "center sliding">My Blog</div>
<div class = "right">
<a href = "#" class = "link icon-only open-panel">
<i class = "icon icon-bars"></i>
</a>
</div>
</div>
</div>
<div class = "pages">
<div data-page = "blog" class = "page">
<div class = "page-content">
<div class = "content-block">
<h2>My Blog</h2>
<p>Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.</p>
</div>
</div>
</div>
</div>
Выход
Давайте выполним следующие шаги, чтобы увидеть, как работает приведенный выше код —
Сохраните приведенный выше HTML-код как файл framework7_environment.html в корневой папке вашего сервера.
Откройте этот HTML-файл как http: //localhost/framework7_environment.html, и вывод отобразится, как показано ниже.
Если щелкнуть панель навигации, отобразится окно предупреждения с настроенным сообщением.