以下整理自己平時累積的一些實用性較高的 JavaScript 方法,包含幾個來自網路上覺得值得一用的寫法,一併貼出來供大家指點與討論。
起因是客戶需求:單個分享到微信的頁面,點擊返回時要能跳轉到網站首頁。
我曾與客戶討論過替代方案——在頁面中加一個回首頁的按鈕。但這種方式無法自動套用到每個頁面,而且指定要做這個功能的分享頁也不一定有空位放得下一個圖標又不影響美觀。於是只能自己研究,網上找到的多是打擦邊球的做法,最後靠嘗試寫出了以下程式碼:
// 返回之前沒頁面則回首頁
function pushHistory() {
// 由於頁面載入時就會將目前頁面壓入紀錄,所以判斷是否小於 2
if (history.length < 2) {
var state = { title: "index", url: getHttpPrefix + "index.html" };
window.history.pushState(state, "index", getHttpPrefix + "index.html");
state = { title: "index", url: "" };
window.history.pushState(state, "index", "");
}
}
再將下面這段加入頁面的 ready 事件:
setTimeout(function () {
pushHistory();
window.addEventListener("popstate", function (e) {
if (window.history.state != null && window.history.state.url != "") {
location.href = window.history.state.url;
}
});
}, 300);
功能就是判斷之前是否有頁面,若沒有就把指定網址插入 state,再監聽 popstate 事件進行跳轉。這段程式碼可能還有小問題,貼出來是希望有人能一起探討完善。
頁面除錯時,console.log() 那幾個字敲久了確實囉嗦。有些人會設定快捷輸入,但專案上線後看到一堆忘了刪的除錯訊息,清除起來同樣麻煩。所以我寫了個方法專門處理這種情況:
function lll() {
// 全域變數 _debug 用來控制除錯訊息開關
if (_debug) {
var arr = [];
// arguments 是方法的參數集合,這樣做不限制參數個數
for (var _item in arguments) {
// 依個人習慣,字串訊息顯示在一行,所以另外篩選拼接
if (typeof arguments[_item] == "string") {
arr.push(arguments[_item]);
} else {
console.log(arguments[_item]);
}
}
if (arr.length > 0) console.log(arr.join(','));
}
}
搭配一個全域開關,上線前把 _debug 設為 false,所有除錯輸出就一次關掉,不必逐處刪除。
還有一點不夠理想:沒辦法自動取得參數的名稱,否則就能像下面這樣輸出:
var a = 123, b = 333, obj = { name: "name", content: "..." };
lll(a, b, obj);
// 期望輸出:a:123, b:333
// obj: { name: "name", content: "..." }
這樣看起來會更清楚一些。
接過不少行動端定制開發的專案,經常需要取得目前位置。網上很多方案都要引入外部 js(百度 API、微信 API 等),以下介紹一個不必引入外部腳本、只要向 API 提交參數就能取得定位的方法:
if (getCookie('position') == "") {
if (navigator.userAgent.indexOf("MicroMessenger") > -1) {
// 判斷是否微信端,可依情況調整
navigator.geolocation.getCurrentPosition(function (position) {
// 透過 HTML5 geolocation 取得定位(行動端最準,PC 會有較大偏差)
var lat = position.coords.latitude;
var lng = position.coords.longitude;
$.ajax({
type: "GET",
url: "https://api.map.baidu.com/geocoder/v2/?ak=YOUR_AK&callback=renderReverse&location=" + lat + "," + lng + "&output=json&pois=1",
beforeSend: function () { iosload(); }, // 這段過程需要時間,最好有載入提示
data: {},
dataType: "jsonp", // 跨域傳輸需以 jsonp 形式進行
jsonpCallback: "renderReverse",
success: function (data) {
ios.hide();
$("#myposition").html("我在:" + data.result.addressComponent.city);
setCookie("position", data.result.addressComponent.city, 24 * 60 * 30);
}
});
}, function (error) {
// 定位失敗的處理
}, {});
}
}
這是我實際專案中的一段程式碼。因為需要判斷是否已取過定位、不希望每次載入都重新請求,所以用 Cookie 把結果快取了起來。流程是:先檢查 Cookie 有無位置資料,再判斷是否在行動端,最後呼叫 HTML5 的 geolocation 介面並把結果交給地圖服務做逆地理編碼,取得城市名稱。範例中的 AK 請替換成自己的金鑰,且切勿把正式的金鑰硬編在前端程式碼中。
專案中我只負責功能實作,頁面未必是自己搭的,難免會遇到不好取值結構的情況,例如:
<div>原價998現在只要 <a>99.8!</a> </div>
要從這種頁面取出 998 或 99.8 就會有點麻煩。以下方法可以很簡潔地解決:
function getNum(text) {
var value = text.replace(/[^(0-9).]/ig, "");
return parseFloat(value);
}
原理就是用正則把非數字、非小數點的字元替換為空字串(等同刪除),最後再轉為浮點數,方便後續處理,例如四捨五入或保留小數位。
這段是在網路上看到別人封裝成物件的判斷方式,覺得很好用也一併分享:
var browser = {
versions: function () {
var u = navigator.userAgent, app = navigator.appVersion;
return {
trident: u.indexOf('Trident') > -1, // IE 內核
presto: u.indexOf('Presto') > -1, // opera 內核
webKit: u.indexOf('AppleWebKit') > -1, // 蘋果、谷歌內核
gecko: u.indexOf('Gecko') > -1 && u.indexOf('KHTML') == -1, // 火狐內核
mobile: !!u.match(/AppleWebKit.*Mobile.*/), // 是否為行動終端
ios: !!u.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/), // iOS 終端
android: u.indexOf('Android') > -1 || u.indexOf('Linux') > -1,
iPhone: u.indexOf('iPhone') > -1,
iPad: u.indexOf('iPad') > -1,
webApp: u.indexOf('Safari') == -1,
weixin: u.indexOf('MicroMessenger') > -1, // 是否微信
qq: u.match(/\sQQ/i) == " qq"
};
}(),
language: (navigator.browserLanguage || navigator.language).toLowerCase()
};
// 使用方式
if (browser.versions.webKit) {
// 為蘋果、谷歌內核執行的程式碼
}
需要提醒的是,以 user-agent 字串判斷環境本身就是脆弱的做法——字串可以被偽裝,且新版本可能改變格式。若只是用來做「行動端與桌面端」的粗略分流,這樣夠用;若涉及功能可用性,仍應回到能力偵測。
以下都是對 String 型別資料附加的方法。
/* 以指定長度顯示字串,多餘部分以省略號顯示
len -- 顯示長度;defaultStr -- 字串為空時顯示的內容 */
String.prototype.splitString = function (len, defaultStr) {
var result = "";
var str = this.toString();
if (str) {
str = str.trim();
if (str.length > len) {
result = str.substring(0, len) + "...";
} else {
result = str;
}
} else {
result = defaultStr;
}
return result;
};
String.prototype.delLast = function () {
return this.substring(0, this.length - 1);
};
有人可能覺得這方法有點多此一舉,但實際專案裡確實經常需要去掉最後一個字元(例如去掉拼接時多出的分隔符號)。與其每次都寫一長串 substring,不如封成方法,打的時候點一下就有。
String.prototype.addZero = function (n) {
var num = this;
var len = num.toString().length;
while (len < n) {
num = '0' + num;
len++;
}
return num;
};
// 使用:"2".addZero(2) → "02"
常用於日期、序號等需要固定位數的格式化場景。
String.prototype.DTD = function () {
return new Date(Date.parse(this.toString().replace(/-/g, "/")));
};
把「-」換成「/」是為了相容舊版 Safari 與 IE 對日期格式的解析差異,這是個很實用的細節。
String.prototype.telHide = function () {
var name = this;
return name.substr(0, 1) + "****" + name.substring(name.length - 1, name.length);
};
雖然 String.prototype 擴充寫起來很順手,但正式專案中有兩點建議留意:一是命名應加上專案前綴(例如 my_splitString),避免與其他套件或團隊成員的擴充衝突;二是若引入的第三方庫也擴充了同名方法,行為可能被覆寫而難以察覺。若專案已採用 ES6 以上環境,改用獨立工具函式(splitString(str, len))通常比改寫原型更安全可控。
以上就是本次整理的全部內容。這些方法多數不複雜,但都是實際被需求逼出來的累積——能省下重複敲打的力氣,也讓程式碼意圖更清楚。若你有更好的寫法,歡迎交流。