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 詳見微信小程序官方文檔,確保代碼兼容最新版本。