BUI 常用方法

生成唯一ID

bui.guid()

例子:

var gid = bui.guid();

類型檢測(cè)

bui.typeof(str)

• 返回字符串,全部是小寫.

彌補(bǔ)typeof 無(wú)法檢測(cè)是否是索引對(duì)象的問(wèn)題, null 本身也會(huì)返回 object.

例子:

var obj = {
    id: 123
}
var objectStr = bui.typeof(obj);
// "object"


var nullStr = bui.typeof(null);
// "null"


var undefinedStr = bui.typeof(undefined);
// "undefined"

平臺(tái)檢測(cè)

bui.platform

通過(guò) navigator.userAgent 判斷當(dāng)前的平臺(tái)類型. 方法名采用駝峰氏命名.

例子:

    bui.platform.isIphone();
    bui.platform.isIphoneX();
    bui.platform.isIpad();
    bui.platform.isWeiXin();
    // 平臺(tái)類
    bui.platform.isIos();
    bui.platform.isAndroid();
    bui.platform.isMac();
    bui.platform.isWindow();

版本檢查

bui.checkVersion(option)

這個(gè)方法會(huì)綁定ID按鈕的點(diǎn)擊,并且第一次會(huì)請(qǐng)求到如果有新版本的時(shí)候,會(huì)在按鈕旁邊增加個(gè)紅點(diǎn), 如果按鈕里面還有圖標(biāo)icon,則紅點(diǎn)會(huì)增加在圖標(biāo)上.

例子:

<div id="checkUpdate" class="bui-btn"></div>

bui.checkVersion({
    id: "#checkUpdate",
    currentVersion: "",
    currentVersionCode: "",
    url: "http://www.easybui.com/json/versionUpdate.json"
});

請(qǐng)求的接口返回的json內(nèi)容

{
    "versionName": "1.0",          //版本名稱
    "versionCode": 20160605,       //版本ID
    "minVersionCode": 20160604,    //最小版本號(hào)
    "isForced": true,              //是否強(qiáng)制更新,如果強(qiáng)制更新,需要檢測(cè)最小版本號(hào)
    "downloadUrl": "http://www.easybui.com/download/bui.apk", //安卓下載的地址
    "iosDownloadUrl": "https://itunes.apple.com/cn/app/id1362470378?mt=8",  //Appstore 地址
    "remark": "版本更新的內(nèi)容"   //新版本的描述,支持html
}

數(shù)組操作

常見的數(shù)組比對(duì),去重,復(fù)制,過(guò)濾,移除 等.

1.5.2 以下, 第1個(gè)參數(shù)為要比對(duì)的值,第2個(gè)參數(shù)為數(shù)組. 1.5.2 以上,第1個(gè)參數(shù)統(tǒng)一為數(shù)組, 第2個(gè)參數(shù)為比對(duì)的值, 1.5.2有向下兼容, 但建議全部統(tǒng)一數(shù)組在前.

bui.array.index(arr,name,key)

返回存在的第1個(gè)索引,支持普通數(shù)組及JSON數(shù)組

例子:

//普通數(shù)組:
var arr = ["hello","bui","hi","bui"];
var index = bui.array.index( arr,"bui" );


// console.log(index) //結(jié)果: 1


//JSON數(shù)組: 
var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
var index = bui.array.index( arr, "bui", "value" );
// console.log(index) //結(jié)果: 1 

bui.array.indexs(arr,name,key)

返回存在的所有索引,支持普通數(shù)組及JSON數(shù)組

例子:

//普通數(shù)組:
var arr = ["hello","bui","hi","bui"];
var index = bui.array.indexs( arr, "bui" );


// console.log(index) //結(jié)果: [1,3]


//JSON數(shù)組: 
var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
var index = bui.array.indexs( arr,"bui", "value" );
// console.log(index) //結(jié)果: [1]

bui.array.compare(arr,name,key)

檢測(cè)是否存在

例子:

//普通數(shù)組:
var arr = ["hello","bui","hi","bui"];
var index = bui.array.compare( arr,"bui" );


// console.log(index) //結(jié)果: 1


//JSON數(shù)組:
var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
var index = bui.array.compare( arr, "bui", "value" );
// console.log(index) //結(jié)果: 1

bui.array.remove(arr,name,key)

