BUI 常用方法

生成唯一ID

bui.guid()

例子:

var gid = bui.guid();

類型檢測

bui.typeof(str)

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

彌補typeof 無法檢測是否是索引對象的問題, null 本身也會返回 object.

例子:

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


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


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

平臺檢測

bui.platform

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

例子:

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

版本檢查

bui.checkVersion(option)

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

例子:

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

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

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

{
    "versionName": "1.0",          //版本名稱
    "versionCode": 20160605,       //版本ID
    "minVersionCode": 20160604,    //最小版本號
    "isForced": true,              //是否強制更新,如果強制更新,需要檢測最小版本號
    "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ù)組比對,去重,復(fù)制,過濾,移除 等.

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

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

返回存在的第1個索引,支持普通數(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)

檢測是否存在

例子:

//普通數(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ù)組里的某個值,返回一個新數(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)鍵字的檢測

例子:

//普通數(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 從第幾個開始復(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)前手機的比例轉(zhuǎn)換的rem值

bui.unit.remToPx("2");

px轉(zhuǎn)換成rem

bui.unit.pxToRem

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

bui.unit.pxToRem("200");

日期處理

bui版本 1.6.0 以上

bui.date.format

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

例子:

      // 時間戳轉(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)日期對象

例子:

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

bui.date.toWeek

某個日期為星期幾, 或者周幾

例子:

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

bui.date.after

某個日期后多少天

例子:

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

bui.date.afterTime

某個日期后多少天

例子:

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