- 实现程序的欢迎页面
用户场景:用户在界面上左右滑动,轮流显示三张图片,通过这三张图片简单介绍软件。
输入/前置条件:程序第一次运行时或者程序版本升级后第一次运行时,进入欢迎页。
流程说明:无
输出/后置条件:根据用户的操作进入登录页或者注册页。
版本说明:
资源名称 | 下载链接 |
---|---|
启动屏幕图片压缩包 | 百度云下载 |
在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官网
- 修改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' }
];
- 执行ionic serve检查第一个出现的界面是否是欢迎页面。
-
在\src\assets目录中创建img文件夹,把splsh_one.png、splsh_two.png和splsh_three.png三张图片拷贝到img的目录中。如果你觉得传统操作比较麻烦,可以为VS Code安装Paste Image扩展插件,直接从剪贴板粘贴图像。先复制图片,然后在Webstorm中,在img目录上点击右键,选择“Paste”菜单项。或者在img目录上直接Ctrl+V,就能够把文件快速地拷贝到制定目录中。
-
修改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所在的目录作为路径的起始。
- 查看界面是否修改成功。
修改文件后,每次都要保存。否则切换到浏览器时无法看到程序的变化。可以通过设置VS Code来实现自动保存。 打开Visual Studio Code,在左上角依次点开 文件→首选项→设置,如下图:
在出现的下拉菜单中选择onFocusChange,当失去焦点时触发保存。
切换到浏览器,不需要按F5刷新,等待console提示编译完毕,浏览器上就能够显示新的界面。
注意:在实际的前端开发中,组件中用到的图片应放在各自组件的images目录中。编译时可以使用webpack把图片拷贝到www\assets\img目录中
在标题栏的右边添加“跳过”按钮。当滑动到第一张或者第二张图片时,显示“跳过”按钮,当滑动到最后一张图片时隐藏“跳过”按钮。
- 在模板文件中添加按钮组件
/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两个属性为透明,“隐藏”标题栏。
- 设置工具栏透明
/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属性。
- 在组件类中添加showSkip属性控制跳过按钮的显示或者隐藏。
当showSkip值为true时,显示“跳过”按钮,当showSkip值为false时,隐藏“跳过”按钮, /src/app/pages/welcome/welcome.ts
export class WelcomePage implements OnInit {
showSkip = false;
ngOnInit() {
}
}
- 设置元素hidden属性的绑定
/src/app/pages/welcome/welcome.page.html
<ion-button color="primary" [hidden]="!showSkip">跳过</ion-button>
要隐藏或显示一个元素,绑定到它的 hidden 属性就可以了。切换到浏览器查看跳过按钮是否消失,再把showSkip的值改为true。
要了解更多属性绑定的知识,请参考Angular官网
- 利用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官网
在第三个幻灯片中添加登录和注册两个按钮,并且把这两个按钮固定在界面的底部。
- 添加.fixed-bottom样式
/src/app/pages/welcome/welcome.scss
app-welcome {
.fixed-bottom{
position: absolute;
bottom: 0;
z-index: 10;
}
}
- 在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的知识,请参考官网
- 编写TypeScript代码时,尽量遵守TSLint配置好的规范
- App目录中创建pages、routes或者views用于存放HTML模板
- 提交src目录,压缩包命名参考之前的任务