Skip to content

Latest commit

 

History

History
308 lines (253 loc) · 11.4 KB

02_欢迎页的实现.md

File metadata and controls

308 lines (253 loc) · 11.4 KB

2 欢迎页的实现

2.1 任务描述

2.1.1 任务介绍

  • 实现程序的欢迎页面

2.1.2 任务要求

2.1.2.1 程序欢迎页面需求

用户场景:用户在界面上左右滑动,轮流显示三张图片,通过这三张图片简单介绍软件。

输入/前置条件:程序第一次运行时或者程序版本升级后第一次运行时,进入欢迎页。

流程说明:无

需求描叙: 欢迎页原型

输出/后置条件:根据用户的操作进入登录页或者注册页。

版本说明:

2.2 工作指导说明

资源名称 下载链接
启动屏幕图片压缩包 百度云下载

2.2.1 创建欢迎页组件

在src\app目录下创建pages文件夹,在命令符号(cmd)下,进入项目的根目录执行下面的命令:

ionic generate page pages/welcome

或者

ionic g page welcome

或者

ionic g page welcome --no-module

该命令会在src\app\pages目录中自动生成以下几个文件

文件名 说明
welcome.page.html HTML模板
welcome.module.ts 模块
welcome.page.scss 私有的样式表,app-welcome{}是一个元素选择器,名称和welcome.page.ts文件中元数据的选择器是一致的,
selector: 'app-welcome'。相当于有一个自定义的元素
welcome.page.ts 组件的类(class)代码

要了解更多ionic generate 的知识,请参考Ionic官网

2.2.3 欢迎页设置成默认页

  1. 修改app-routing.module.ts文件。

    src\app\app-routing.module.ts

const routes: Routes = [
  {
    path: '',
    redirectTo: 'welcome', // 原来是home
    pathMatch: 'full'
  },
  {
    path: 'home',
    loadChildren: './home/home.module#HomePageModule'
  },
  {
    path: 'list',
    loadChildren: './list/list.module#ListPageModule'
  },
  // 下面这行代码是在创建页面时,Ionic自动更新的
  { path: 'welcome', loadChildren: './welcome/welcome.module#WelcomePageModule' }
];
  1. 执行ionic serve检查第一个出现的界面是否是欢迎页面。

image

2.2.2 为界面添加轮播

  1. 在\src\assets目录中创建img文件夹,把splsh_one.png、splsh_two.png和splsh_three.png三张图片拷贝到img的目录中。如果你觉得传统操作比较麻烦,可以为VS Code安装Paste Image扩展插件,直接从剪贴板粘贴图像。先复制图片,然后在Webstorm中,在img目录上点击右键,选择“Paste”菜单项。或者在img目录上直接Ctrl+V,就能够把文件快速地拷贝到制定目录中。 快速拷贝图片

  2. 修改HTML模板文件,为<ion-content>元素添加<ion-slides>子元素。

  \src\app\pages\welcome\welcome.page.html

<!-- 其他省略 -->
<ion-content>
  <ion-slides pager="true">
    <ion-slide>
      <img src="/assets/img/splsh_one.png" alt="">
    </ion-slide>
    <ion-slide>
      <img src="./assets/img/splsh_two.png" alt="">
    </ion-slide>
    <ion-slide>
      <img src="assets/img/splsh_three.png" alt="">
    </ion-slide>
  </ion-slides>
</ion-content>

ion-content:内容组件提供了易于使用的内容区域。
ion-slides:幻灯片(轮播、旋转木马)组件是个多节容器。每个部分都可以在其间滑动或拖动。它包含任意数量的Slide组件。
ion-slide:滑动组件是Slides的子组件。任何幻灯片内容都应该写在此组件中,并且应该与幻灯片一起使用。

要了解更多Slides 的知识,请参考Ionic官网

要了解更多Slide 的知识,请参考Ionic官网

在之前的页面或者代码中出现过“/”、“./”,我们了解这些路径的区别。

语法 说明
/ 根目录开始
./ 当前目录开始
../ 上一级目录开始

有开发过多页面应用(MPA,Multi-page Application)的同学可能感到很奇怪,welcome.page.html和assets根本不在同一级目录下,在浏览器上运行时正常会报404错误。想要访问assets目录下的文件,常规的写法“../../../”。然而单页面应用(SPA,Single-page Application)只显示一个index.html页面,相应的页面仅仅替换index.html的某个区域。因此在单页面应用程序中,以index.html所在的目录作为路径的起始。

  1. 查看界面是否修改成功。

修改文件后,每次都要保存。否则切换到浏览器时无法看到程序的变化。可以通过设置VS Code来实现自动保存。 打开Visual Studio Code,在左上角依次点开 文件→首选项→设置,如下图:

image

image

在出现的下拉菜单中选择onFocusChange,当失去焦点时触发保存。

切换到浏览器,不需要按F5刷新,等待console提示编译完毕,浏览器上就能够显示新的界面。

image

注意:在实际的前端开发中,组件中用到的图片应放在各自组件的images目录中。编译时可以使用webpack把图片拷贝到www\assets\img目录中

2.2.3 添加“跳过”按钮

在标题栏的右边添加“跳过”按钮。当滑动到第一张或者第二张图片时,显示“跳过”按钮,当滑动到最后一张图片时隐藏“跳过”按钮。

