HTML5實(shí)現(xiàn)微商城

發(fā)布時(shí)間：2020-05-26 16:41:03 來源：億速云閱讀：520 作者：鴿子欄目：編程語言

背景
做一個(gè)H5的微商城，主要在微信內(nèi)，但也要考慮到其他瀏覽器。其中，首頁需要根據(jù)當(dāng)前用戶的經(jīng)緯度找到距離最近的門店并展示。前端需要做的工作就是獲取用戶的經(jīng)緯度然后查詢后臺(tái)接口并渲染頁面。

目標(biāo)與分析
我們的目標(biāo)是經(jīng)過封裝之后，只需要調(diào)用一個(gè)方法就可以拿到返回的位置信息。
我們需要做的事情是，針對(duì)不同的端（微信H5和其他瀏覽器環(huán)境）封裝不同的類，再通過一個(gè)方法通過 UA 區(qū)分，調(diào)用不同環(huán)境對(duì)應(yīng)的類獲取位置。
在微信內(nèi)部，經(jīng)過反復(fù)的實(shí)踐之后，不論是通過原生的 HTML5 定位，還是通過第三方(如百度或騰訊地圖) jsapi 獲取位置，不僅定位時(shí)間長(zhǎng)，甚至經(jīng)常出現(xiàn)定位失敗的情況，嚴(yán)重影響用戶體驗(yàn)，尤其對(duì)于大部分信息流都依賴于用于位置的商城首頁來說，是完全無法接受的。所以在微信內(nèi)我們只有微信 sdk 這一種選擇；

而對(duì)于瀏覽器端，通過第三方的地圖 jsapi 或定位組件，可以穩(wěn)定且較快速地獲取位置信息，為了與微信內(nèi)盡量保持一致，我們選擇的是騰訊地圖 jsapi。

解決方案
Talk is cheap, show me the code. 廢話不多說，直接上代碼：

在瀏覽器中，通過騰訊地圖jsapi獲取位置
1.1 在項(xiàng)目的 html 模版文件中引入騰訊地圖 jsapi

<script charset="utf-8" src="https://map.qq.com/api/js?v=2.exp&key=騰訊地圖key&referer=應(yīng)用名稱"></script>
說明：

使用騰訊地圖 jsapi, 需要先去騰訊地圖開放平臺(tái)申請(qǐng)自己的賬號(hào)，然后創(chuàng)建自己的應(yīng)用，將騰訊地圖key 和創(chuàng)建的應(yīng)用名稱替換上面的值。

1.2 調(diào)用獲取位置接口，獲取位置信息
為了方便復(fù)用，我們單獨(dú)封裝一個(gè)騰訊地圖 jsapi 的類，命名為 tMap.js

// tMap.js
const qq = window.qq
var geolocation = null
if (qq && qq.maps) {
// 初始化定位組件
geolocation = new qq.maps.Geolocation(
'QVLBZ-YUULR-OUMW7-WKXFD-4SUWS-UDBIA',
'mymap'
)
}

class TMap {
// 獲取定位計(jì)數(shù)器用于定位失敗時(shí)累計(jì)次數(shù) 超過3次后不再繼續(xù)，拋出定位失敗錯(cuò)誤
getPositionCount = 0

// 對(duì)外暴露的獲取位置接口
getLocation () {
return new Promise((resolve, reject) => {
// 定位成功回調(diào)
this.getTMapLocation(resolve, reject)
})
}

// 調(diào)用騰訊地圖獲取位置
getTMapLocation (success, fail) {
const _self = this

// 定位成功回調(diào)
const showPosition = position => {
  uni.setStorage({
    key: 'positionData',
    data: position
  })
  success(position)
}

// 定位失敗回調(diào)
const showErr = (err) => 
  // 如果獲取定位失敗超過3次 拋出錯(cuò)誤 否則繼續(xù)獲取定位信息
  if (this.getPositionCount > 3) {
    fail('超過3次 獲取定位失敗')
  } else {
    // 定位失敗遞歸
    _self.getPositionCount = _self.getPositionCount + 1
    _self.getTMapLocation(success, fail)
  }
}

// 調(diào)用騰訊web定位組件獲取位置信息
if (geolocation) {
  geolocation.getIpLocation(showPosition, showErr, {
    timeout: 6000,  // 定位超時(shí)時(shí)長(zhǎng) 單位ms
    failTipFlag: true
  })
}

}
}

