clearstorage

微信官⽅⽂档学习——API

⼀、基础

e('')//true//e（判断⼩程序的API，回调，参数，组件等是否在当前版本可⽤）

rrayBuffer=64ToArrayBuffer('xuezhiqian')//(将Base64字符串转成ArrayBuffer对象)

rrayBuffer=newUint8Array([11,22,33])//(将Base64字符串转成ArrayBuffer对象)

constbase64=ufferToBase64(arrayBuffer)

temInfoSync()//(系统信息,包括设备品牌、型号、微信号版本、摄像头、蓝⽛、WiFi的开关等)

temInfo({//success、fail、complete

success(res){

(res)

}

})

ateManager()//获取全局唯⼀的版本更新管理器

constupdateManager=ateManager()

kForUpdate(function(res){//onCheckForUpdate(监听向微信后台请求检查更新结果事件。微信在⼩程序冷启动时⾃动检查更新，)

(ate)//请求完新版本信息的回调

})

teReady(function(){//监听⼩程序有版本更新事件,下载成功后回调

dal({

title:'更新提⽰',

content:'新版本已经准备好，是否重启应⽤？',

success:function(res){

if(m){

pdate()//强制⼩程序重启并使⽤新版本。在⼩程序新版本下载完成后调⽤。

}

}

})

})

teFailed(function(){//新版本下载失败

})

nchOptionsSync()//获取⼩程序启动时的参数,包含path,query,scene,只有冷启动

erOptionsSync()//获取⼩程序启动时的参数,包含path,query,scene,冷启动和热启动

注：

①热启动：假如⽤户已经打开过某⼩程序，然后在⼀定时间内再次打开该⼩程序，此时⽆需重新启动，只需将后台态的⼩程序切换到前台，

这个过程就是热启动；

②冷启动：⽤户⾸次打开或⼩程序被微信主动销毁后再次打开的情况，此时⼩程序需要重新加载启动，即冷启动

⼆、路由

//Tab跳转到tabBar页⾯

Tab({

url:'/index'

})

//ch关闭所有页⾯，打开到应⽤内的某个页⾯

//ctTo关闭当前页⾯，跳转到应⽤内的某个页⾯。但是不允许跳转到tabbar页⾯

//teTo保留当前页⾯，跳转到应⽤内的某个页⾯。⼩程序中页⾯栈最多⼗层

//teBack关闭当前页⾯，返回上⼀页⾯或多级页⾯。可通过getCurrentPages获取当前的页⾯栈，决定需要返回⼏层

//此处是A页⾯

teTo({

url:'B?id=1'

})

//此处是B页⾯

teTo({

url:'C?id=1'

})

//在C页⾯内navigateBack，将返回A页⾯

teBack({

delta:2

})

//hannel页⾯间事件通信通道

三、界⾯

ast({

title:'显⽰消息提⽰框',

icon:'success',//success、loading、none

duration:2000,

mask:true

})

ast()//隐藏消息提⽰框

dal({

title:'提⽰',

content:'这是⼀个模态弹窗',

showCancel:false,//是否显⽰取消按钮

cancelText:'取消',//取消按钮的⽂字

cancelColor:'#000000',//取消按钮的⽂字颜⾊

confirmText:'确定',

confirmColor:'#576B95',

success(res){

if(m){

('⽤户点击确定')

}elseif(){

('⽤户点击取消')

}

}

})

ading({

title:'加载中'

})

eout(function(){

ading()

},2000)

//6.显⽰操作菜单

tionSheet({

itemList:['拍照','从相册选取'],

success(res){

(ex)

},

fail(res){

()

}

})

})

//7.在当前页⾯显⽰导航条加载动画

vigationBarLoading({

success(e){

}

})

vigationBarLoading()//在当前页⾯隐藏导航条加载动画

//9.动态设置当前页⾯的标题

igationBarTitle({

title:'当前页⾯'

})

//10.设置页⾯导航条颜⾊

igationBarColor({

frontColor:'#ffffff',//前景颜⾊值，包括按钮、标题、状态栏的颜⾊，仅⽀持#ffffff和#000000

backgroundColor:'#ff0000',

animation:{

duration:400,

timingFunc:'easeIn'

}

})

meButton()//隐藏返回⾸页按钮

kgroundTextStyle({

textStyle:'dark'//下拉背景字体、loading图的样式为dark只能为dark和light

})

kgroundColor({

backgroundColorTop:'#ff0000',//顶部窗⼝的背景⾊为⽩⾊

backgroundColorBottom:'#fff000',//底部窗⼝的背景⾊为⽩⾊

})

//14.显⽰tabBar某⼀项的右上⾓的红点

bBarRedDot({

index:0,

})