2.2.3.1 在头部右侧添加“跳过”按钮

  1. 在模板文件中添加按钮组件

/src/app/pages/welcome/welcome.page.html

<ion-header>
  <ion-toolbar no-border>
    <ion-buttons slot="end">
      <ion-button color="primary">跳过</ion-button>
    </ion-buttons>
  </ion-toolbar>
</ion-header>

ion-header:标题组件是包含工具栏组件的父级组件。注意:ion-header必须是页面的三个根元素之一(ion-content,ion-footer)。
ion-toolbar:工具栏组件
ion-buttons:按钮组组件,用于存放1个或者多个按钮。
ion-button:按钮组件
借助标题等组件,可以使用Ionic提供的默认样式,帮助我们快速定义好按钮的外观及位置。但是正常的欢迎页面是不出现标题栏的,可以通过设置css中的background和bordy-color两个属性为透明,“隐藏”标题栏。

  1. 设置工具栏透明

/src/app/pages/welcome/welcome.scss

app-welcome {
  ion-toolbar {
    --background: transparent;
    --border-color: transparent;
  }
}

在SCSS中app-welcome是一种元素选择器,同样ion-toolbar也是元素选择器。ion-toolbar嵌套在app-welcome中表示子元素选择器。意思是在页面中作为app-welcome子元素的ion-toolbar元素才能应用--background: transparent和--border-color: transparent这两种样式。最终生成的css如下:

app-wlecome ion-toolbar {
  background: transparent;
  border-color: transparent;
}

在组件类中修改装饰器,添加encapsulation元数据,提供模板和 CSS 样式使用的样式封装策略。

/src/app/pages/welcome/welcome.ts

import {Component, OnInit, ViewChild, ViewEncapsulation} from '@angular/core';
@Component({
  selector: 'app-welcome',
  templateUrl: './welcome.page.html',
  styleUrls: ['./welcome.page.scss'],
  encapsulation: ViewEncapsulation.None
})
export class WelcomePage implements OnInit {
  constructor() { }
  ngOnInit() {
  }
}

在iOS模式下测试通过,在md模式下发现工具栏的底部依旧存在一条边,通过阅读官方文档发现,需要为ion-toolbar元素添加no-border属性。

2.2.3.2 控制“跳过”按钮的显示或者隐藏

  1. 在组件类中添加showSkip属性控制跳过按钮的显示或者隐藏。

当showSkip值为true时,显示“跳过”按钮,当showSkip值为false时,隐藏“跳过”按钮, /src/app/pages/welcome/welcome.ts

export class WelcomePage implements OnInit {
  showSkip = false;
  ngOnInit() {
  }
}
  1. 设置元素hidden属性的绑定

/src/app/pages/welcome/welcome.page.html

<ion-button color="primary" [hidden]="!showSkip">跳过</ion-button>

要隐藏或显示一个元素,绑定到它的 hidden 属性就可以了。切换到浏览器查看跳过按钮是否消失,再把showSkip的值改为true。

要了解更多属性绑定的知识,请参考Angular官网

  1. 利用slides的事件控制showSkip的值。

为组件类添加onSlideWillChange方法

/src/app/pages/welcome/welcome.ts

export class WelcomePage implements OnInit {
  showSkip = true;
  @ViewChild('slides', {static: false}) slides: IonSlides;
  constructor() { }

  ngOnInit() {
  }
  onSlideWillChange(event) {
    console.log(event);
    this.slides.isEnd().then((end) => {
      this.showSkip = !end;
    });
  }
}

另外一种实现方式

  onSlideWillChange(event) {
    event.target.isEnd().then((end) => {
      this.showSkip = !end;
    });
  }

在模板中实现事件绑定

/src/app/pages/welcome/welcome.html

<ion-slides #slides pager="true" (ionSlideWillChange)="onSlideWillChange($event)">

要了解更多事件绑定的知识,请参考Angular

#slides这是angular中的本地变量,也可以不使用本地变量。

@ViewChild(IonSlides, {static: false})
slides: IonSlides;

要了解更多@ViewChild知识,请参考Angular官网

2.2.4 添加登录和注册按钮

在第三个幻灯片中添加登录和注册两个按钮,并且把这两个按钮固定在界面的底部。

  1. 添加.fixed-bottom样式

/src/app/pages/welcome/welcome.scss

app-welcome {
  .fixed-bottom{
    position: absolute;
    bottom: 0;
    z-index: 10;
  }
}
  1. 在welcome.html文件中添加登录和注册按钮

修改ion-slides元素中的第三个ion-slide元素

/src/app/pages/welcome/welcome.html

<!--其他省略-->
<ion-grid>
  <ion-row>
    <ion-col>
      <img src="assets/img/splsh_three.png">
    </ion-col>
  </ion-row>
  <ion-row>
    <ion-col>
      <ion-button color="primary" fill="outline" expand="block">登录</ion-button>
    </ion-col>
    <ion-col>
      <ion-button color="primary" expand="block">注册</ion-button>
    </ion-col>
  </ion-row>
</ion-grid>

要了解更多Grid的知识,请参考官网

要了解更多Buttons的知识,请参考官网

2.3 产品工作要求

2.4 产品检查要求

  1. 编写TypeScript代码时,尽量遵守TSLint配置好的规范
  2. App目录中创建pages、routes或者views用于存放HTML模板
  3. 提交src目录,压缩包命名参考之前的任务