uni-app小白入门自学笔记(二)

码文不易啊,转载请带上本文链接呀,感谢感谢 https://www.cnblogs.com/echoyya/p/14429616.html

目录

  • 码文不易啊,转载请带上本文链接呀,感谢感谢 https://www.cnblogs.com/echoyya/p/14429616.html
  • 下拉刷新 onPullDownRefresh
  • 上拉加载 (页面触底加载)
  • 数据缓存 (操作storage)

uni的生命周期

应用生命周期

  • 生命周期的概念:一个对象从创建,运行,销毁的整个过程被称为生命周期

  • 生命周期函数:在生命周期中每个阶段会触发一个函数,这些函数被称为生命周期函数

  • 应用生命周期仅可在 App.vue 中监听,在其它页面监听无效。

uni-app 支持如下应用生命周期函数:

函数名 说明
onLaunch uni-app 初始化完成时触发(全局只触发一次)
onShow uni-app 启动,或从后台进入前台显示
onHide uni-app 从前台进入后台
onError uni-app 报错时触发
    // 只能在App.vue里监听应用的生命周期
    export default {
        onLaunch: function() {
            console.log('App Launch')
        },
        onShow: function() {
            console.log('App Show')
        },
        onHide: function() {
            console.log('App Hide')
          },
        onError: function(err) {
            console.log(err)
        }
    }

页面生命周期

uni-app 常用的页面生命周期函数:

函数名 说明
onLoad 监听页面加载,其参数为上个页面传递的数据,参数类型为 Object(用于页面传参)
onShow 监听页面显示。页面每次出现在屏幕上都触发,包括从下级页面点返回露出当前页面
onReady 监听页面初次渲染完成。注意如果渲染速度快,会在页面进入动画完成前触发
onHide 监听页面隐藏
onUnload 监听页面卸载
    export default {
        onLoad: function(option) {
            console.log('页面加载',option)
        },
        onShow: function() {
            console.log('页面显示')
        },
        onReady: function() {
            console.log('页面初次渲染')
          },
        onHide: function() {
            console.log('页面隐藏')
        }
    }

导航跳转和传参

声明式导航: navigator

该组件类似HTML中的 组件,但只能跳转本地页面。目标页面必须在pages.json中注册。

常用属性:

属性名 说明
url 应用内的跳转链接,值为相对或绝对路径,不需要加 .vue 后缀
open-type 跳转方式 默认值:navigate,而跳转tabbar页面时,需设置为switchTab
  
    
    跳转详情
        
    
    关于我们
  

编程式导航:

uni.navigateTo(obj)

保留当前页面,跳转到应用内的某个页面,使用 uni.navigateBack 可以返回到原页面。

obj必传参数说明: url ,需要跳转的应用内 非 tabBar 的页面的相对或绝对路径,路径后可以带参数,下一个页面的 onLoad函数 可得到传递的参数

跳转到 tabBar 页面只能使用 switchTab 跳转

//在跳转到detail.vue页面并传递参数
uni.navigateTo({
    url: '../detail/detail?id=1&name=Echoyya'
});

uni.redirectTo(obj)

关闭当前页面,跳转到应用内的某个页面。

obj必传参数说明: url ,需要跳转的应用内 非 tabBar 的页面的相对或绝对路径,路径后可以带参数,下一个页面的 onLoad函数 可得到传递的参数

uni.redirectTo({
    url: '../detail/detail?id=1'
});

uni.switchTab(obj)

跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面。

但 如果调用了 uni.preloadPage(OBJECT) 不会关闭,仅触发生命周期 onHide

obj必传参数说明: url ,需要跳转的 tabBar 的页面的相对或绝对路径,(需在 pages.json 的 tabBar 字段定义的页面),路径后不能带参数

pages.json

"tabBar":{
  "color":"#8a8a8a",
  "selectedColor":"#d81e06",
  "list":[
    {
      "text":"首页",
      "pagePath": "pages/index/index",
      "iconPath":"static/tabs/home.png",
      "selectedIconPath":"static/tabs/home-active.png"
    },
    {
      "text":"我们",
      "pagePath": "pages/us/us",
      "iconPath":"static/tabs/us.png",
      "selectedIconPath":"static/tabs/us-active.png"
    }
  ]
}

index.vue

uni.switchTab({
    url: '/pages/us/us'
});

获取参数

导航跳转传参,在目标页面 onLoad 生命周期中,可以接受一个参数options,即为传递的参数

detail.vue

onLoad(options) {
   console.log(options.id)  // 80
}

创建组件,组件通讯

首先在uni-app中,创建组件的方法与Vue中一模一样, 新建组件 -> import引入 -> components中声明 ,相信大家对Vue都比较熟悉,此处不再赘述,主要简述一下组件间的通讯,与Vue中略有不同,

  • 父向子,子向父 同Vue,可参考我之前总结过的一篇博文有非常详细的描述及案例 Vue2.0 多种组件传值方法-不过如此的 Vuex

  • 兄弟组件传值,与Vue略有不同

    uni.$emit(eventName,obj) :触发全局的自定义事件,附加参数都会传给监听器回调函数。

    属性 类型 描述
    eventName String 事件名
    OBJECT Object 触发事件携带的附加参数

    uni.$on(eventName,callback) :监听全局的自定义事件,事件由 uni.$emit 触发,回调函数会接收事件触发函数的传入参数。

    属性 类型 描述
    eventName String 事件名
    callback Function 事件的回调函数

