微信小程序原生开发的使用指南

事件

默认事件在 touchstart 时触发

若要实现 用户交互事件 与 系统默认事件 同步,只需要监听 touchstart 即可

阻止默认事件使用 catch 句柄

  • 禁止默认事件:catchtouchstart
  • 禁止触摸滑动 :catchtouchmove

路由跳转

A -> B -> C , C 直接返回 A

A -> B 通过 wx.navigateTo 跳转

B -> C 通过 wx.redirectTo 跳转.跳转触发后 B 页面就会被销毁, C 页面再返回 wx.navigateBack 就会直接到 A 了

A -> B -> C , 返回效果 C -> B -> A

正常 A -> B -> C 都是通过 wx.navigateTo 跳转的,所以 wx.navigateBack 只能返回上一界面

template 使用

定义 template

<template name="empty">
  <view style="text-align:center;">
    <image
      style="margin-top:{{ mt0 ? '0' : '180rpx'}};width: 200rpx;height:200rpx;"
      src="/common/images/no-content.png"
    ></image>
    <view style="margin-top: 20rpx;font-size: 24rpx; color: #B4B4B4;">{{text ? text : '无内容'}}</view>
  </view>
</template>

template 传入变量必须 xxx.js 的 data 上定义变量

data: {
  nomoreTxt: {text: '还没有粉丝哦~'},
}

在 wxml 引用 template

<import src="../../../template/empty.wxml" />
<template data="{{...nomoreTxt}}" is="empty"></template>

数据 Data

改变视图的唯一方式

the.setData({ xxx: this.data.xxx });
the.setData({ xxx: yyy });

this.setData 是一个函数,setData 之后执行 callback 必须使用 回调

the.setData({ xxx: yyy }, callback);

css

加载样式 .wxss

.wxss 不支持 background 加载图片

编写 css 不需要写 prefix,小程序上传的时候会自动编译

动态控制多类状态

<view class="{{}}  {{}}  {{}}">hello world</view>
style="margin-top:{{ mt0 ? '0' : '180rpx'}};"

网络请求

在小程序请求中,request header 默认 'Content-Type': 'application/json',适用于 get 请求

post请求 需要改为:"Content-Type": "application/x-www-form-urlencoded"

不知道为何有时候 post 请求不行的情况下直接修改大小写就搞定'content-type'

组件

组件默认样式

button 边框、背景

button::after {
  border: none;
}
buttom {
  background: transparent;
}

Swiper 组件

current 属性问题

当使用 Swiper 绑定 bindchange 时,current 改变时会触发 change 事件

因此当在 tab 点击菜单和 Swiper 组件 共同配合 来 切换页面时,

不需要分别在 tab 和 Swiper 上 执行相同代码,

只需要在 tab 上维护一个 currentIndex,然后所有业务逻辑在 Swiper 上执行,如:

export default {
  // 导航栏事件
  handleTab(e) {
    const currIndex = e.target.dataset.index + '';
    if (!currIndex) return;
    this.setData({
      tabIndex: currIndex,
    });
  },
  handleSwiperChange(e) {
    const currIndex = e.detail.current + '';
    if (!currIndex) return;
    this.setData({
      tabIndex: currIndex,
    });
    this.switchTab(currIndex);
    this.initTabLine();
    this.initParam();
  },
};

在 swiper 中使用 image 组件出现的偶尔无法显示图片的问题

  • 分析:在 swiper 内,<image> 在自动设置比例的时候有一个属性 overflow 一直被设置成 hidden,图片元素在超出了它的布局后都被隐藏了

  • 解决: 将所有<swiper-item><image>的属性 overflow 设置为 show

<swiper display-multiple-items="3" previous-margin="6px" next-margin="6px" class="jy-swiper">
  <block wx:for="{{list}}" wx:for-index="i" wx:key="i" wx:for-item="item">
    <swiper-item class="swiper-item">
      <image
        current="{{current}}"
        bindtap="handleImg"
        data-src="{{item.url}}"
        src="{{item.url}}"
        mode="aspectFill"
        class="img"
        style="overflow:show"
      ></image>
    </swiper-item>
  </block>
</swiper>

API 接口

wx.uploadFile

这里的 name 要对应服务器 File 文件的属性名字, 如:

wx.uploadFile({
  url: 'https://cdnapp.tanwan.com/tan_wan_app_upload.php',
  filePath: file,
  name: 'file',
  formData: param,
  success: (res) => resolve(res),
  fail: (err) => reject(err),
});
if ($_FILES["file"]["error"] > 0)
  {
  echo "Error: " . $_FILES["file"]["error"] . "<br />";
  }
else
  {
  echo "Upload: " . $_FILES["file"]["name"] . "<br />";
  echo "Type: " . $_FILES["file"]["type"] . "<br />";
  echo "Size: " . ($_FILES["file"]["size"] / 1024) . " Kb<br />";
  echo "Stored in: " . $_FILES["file"]["tmp_name"];
  }

wx.chooseImage

  • 可用于获取图片所在路径来获得文件流 File
  • 可配合 wx.request 来设置 responseType,获取 arrayBuffer,使用 wx.arrayBufferToBase64 来获取 base64
export default{
  chooseImage({count: 9}).then(res => {
    const { tempFiles, tempFilePaths } = res
    wx.request({
      url: tempFilePaths[0],
      method: 'GET',
      responseType: 'arraybuffer',
      success: function (res) {
        const base64 = 'data:image/jpg;base64,' + wx.arrayBufferToBase64(res.data);
        console.log(base64)
        uploadImage({ base64: base64 })

      }
    })
  })
}

wx.showModal

若需要换行则添加 \r\n,在小程序 IDE 无效果,真机换行

实战 FAQS

兼容性问题

  • Page.onPullDownRefresh()Page.onReachBottom() 不能 与 scroll-view 组件的上下拉共存,只能取其一

API 默认值在 ios 与 android 上差异

详情请查看原文-微信小程序原生开发的使用指南

相关文献

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,298评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,701评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,078评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,687评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,018评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,410评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,729评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,412评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,124评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,379评论 2 242
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,903评论 1 257
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,268评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,894评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,014评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,770评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,435评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,312评论 2 260

推荐阅读更多精彩内容