onShow() { // 页面显示 },

onPullDownRefresh() { // 下拉刷新 this.fetchData().then(() => { wx.stopPullDownRefresh(); }); },

fetchData() { this.setData({ loading: true }); return new Promise((resolve, reject) => { wx.request({ url: 'https://api.example.com/data', success: res => { this.setData({ list: res.data, loading: false }); resolve(res); }, fail: reject }); }); },

handleTap(e) { console.log('tap', e.currentTarget.dataset); } })


```xml
<!-- pages/demo/demo.wxml -->
<view class="container">
  <text class="title">{{message}}</text>
  
  <block wx:for="{{list}}" wx:key="id">
    <view class="item" bindtap="handleTap" data-id="{{item.id}}">
      {{item.name}}
    </view>
  </block>

  <loading wx:if="{{loading}}">加载中...</loading>
</view>

/* pages/demo/demo.wxss */
.container {
  padding: 20rpx;
}

.title {
  font-size: 32rpx;
  font-weight: bold;
  display: block;
  margin-bottom: 20rpx;
}

.item {
  padding: 20rpx;
  border-bottom: 1rpx solid #eee;
}

常用 API

// 提示框
wx.showToast({ title: '成功', icon: 'success' });
wx.showModal({ title: '提示', content: '确认？' });

// 跳转页面
wx.navigateTo({ url: '/pages/detail/detail?id=1' });
wx.redirectTo({ url: '/pages/detail/detail' });
wx.switchTab({ url: '/pages/index/index' });

// 存储
wx.setStorageSync('key', 'value');
const value = wx.getStorageSync('key');

// 授权
wx.getUserProfile({
  success: res => {
    console.log(res.userInfo);
  }
});

// 支付
wx.requestPayment({
  timeStamp: '',
  nonceStr: '',
  package: '',
  signType: 'MD5',
  paySign: '',
  success: () => {},
  fail: () => {}
});

组件通信

// 父组件 → 子组件
// parent.wxml
<child-component id="child" data="{{parentData}}" />

// parent.js
this.selectComponent('#child').childMethod();

// 子组件 → 父组件
// child.js
this.triggerEvent('myEvent', { detail: 'data' });

// child.wxml
<view bind:myEvent="handleEvent" />

// parent.wxml
<child-component bind:myEvent="handleEvent" />

TabBar 配置

// app.json
{
  "pages": [
    "pages/index/index",
    "pages/profile/profile"
  ],
  "window": {
    "navigationBarTitleText": "我的小程序"
  },
  "tabBar": {
    "color": "#999",
    "selectedColor": "#1890ff",
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "首页",
        "iconPath": "/icons/home.png",
        "selectedIconPath": "/icons/home-active.png"
      },
      {
        "pagePath": "pages/profile/profile",
        "text": "我的",
        "iconPath": "/icons/user.png",
        "selectedIconPath": "/icons/user-active.png"
      }
    ]
  }
}

常见问题

1. 页面不刷新

检查是否在 onShow 而非 onLoad 中处理数据刷新。

2. 授权失败

记得在 app.json 的 permission 中声明权限：

{
  "permission": {
    "scope.userLocation": {
      "desc": "用于展示附近内容"
    }
  }
}

3. 安卓真机调试

使用 vConsole 查看日志：

wx.vibrateLong(); // 震动提示

需要具体页面的代码吗？告诉我你的需求 📱

mini-program-dev

微信小程序开发辅助

常用代码模板

页面结构