微信小程序 API 界面(1)

  界面  有关屏幕的api

  交互:

    wx.showToast()  显示消息提示框  参数:object

      object的属性:

        title:类型  字符串  提示的内容(文本最多7个汉字)

        icon:类型  字符串  图标

          属性值:success:显示成功的图标

              loading:显示加载的图标

              none:不显示图标

        image:类型  字符串  自定义图标的本地路径,image的优先级高于 icon

        duration:类型  数字  提示延迟的时间

        mask:类型  布尔  是否显示透明蒙层,防止触摸穿透

        success:类型  函数  接口成功调用的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(成功,失败,都会执行)

    wx.showModal()  显示模态对话框(他拥有 确定按钮 和 取消按钮)  参数:object  

      object的属性:

        title:类型  字符串  提示的标题

        content:类型  字符串  提示的内容

        showCancel:类型  布尔  是否显示取消按钮

        cancelText:类型  字符串  取消按钮的文字(最多4个字符)

        cancelColor:类型  字符串  取消按钮的文字颜色

        confirmText:类型  字符串  确认按钮的文字(最多4个字符)

        confirmColor:类型  字符串  确认按钮的文字颜色

        success:类型  函数  接口调用成功的回调函数  

          参数对象上拥有:confirm:类型  布尔  表示用户点击了确定按钮

                  cancel:类型  布尔  表示用户点击了取消按钮  

        fail:类型  函数  接口调用失败的回调函数   

        complete:类型  函数  接口调用结束的回调函数(成功,失败,都会执行)

    wx.showLoading()  显示 loading 的提示框,(需要主动调用 wx.hideLoading,才能关闭提示框)  参数:对象

      对象的属性:

        title:类型  字符串  提示的内容

        mask:类型  布尔  是否显示透明蒙层,防止触摸穿透

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

    wx.showActionSheet()  显示操作菜单  参数:对象

      对象的属性

        itemList:类型  数组  按钮的文字的数组,数组长度最大为 6

        itemColor:类型  字符串  按钮文字的颜色

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(接口调用 成功,失败,都会执行)

    wx.hideToast()  隐藏消息提示框  参数:对象

      对象的属性:

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(接口调用 成功,失败,都会执行)

    wx.hideLoading()  隐藏 loading 提示框  参数:对象

      对象的属性:

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(接口调用 成功,失败,都会执行)

  导航栏:(跟 navigator组件结合使用)

    wx.showNavigationBarLoading()  在当前页面显示导航条加载动画  参数:对象

      对象的属性:

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(接口调用 成功,失败,都会执行)

    wx.setNavigationBarTitle()  动态的设置当前页面的标题  参数:对象 

      对象的属性:

        title:类型  字符串  页面标题

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(接口调用 成功,失败,都是执行)

    wx.setNavigationBarColor()  设置页面导航条颜色  参数:对象

      对象的属性:

        frontColor:类型  字符串  前景的颜色值  (必须设置 backgroundColor 属性,这个属性才有效)

        backgroundColor:类型  字符串  背景的颜色值(必须是十六进制的颜色值)

        animation:类型  对象  动画效果

          属性:duration:类型  数字  动画的变化时间,单位ms

             timingFunc:类型  字符串  动画的变化方式

                属性值:linear  动画从头到尾的速度相同

                    easeIn  动画以低速开始

                    easeOut  动画以低俗结束

                    easeInOut  动画以低速开始和低速结束

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(不管 成功,失败,都会执行)

     wx.hideNavigationBarLoading()  在当前页面隐藏导航条加载动画  参数:对象

        对象的属性:

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(不管 成功,失败,都会执行)

  背景:a.json{}里面设置  "enablePullDownRefresh":true  必须设置  不然不会下拉

    wx.setBackgroundTextStyle()  动态的设置背景字体,loading图的样式  参数:对象  (想让这个方法生效,

    要么app.json上设置 "window:{"backgroundColor":"red","navigationBarBackgroundColor": "#f01450"} ,要么使用wx.setBackgroundColor()这个API)

      对象的属性:

        textStyle:类型  字符串  下拉背景字体,loading 图的样式

          属性值:dark  dark 样式

              light  light 样式

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数

    wx.setBackgroundColor()  动态设置窗口的背景色  参数:对象

      对象的属性

        backgroundColor:类型  字符串  窗口的背景色,必须是十六进制的颜色值

        backgroundColorTop:类型  字符串  顶部窗口的背景色,必须为十六进制的颜色值 仅 ios 有效

        backgroundColorBottom:类型  字符串  底部窗口的背景色,必须为十六进制的颜色值  仅ios有效(经过多次测试,没有效果 。。。)

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

  Tab Bar

    wx.showTabBarRedDot()  显示 tabBar 某一项右上角的红点  参数:对象

      对象的属性

        index:类型  数字  tabBar的哪一项,从左往右算起

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

    wx.showTabBar()  显示 tabBar  参数:对象 

      对象的属性

        animation:类型  布尔  是否需要动画效果

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

    wx.setTabBarStyle()  动态设置 tabBar 的整体样式  参数:对象

      对象的属性

        color:类型  字符串  tab上文字的默认颜色

 

        selectedColor:类型  字符串  tab上的文字选中时的颜色

        backgroundColor:类型  tab的背景色

        borderStyle:类型  tabBar上边框的颜色

        success:类型  函数  接口调用成功的函数

        fail:类型  函数  接口调用失败的函数

        complete:类型  函数  接口调用结束的函数(调用 成功,失败,都会执行)

    wx.setTabBarltem()  动态设置 tabBar 某一项内容  参数:对象

      对象的属性

        index:类型  数字  tabBar的哪一项,从左边算起

        text:类型  字符串  tab上的按钮文字

        iconPath:类型  字符串  图片路径,icon 大小限制为40kb,position:top 时,此参数无效

        selectedlconPath:类型  字符串  选中时的图片路径,position:top 时,此参数无效

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

    wx.setTabBarBadge()  为 tabBar 某一项的右上角添加文本  参数:对象

      对象的属性

        index:类型  数字  tabBar的哪一项,从左边算起

        text:类型  字符串  显示的文本,超过4个,则显示成 ...

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

      wx.removeTabBarBadge()  移除 tabBar 某一项右上角的文本  参数:对象

      对象的属性

        index:类型  数字  tabBar的哪一项,从左边算起

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

    wx.hideTabBarRedDot()  隐藏 tabBar 某一项的右上角的红点  参数:对象

      对象的属性

        index:类型  数字  tabBar的哪一项,从左边算起

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数  

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

    wx.hideTabBar()  隐藏 tabBar  参数:对象

      对象的属性

        animation:类型  布尔  是否需要动画效果

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)

  字体

    wx.loadFontFace()  动态的加载网络字体,文件地址需为下载类型,(ios仅支持 https 格式文件地址)  参数:对象

      对象的属性

        family:类型  字符串  定义字体名称

        source:类型  字符串  建议格式为 TTF 和 WOFF,WOFF2 在低版本的 ios 上会不兼容   属性值:'url( " 地址 ")'

        desc:类型  对象  可选的字体描述符

          属性:style:类型  字符串  字体样式

             weight:类型  数字  字体粗细

             variant:类型  字符串  设置小型大写字母的字体显示文本  可选值为 normal / small-caps / inherit

        success:类型  函数  接口调用成功的回调函数

        fail:类型  函数  接口调用失败的回调函数

        complete:类型  函数  接口调用结束的回调函数(调用 成功,失败,都会执行)     

      

posted on 2019-05-30 14:25  Web引领者  阅读(487)  评论(0编辑  收藏  举报