1、swiper轮播图
微信小程序的swiper组件中只能放置swiper-item,而鸿蒙js的swiper组件中可以放置除list之外的任意组件,功能更强大。除之前讲过用swiper结合自定义tabbar实现底部菜单分页功能,swiper最常用的就是首页的轮播图了。
swiper的属性可见官方文档(https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-components-container-swiper-0000000000611533),开发者工具在duration属性的代码提示是有bug的,这里应填的是毫秒数:
"true" duration="1000" interval="3000" indicator="true" loop="true" vertical="false"> -
for ="{{ swipeImg }}"> -
"{{ $item }}" > -
-
代码中swiper的后四个属性所填的都是默认值,可以省略。
2、image-animator幻灯片
swiper是滚动轮播图的效果,image-animator组件提供了类似幻灯片一样的图片切换效果。它不支持任何的子组件,且只支持图片。官方文档(https://developer.harmonyos.com/cn/docs/documentation/doc-references/js-components-basic-image-animator-0000001050066126)。
image-animator的duration属性与swiper的duration属性不同,它支持给定单位,不给单位默认为ms。且文档中写的“单次播放时长”其实是一次播放完所有图片的时长,每张图片的显示时长被均分。
"8s" images="{{ animatorImg }}">
images数组格式:
- "animatorImg": [
- {
- "src": "newyear1.jpeg"
- },
- {
- "src": "newyear2.jpeg"
- },
- {
- "src": "newyear3.jpeg"
- },
- {
- "src": "newyear4.jpeg"
- }
- ],
支持设置fixedsize="false",即可在数组中指定每幅图片的长、宽、偏移量。
"8s" images="{{ animatorImg }}" fixedsize="false">
- "animatorImg": [
- {
- "src": "newyear1.jpeg",
- "width": 500,
- "height": 500
- },
- {
- "src": "newyear2.jpeg"
- },
- {
- "src": "newyear3.jpeg"
- },
- {
- "src": "newyear4.jpeg",
- "width": 400,
- "height": 400,
- "top": 100,
- "left": 100
- }
- ],
3、marquee跑马灯
marquee组件提供了一种跑马灯的文字效果,文字从屏幕右侧开始出现,并向屏幕左侧滚动。适合做滚动通知,或是手表类的布局。
- {{ text }}
-
整体代码和效果图:
hml:
- "container">
-
"true" duration="1000" interval="3000" indicator="true" loop="true" vertical="false"> -
for ="{{ swipeImg }}"> -
"{{ $item }}" > -
-
-
- {{ text }}
-
-
"8s" images="{{ animatorImg }}" fixedsize="false">
css:
- .container {
- display: flex;
- flex-direction: column;
- width: 100%;
- height: 1200px;
- }
- swiper {
- width: 100%;
- height: 350px;
- }
- swiper image {
- width: 100%;
- height: 350px;
- }
-
- marquee {
- margin-top: 20px;
- margin-bottom: 20px;
- width: 100%;
- }
-
- image-animator {
- width: 100%;
- height: 550px;
- }
js: (采用动静分离,详见下文)
- import fetch from '@system.fetch';
-
- export default {
- data: {
- dataUrl: "http://milkytea.free.idcfengye.com/text/newyear.json",
- swipeImg: [],
- text: "",
- animatorImg: []
- },
- onInit() {
- fetch.fetch({
- url: this.dataUrl,
- responseType: 'json',
- success: res => {
- let data = JSON.parse(res.data);
- let imgUrl = data.imgUrl;
- let swipeImg = data.swipeImg;
- let animatorImg = data.animatorImg;
- for (let i in swipeImg) {
- swipeImg[i] = imgUrl + swipeImg[i];
- }
- for (let i in animatorImg) {
- animatorImg[i].src = imgUrl + animatorImg[i].src;
- }
- this.swipeImg = swipeImg;
- this.text = data.text;
- this.animatorImg = animatorImg;
- }
- })
- }
- }
4、nginx动静分离
在这个模块中,我并没有将图片放在项目工程目录中,甚至图片的url都没有写在js文件中。一是现在app功能越发强大,占用的存储空间也越来越大,如果将静态资源全部存放在工程目录中加大了空间的占用量。二是如果图片定期更换,或者服务器地址更换,写在代码里不便于维护。
nginx服务器可以实现动静分离,将本地路径作为静态资源服务器。基本配置如下,在nginx.conf中添加一个server:
- server{
- listen 8500;
- server_name localhost;
-
- location / {
- root /Users/liuyufeng/image/;
- autoindex on;
- }
-
- location ~ ^/(images|text|video|audio)/ {
- root /Users/liuyufeng/image/;
- autoindex on;
- access_log on;
- expires 30d;
- }
- }
将本地文件夹"/Users/liuyufeng/image"和localhost:8500绑定,并通过正则匹配"images","text","video","audio"四个子目录,分别存放图片、文本、视频、音频。重启nginx后,访问localhost:8500:
本地目录就成为了静态资源服务器,不得不感叹nginx的强大。
在鸿蒙项目中,总不能请求localhost,因此再搭配内网穿透,将本地服务器和域名绑定就可以了。
刚才模块中的js代码,就是通过请求静态资源中的newyear.json文件获取图片路径以及文字数据,实现了动静分离。
newyear.json
- {
- "imgUrl": "http://milkytea.free.idcfengye.com/images/newyear/",
- "swipeImg": ["swiper1.jpg", "swiper2.jpg", "swiper3.jpg"],
- "animatorImg": [
- {
- "src": "newyear1.jpeg",
- "width": 500,
- "height": 500
- },
- {
- "src": "newyear2.jpeg"
- },
- {
- "src": "newyear3.jpeg"
- },
- {
- "src": "newyear4.jpeg",
- "width": 400,
- "height": 400,
- "top": 100,
- "left": 100
- }
- ],
- "text": "新春佳节,快乐假期,祝你放假快乐,阖家幸福,新春大吉! 福气高,乐逍遥,生活日日美,收入月月高。"
- }