微信小程序开发学习笔记

来源:FEvivi 发布时间:2019-03-27 17:39:28 阅读量:1186

默认开发目录

开发目录解析

1.  app.js、app.json、app.wxss 这三个文件必须有不能删掉。

   个小程序主体部分由这三个文件组成,而且必须放在项目的根目录

  • js后缀的是脚本文件,调用小程序框架提供的 API—— API 文档

  • json后缀的文件是对整个小程序的全局配置文件——配置详解

    •   微信小程序中的每一个页面的【路径+页面名】都需要写在 app.json 的 pages 中,用来激活。

  例如,你没写他就会报这个错

     

 app.json文件的pages属性的路径配置与tabBar内的list属性的路径配置必须一一对应,协调一致,不然调用了哪个页面,二者中有一个没配置都不起作用

另外,pages属性是要一定一定要在引用页面的时候配置好路径。

就像官方文档说的:

【注意】json文件不要加任何注释信息,任何json文件都是这样;

  • wxss后缀的是样式表文件。是整个小程序的公共样式表

  • 其他自定义文件夹下的页面中,wxml后缀的文件是页面结构文件。

  

2. pages文件夹下的index 页面和 logs 页面

 pages 中的第一个页面是小程序的首页,一个小程序页面由四个文件组成。

index 页面——小程序的欢迎页

页面的样式表(.wxss文件)是非必要的。当有页面样式表时,页面的样式表中的样式规则会层叠覆盖 app.wxss 中的样式规则。

如果不指定页面的样式表,也可以在页面的结构文件中直接使用 app.wxss 中指定的样式规则。【.json文件同理】

index.js、index.json、index.wxml、index.wxss——描述页面的这四个文件必须具有相同的路径与文件名

logs 页面——小程序启动日志的展示页

 

3.  框架

小程序的核心—响应的数据绑定系统

即:在逻辑层修改数据,视图层就会做相应的更新

视图层

视图层(View)描述语言:wxml,wxss

逻辑层(App Service)框架:基于javascript

 

//util文件夹下的util.js

 View Code

判断时分秒是否大于10,不大于10,前边加一个0:

 n[1] ? n : '0' + n

 

4.    pages属性——一个数组

每一项都是字符串,写入路径信息,来指定小程序由哪些页面组成。字符串之间用逗号隔开。

每一项代表对应页面的【路径+文件名】信息,数组的第一项代表小程序的初始页面

小程序中新增/减少页面,都需要对 pages 数组进行修改。

 

5.   page.json

  相当于app.json下的window里的设置,只不过多了第七条:disableScroll

  disableScroll:true,

  这个情况,设置了也没用,页面超出后照样滚动,问题待解决。

 

6.    page.js

  page(data):

  data 数据必须是可以转成 JSON 的格式:字符串,数字,布尔值,对象,数组。

 

 7.  wxs

该有的在文档都有: https://mp.weixin.qq.com/debug/wxadoc/dev/framework/view/wxs/01wxs-module.html

以下是我实验的:

一个wxs还可以调用两个wxs甚至多个
 
  

 

 

多个页面可以嵌套调用,比如:b调a,c调b,那么在c里边也可以输出a里边的原始数据
文件a与其原始数据
文件b的调用
文件c的调用

 

注意,定义了变量还要输出变量:“exports”的拼写,另外对象里边的结构也总是写错,key:value,(键名、冒号、键值、逗号、最后一条没有逗号,更没有分号

 

 

可以把js中的data的数据传入到wxs中,直接使用就好了。
 
<wxs src="./../tools.wxs" module = "toolJs"/>【可以闭合标签引入wxs页面】
直接把test.js中的数据当做参数传到wxs的函数中,调用得到boo函数的结果。如:{{toolJs.boo(msg)}}
 
tool.wxs截图在上边(是文件a的截图),text.js文件截图如下

 

组件

——scroll-view

经验总结、实验代码如下

html

 wxml

css

 wxss

js

 js

   

——block

    <block/> 并不是一个组件,它仅仅是一个包装元素,不会在页面中做任何渲染,只接受控制属性(想wx:if,wx:else,wx:for等)。

 

——template

模板定义:

template,双标签,且要给他起一个独一无二的name

<template name=“onlyName”>模板内容</template>

示例:

模板中也可以放变量,调用的时候再传入不同的数据。方便重复调用:

<template name=“onlyName”>

    <view >{{text}}</view></template>

 

模板引用:

通过import引用、调用目标文件中<template>中定义的内容

调用某个wxml页面中定义好的模板部分,template处用is调用

1 <import src=“定义模板的页面路径”/>2 <template is=“要引用的模板的name值”/>

示例:

技巧:

template的is中可以使用Mustache语法,里边放判断用的三元表达式,这样就可以动态性的根据需求渲染模板。

文档案例:

问题:

在模板页面设置的css样式,调用到另一个页面后,是不受管制的,所以可能需要复制一份css样式到调用的页面,或者把模板用到的css写到公用样式app.wxss中。

还有一种方法是调用wxss文件:@import方法:

 

@import "../about/about.wxss";

 

这个方法,可以把about.wxss里边的样式全部调到目标页面,但是还是建议公用的代码放到app.wxss中。

 

调用带数据的模板:

<template is="aboutTwo" data="{{msg:'我是index.wxml里边传入的数据'}}"/>

问题:

目前用这种,在template标签上放data属性来传入数据值得方法。但是如果数据多了咋办?那就要想怎么把数据放到js文件的data中,然后在template中调用。

永远记住一点

想要传入多个参数,可以试试三个点的符号加对象/数组名字的方法,这在es6中的新方法,在vue,小程序,甚至pug中都可用,真的很好用。

<template is="aboutTwo" data="{{...对象名}}"/>

模板(template)的作用域:

模板拥有自己的作用域,所以js数据不会跟着模板结构被引过来,就和css也没过来一样,只能使用data传入的数据。不过可以把这些公共的数据放到app.js的data中,公用。

 

下边是demo代码:2017-09-01  17:19:42

 index.wxml
 about.wxml
 logs.wxml
 about.js+index.js

 

——inport 作用域

先说一个官方文档中的说法:

 官方文档的这种做法,应该在B.html定义的b模板中调用A中的a模板

<!-- B.wxml -->
<import src="a.wxml"/>
<template name="B">
  <text> B template </text>
    <template is="A" />
</template>

亲测有效,这样就可以连环调,不过有缺陷就是,如果a里边的内容是交叉放在b里边的,就没办法这样做了,毕竟在c里边调取的是一整个b,就没办法再拆开穿插了。

 

——include 引用模板页面

注意两点:

include引用除<template>模板以外的一整张页面的内容:

include引用的是一整个页面,如果目标页面当中有template模板的话,template里边的内容不会被调取出来。

但是,A页面通过include,可以调用到B页面里边通过import调取来的C页面的内容 :

即、A页面include目标页面为B页面,如果目标页面B中使用import和<template is=“C页面模板名字”>配合调用了第三个页面C里边的内容C-C,那么第三个页面的C-C内容也会在A页面里显示出来。

 示例:

C页面(logs.wxml)的 C-C内容 :

 logs.wxml

B页面(about.wxml)的内容:

里边包含普通文本、<template name="">定义的模板文本、import调用C页面内容的命令文本

 about.wxml

A页面(index.wxml)里调用B页面(about.wxml)的命令:

 index.wxml

A页面的显示:

 

二、小程序组件大纲——20170803版本

视图容器

基础内容

 

 

表单

    

input的type类型详解:

关于picker的multiSelector的mode详解: 

导航

 

多媒体

 

地图

画布

 

开发数据

 

客服会话

 

 

三、小程序困惑

1.问:小程序的文本换行?即原来html中的<br />标签,在小程序中可以用什么模拟?

1.答:小程序text文本组件支持转义字符,那么\n就可以用来换行。示例如下:

<text>小程序\n换行</text>

2.问:小程序的弹窗提示怎么做?即原来js中的alert功能,在小程序中可以用什么模拟?

2.答:使用console.log调试

3.小程序的页面跳转?即原来html中的a链接标签,在小程序中可以用什么模拟?,

3.答:用navigator或用js编码配置来实现小程序的页面跳转。

navigator如下:设置open-type为switchTab(导航间页面切换)或者reLaunch(应用内部跳转),

 <navigator url="/page/index/index" open-type="switchTab" hover-class="other-navigator-hover">切换 Tab</navigator>

这样点击“切换 Tab”文字就能进行跳转。

js如下,在wxml页面给view等组件绑定bindTap点击事件,然后js页面中配置事件时,让其navigateTo(跳转到)、并指定目标链接即可

问:如何跳转到指定的外部链接?

 

四、小程序开发问题汇总

2017-08-08  11:30:30

  • Padding的问题

一定要计算在宽度里边

若宽度是百分百,则尽量用内部内容的margin解决,不然会撑开页面,导致左右滑动的

不计算在里边,就用box-sizing设置一下

 

  • 字体大小、间距问题

手机看和电脑看有差距

所以涉及到的时候,要定可适应性的死宽度比较合适,不光自己,其他也是一样,不同的界面看,

虽然margin、padding一致,但是屏幕宽度不一样,最后留下的间隙就会有便宜,出现问题。

 

 2017-08-11  11:28:23

  • 模拟机可以css调用背景图但是真机不显示background-image

1  background: linear-gradient(to right, rgba(0,140,201,0.8),rgba(0,158,165,0.8)),url('https://pic.cnblogs.com/avatar/956663/20170428110911.png') no-repeat center/cover;

上边那张图片高兴地太早了,真机测试的时候,那张图根本就出不来。

 

仔细想想,我这张图是用的background-image。我想我学的知识真的是喂了狗了。

在小程序的开发文档(mp.weixin.qq.com/debug/wxadoc/dev/qa.html)中有这么一句话被我抛在了脑后:

 

既然如此,不废话,那就寻找解决/替代方法吧:

解决办法总是有的,不就是网络图片吗!我让这些图在我自己测试的时候,先调取个人网络空间地址啊,做上标记,等到上线的时候把连接再改过来就好了。

至于base64:

http://base64.xpcha.com/indexie.php    这是一个base64在线转码的网站。可以转换字符或者图片的编码。

这个网站,

 

第一步选择图片编码的tab,

第二步选择本地文件,

第三步复制编码,

第四步把这逆天的代码链接复制到对应的url中去。

搞定!

 

 2017-08-10  16:49:44

  • rpx和px的使用场景

字体大小、宽度等要用到rpx,并且数值是px的两倍。不然小的设备观看是会被截掉的。

px用在margin、padding啥的上边。重点是上下边距和间距,左右的也可能要自适应式的、

 

  • 溢出隐藏+小标点符号不能显示

溢出隐藏+小标点符号不能显示,不知道是配错组件还是因为啥。有待实验。

我没有实现的情况是:view里边套了text,给view溢出隐藏的三条代码没用,把代码给了text并设置其display为block也不出效果

 

  • 小程序本页面内楼层跳转

用到scroll-view组件:

讲解页面:http://blog.csdn.net/liona_koukou/article/details/54408396
组件文档:https://mp.weixin.qq.com/debug/wxadoc/dev/component/scroll-view.html?t=2017112
大致思路就是:把所有需要滚动、跳转的东西都放到scroll-view中,然后给scrol-view一个scroll-into-view属性,

属性值用变量表示,在js数据中进行判断点击的是哪个按钮,传参改变scroll-into-view的值。

这种想法是可以,但是不适合我本次项目。毕竟scroll-view要设置固定的高度,如果没有固高,scroll-into-view根本不起作用

 

  • 如何让传入的json数据渲染到页面后,带组件的标签格式?或者正确区分并翻译我的组件代码和文本?

比如我json里这么写:

  

翻译结果—:

这么做翻译不出来。其他方法有吗?我想在json中插入图片

哈哈,我用了if判断,json中有链接的地方我就给他显示这一组view组件,否则就是另一组:

 

Json数据中这样写:

这样有图片地址的就会调用图片地址,并且把结构写成if的情况,没有picsrc的就会直接一个text组件!

 

  • 关于页面跳转

我用的js的跳转方法,加一个点击监听,bindtap后执行函数wx.navigateTo 但是没反应老报错,

一直返回跳转失败和跳转完成的函数内容。后来才发现,是我没有在app.json里边加入新增加的页面,导致跳转不成功的。

以下是报错截图

所以app.json的页面注册真的很重要,切记切记!大问题。

——跳转路径src的填写

直接写路径名即可,不用加.wxml,不然报错。

跳转到应用内、非tabBar页面

就是说你src的链接处填写的页面,不能是外部链接,并且内部的页面现在app.json上注册了,

并且不是tabBar正在使用的页面,并且链接的书写方式不能加后缀名字!!才可以跳转成功!因此看来,

要跳转到该页面时,页面的命名上,wxml页面和其他js、css页面不能重名?

经过试验,是可以重名的——如下:因为我注册text页面的时候,自动加了其他三个同名的文件,

但是最后我调用这个目录下的text名字文件时,依旧跳转成功,看来他自己只认wxml

 

 

五、小程序技巧

  • 页面加载后切换一次类名,实现初始页动画展示、初始页切换类名、配合一次性定时器切换类名

  •  View Code

     

  • 返回顶部 效果

 要配合scroll-view组件、wx:if功能、、、、具体代码如下:

主要是scroll-top这个属性目前在微信中是scroll-view组件支持的,所以需要他配合完成。

wxml

1 <scroll-view class="scrollview-style" scroll-y bindscroll="wrapScroll" bindscrolltolower= "scrolltolower" scroll-top="{{scrollTop}}">2     <view class="toTop" bindtap="goTop" wx:if="{{floorstatus}}">返回顶部</view>3 <view>接下来的其他各种内容。。。</view>4 </scroll-view>

html代码解析: 

scroll-view作为整个页面的大package,所有页面内容都要放在滚动组件内部

至于返回顶部按钮,因为是要固定在页面底部的,所以可以不放在scroll-view组件中,这里我放进去了。

css

 css

css代码解析:

croll-view给了一个绝对定位,不过他的上下左右皆是0,这样目的是为了把scroll-view撑开。

不过经过我后来的测试,把绝对定位这一套代码删掉,然后只要有scroll-y属性都是可以的,

关键是这个属性,放在scroll-view内的所有内容组成的页面才可以滚动。

然后返回顶部这个按钮的样式就没啥好说的了。

根据自己想要的效果随便设置了,但是fixed固定定位肯定是少不了的。

js

——data配置

data: {
    scrollTop: 0,
    floorstatus: false}

先说初始数据这里,

因为wxml中要调取,所以会需要一个初始数据放在data这里:

scrollTop是对应scroll-view这里的距离顶部距离,初始是0。

Floorstatus这里是定义返回顶部按钮的初始渲染状态,初始值为false,

这样wx:if进行判断为否的话,view那条代码就不会被渲染,我们在页面中就看不到按钮,因为他没有被编译出来,死在了if手上。

——函数配置

复制代码
 1 //scroll-view组件的滚动事件函数 2 wrapScroll: function (e) { 3     if (e.detail.scrollTop > 500) { 4       this.setData({ 5         floorstatus: true 6       }); 7     } else { 8       this.setData({ 9         floorstatus: false10       });11     }12   }
复制代码
复制代码
1 //返回顶部按钮的点击事件2 goTop: function (e) {3     //console.log("点击了我了");4     this.setData({5       scrollTop: 06     })7 }
复制代码

之后开始动态的改变这两个值进而改变页面的呈现效果:

scroll-view给一个滚动的事件监听wrapScroll,当页面滚动的时候他就判断scroll-top的大小,如果大于我们设定的值(这里是500)的时候,他就执行一条设置数据的代码,否则就执行另一条设置数据的代码。

而他设置的数据为设定返回顶部按钮的渲染状态值——如果大于500就设置data里边的Floorstatus为true,反应到wxml中,if条件成立,就渲染view组件。进而我们就能看到他了。反之不渲染我们就看不到这个按钮。

至于返回按钮的那个点击事件goTop,原理上就是要点击他,改变scroll-view的高度值,所以在函数中,直接setData,改变高度值为0,反映到页面上的效果就是页面返回到了顶部。

从这里逻辑中,我觉得收获最大的是用if判断值,动态改变一个变量等于false还是ture,然后在wxml中再if判断,变量等于false还是ture,这样就能千回百转的完成逻辑。

我就说if是个好东西,把我们的思维传递给电脑。因为他只分是非,而人类有时候却分不了是非。。。

 

  • 动态的添加内容、渲染结构

wx:for功能——列表渲染!!

重复的结构都可以用其配置,然后传数据就ok;

 

另外,配合wx:if、wx:else来判断并动态选择将参数传入哪个结构中

 

  • Console.log(event)

Event::事件对象,方法在执行的时候,当前环境携带的一些信息

可以打印出来、获取很多信息,根据这些信息再度寻找你需要的信息的路径。如小程序里的event.detail.width;;;;

 

  • 关于rpx单位的用法:

rpx是用来自适应的,设计图是750px的模式下,用rpx直接一比一复刻建模,出来后就是标准的i6的界面,也能自适应绝大多数页面了

不过有些小的5px、3px、1px啥的间距或border,我就用px了,

可以大概记忆:1px = 2rpx;当然这么说很不科学,他们并不全等,但是做页面的时候这么想着可以很快地计算粗大概的数值。

 

  • 巧用if判断和for循环搭建结构

判断真的好用,在这个代码中,没有数据的时候,下边的结构就不会渲染出来。

还可以利用判断显示隐藏、添加删除类名啥的,达到自己想要的效果。

 

  • 如何实现“万能(不管内部文字极限)”垂直居中

见我另一篇博文的总结:http://www.cnblogs.com/padding1015/p/6194422.html

 

  • 终于研究出来怎么让Scroll-x实现横向滚动拉!! 

代码关键:

Scroll-view关键css: width:100%;scroll-x=“true”

里边view-wrap的关键css:width:要多长有多长px;(确保日后所有内容都能装下),不清楚浮动

最里边的image/内容:float:left;

具体如下:

 


分享:
评论:
你还没有登录,请先