声明:
本文章是基于黑马程序员的课程所编写,本人才疏学浅,内容仅作参考
项目和markdown文件资料:
微信小程序: 基于黑马程序员的微信小程序笔记与项目
1、获取APPID
登录地址:微信公众平台
主页—>开发—>开发管理—>开发设置—>开发者ID中的AppID
(复制)
2、下载“微信开发者工具”
下载地址:微信开发者工具
3、第一个项目
4、平台布局
结构 | 传统web | 微信小程序 |
---|---|---|
结构层 | HTML |
WXML |
样式层 | CSS |
WXSS |
逻辑层 | Javascript |
Javascript |
配置层 | 无 | JSON |
简介
一个小程序包括最基本的两种配置文件
app.json
page.json
注:配置文件中不能出现注解
app.json
app.json
是当前⼩程序的全局配置,包括了⼩程序的所有⻚⾯路径、界⾯表现、⽹络超时时间、底 部 tab 等。普通快速启动项⽬⾥边的 app.json
配置
{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle":"black"
}
}
字段的含义
pages
字段⸺⽤于描述当前⼩程序所有⻚⾯路径,这是为了让微信客⼾端知道当前你的⼩程序 ⻚⾯定义在哪个⽬录。window
字段⸺定义⼩程序所有⻚⾯的顶部背景颜⾊,⽂字颜⾊定义等。page.json
page.json
其实⽤来表⽰⻚⾯⽬录下的 page.json
这类和⼩程序⻚⾯相关的配置。app.json
中部分 window 配置项的内容,⻚⾯中配置项会覆盖 app.json
的 window 中相同的配置项。小程序根⽬录下的 sitemap.json
⽂件⽤于配置小程序及其⻚⾯是否允许被微信索引!
注:了解即可
简介
WXML(WeiXin Markup Language
)是框架设计的⼀套标签语⾔,结合基础组件、事件系统,可以构建出⻚⾯的结构!
测试
wxml
<view> {{msg}} view>
<view>{{num}}view>
<view> 是否是伪娘: {{isGirl}} view>
<view>{{person.age}}view>
<view>{{person.height}}view>
<view>{{person.weight}}view>
<view>{{person.name}}view>
<view data-num="{{num}}"> 自定义属性view>
js
//Page Object
Page({
data: {
msg: "hello mina",
num: 10000,
isGirl: false,
person: {
age: 74,
height: 145,
weight: 200,
name: "富婆"
}
}
});
测试
wxml
<view>
<checkbox checked="{{isChecked}}"> checkbox>
view>
<view>{{1+1}}view>
<view>{{'1'+'1'}}view>
<view>{{ 11%2===0 ? '偶数' : '奇数' }}view>
js
//Page Object
Page({
isChecked:true,
}
);
测试
wxml
<view>
<view wx:for="{{list}}" wx:for-item="item"
wx:for-index="index" wx:key="id">
索引:{{index}}--值:{{item.name}}
view>
view>
<view>
<view>对象循环view>
<view wx:for="{{person}}" wx:for-item="value"
wx:for-index="key" wx:key="age">
属性:{{key}}--值:{{value}}
view>
view>
<view>
<block wx:for="{{list}}" wx:for-item="item"
wx:for-index="index" wx:key="id"
class="my_list">
索引:{{index}} -- 值:{{item.name}}
block>
view>
js
//Page Object
Page({
list:[
{
id:0,
name:"猪八戒"
},
{
id:1,
name:"天蓬元帅"
},
{
id:2,
name:"悟能"
}
]
});
测试
wxml
<view>
<view>条件渲染view>
<view wx:if="{{true}}">显示view>
<view wx:if="{{false}}">隐藏view>
<view wx:if="{{flase}}">1view>
<view wx:elif="{{flase}}">2 view>
<view wx:else> 3 view>
<view>---------------view>
<view hidden>hidden1view>
<view hidden="{{false}}" >hidden2view>
<view>-----000-------view>
<view wx:if="{{false}}">wx:ifview>
<view hidden style="display: flex;" >hiddenview>
view>
频繁切换 ⽤ hidden
不常使⽤ ⽤ wx:if
测试
wxml
<text selectable decode>
text 123 <
text>
简述
在组件中绑定事件,在js
中处理事件和存储数据
测试
wxml
<input type="text" bindinput="handleInput" />
<button bindtap="handletap" data-operation="{{1}}" >+button>
<button bindtap="handletap" data-operation="{{-1}}">-button>
<view>
{{num}}
view>
js
// pages/demo04/demo04.js
Page({
data: {
num: 0
},
// 输入框的input事件的执行逻辑
handleInput(e) {
// console.log(e.detail.value );
this.setData({
num: e.detail.value
})
},
// 加 减 按钮的事件
handletap(e) {
// console.log(e);
// 1 获取自定义属性 operation
const operation = e.currentTarget.dataset.operation;
this.setData({
num: this.data.num + operation
})
}
})
简述
WXSS( WeiXin Style Sheets
)是⼀套样式语⾔,⽤于描述 WXML 的组件样式
与 CSS
相比,WXSS
扩展的特性有
响应式⻓度单位 rpx
样式导入
简述
rpx
(responsive pixel): 可以根据屏幕宽度进⾏⾃适应。规定屏幕宽为 750rpx 。如在 iPhone6 上,屏幕宽度为 375px ,共有750个物理像素,则 750rpx = 375px = 750物理像 素 , 1rpx = 0.5px = 1物理像素
设备 | rpx 换算px (屏幕宽度/750) |
px 换算rpx (750/屏幕宽度) |
---|---|---|
iPhone5 | 1rpx = 0.42px | 1px = 2.34rpx |
iPhone6 | 1rpx = 0.5px | 1px = 2rpx |
iPhone6 Plus | 1rpx = 0.552px | 1px = 1.81rpx |
建议: 开发微信⼩程序时设计师可以⽤ iPhone6 作为视觉稿的标准
使⽤步骤:
pageWidth
750rpx = pageWidth px
,因此 1px=750rpx/pageWidth
px
=> 750/pageWidth rpx
即可。测试
wxml
<view>
rpx
view>
wxss
view{
/* width: 200rpx; */
height: 200rpx;
font-size: 40rpx;
background-color: aqua;
/* 以下代码写法是错误 */
/* width:750 rpx * 100 / 375 ; */
width:calc(750rpx * 100 / 375);
}
测试
demo06.wxss
/*
1 引入的 代码 是通过 @import 来引入
2 路径 只能写相对路径
*/
@import "../../styles/common.wxss";
common.wxss
view{
color: aqua;
font-size: 50px;
}
简述
原生的小程序app不支持less,可以使用vscode
测试
wxss
/* 1 定义less变量 */
text {
/* 2 使用变量 */
color: yellow;
}
view .vie1 text {
color: red;
}
/* 导入 */
view {
color: green;
}
.main {
/*
1 less中 支持 两种注释 多行 单行
2 wxss 不能写 单行注释 因为 写了 和没写是一样!!!
*/
/* font-size: 200px; */
}
less
/* 1 定义less变量 */
@color:yellow;
text{
/* 2 使用变量 */
color:@color;
}
view{
.vie1{
text{
color: red;
}
}
}
/* 导入 */
@import "../../styles/reset.less";
view{
color: @themeColor;
}
.main{
/*
1 less中 支持 两种注释 多行 单行
2 wxss 不能写 单行注释 因为 写了 和没写是一样!!!
*/
/* font-size: 200px; */
// font-size: 400px;
}
reset.less
@themeColor:green;
普通标签
相当于是html中的div
标签
<view>helloworldview>
文本标签
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
selectable | Boolean | false | 文本是否可选 |
decode | Boolean | false | 是否解码 |
<text selectable="{{false}}" decode="{{false}}">
普 通
text>
图片标签
src
指定要加载的图片的路径,图片存在默认的宽度和高度 320 * 240 (原图大小是 200 * 100)mode
决定 图片内容 如何 和 图片标签 宽高 做适配
scaleToFill
默认值 不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素aspectFit
保持宽高比 确保图片的长边 显示出来 页面轮播(常用)aspectFill
保持纵横比缩放图片,只保证图片的 短 边能完全显示出来(少用)widthFix
以前web的图片的 宽度指定了之后 高度 会自己按比例来调整 (常用)bottom
类似以前的 background-position
lazy-load
lazy-load
会自己判断当图片出现在视口上下三屏的高度之内的时候自己开始加载图片测试
wxml
<image mode="bottom" lazy-load src="https://tva2.sinaimg.cn/large/007DFXDhgy1g51jlzfb4lj305k02s0sp.jpg" />
wxss
image{
box-sizing: border-box;
border: 1px solid red;
width: 300px;
height: 200px;
}
微信内置轮播图组件
属性 | 说明 |
---|---|
autoplay |
自动轮播 |
interval |
修改轮播时间 |
circular |
衔接轮播 |
indicator-dots |
显示 指示器 分页器 索引器 |
indicator-color |
指示器的未选择的颜色 |
indicator-active-color |
选中的时候的指示器的颜色 |
测试
wxml
<swiper autoplay interval="1000" circular indicator-dots indicator-color="#0094ff" indicator-active-color="#ff0094">
<swiper-item> <image mode="widthFix" src="//gw.alicdn.com/imgextra/i1/44/O1CN013zKZP11CCByG5bAeF_!!44-0-lubanu.jpg" /> swiper-item>
<swiper-item> <image mode="widthFix" src="//aecpm.alicdn.com/simba/img/TB1CWf9KpXXXXbuXpXXSutbFXXX.jpg_q50.jpg" /> swiper-item>
<swiper-item> <image mode="widthFix" src="//gw.alicdn.com/imgextra/i2/37/O1CN01syHZxs1C8zCFJj97b_!!37-0-lubanu.jpg" /> swiper-item>
swiper>
wxss
/* pages/demo10/demo10.wxss */
swiper {
width: 100%;
/* height: calc(100vw * 352 / 1125); */
height: 31.28vw;
}
image {
width: 100%;
}
导航组件(类似超链接标签)
属性名 | 说明 |
---|---|
url | 要跳转的页面路径(绝对路径/相对路径) |
target | 要跳转到当前的小程序 还是其他的小程序的页面 1.self 默认值 自己 小程序的页面 2.miniProgram 其他的小程序的页面 |
open-type | 跳转方式 |
open-type
有效值:
值 | 说明 |
---|---|
navigate(默认值) | 保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面 |
redirect | 关闭当前页面,跳转到应用内的某个页面,但是不允许跳转到 tabbar 页面 |
switchTab | 跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面 |
reLaunch | 关闭所有页面,打开到应用内的某个页面 |
测试
wxml
<navigator url="/pages/demo10/demo10"> 轮播图页面 navigator>
<navigator url="/pages/index/index"> 直接跳转到 tabbar页面 navigator>
<navigator open-type="redirect" url="/pages/demo10/demo10"> 轮播图页面 redirect navigator>
<navigator open-type="switchTab" url="/pages/index/index"> switchTab直接跳转到 tabbar页面 navigator>
<navigator open-type="reLaunch" url="/pages/index/index"> reLaunch 可以随便跳 navigator>
测试
富文本标签
可以将字符串解析成 对应标签,类似 vue
中 v-html
功能
测试
wxml
<rich-text nodes="{{html}}">rich-text>
js
// pages/demo12/demo12.js
Page({
data: {
// 1 标签字符串 最常用的
// 2 对象数组
html:[
{
// 1 div标签 name属性来指定
name:"div",
// 2 标签上有哪些属性
attrs:{
// 标签上的属性 class style
class:"my_div",
style:"color:red;"
},
// 3 子节点 children 要接收的数据类型和 nodes第二种渲染方式的数据类型一致
children:[
{
name:"p",
attrs:{},
// 放文本
children:[
{
type:"text",
text:"hello"
}
]
}
]
}
]
}
})
按钮标签
属性 | 说明 |
---|---|
size | 控制按钮的大小 1.default 默认大小 2.mini 小尺寸 |
type | 用来控制按钮的颜色(default 灰色/primary 绿色/warn 红色) |
plain | 按钮是否镂空,背景色透明 |
loading | 文字前显示正在等待图标 |
测试
wxml
<button>默认按钮button>
<button size="mini"> mini 默认按钮button>
<button type="primary"> primary 按钮button>
<button type="warn"> warn 按钮button>
<button type="warn" plain> plain 按钮button>
<button type="primary" loading> loading 按钮button>
open-type的合法值
值 | 说明 |
---|---|
contact | 直接打开客服对话功能,需要在微信小程序的后台配置,只能够通过真机调试来打开 |
share | 转发当前的小程序到微信朋友中(不能把小程序 分享到朋友圈) |
getPhoneNumber | 获取当前用户的手机号码信息,结合一个事件来使用 ,不是企业的小程序账号,没有权限来获取用户的手机号码 |
getUserInfo | 获取当前用户的个人信息,可以从bindgetuserinfo回调中获取到用户信息 |
launchApp | 打开APP,可以通过app-parameter属性设定向APP传的参数 |
openSetting | 打开小程序内置的授权页面 |
feedback | 打开小程序内置的意见反馈页面(只能够通过真机调试来打开) |
测试
wxml
<button open-type="contact">contactbutton>
<button open-type="share">sharebutton>
<button open-type="getPhoneNumber" bindgetphonenumber="getPhoneNumber">getPhoneNumberbutton>
<button open-type="getUserInfo" bindgetuserinfo="getUserInfo">getUserInfobutton>
<button open-type="launchApp">launchAppbutton>
<button open-type="openSetting">openSettingbutton>
<button open-type="feedback">feedbackbutton>
js
// pages/demo13/demo13.js
Page({
// 获取用户的手机号码信息
getPhoneNumber(e){
console.log(e);
},
// 获取用户个人信息
getUserInfo(e){
console.log(e);
}
})
图标标签
属性 | 说明 |
---|---|
type(必填) | 图标类型 |
size | 图标大小 |
color | 图标颜色 |
测试
wxml
<view class="group">
<block wx:for="{{iconSize}}">
<icon type="success" size="{{item}}"/>
block>
view>
<view class="group">
<block wx:for="{{iconType}}">
<icon type="{{item}}" size="40"/>
block>
view>
<view class="group">
<block wx:for="{{iconColor}}">
<icon type="success" size="40" color="{{item}}"/>
block>
view>
js
Page({
data: {
iconSize: [20, 30, 40, 50, 60, 70],
iconType: [
'success', 'success_no_circle', 'info', 'warn', 'waiting', 'cancel',
'download', 'search', 'clear'
],
iconColor: [
'red', 'orange', 'yellow', 'green', 'rgb(0,255,255)', 'blue', 'purple'
],
}
})
单选框标签
测试
wxml
<radio-group bindchange="handleChange">
<radio color="red" value="male">男radio>
<radio color="red" value="female" >女radio>
radio-group>
<view>您选中的是:{{gender}}view>
js
// pages/demo15/demo15.js
Page({
data: {
gender: ""
},
handleChange(e){
// 1 获取单选框中的值
let gender=e.detail.value;
// 2 把值 赋值给 data中的数据
this.setData({
// gender:gender
gender
})
}
})
复选框
测试
wxml
<view>
<checkbox-group bindchange="handleItemChange">
<checkbox value="{{item.value}}" wx:for="{{list}}" wx:key="id">
{{item.name}}
checkbox>
checkbox-group>
<view>
选中的水果:{{checkedList}}
view>
view>
js
// pages/demo16/demo16.js
Page({
data: {
list:[
{
id:0,
name:"",
value:"apple"
},
{
id:1,
name:"",
value:"grape"
},
{
id:2,
name:"",
value:"bananer"
}
],
checkedList:[]
},
// 复选框的选中事件
handleItemChange(e){
// 1 获取被选中的复选框的值
const checkedList=e.detail.value;
// 2 进行赋值
this.setData({
checkedList
})
}
})
简述
一个自定义组件由 json
wxml
wxss
js
4个文件组成
测试(组件端)
Tabs.json
⾸先需要在组件的 json
⽂件中进⾏⾃定义组件声明
{
"component": true,
}
Tabs.wxml
在组件的 wxml
⽂件中编写组件模板,在 wxss
⽂件中加⼊组件样式
<view class="tabs">
<view class="tabs_title">
<view wx:for="{{tabs}}" wx:key="id"
class="title_item {{item.isActive?'active':''}}"
bindtap="hanldeItemTap" data-index="{{index}}">
{{item.name}}
view>
view>
<view class="tabs_content">
<slot>slot>
view>
view>
Tabs.wxss
wxss
中不应使用ID选择器、属性选择器和标签名选择器.tabs{}
.tabs_title{
display: flex;
padding: 10rpx 0;
}
.title_item{
flex: 1;
display: flex;
justify-content: center;
align-items: center;
}
.active{
color:red;
border-bottom: 5rpx solid currentColor;
}
.tabs_content{}
简述
在页面的 json
文件中进行引用声明
测试(页面端)
json
{
"usingComponents": {
"Tabs":"../../components/Tabs/Tabs"
}
}
js
// pages/demo17/demo18.js
Page({
/**
* 页面的初始数据
*/
data: {
tabs: [
{
id: 0,
name: "首页",
isActive: true
},
{
id: 1,
name: "原创",
isActive: false
}
,
{
id: 2,
name: "分类",
isActive: false
}
,
{
id: 3,
name: "关于",
isActive: false
}
]
},
// 自定义事件 用来接收子组件传递的数据的
handleItemChange(e) {
// 接收传递过来的参数
const { index } = e.detail;
let { tabs } = this.data;
tabs.forEach((v, i) => i === index ? v.isActive = true : v.isActive = false);
this.setData({
tabs
})
}
})
wxml
<Tabs tabs="{{tabs}}" binditemChange="handleItemChange" >
<block wx:if="{{tabs[0].isActive}}">0 block>
<block wx:elif="{{tabs[1].isActive}}">1 block>
<block wx:elif="{{tabs[2].isActive}}">2 block>
<block wx:else>3block>
Tabs>
简述
流程:
测试
{{tabs}}
传递到 ⼦组件的 tabItems
属性中onMyTab
事件bindmytap
中的 mytap
事件
triggerEvent
方法,指定事件名
、detail
对象this.selectComponent("#tabs");
父组件代码
<tabs tabItems="{{tabs}}" bindmytap="onMyTab" >
内容-这里可以放插槽
tabs>
//page.js
data: {
tabs:[
{name:"体验问题"},
{name:"商品、商家投诉"}
]
},
onMyTab(e){
console.log(e.detail);
},
子组件代码
<view class="tabs">
<view class="tab_title" >
<block wx:for="{{tabItems}}" wx:key="{{item}}">
<view bindtap="handleItemActive" data-index="{{index}}">{{item.name}}view>
block>
view>
<view class="tab_content">
<slot>slot>
view>
view>
//com.js
Component({
properties: {
tabItems:{
type:Array,
value:[]
}
},
/**
* 组件的初始数据
*/
data: {
},
/**
* 组件的方法列表
*/
methods: {
handleItemActive(e){
this.triggerEvent('mytap','haha');
}
}
})
简述
分为应用生命周期和页面生命周期
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
onLaunch |
function | 否 | 监听小程序初始化 |
onShow |
function | 否 | 监听小程序启动或切前台 |
onHide |
function | 否 | 监听小程序切后台 |
onError |
function | 否 | 错误监听函数 |
onPageNotFound |
function | 否 | 页面不存在监听函数 |
测试
js
程序)//app.js
App({
// 1、应用第一次启动的就会触发的事件
onLaunch() {
// 在应用第一次启动的时候 获取用户的个人信息
// console.log("onLaunch");
// aabbcc
// js的方式来跳转 不能触发 onPageNotFound
// wx.navigateTo({
// url: '/11/22/33'
// });
},
// 2、应用 被用户看到
onShow(){
// 对应用的数据或者页面效果 重置
// console.log("onShow");
},
// 3、应用 被隐藏了
onHide(){
// 暂停或者清除定时器
// console.log("Hide");
},
// 4、应用的代码发生了报错的时候 就会触发
onError(err){
// 在应用发生代码报错的时候,收集用户的错误信息,通过异步请求 将错误的信息发送后台去
// console.log("onError");
// console.log(err);
},
// 5、页面找不到就会触发
// 应用第一次启动的时候,如果找不到第一个入口页面 才会触发
onPageNotFound(){
// 如果页面不存在了 通过js的方式来重新跳转页面 重新跳到第二个首页
// 不能跳到tabbar页面 导航组件类似
wx.navigateTo({
url: '/pages/demo09/demo09'
});
// console.log("onPageNotFound");
}
})
属性 | 类型 | 说明 |
---|---|---|
data |
Object | 页面初始数据 |
onLoad |
function | 生命周期回调—监听页面加载 |
onShow |
function | 生命周期回调—监听页面显示 |
onReady |
function | 生命周期回调—监听页面初次渲染完成 |
onHide |
function | 生命周期回调—监听页面隐藏 |
onUnload |
function | 生命周期回调—监听页面卸载 |
onPullDownRefresh |
function | 监听用户下拉动作 |
onReachBottom |
function | 页面上拉触底事件 |
onShareAppMessage |
function | 用户点击右上角转发 |
onPageScroll |
function | 页面滚动触发事件的处理函数 |
onResize |
function | 页面尺寸改变时触发 |
onTabItemTap |
function | 当前页面是tab页时,点击tab时触发 |
测试
json
{
"pageOrientation": "auto"
}
js
(*)Page({
/**
*1、 页面的初始数据
*/
data: {
},
/**
* 2、生命周期函数--监听页面加载
*/
onLoad: function (options) {
console.log("onLoad");
// onLoad发送异步请求来初始化页面数据
},
/**
* 3、生命周期函数--监听页面显示
*/
onShow: function () {
console.log("onShow");
},
/**
* 4、生命周期函数--监听页面初次渲染完成
*/
onReady: function () {
console.log("onReady");
},
/**
* 5、生命周期函数--监听页面隐藏
*/
onHide: function () {
console.log("onHide");
},
/**
* 6、生命周期函数--监听页面卸载 也是可以通过点击超链接来演示
*
*/
onUnload: function () {
console.log("onUnload");
},
/**
* 7、页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
console.log("onPullDownRefresh");
// 页面的数据 或者效果 重新 刷新
},
/**
* 8、页面上拉触底事件的处理函数
* 需要让页面 出现上下滚动才行
*/
onReachBottom: function () {
console.log("onReachBottom");
// 上拉加载下一页数据
},
/**
* 9、用户点击右上角分享
*/
onShareAppMessage: function () {
console.log("onShareAppMessage");
},
/**
* 10、页面滚动 就可以触发
*/
onPageScroll(){
console.log("onPageScroll");
},
/**
* 11、页面的尺寸发生改变的时候 触发
* 小程序 发生了 横屏竖屏 切换的时候触发
*/
onResize(){
console.log("onResize");
},
/**
* 12、
* 1 必须要求当前页面 也是tabbar页面
* 2 点击的自己的tab item的时候才触发
*/
onTabItemTap(){
console.log("onTabItemTap");
}
})
wxml
<navigator url="/pages/demo17/demo17" open-type="navigate">
跳转到demo17
navigator>
<navigator url="/pages/demo17/demo17" open-type="redirect">
重定向到demo17(redirect)
navigator>
感谢观看!!!