隐藏tabbar上的红点

bBarRedDot({

index:(0),

})

//15.显⽰tabbar

bBar({

animation:true,

})

//16.隐藏tabbar

bBar({

animation:true,

})

//17.动态设置tabBar的整体样式

BarStyle({

color:'#000000',

selectedColor:'#ffffff',

backgroundColor:'#ff0000',

borderStyle:'black'//值只能是black/white

})

//18.动态设置tabBar某⼀项的内容(⽂字和图⽚)

BarItem({

index:0,

text:'text',

iconPath:'/path/to/iconPath',

selectedIconPath:'/path/to/selectedIconPath'

})

//19.为tabBar某⼀项的右上⾓添加⽂本

BarBadge({

index:0,

text:'1'

})

//20.移除tabBar某⼀项右上⾓的⽂本

TabBarBadge({

TabBarBadge({

index:0,

})

//21.字体-------------------------------------------------需学习

ntFace({

family:'BitstreamVeraSerifBold',

source:'url("/")',

success:

})

//22.下拉刷新下拉刷新要在json⽂件中容许下拉刷新"enablePullDownRefresh":true

ullDownRefresh()//下拉刷新

llDownRefresh()//停⽌下拉刷新

//23.滚动

rollTo({

scrollTop:0,

duration:300

})

//24.置顶

BarText({

text:'hello,world!'

})

//25.延迟⼀部分操作到下⼀个时间⽚再执⾏（类似于setTimeout）

ck(()=>{

a({number:3})//在当前同步流程结束后，下⼀个时间⽚执⾏

})

//26.获取菜单按钮（右上⾓胶囊按钮）的布局位置信息。坐标信息以屏幕左上⾓为原点

uButtonBoundingClientRect()

dowSize()//设置窗⼝⼤⼩，该接⼝仅适⽤于PC平台(已停⽌维护)

owResize((result)=>{

(result)

})

dowResize((res)=>{

(res)

})

30.监听键盘⾼度变化(⼀个值为height)

oardHeightChange((result)=>{

(result)

})

31.取消监听键盘⾼度变化事件

boardHeightChange(callback)

//32.在input、textarea等focus拉起键盘之后，⼿动调⽤此接⼝收起键盘

yboard({

complete:(res)=>{

(res)

},

})

//33.在input、textarea等focus之后，获取输⼊框的光标位置。注意：只有在focus的时候调⽤此接⼝才有效

ectedTextRange({

complete:(res)=>{

(res)

},

})

四、动画

Page({

data:{

animationData:{}

},

onShow:function(){

varanimation=Animation({

duration:3000,//动画持续时间,ms

timingFunction:'linear',//动画的效果linear匀速、ease慢快慢、ease-in慢速开始、

//ease-in-out慢速开始和结束、ease-out慢速结束、step-start动画第⼀帧就跳⾄结束状态直到结束、step-end动画⼀直保持开始状态，最后⼀帧跳到结束状态

delay:500,//动画延迟时间,ms

transformOrigin:"lefttop0"

})

ion=animation

//step()表⽰⼀组动画完成。可以在⼀组动画中调⽤任意多个动画⽅法，⼀组动画中的所有动画会同时开始，⼀组动画完成后才会进⾏下⼀组动画

(2,2).rotate(45).step()

a({

//()导出动画队列。export⽅法每次调⽤后会清掉之前的动画操作

animationData:()

})

},

})

五、数据缓存

rageSync('0','你好，ly！')//同步的(即当存储成功后才会执⾏下⼀步代码)

rage({//异步的(即存储成功的同时也会执⾏下⼀步代码)

data:"您好，wh！",

key:'1',

})

Storage({

key:'0',

success(res){

}

})

StorageSync('1')//

rage({//异步获取指定key的内容

key:'1',

success(res){

()

}

})

rage('1')

rageSync('1')//同步获取指定key的内容

rageInfo()

rageInfoSync()

torage()

torage()

六、⽣命周期

/**

*⽣命周期函数--监听页⾯加载

*/

onLoad:function(){

},

/**

*⽣命周期函数--监听页⾯初次渲染完成

*/

onReady:function(){

},

/**

*⽣命周期函数--监听页⾯显⽰

*/

onShow:function(){

},

/**

*⽣命周期函数--监听页⾯隐藏

*/

onHide:function(){

},

/**

*⽣命周期函数--监听页⾯卸载

*/

onUnload:function(){

},

/**

*页⾯相关事件处理函数--监听⽤户下拉动作

*/

onPullDownRefresh:function(){

},

/**

*页⾯上拉触底事件的处理函数

*/

onReachBottom:function(){

},

/**

*⽤户点击右上⾓分享

*/

onShareAppMessage:function(){

}