export default new TMap()

在微信 webview 中, 通過微信sdk獲取位置信息
2.1 微信 js-sdk 相關(guān)的準(zhǔn)備工作
2.1.1 引入js文件
/**
- 微信sdk異步加載
- @param {*} src
- @param {} callback api接口
  /
  export const handlerLoadScript = callback => {
  const src = https://res.wx.qq.com/open/js/jweixin-1.4.0.js
  if (!(typeof callback === 'function')) {
  callback = function() {}
  }
  var check = document.querySelectorAll(script[src="${src}"])
  if (check.length > 0) {
  check[0].addEventListener('load', function() {
  callback()
  })
  callback()
  return
  }
  var script = document.createElement('script')
  var head = document.getElementsByTagName('head')[0]
  script.type = 'text/javascript'
  script.charset = 'UTF-8'
  script.src = src
  if (script.addEventListener) {
  script.addEventListener(
  'load',
  function() {
  callback()
  },
  false
  )
  } else if (script.attachEvent) {
  script.attachEvent('onreadystatechange', function() {
  var target = window.event.srcElement
  if (target.readyState === 'loaded') {
  callback()
  }
  })
  }
  head.appendChild(script)
  }
  2.1.2 注入權(quán)限驗(yàn)證配置
  所有需要使用JS-SDK的頁面必須先注入配置信息，否則將無法調(diào)用。通常是通過后臺(tái)接口獲取配置信息。

/**

注入權(quán)限驗(yàn)證配置
@param {object} 微信 js-sdk 權(quán)限驗(yàn)證配置
*/
export const wxconfigInfo = config => {
wx.config({
debug: false, // 開啟調(diào)試模式,調(diào)用的所有api的返回值會(huì)在客戶端alert出來，若要查看傳入的參數(shù)，可以在pc端打開，參數(shù)信息會(huì)通過log打出，僅在pc端時(shí)才會(huì)打印。
appId: config.appId,
timestamp: parseInt(config.timestamp),
nonceStr: config.nonceStr,
signature: config.signature,
jsApiList: [ // 需要使用的 jsapi 列表
...,
'getLocation' // 獲取地理位置
]
})
}
2.2 調(diào)用 api 獲取位置信息
/**
微信獲取位置
*/
export const handleGetLocation = (config) => {
return new Promise((resolve, reject)=>{
wxconfigInfo(config)
wx.ready(function () {
wx.getLocation({
type: 'wgs84', // 默認(rèn)為wgs84的gps坐標(biāo)，如果要返回直接給openLocation用的火星坐標(biāo)，可傳入'gcj02'
success: function (res) {
console.warn('微信sdk定位成功', res)
resolve({
lat: res.latitude, // 緯度
lng: res.longitude, // 經(jīng)度
speed: res.speed, // 速度，以米/每秒計(jì)
accuracy: res.accuracy // 位置精度
})
},
fail: function (err) {
console.error('微信sdk定位失敗', err)
reject(err)
}
})
})
wx.error(function(err) {
// config信息驗(yàn)證失敗會(huì)執(zhí)行error函數(shù)，如簽名過期導(dǎo)致驗(yàn)證失敗，具體錯(cuò)誤信息可以打開config的debug模式查看，也可以在返回的res參數(shù)中查看，對(duì)于SPA可以在這里更新簽名。
console.log('wxjsapi-error=', err)
reject(wxjsapi-error: ${err})
})
})
2.3 根據(jù)不同運(yùn)行環(huán)境調(diào)用不同的定位方法
// public.js

/**

UA枚舉
*/
const UA = {
/**
- 微信h6
  */
  WECHAT: 'WECHAT',
  /**
- 支付寶h6
  */
  ALIPAY: 'ALIPAY',
  /**
- 其他
  */
  OTHERS: 'OTHERS'
  }

/**

判斷客戶端運(yùn)行環(huán)境這里只判斷微信和瀏覽器h6
*/
export const getUserAgent = () => {
var userAgent = navigator.userAgent.toLowerCase()
if (userAgent.match(/Alipay/i) == 'alipay') {
return UA.ALIPAY
} else if (userAgent.match(/MicroMessenger/i) == 'micromessenger') {
return UA.WECHAT
} else {
return UA.OTHERS
}
}
// js-sdk.js
/**
喚起微信api
@param {*} _href 當(dāng)前頁面url
@param {*} options 分享信息
@param {} apiType 調(diào)用api類型
/
export const handleWXSDKCall = (_href, apiType, options) => {
return new Promise((resolve, reject)=>{
// 通過后臺(tái)接口獲取配置信息
WeChatServivce.sign(_href)
.then(res => {
if (res) {
if ( apiType === 'location' ) {
handleGetLocation(res).then((res)=>{
resolve(res)
}).catch(err=>{
reject(err)
})
}
}
})
.catch(err => {
reject(err-sign: ${err})
uni.showToast({
title: err.data.code + err.data.msg,
mask: true,
icon: 'none'
})
})
})
}
// getLocation.js
import { getUserAgent, handlerLoadScript } from '@/module/utils'
import { handleWXSDKCall } from '@/module/utils/wechat/wxJsApiSdk'
import UA from '@/module/enums/userAgent'
import TMap from '@/module/utils/tMap'

/**

對(duì)外暴露的獲取位置方法
@return Promise resolve一個(gè) positionData 對(duì)象 lat-緯度 lng-經(jīng)度
*/
const getLocation = () => {
return new Promise((resolve, reject) => {
console.log('進(jìn)入全局獲取用戶位置方法')
const storageData = uni.getStorageSync('positionData')
const userAgent = getUserAgent()
if (storageData) {
resolve(storageData)
} else {
// 根據(jù)環(huán)境判斷如果在微信內(nèi)使用微信sdk 其他使用騰訊地圖定位組件
if (userAgent === UA.WECHAT) {
handlerLoadScript(() => {
handleWXSDKCall(window.location.href, 'location').then((res) => {
uni.setStorageSync('positionData', res)
resolve(res)
}).catch(err => {
reject(err)
})
})
} else {
TMap.getLocation().then(res => {
uni.setStorageSync('positionData', res)
resolve(res)
}).catch((err) => {
reject(err)
})
}
}
})
}

export default getLocation

頁面調(diào)用
3.1 綁定方法到 Vue 原型上
import getLocation from '@/module/utils/getLocation'
Vue.prototype.$getLocation = getLocation
3.2 在頁面組件中調(diào)用
onShow() {
// 獲取位置信息后請(qǐng)求后臺(tái)接口
this.$getLocation()
.then(res => {
console.warn('首頁獲取位置成功', res)
this.latitude = res.lat
this.longitude = res.lng
// 這里根據(jù)獲取到的經(jīng)緯度請(qǐng)求后臺(tái)接口...
})
.catch(err => {
console.error('首頁獲取位置失敗', err)
// 錯(cuò)誤處理
})
}

總結(jié)
遇到的坑以及需要注意的點(diǎn)：

使用微信sdk獲取位置信息需要按順序完成以下步驟：
異步加載微信sdk
通過接口獲取配置信息，配置微信sdk
在wx.ready回調(diào)中調(diào)用方法
必須嚴(yán)格按順序完成以上的三個(gè)步驟，否則是無法調(diào)用微信sdk的功能的。

向AI問一下細(xì)節(jié)

HTML5實(shí)現(xiàn)微商城

猜你喜歡

最新資訊

相關(guān)推薦

相關(guān)標(biāo)簽