小程序常用api
1. wx.request - 发起网络请求
用于向服务器发送 HTTP 请求，获取数据或提交表单。
// 示例：GET 请求获取数据
wx.request({url: 'https://api.example.com/data', // 替换为实际 API 地址method: 'GET',success: (res) => {console.log('请求成功', res.data);},fail: (err) => {console.error('请求失败', err);}
});
2. wx.showToast - 显示提示消息
显示一个轻量级的提示框，常用于操作反馈。
// 示例：显示成功提示
wx.showToast({title: '操作成功！',icon: 'success',duration: 2000 // 显示时长（毫秒）
});
3. wx.getStorage - 获取本地缓存数据
从本地存储中读取数据，适合保存用户偏好设置。
// 示例：获取名为 'token' 的缓存数据
wx.getStorage({key: 'token',success: (res) => {console.log('获取缓存成功', res.data);},fail: (err) => {console.error('获取缓存失败', err);}
});
4. wx.navigateTo - 页面跳转
跳转到新页面，保留当前页面在栈中。
// 示例：跳转到 'pages/detail/detail' 页面
wx.navigateTo({url: '/pages/detail/detail' // 页面路径
});
5. wx.login - 用户登录
获取用户登录凭证（code），用于后端换取 openid。
// 示例：调用登录接口
wx.login({success: (res) => {if (res.code) {console.log('登录凭证:', res.code);// 通常这里发送 code 到后端服务器} else {console.error('登录失败');}}
});
6. wx.chooseImage - 选择图片
从相册或相机选择图片，常用于上传功能。
// 示例：选择一张图片
wx.chooseImage({count: 1, // 最多选择数量sizeType: ['original', 'compressed'], // 图片类型sourceType: ['album', 'camera'], // 来源success: (res) => {console.log('选择的图片路径:', res.tempFilePaths[0]);}
});
7. wx.showModal - 显示模态对话框
弹出对话框，用于确认操作或提示信息。
// 示例：显示确认对话框
wx.showModal({title: '提示',content: '确定要删除吗？',success: (res) => {if (res.confirm) {console.log('用户点击确定');} else if (res.cancel) {console.log('用户点击取消');}}
});
8. wx.getLocation - 获取地理位置
获取用户当前位置信息，需用户授权。
// 示例：获取经纬度
wx.getLocation({type: 'wgs84', // 坐标类型success: (res) => {console.log('纬度:', res.latitude, '经度:', res.longitude);},fail: (err) => {console.error('获取位置失败', err);}
});
使用建议
- 代码集成：将以上代码复制到小程序的
.js文件（如app.js或页面脚本）中即可运行。 - 权限处理：部分 API（如
wx.getLocation）需要在小程序配置文件中声明权限（在app.json中添加"permission": { "scope.userLocation": { "desc": "你的位置信息将用于定位" } }）。 - 错误处理：始终添加
fail回调处理异常。 - 官方文档：更多 API 详见微信小程序官方文档，确保代码兼容最新版本。