Framework7 - 安装和环境设置

在本章中,我们将讨论如何安装和设置 Framework7。

您可以通过两种方式下载 Framework7 −

Framework7 Github 存储库 下载

您可以使用 Bower 安装 Framework7,如下所示 −

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

从 CDN 下载 Framework7 库

CDN 或内容分发网络是旨在向用户提供文件的服务器网络。如果您在网页中使用 CDN 链接,它会将托管文件的责任从您自己的服务器转移到一系列外部服务器。这还提供了一个优势,即如果访问您网页的访问者已经从同一 CDN 下载了一份 Framework7,则无需重新下载。您可以将以下 CDN 文件包含到 HTML 文档中。

以下 CDN 用于 iOS 应用布局

<link rel = "stylesheet" 
href = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.ios.min.css" />

它用于将 Framework7 iOS CSS 库包含到您的应用程序中。

<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>

它用于将 Framework7 JS 库包含到您的应用程序中。

<script src = "https://cdnjs.cloudflare.com/ajax/libs/framework7/1.4.2/css/framework7.material.min.css"></script>

它用于将 Framework7 Material 样式包含到您的应用程序中。

我们在本教程中一直使用库的 CDN 版本。我们使用 AMPPS(AMPPS 是 Apache、MySQL、MongoDB、PHP、Perl 和 Python 的 WAMP、MAMP 和 LAMP 堆栈)服务器来执行所有示例。

示例

以下示例演示了在 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>
            // 此处初始化应用程序
            var myApp = new Framework7();
            
            // 如果您使用自定义 DOM 库,则将其保存到 $$ 变量
            var $$ = Dom7;
            
            // 添加视图
            var mainView = myApp.addView('.view-main', {
                
                // 为该视图启用动态导航栏:
                dynamicNavbar: true
            });
            
            // 对所有页面使用"pageInit"事件处理程序
            $$(document).on('pageInit', function (e) {
         
            //从事件数据中获取页面数据
            var page = e.detail.page;

            if (page.name === 'blog') {
            
               // 当页面的数据页属性等于"blog"时,您将在警告框中看到以下消息
               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 文件。

  • 以 http://localhost/framework7_environment.html 的形式打开此 HTML 文件,输出如下所示。

  • 单击导航栏时,它将显示带有自定义消息的警告框。