ionic中一些常用的方法封装

前言

在ionic1技术栈的开发中中有很多零碎的功能或者服务，通过每次注入的方式都比较麻烦, 所以需要对一些通用的功能进行一些封装(通用的UI封装成指令，通用的逻辑封装成服务) ，下面主要对一些常用功能进行封装，当然这里只是一个引子，针对不同的逻辑业务，有不同或者更多的实践，此处只作为举例，主要代码和相关注释如下：

关键代码和注释

.factory('appUtils', [
'$state',
'$ionicViewSwitcher',
'$ionicNativeTransitions',
'$ionicHistory',
'$cookies',
'$ionicModal',
'$cordovaInAppBrowser',
'$cordovaToast',
'$cordovaKeyboard',
'$ionicScrollDelegate',
function ($state, $ionicViewSwitcher, $ionicNativeTransitions, $ionicHistory, $cookies, $ionicModal,
$cordovaInAppBrowser, $cordovaToast, $cordovaKeyboard, $ionicScrollDelegate) {
/* util 构造函数 */
var Util = function () {
};

/* util 原型对象 */
Util.prototype = {
/* 通用返回函数 */
back: function () {
// 不同平台分别处理,此处使用了ionic-native-transitions插件
ionic.Platform.isIOS() ? $ionicHistory.goBack() : $ionicNativeTransitions.goBack();
},

/* 进入某个路由模块 */
/* 路由的跳转不推荐使用a标签加上相应属性来做,用事件和下面的方法来跳转有效果较好的转场动画 */
go: function (route, params, callback) {
$ionicViewSwitcher.nextDirection('forward');
$state.go(route, params);
callback && typeof callback === 'function' && callback();
},

/* 解决双平台刷新问题的直接进入 tab栏 on-select 时使用 直接进入模块(无动画) */
doGo: function (url) {
$ionicNativeTransitions.locationUrl(url, {
"type": "fade",
"duration": 0
});
},

/* 字符串 trim 函数 */
trim: function (str) {
if (typeof str === 'string') {
return str.replace(/^\s+|\s+$/g, "");
}
},

/* 截取字符串的方法 */
textCut: function (str, num) {
if (typeof str === 'string' && typeof num === 'number' && str.length >= num) {
var temp = str.slice(0, num);
var last = temp.lastIndexOf(' '); // 找到空格的索引
temp = null; // 内存回收
return str.slice(0, last) + '...';
}
return str;
},

/* 此处只演示基于cookie的存储方法 | flag标识: 0 -> ip用户(匿名) , 1 -> 正常用户 */
/* isLogin为同步存储的登录标识 */
storage: function (data, flag, callback) {
var expireDate = new Date();
expireDate.setDate(expireDate.getDate() + 90); // 设置过期时间为3个月(90天)
$cookies.put('token', data.token, {'expires': expireDate}); // cookie 存储token
$cookies.put('user', JSON.stringify(data), {'expires': expireDate}); // cookie 存储 userInfo

// 下面是为正常用户和匿名ip用户的设置，登录与否的标识是isLogin
flag ? $cookies.put('isLogin', true, {'expires': expireDate}) : $cookies.remove('isLogin');
callback && angular.isFunction(callback) && callback();
},

/* 判断是否登录 */
isLogin: function () {
return $cookies.get('isLogin');
},

/* 退出功能 */
logout: function (fn) {
$cookies.remove('user');
$cookies.remove('token');
$cookies.remove('isLogin');
fn && typeof fn === "function" && fn();
},

/* 获取用户信息 */
getUser: function () {
return $cookies.get('user');
},

/* 用户提示功能 */
tips: function (prompt, index) {
// 位置信息 0 上 , 1 中 , 2 下
switch (index) {
case 0:
return window.cordova ? $cordovaToast.showShortTop(prompt) : alert(prompt);
break;
case 1:
return window.cordova ? $cordovaToast.showShortCenter(prompt) : alert(prompt);
break;
case 2:
return window.cordova ? $cordovaToast.showShortBottom(prompt) : alert(prompt);
break;
}
},

/* 弹出模态窗口功能 */
showModal: function (path, scope, animation, cb) {
$ionicModal.fromTemplateUrl(path, {
scope: scope,
animation: animation
}).then(function (modal) {
cb && angular.isFunction(cb) && cb(modal);
});
},

/* 隐藏 modal */
hideModal: function (modal) {
modal.hide();
},

/* 移除 modal 支持多个modal一起移除 */
destroyModal: function (scope, modal) {
scope.$on('$destroy', function () {
// 如果是单个，则直接移出，如果是数组，则迭代移除
if (Array.isArray(modal)) {
modal.forEach(function (item) {
item.remove();
})
} else {
modal && modal.remove();
}
});
},

/* 清除历史记录功能，每次回到tab根目录调用,修复ionic偶尔无法回退bug */
clearHistory: function () {
$ionicHistory.clearHistory();
},

/* pdf的方法 */
openPdf: function (url) {
// 安卓平台进入pdf模块打开，使用的是嵌入了一个pdf的h5网页(后台处理之后的页面)
if (!ionic.Platform.isIOS()) {
return this.go('pdf', {pdf: url});
}
// iOS平台通过内置safari打开
var options = {
location: 'yes',
clearcache: 'yes',
toolbar: 'yes'
};
// 下面此处只有真机能够打开,浏览器打不开
document.addEventListener("deviceready", function () {
$cordovaInAppBrowser.open(url, '_system', options)
}, false);
},

/* 测试用户是否登录 */
checkAndGoLogin: function (cb1, cb2) {
var flag = this.isLogin();  // 是否登录
if (flag) return cb1();
this.go('login', null, cb2);
},

/* 数组去重功能 */
arrayUnique: function (arr) {
if (!Array.isArray(arr)) return;
var res = [];
var json = {};
for (var i = 0; i < arr.length; i++) {
if (!json[arr[i]]) {
res.push(arr[i]);
json[arr[i]] = 1;
}
}
return res;
},

/* 存储搜索记录 */
getSearchTextStorage: function (searchText) {
var searchList = [];
var res = [];
if (localStorage.searchList && searchText) {
searchList = JSON.parse(localStorage.searchList);
searchList.unshift(searchText); // 头部加1
res = this.arrayUnique(searchList); // 数组去重
} else if (!localStorage.searchList && searchText) {
res.unshift(searchText);
} else {
return localStorage.searchList ? JSON.parse(localStorage.searchList) : [];
}
localStorage.searchList = JSON.stringify(res); // 本地存储
return res;
},
/* 键盘监听 只针对安卓,ios会自动处理 */
/* 其中window.addEventListener可使用ionic内置的 ionic.EventController.on代替 */
listenKeyBoard: function (cb_show, cb_hide) {
if (ionic.Platform.isIOS()) return;
window.addEventListener('native.keyboardshow', function () {
cb_show && typeof cb_show === 'function' && cb_show();
});
window.addEventListener('native.keyboardhide', function () {
cb_hide && typeof cb_hide === 'function' && cb_hide();
});
},

/* 隐藏键盘 */
hideKeyBoard: function () {
if (!$cordovaKeyboard.isVisible()) return;
$cordovaKeyboard.close();
},

/* 媒体文件相关功能 */

/* 用于判断数字是否 < 10 , < 10 则补0 */
tenFormat: function (num) {
return num / 10 < 1 ? '0' + num : num;
},

/* 处理时分秒 */
handleTime: function (hour, min, sec) {
var hh = this.tenFormat(hour);
var mm = this.tenFormat(min);
var ss = this.tenFormat(sec);
return hh + ':' + mm + ':' + ss;
},

/* 获取音频或视频时长 */
getMediaDuration: function (scope, media, mediaData) {
if (!media.duration) {
return;
}
mediaData.current = mediaData.duration = '00:00:00'; // 先初始化时间
mediaData.durationOrigin = media.duration; // 得到音频或视频时长
var hh = Math.floor(media.duration / 3600);
var mm = Math.floor(media.duration % 3600 / 60);
var ss = Math.floor(media.duration % 60);
mediaData.duration = this.handleTime(hh, mm, ss); // 得到经过格式转换之后的音频或视频时长
scope.$apply();
},

/* 检查媒体时长 */
checkToGetMediaDuration: function (scope, media, mediaData) {
!mediaData.durationOrigin && this.getMediaDuration(scope, media, mediaData);
},

/* 处理正在进行的时间 格式为: hh:mm:ss */
handlePlayingTime: function (time) {
var hh = Math.floor(time / 3600);
var mm = Math.floor(time % 3600 / 60);
var ss = Math.floor(time % 60);
return this.handleTime(hh, mm, ss);
},
// 隐藏闪屏
enterSettings: function () {
navigator.splashscreen && navigator.splashscreen.hide && navigator.splashscreen.hide(); // 设置闪屏
window.StatusBar && window.StatusBar.show(); // 显示状态栏
},

// 滚动到最顶部方法
scrollToTop: function (name, flag) {
$ionicScrollDelegate.$getByHandle(name).scrollTop(flag);
}
};

return new Util();
}]);