写着写着发现会写不少内容... 全部写在一篇文章里感觉太多了不方便看,所以分为上下篇吧...
下篇写完啦,感兴趣的朋友可以继续关注~ => 用Vue开发仿旅游站webapp项目总结 (下)
此文章,仅是做完项目后的个人觉得可以总结下来的操作/思路,接触vue不久的朋友应该会有收获。此项目也才是萌新做的第二个Vue项目,使用了脚手架工具( vue-cli 2.x 非 3 ),前辈老手们有时间看的话,有写得不好的地方还请多多指导!~
仅实现项目首页、项目详情页、城市列表页组件的页面/逻辑。
千万别点我
先用脚手架生成项目框架。
因为做的是一个移动端网页,所以我们可以有一些配置:
index.html里加个meta标签:
复制代码
在网页的
标签中增加以上代码,可以让网页的宽度自动适应手机屏幕的宽度。其中:
width=device-width : 表示宽度是设备屏幕的宽度
initial-scale=1.0 : 表示初始的缩放比例
minimum-scale=1.0 : 表示最小的缩放比例
maximum-scale=1.0 : 表示最大的缩放比例
user-scalable=no : 表示用户是否可以调整缩放比例
以上我设置的参数的目的是:想要一打开网页,就自动以原始比例显示,并且不允许用户修改,不允许用户缩放。
在不同的手机浏览器上,默认的一些样式是不同统一的。我们需要把这些不同手机的初始化样式做一个统一。
所以可以引入个 reset.css
这是一个初始化的代码,其中一些初始化配置可以自行根据需求修改。
想看/拿代码的可以到我Github上拿:src/assets/styles/reset.css
在移动端页面开发,常常有个 1像素边框 的问题。
也就是有的手机屏幕分辨率比较高,如果我们在页面上写border-bottom啥的样式,会导致这些手机屏幕分辨率高的当中,1px边框显示成2px边框或3px边框等显示成多像素。
为了解决这个1像素边框问题,我们就引入了 border.css(貌似这是哪个团队提出的解决方案?忘记啦,只知道怎么用...但仍然要表示感谢。还有其他解决方案,这个就自行搜索了。)
两百多行不贴出来了,想看/拿完整代码的可以到我Github上:src/assets/styles/border.css
具体这个解决方案的用法,看过border.css代码的同志就会发现很简单:在元素上根据想要的需求加以下这些类名。
按照字面意思理解就行。
比如要给一个元素加上一像素的下边框,就直接加个类名:
要给一个元素加上一像素的上边框和下边框,就直接加类名:
边框也可以改颜色的,举个项目中的例子,按照这种格式去改颜色(本文例子有css代码的话基本都是stylus的写法):
http://www.developcls.com/qa/1795d18c9ce344deb99915557494befd.html
对应页面:
在移动端开发中,某些机型、某些浏览器上,click点击事件要延迟300ms执行。
要解决这个问题,我们引入个fastclick库
npm install fastclick --save
--save的意思是:不管在开发环境测试,还是线上跑代码,安装了的库都可以使用。并且下载好后,自动存到package.json的dependencies属性中,比如这里install的fastclick:
然后在入口函数main.js中引入和使用:
import fastClick from 'fastclick'、fastClick.attach(document.body)
先在阿里巴巴矢量图标库创建一个项目
然后在iconfont上选购,添加到购物车,选好后添加到自己的项目,然后下载到本地。
下载的东西中只要用到这几个:
然后把iconfont.css放到一个文件夹中并且在入口函数main.js处引入后就可以全局使用了。
举个使用的例子:
注意类名要加iconfont,然后这里在span里输入的代码就是你选中的图标的代码:
这步其实应该穿插在做项目过程中进行的,这里先列出来。
在build文件夹下的webpack.base.conf.js中配置,如下图,圈起来的是我在项目中配置的。
这样有配置后就可以使用自定义目录了。比如按照我上面的配置的话
import src/assets/styles/border.css
就可以写成
import styles/border.css了。
这里使用的是 vue-awesome-swiper。
先安装: npm install vue-awesome-swiper --save
然后用法一些的其实都可以在其文档中查阅到:
鉴于在各个页面都可能会用到轮播功能,所以直接在全局也就是入口文件 main.js 处引入。
然后使用:
比如要使用按钮区的话,就需要配置参数。根据个人在项目中的需求,可以查阅其github文档按需使用。
比如这个test。在网速慢慢加载的时候,可能test会先在上面显示,然后等图片撑开区域的时候再跑回下面。
为了防止这种抖动,最好这样子做:
给轮播swiper外面套一层类为wrapper的div,然后给div固定大小。比如在项目中这里的轮播图片的宽高比是 364:97 约等于 3.75,高度是宽度的百分之 26.6。
所以响应式开发可以这样给div框样式:
现在vw单位的兼容性其实可以了。
有种兼容性很好的方案:
overflow: hidden width: 100% height: 0 padding-bottom: 26.6% 复制代码
这种方式也是高度是宽度的 26.6%。
其实吧。。这个vue-aowsome-swiper组件目前为止已经不存在这种抖动问题了。。
比如插件按钮区配置后,默认按钮颜色是蓝色小圆点。
审查元素可以看出:
那我们如下这样子加样式去改变行吗?
一般这样子问都是不行滴...
因为有scoped作用域的原因,这个类的属性的设置是在原本的 swiper组件下,而不是在我们这里设置的swiper组件下。
应该这样设置:
意思是在.wrapper下的所有类中,找.swiper-pagination-bullet-active类。
>>>是具有穿透作用域的意思,穿透其他组件的作用域。
比如,这里是个p标签。
P标签里的数据太多的话 希望显示一个 ... 省略号。
可以这样利用text-overflow属性:
要实现溢出时产生省略号的效果,应该在定义两个样式:强制文本在一行内显示(white-space:nowrap)和溢出内容为隐藏(overflow:hidden),只有这样才能实现溢出文本显示为省略号效果。
一般情况下在mounted钩子里发送ajax请求数据。想详细了解生命周期 => 我有写过一篇文章
请求方式,看自己,这个项目中axios、fetch两个方式我都写过。
首先,用vue脚手架工具生成的工程里面,只有static目录(静态文件目录)下,才能被外界访问到。
我们就把本地的一些模拟数据放在这个static目录下,自己建个文件夹存储数据。这个项目中是static/mock/index.json:
这数据是本地的模拟数据,我们不希望到时候一起把它push到线上,可以在.gitignore里这样配置:
现在这个文件夹下的所有东西都不会被传到线上了。
当然,也不会提交到本地的git仓库里面。
这样配置还不够,目前在局部根组件中写的请求的路径是这样的,拿项目中举例:
当我们上线这代码的时候,我们请求的网址,最好前面加上个‘api’,如下面的红框中:/api/index.json 这样子最好了。
很好的是,恰好Vue脚手架里面有这样一个转发的代理功能。通过这个功能,就可以实现以上构想。
config配置文件下,有个 index.js 脚本,官方给我们提供了一个 proxyTable{} 的配置项,我们可以这样配置:
这意思是:当我们请求api的时候,依然映射到本地8080端口,然后访问任何以api为开头的url的时候,做一个路径替换,代理访问到 /static/mock 处。
实际这功能 是webpack-dev-sever提供的。
改过配置文件,需要重启下服务器,重启后就可以如下请求数据了:
这里实际上访问的就是static/mock/index.json里的内容了。
如果可以的话,最好能在局部根组件里请求一次ajax数据,然后从局部根组件里把接收到的数据分别传给各个局部的子组件,而不是每个局部的子组件都发送一次ajax请求。
这里是这样写的css
现在在输入框里面输入文字字符超过输入框大小时:
这两部会贴着,不那么好看。想要给这个输入框加个padding,留点间隙会更好。
但直接在input下面加行吗?
页面:
因为包裹input框的div没设置width,也就是width是auto。input框的width设置的是100%。
如果直接给input加padding左右一点的话是会撑开input框的宽度的。所以会溢出。
那怎样解决这个问题呢?
我们只是想设置一个左右padding值,没想让input框长宽变化。所以,我们在 Input 下面加个:box-sizing: border-box
这样的话,我们直接给input设置的宽高就包括了padding、border在内的宽高了。
此时我们要修改padding的值的话,就只会在这个框内变化 不会撑开框宽高了。
初始开发页面时,到这步,因为加了比较多字母对应的区域,页面出现了滚动条的时候:
为了使用better-scroll库,我们仅让列表区域显示到刚进页面时能显示到的区域就行了,不需要出现滚动条。所以可以给最外层的包裹整个列表区域的框div.list 加个overflow: hidden就行了。(整个列表页指下图中的从当前城市开始到最后,城市选择和输入框是其他子组件写的了)
接下来具体better-scroll的用法,github上其文档有说明,各人可根据具体情况查阅使用。
点击事件中,我们需要查看点击的内容时,可以利用点击事件的事件对象
在Vue的一个点击事件里,在methods定义点击方法时这个方法可以接收一个参数e,e就是我们点击到的那个事件对象。
要拿到我们点击到的事件对象的内容 可以这样来:e.target.innerText
举个项目中的例子验证一下:
比如此时页面上点击了 D F J
当点击到相应的字母的时候显示list组件的对应城市的区域。
better-scroll这个第三方插件有个方法可以实现这个需求,思路是:
监听所点击的字母表里字母的值letter的变化,一旦letter变了,就利用better-scroll的提供的一个接口,如下图划线的部分
它会让better-scroll的滚动区域,自动滚动到某一个元素上。需要给这个方法传递我们滚动到该元素的该元素DOM。
利用这个思路就可以实现需求1了。
手指拖动字母表,字母对应的列表跟着联动展示。
思路:
利用touchstart、touchmove、touchend事件,并给个限制(touchStatus) 只当手指在屏幕移动的时候才执行一些操作。然后用个数组letters来存放字母表的所有字母,这里的letters大概是['A','B','C'...],并让页面v-for这个letters来显示相应的内容。用数组存放这些字母的原因也是为了实现这需求的主要思想:根据下标,找到对应的字母。
接下来,先用offsetTop找到字母表中字母A距离包裹它的顶部的高度。下图红框。
这里的74 代表的是红色方框的高度。
然后获取移动时手指所在的高度,此高度时针对于客户端的高度,用clientY。 touchmove事件有个事件对象,事件对象里有个touches数组,touches[0]里面就有当前手指的信息,包括clientY属性。
实时获取我们手指的位置。
我们要获取距离包裹块的高度 => 也就是clientY的高度要减去headers区和serach区的高度,这两个区高度是 79px。
然后算我们手指移到的字母在数组中的下标 逻辑是 (touchY - startY)/每个字母的高度,再把结果向下取个整。
最后,把这个下标在letters数组中对应的字母传给需求1所在的组件利用需求1的思路就行了。(这里的传值涉及到了兄弟组件之间的传值,此时该页面比较简单不建议用vuex,可以用event bus/找同一父组件做媒介传值,具体方法百度。)
在我项目中最终逻辑代码是这样写的:
最后做个最佳实践,用个if,确保 index的值。
第一处
handleTouchMove是手指滑动的时候就会执行,而我们框起来的也就是A字母距离包裹框的高度是固定的,不用每次滑动的都执行这段代码。
所以此处需要优化,这样子来:
在data里初始化startY为0
然后用生命周期钩子 updated 去执行给startY赋值的语句
这里为什么用updated这个钩子呢?在项目中初次渲染字母表组件alphabet.vue的时候,从它父组件City.vue传过来的值是一个空对象。当City.vue里ajax动态获取数据后,从City再传到alphabet的值让数据从初次的空对象发生改变。在数据更新完毕后,就触发了updated钩子,此时给startY赋值就是值都有,而且只会赋一次。
第二处:函数节流
通过函数节流 减少handleTouchMove()的执行频率 (因为我们手指在滑动的时候 该函数执行频率很高的)。
怎样使得函数节流呢?
通过定时器和清除定时器来实现。
先在data中初始化timer为 null,然后这样来用
这样子用定时器进行函数节流的话 :
如果已经正在做这件事情的时候,我呢,让它延迟16ms之后再去执行。假设在这16ms之间你又去做了手指的滚动,那么它会把上一次你要做的操作给清除掉(clearTimeout),然后重新执行你这次要做的事情 (等于以最终的手指滑动的位置为准 )。
通过这种函数节流方式,会大大减少该函数的执行次数,从而提高网页性能。
函数节流的方式,当一个函数执行次数很多想要减少而且减少也没影响的时候,是很有必要采用的一种方式。
可能用户会有不小的概率关闭了本地自动存储的功能,一般我们使用localStorage的时候 都要使用 try catch 代码块,这样就算用户关闭本地自动存储功能,也不会让整个代码都不能运行,只是没了这个localStorage的功能而已。
举个项目中的例子: