请选择 进入手机版 | 继续访问电脑版

微信小程序教程网

新浪微博达人勋

1116

积分

255

金钱

0

广播

Rank: 6Rank: 6

积分
1116

社区QQ达人最佳新人

发表于 2019-6-25 11:29:00 | 显示全部楼层 |阅读模式
分享到:
微信小程序的语法与vueJS类似,没学过vueJS的同学尽量先过一遍vue再看本教程。
首先在微信平台中注册一个账号获得开发者AppID,如下载微信小程序的开发者工具,安装完毕后打开开发者工具创建一个项目,将项目名称位置AppID填入即可。
2 文件目录及每个文件的功能

微信小程序的文件有四类,分别是.wxml文件,.wxss文件,.js文件,.json文件。 其中.wxml对应.html文件,.wxss文件对应.css文件,.json文件是配置文件。

pages文件夹中每一个文件夹代表一个页面,新建的项目有两个页面,分别四index和logs页面,每个页面包含一个.js文件,一个.wxml文件,一个.wxss文件以及一个.json文件。四类文件的作用稍后会讲到。

utils文件存放的是工具类,这个文件夹是非必须的,可以直接删掉。

project.config.json与sitemap.json初学者可以暂时不理会。

2.1 .wxml文件

.wxml文件类似我们写的.html文件,但标签上有些不同。

使用<view></view>标签代替<div></div>,使用<image></image>代替<img/>,使用<block></block>标签代替<template></template>,引入<text></text>标签等等,后续做项目的时候会了解到更多标签。


  1. <font color="rgb(51, 51, 51)"><font style="background-color:rgb(254, 254, 254)"><font face="&quot;"><font style="font-size: 16px"><!--新建项目的index.wxml文件-->
  2. <view class="container">
  3.   <view class="userinfo">
  4.     <button wx:if="{{!hasUserInfo && canIUse}}" open-type="getUserInfo" bindgetuserinfo="getUserInfo"> 获取头像昵称 </button>
  5.     <block wx:else>
  6.       <image bindtap="bindViewTap" class="userinfo-avatar" src="{{userInfo.avatarUrl}}" mode="cover"></image>
  7.       <text class="userinfo-nickname">{{userInfo.nickName}}</text>
  8.     </block>
  9.   </view>
  10.   <view class="usermotto">
  11.     <text class="user-motto">{{motto}}</text>
  12.   </view>
  13. </view></font></font></font></font>
复制代码

2.2 .wxss文件

.wxss文件就是.css文件。在app.wxss中控制全局样式,在pages文件夹中的页面文件的.wxss文件中控制局部样式。局部样式的优先级大于全局样式。

微信小程序推荐的布局方式是弹性布局( 弹性布局快速入门点这里 ),使用弹性布局可以很快速的搭建我们的项目。

微信小程序为了适配多种不同屏幕大小的设备,采取了一种的响应式单位rpx,使用rpx单位就好像使用百分比作为单位一样实现响应式布局。rpx是一种相对大小,我们使用iphone6的机型时,1px=2rpx,iphone6的大小为375px*667px,对于的rpx为750rpx*1334rpx。关于rpx的更多了解见wxss.html#尺寸单位

2.3 .json文件

.json文件是项目的配置文件


  1. <font color="rgb(51, 51, 51)"><font style="background-color:rgb(254, 254, 254)"><font face="&quot;"><font style="font-size: 16px">//-新建项目的app.json文件
  2. {
  3.   "pages": [
  4.     "pages/index/index",
  5.     "pages/logs/logs"
  6.   ],
  7.   "window": {
  8.     "backgroundTextStyle": "light",
  9.     "navigationBarBackgroundColor": "#fff",
  10.     "navigationBarTitleText": "WeChat",
  11.     "navigationBarTextStyle": "black"
  12.   },
  13.   "sitemapLocation": "sitemap.json"
  14. }</font></font></font></font>
复制代码

pages是存放所有页面的数组,每一个使用到的页面都需要写入pages内,不需要写文件后缀,window属性配置的是状态栏的样式,如navigationBarBackgroundColor用于设置背景色,navigationBarTitleText设置状态栏显示的文本,navigationBarTextStyle设置状态栏文本的颜色,只能传入black/white,除此之外还可以配置底部导航栏tabBar等等。

app.json文件进行全局配置,每个页面文件夹下还有一个.json文件用于局部配置,局部配置只能配置window属性

//局部配置.json文件,这里的配置会覆盖app.json中的window属性{  "backgroundTextStyle": "light",    "navigationBarBackgroundColor": "#fff",    "navigationBarTitleText": "WeChat",    "navigationBarTextStyle": "black"}

注意事项

  • 必须用一对大括号将属性包围起来,写成json字符串的格式。
  • 属性名必须用双引号包围起来.
  • .json文件中不可以写注释。
2.4.js文件

小程序的生命周期分为应用声明周期和页面生命周期,应用声明周期函数在app.js中定义,且在小程序运行过程中一直存在内存中处于运行状态,在这里可以定义应用声明周期函数以及定义全局变量。每个页面中的.js文件中则可以定义页面声明周期函数等,语法类似vueJS。

小程序为了提高性能,是不允许开发者操作DOM元素的。

//新建项目的app.js文件,通过App方法声明App({  onLaunch: function () {   //页面渲染前执行  },  globalData: {    //定义全局变量    userInfo: null    }});//页面的.js文件,通过Page方法声明Page({    });

3 指令

小程序中常用的指令有wx:for、wx:if、wx:elif、wx:else等。


  1. //wxml
  2. <view>
  3.     <text wx:if="count>0">{{count}}</text>
  4.     <text wx:elif="count<0">{{count}}</text>
  5.     <text wx:else>{{count}}</text>
  6. </view>
  7. //js
  8. data() {
  9.     return {
  10.         count:0
  11.     }
  12. }
复制代码
wx:if、wx:elif、wx:else的逻辑等同于if else。
  1. //wxml
  2. <view>
  3.     <text wx:for="arr" wx:for-item="value" wx:for-index="index">
  4.         {{index}}.{{value}}
  5.     </text>
  6. </view>
  7. //js
  8. data() {
  9.     return {
  10.         arr:[
  11.             '小明',
  12.             '小红',
  13.             '李雷'
  14.         ]
  15.     }
  16. }
  17. 输出===>
  18. <view>
  19.     <text>1.小明</text>
  20.     <text>2.小红</text>
  21.     <text>3.李雷</text>
  22. </view>
复制代码
wx:for即循环生成标签。
4 事件
小程序中不使用click事件,而用tab(触摸)事件代替,事件的前缀有两种分别是bind和catch,bind:tab表示冒泡事件,即事件触发后继续冒泡触发后续事件,catch:tab表示非冒泡事件,即事件触发后不再冒泡,类似执行了event.stopPropagation()方法。
  1. //实现一个点击加一的计数器
  2. //wxml
  3. <view>
  4.     <text bind:tab="addNumber">{{count}}</text>
  5. </view>
  6. //js
  7. Component({
  8.     //调用组件传来的变量
  9.     properties:{
  10.     },
  11.     //内部变量
  12.     data() {
  13.         return {
  14.             count:0
  15.         }
  16.     },
  17.     //内部方法
  18.     methods:{
  19.         //点击加一
  20.         addNumber() {
  21.             this.setData({
  22.                count:count+1
  23.             });
  24.         }
  25.     }
  26. });
复制代码
改变data中的属性值必须使用this.setData()方法,传入一个对象,对象中存放需要改变的属性键值对。
bind:tab可以简写为bindtb,个人喜欢bind:tab,看起来更清晰
5 组件
对于一个js文件,函数就是一个最小的、可复用的代码片段。而组件就是对于一个项目最小的、可复用的代码片段,他包括html、css、js代码,如我们常见的页面导航栏就可以做成一个组件,通过组件名字来使用,而不用将导航栏的代码复制粘贴到每个页面中。
5.1组件的使用
小程序的组件通过Component方法声明
  1. //.js文件
  2. Component({
  3.     properties:{
  4.         //接收外接传来的变量
  5.     },
  6.     data() {
  7.         return {
  8.             //组件内部的变量
  9.         }
  10.     },
  11.     methods:{
  12.         //组件内部的方法
  13.     }
  14. });
复制代码
声明完毕之后,在需要使用到该组件的页面中进行调用
  1. //使用组件的页面的.json文件
  2. {
  3.     "usingComponents":{
  4.         //由键值对组成,键表示组件的名字,值是组件的路径,也是不需要文件后缀
  5.         "component-name":"/components/component/index"
  6.     }
  7. }
  8. //使用组件的页面的.wxml文件
  9. <view>
  10.     <component-name />  <!--不需要传入properties-->
  11.     <component-name userName="小明"/>  <!--传入properties-->
  12. </view>
复制代码
5.2父子组件的传值
首先我们看一下使用组件内部变量的例子,我们定义了userName变量并把它渲染到页面当中。
  1. //component .wxml文件
  2. <view>
  3.     <text>Hello {{userName}},how are you?</text>
  4. </view>
  5. //component .js文件
  6. Component({
  7.     properties:{
  8.         //接口外接传来的变量
  9.     },
  10.     data() {
  11.         return {
  12.             userName:"李雷"
  13.         }
  14.     }
  15. });
复制代码

5.2.1父组件向子组件传值
接着我们接受一个外部的变量并把它渲染到页面上,这样就实现了父组件向子组件传值。

  1. //component .wxml文件
  2. <view>
  3.     <text>Hello {{userName}},how are you?</text>
  4. </view>
  5. //component .js文件
  6. Component({
  7.     properties:{
  8.         userName:{
  9.             type:String,    //调用该组件时传入的值的类型,可以是Number、String、Boolean、Object、Aray、Null(任意类型)
  10.             value:"李雷"    //默认值,调用该组件时未传入userName时,则userName的值为预设值李雷
  11.         }
  12.     },
  13.     data() {
  14.         return {
  15.             //组件内部变量
  16.         }
  17.     }
  18. });
复制代码

5.2.2子组件向父组件传值
子组件向父组件传值的思路一般都是父组件监听一个自定义的事件,子组件触发这个事件同时将值传入,父组件监听这个事件的时候就可以拿到子组件传过来的值。

  1. //component .wxml文件
  2. <view>
  3.     <text bind:tap="clickMe">Hello world</text>
  4. </view>
  5. //component .js文件
  6. Component({
  7.     properties:{
  8.         //接口外接传来的变量
  9.     },
  10.     data() {
  11.         return {
  12.             //组件内部变量
  13.         }
  14.     },
  15.     methods:{
  16.         //用户点击Hello world的时候向父组件传值
  17.         clickMe() {
  18.             //第一个参数为自定义事件名,父组件需要监听这个事件,第二个参数为需要传的值
  19.             this.triggerEvent('clickMe',{msg:'Hello world'});
  20.         }
  21.     }
  22. });
  23. //parent.wxml
  24. <!--监听clickMe事件-->
  25. <component bind:clickMe="clickMe"></component>
  26. //parent.js
  27. clickMe(event) {
  28.     console.log(event.detail.msg);//输出子组件传来的参数Hello world,子组件传来的参数都在event.deail中
  29. }
复制代码

5.3注意事项
前面我们说到了可以在app.wxss中定义全局样式,每个page页面都可以继承全局样式。但组件不同,组件只能继承有关字体以及color的样式,其他全局样式不能影响到组件的样式。
6 声明周期
小程序的声明周期分为整个应用的声明周期以及单个页面的声明周期,对于初学者来说这部分内容可以先跳过,它就像一幅眼镜,你自然会知道什么时候需要。
6.1 应用生命周期回调函数
在app.js中调用的App函数中,可以设置应用声明周期的回调函数
App({  onLaunch (options) {    //初始化完成后执行  },  onShow (options) {    //进入小程序后执行  },  onHide () {    //离开小程序后执行,注意不是销毁,如切换其他App时,微信处于后台中,这时调用onHide  },  onError (msg) {    //小程序出错时执行  }});6.2 页面的生命周期回调函数
  1. Page({
  2.   onLoad: function(options) {
  3.     //页面初始化后执行
  4.   },
  5.   onReady: function() {
  6.     //初次渲染结束执行
  7.   },
  8.   onShow: function() {
  9.     //进入页面执行
  10.   },
  11.   onHide: function() {
  12. //页面隐藏/切入后台时触发,如 wx.navigateTo 或底部 tab 切换到其他页面,小程序切入后台等  
  13.   },
  14.   onUnload: function() {
  15.     //页面卸载时触发。如wx.redirectTo或wx.navigateBack到其他页面时。
  16.   },
  17.   onPullDownRefresh: function() {
  18.     // Do something when pull down.监听下拉刷新事件,必须开启enablePullDownRefresh
  19.   },
  20.   onReachBottom: function() {
  21.     // Do something when page reach bottom. 监听用户上拉触底事件
  22.   },
  23.   onShareAppMessage: function () {
  24.     // return custom share data when user share.点击转发按钮
  25.   },
  26.   onPageScroll: function() {
  27.     // Do something when page scroll 页面滚动事件
  28.   },
  29.   onResize: function() {
  30.     // Do something when page resize旋转屏幕触发
  31.   },
  32.   onTabItemTap(item) {
  33.     console.log(item.index)
  34.     console.log(item.pagePath)
  35.     console.log(item.text)
  36.   },
  37.   // Event handler.
  38.   viewTap: function() {
  39.     this.setData({
  40.       text: 'Set some data for updating view.'
  41.     }, function() {
  42.       // this is setData callback
  43.     })
  44.   },
  45.   customData: {
  46.     hi: 'MINA'
  47.   }
  48. })
复制代码
6.3 组件生命周期回调函数
  1. Component({
  2.   lifetimes: {
  3.         created:function() {
  4.                 //组件实例化的时候执行,此时不能调用setData()
  5.         }
  6.     attached: function() {
  7.       // 在组件实例进入页面节点树时执行
  8.     },
  9.     detached: function() {
  10.       // 在组件实例被从页面节点树移除时执行
  11.     },
  12.   },
  13. });
复制代码
7零碎知识点7.1<image>
<image>标签中,不管图片多大,默认的图片大小宽度为300px,高度为225px,所以一定要给图片设置宽高。
7.2页面最外层元素
html页面中最外层的元素为<html>,小程序中的最外层元素为<page>,且<page>不需要自己添加啊,小程序自动添加的。
7.3开启识别转义字符
<text></text>标签中默认不能识别&nbsp;&lt;&gt;等转移字符,设置decode属性即可识别这些转移字符。
  1. <text>< ><text>
  2. ==>输出,不可识别转移字符
  3. < >
  4. <text decode="{{true}}">< ><text>
  5. ==>输出,可以识别转移字符
  6. < >
复制代码
7.4 隐藏元素
VueJS中使用v-if控制元素是否渲染,使用v-show控制元素是否显示。微信小程序中也有对应的操作,使用wx:if控制元素是否渲染,使用属性hidden控制元素是都显示。
  1. <span class="xml"><span class="hljs-comment"><!--渲染且显示(display:inline)--></span>
  2. <span class="hljs-tag"><<span class="hljs-name">text</span>></span>Hello World<span class="hljs-tag"><<span class="hljs-name">text</span>></span>
  3. <span class="hljs-comment"><!--渲染但不显示(display:none)--></span>
  4. <span class="hljs-tag"><<span class="hljs-name">text</span> <span class="hljs-attr">hidden</span>=<span class="hljs-string">"</span></span></span><span class="hljs-template-variable">{{true}</span><span class="xml"><span class="hljs-tag"><span class="hljs-string">}"</span>></span>Hello World<span class="hljs-tag"><<span class="hljs-name">text</span>></span></span>
复制代码






本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册 新浪微博登陆

x

新浪微博达人勋

567

积分

0

金钱

0

广播

Rank: 4

积分
567
发表于 2019-6-25 11:36:26 | 显示全部楼层
支持小程序教程网

新浪微博达人勋

141

积分

6

金钱

0

广播

Rank: 2

积分
141
发表于 2019-7-22 12:44:44 | 显示全部楼层
前排支持下

新浪微博达人勋

132

积分

9

金钱

0

广播

Rank: 2

积分
132
发表于 2019-8-13 17:25:04 | 显示全部楼层
1v1飘过

新浪微博达人勋

1175

积分

308

金钱

1

广播

Rank: 6Rank: 6

积分
1175

活跃会员热心会员推广达人社区QQ达人最佳新人

发表于 2019-8-22 02:30:15 | 显示全部楼层
顶起出售广告位

新浪微博达人勋

562

积分

0

金钱

0

广播

Rank: 4

积分
562
发表于 2019-9-9 03:16:07 | 显示全部楼层
沙发???

新浪微博达人勋

553

积分

0

金钱

0

广播

Rank: 4

积分
553
发表于 2019-9-18 13:12:16 | 显示全部楼层
:lol

新浪微博达人勋

624

积分

0

金钱

0

广播

Rank: 4

积分
624
发表于 2019-9-23 13:22:42 | 显示全部楼层
鼎力支持!!

新浪微博达人勋

131

积分

4

金钱

0

广播

Rank: 2

积分
131
发表于 2019-9-24 05:52:36 | 显示全部楼层
前排,哇咔咔

新浪微博达人勋

1164

积分

303

金钱

0

广播

Rank: 6Rank: 6

积分
1164

社区QQ达人最佳新人活跃会员热心会员推广达人

发表于 2019-10-1 07:43:39 | 显示全部楼层
前排顶,很好!
您需要登录后才可以回帖 登录 | 立即注册 新浪微博登陆

本版积分规则

小黑屋|手机版|Archiver|小程序教程网. ( 粤ICP备12089784号 )

GMT+8, 2019-12-9 07:18 , Processed in 0.296875 second(s), 42 queries .

Powered by Discuz X3.1

© 2001-2013 IOS教程网

快速回复 返回顶部 返回列表