刪除數(shù)組里的某個(gè)值,返回一個(gè)新數(shù)組

例子:

//普通數(shù)組:
var arr = ["hello","bui","hi","bui"];
var newArr = bui.array.remove( arr,"bui" );


// console.log(newArr) //結(jié)果: ["hello","hi"]


//JSON數(shù)組:
var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"}];
var newArr = bui.array.remove( arr, "bui", "value" );
// console.log(newArr) //結(jié)果: [{ "id":1,value:"hello"}]

bui.array.uniq(arr,name,key)

去除重復(fù)的值

例子:

//普通數(shù)組:
var arr = ["hello","bui","hi","bui"];
var newArr = bui.array.excess(  arr,"bui" );


// console.log(newArr) //結(jié)果: ["hello","bui","hi"]


//JSON數(shù)組:
var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"},{ "id":3,value:"bui"}];
var newArr = bui.array.excess( arr, "bui", "value" );
// console.log(newArr) //結(jié)果: [{ "id":1,value:"hello"},{ "id":2,value:"bui"}]

bui.array.filter(arr,name,key)

篩選數(shù)組,可以用于搜索關(guān)鍵字的檢測(cè)

例子:

//普通數(shù)組:
var arr = ["hello","bui","hi","easybui"];
var newArr = bui.array.filter( arr,"bui" );


// console.log(newArr) //結(jié)果: ["bui","easybui"]


//JSON數(shù)組:
var arr = [{ "id":1,value:"hello"},{ "id":2,value:"bui"},{ "id":3,value:"easybui"}];
var newArr = bui.array.filter( arr,"bui", "value" );
// console.log(newArr) //結(jié)果: [{ "id":2,value:"bui"},{ "id":3,value:"easybui"}]

bui.array.copy(arr,from,length)

復(fù)制數(shù)組或某一部分, from 從第幾個(gè)開始復(fù)制, 默認(rèn):0; length 不傳則到數(shù)組的最后,否則以自身開始算起

例子:

//普通數(shù)組:
var arr = ["hello","bui","hi","easybui"];
var newArr = bui.array.copy( arr, 1 );
var newArr2 = bui.array.copy( arr, 1,2 );


// console.log(newArr) //結(jié)果: ["bui","hi","easybui"]
// console.log(newArr2) //結(jié)果: ["bui","hi"]

打電話

bui.unit.tel

例子:

bui.unit.tel("10086");

發(fā)短信

bui.unit.sms

例子:

bui.unit.sms("10086","CZMM");

發(fā)郵件

bui.unit.mailto

例子:

bui.unit.mailto({
    email:"admin@bui.com",
    cc:"test@bui.com",
    subject:"郵件主題",
    body:"郵件內(nèi)容"
});

rem轉(zhuǎn)換成px

bui.unit.remToPx

例子: 按當(dāng)前手機(jī)的比例轉(zhuǎn)換的rem值

bui.unit.remToPx("2");

px轉(zhuǎn)換成rem

bui.unit.pxToRem

例子: 按當(dāng)前手機(jī)的比例轉(zhuǎn)換的px值

bui.unit.pxToRem("200");

日期處理

bui版本 1.6.0 以上

bui.date.format

日期格式化, 兼容IOS的日期格式轉(zhuǎn)換

例子:

      // 時(shí)間戳轉(zhuǎn)日期
 var date = bui.date.format(1584781609309,"yyyy-MM-dd hh:mm:ss");
       // 2020-03-21 17:06:49
       // 日期轉(zhuǎn)日期
 var date = bui.date.format("2020-3-20","MM/dd");
       // 03/20

bui.date.convert

轉(zhuǎn)日期對(duì)象

例子:

 var date = bui.date.convert(1584781609309);
 date.getFullYear();
 // 2020

bui.date.toWeek

某個(gè)日期為星期幾, 或者周幾

例子:

var week = bui.date.toWeek("2020-3-20");
// 星期六
var week = bui.date.toWeek("2020-3-20",1);
// 周六

bui.date.after

某個(gè)日期后多少天

例子:

var date = bui.date.after("2020-3-20",5);
    // 2020-3-25

bui.date.afterTime

某個(gè)日期后多少天

例子:

var time = bui.date.afterTime("15:00",30);
       // 15:30