下拉刷新 onPullDownRefresh

开启下拉刷新的两种方式:

  1. 需要在 pages.json 里,找到的当前页面的pages节点,并在 style 选项中开启 enablePullDownRefresh
{
    "pages": [
        {
            "path": "pages/index/index",
            "style": {
                "enablePullDownRefresh": true
            }
        }
    ]
}
  1. uni.startPullDownRefresh(obj) 方法,触发该方法从而实现下拉刷新,效果与用户手动下拉刷新一致。参数可接受回调函数
// 仅做示例,实际开发中延时根据需求来使用。
export default {
    onLoad: function (options) {
        uni.startPullDownRefresh();
    },
}

监听下拉刷新

在 JS 中定义 onPullDownRefresh 处理函数(和onLoad等生命周期函数同级),监听该页面用户下拉刷新事件。

export default {
    onPullDownRefresh() {
        console.log('监听下拉刷新');
    }
}

关闭下拉刷新

处理完数据刷新后, uni.stopPullDownRefresh 可以停止当前页面的下拉刷新。

export default {
    onPullDownRefresh() {
        console.log('监听下拉刷新');
        setTimeout(()=>{
            uni.stopPullDownRefresh()
        }, 1000)
    }
}

上拉加载 (页面触底加载)

监听页面触底

  1. 在 JS 中定义 onReachBottom 处理函数(和onLoad等生命周期函数同级),监听该页面上拉触底事件。常用于触底加载下一页数据
     
      
        {{item}}
      
     
   
   
   
    export default {
      data() {
        return {
          listNum:10
        }
      },
      onReachBottom(){
            console.log('页面触底');
            this.listNum +=5
          }
    }
   
   
   
   .box{
    height: 100px;
    line-height: 100px;
    text-align: center;
   }
   
  1. 需要在 pages.json 里,找到的当前页面的pages节点,并在 style 选项中开启 onReachBottomDistance 。页面上拉触底事件触发时距页面底部距离(Number类型)

    • 也可设置 globalStyle 下的触底距离,若同时设置,page节点下的style会覆盖全局配置
{
  "pages": [
    {
      "path": "pages/index/index",
      "style": {
          "onReachBottomDistance": 200
        }
    }
  ],
  "globalStyle": { // 全局配置
     "navigationBarTextStyle": "white",
     "navigationBarTitleText": "hello-uni-app",
     "navigationBarBackgroundColor": "#8470FF",
     "backgroundColor": "#8DEEEE",
   
     "onReachBottomDistance": 200
   }
}

数据缓存 (操作storage)

同步(推荐)

  • uni.setStorageSync(key,data)

  • uni.getStorageSync(key)

  • uni.removeStorageSync(key)

  
    
    
    
  



  export default {
    methods: {
      setStorageSync() {
        uni.setStorageSync('name', 'Echoyya');
      },
      getStorageSync() {
        console.log(uni.getStorageSync('name'))     
      },
      removeStorageSync() {
        uni.removeStorageSync('name')
      }
    }
  }

异步

  • uni.setStorage(obj) :包括存储的key,data,以及成功失败的回调函数

  • uni.getStorage(obj) :包括存储的key,以及成功失败的回调函数

  • uni.removeStorage(obj) :包括存储的key,以及成功失败的回调函数

  
    
    
    
  



  export default {
    methods: {
      setStorage() {
        uni.setStorage({
          key: 'name',
          data: 'Echoyya',
          success: function() {
            console.log('存储成功');
          }
        })
      },
      getStorage() {
        uni.getStorage({
          key: 'name',
          success: function(res) {
            console.log(res.data);
          }
        })
      },
      removeStorage() {
        uni.removeStorage({
          key: 'name',
          success: function(res) {
            console.log('移除成功');
          }
        })
      },
    }
  }

上传、预览图片

图片操作,常用到以下两个方法:

  • uni.chooseImage(obj) :上传图片,从本地相册选择图片或使用相机拍照。
参数名 类型 说明
count Number 最多可以选择的图片张数,默认9
success Function 必填项,成功则返回图片的本地文件路径列表 tempFilePaths
  • uni.previewImage(obj) :预览图片
参数名 类型 说明
current String/Number 为当前显示图片的链接/索引值,不填或填写的值无效则为 urls 的第一张。有些app版本为必填
urls Array 必填项,需要预览的图片链接列表
  
    
    
    
  



  export default {
    data() {
      return {
        imgArr: []
      }
    },
    methods: {
      chooseImage() {
        uni.chooseImage({
          count: 5,
          success: (res) => {
            this.imgArr = res.tempFilePaths
          }
        })
      },
      previewImage(current) {
        uni.previewImage({
          current,
          urls: this.imgArr
        })
      }
    }
  }