鸿蒙加载刷新功能的插件

介绍

这是鸿蒙的一个加载刷新功能的插件,不需要修改源代码的UI结构!它可以用在任意列表或其他组件上面,通过修改自己按属性达到刷新效果,也可以自定义刷新UI

软件架构

无入侵,更丝滑!
通过滑动组件的方式达到刷新加载的效果

安装教程

ohpm install @free/refresh

使用说明

简单例子

    // 实例化
    private refresh: RefreshUtils = new RefreshUtils()

    // 构建UI
    RelativeContainer() {
      // 加载刷新的UI
      refreshView.builder(this.refresh)
      List({ space: 5, scroller: this.refresh.scroller }) {
        LazyForEach(this.refresh.data, (data: Object) => {
          ListItem() {
            this.itemBuilderParam(data)
          }.padding(10).backgroundColor(0xFFFFFF)
        }, (item: RefreshModel, index: number) => index.toString())
      }
      .refresh(this.refresh)

      if (this.refresh.length == 0) {
        normalView.builder(undefined)
      }
    }.height('90%').clip(true)

1、引入工具类

import { PageFace, RefreshUtils } from '../RefreshUtils'

2、创建对象,并设置刷新加载的方法(RefreshModel 泛型可传如自定义model 也可以不传)
刷新加载方法均配置分页能力

  refresh: RefreshUtils<RefreshModel> = new RefreshUtils<RefreshModel>()

  this.refresh.upData = this.upData
  this.refresh.downData = this.downData

  upData(page?: PageFace | undefined): Promise<boolean | Array<RefreshModel>> {
    return new Promise<boolean | Array<RefreshModel>>((res, rej) => {
      setTimeout(() => {
        res([new RefreshModel()])
      }, 2000)
    })
  }

  downData(page?: PageFace | undefined): Promise<boolean | Array<RefreshModel>> {
    return new Promise<boolean | Array<RefreshModel>>((res, rej) => {
      setTimeout(() => {
        res([new RefreshModel])
      }, 2000)
    })
  }

3、添加刷新能力

List()
  .offset({ x: 0, y: this.refresh.offsetY })
  .onTouch((e) => this.refresh.onTouch(e))
  .enabled(this.refresh.state < 4)

4、可以定义一个扩展方法

@Extend(List)
function refresh(refresh: RefreshUtils) {
  .offset({ x: 0, y: refresh.offsetY })
  .onTouch((e) => refresh.onTouch(e))
  .enabled(refresh.state < 4)
}

List()
    .refresh(this.refresh)

5、把刷新加载的UI添加到界面

refreshView.builder(this.refresh)

6、设置默认图

if (this.refresh.length == 0) {
  normalView.builder(undefined)
}

7、直接复制全部代码 根据自己的需求修改配置

import { PageFace, RefreshUtils } from '../RefreshUtils'
import { normalView, refreshView } from './RefreshBuilder'

// List可以为任意组件
@Extend(List)
function refresh(refresh: RefreshUtils) {
  .offset({ x: 0, y: refresh.offsetY }) // 滑动的位置
  .onTouch((e) => refresh.onTouch(e)) // 滑动手势
  .enabled(refresh.state < 4) // 禁止在刷新或加载的过程中继续滑动
}

export class RefreshModel {
  title: string = "RefreshModel"
}

@Component
export struct RefreshComponent {
  refresh: RefreshUtils<RefreshModel> = new RefreshUtils<RefreshModel>()

  @Builder
  itemBuilder(data: RefreshModel) {
    Text(data.title)
  }

  aboutToAppear(): void {
    this.refresh.upData = this.upData
    this.refresh.downData = this.downData
  }

  upData(page?: PageFace | undefined): Promise<boolean | Array<RefreshModel>> {
    return new Promise<boolean | Array<RefreshModel>>((res, rej) => {
      setTimeout(() => {
        res([new RefreshModel()])
      }, 2000)
    })
  }

  downData(page?: PageFace | undefined): Promise<boolean | Array<RefreshModel>> {
    return new Promise<boolean | Array<RefreshModel>>((res, rej) => {
      setTimeout(() => {
        res([new RefreshModel])
      }, 2000)
    })
  }

  build() {
    RelativeContainer() {
      // 加载刷新的UI
      refreshView.builder(this.refresh)
      List({ space: 5, scroller: this.refresh.scroller }) {
        LazyForEach(this.refresh.data, (data: RefreshModel) => {
          ListItem() {
            this.itemBuilder(data)
          }.padding(10).backgroundColor(0xFFFFFF)
        }, (item: RefreshModel, index: number) => index.toString())
      }
      .width('100%')
      .height('100%')
      .backgroundColor(0xEEEEEE)
      .padding({ top: 5 })
      .cachedCount(3)
      .refresh(this.refresh)

      if (this.refresh.length == 0) {
        normalView.builder(undefined)
      }
    }.height('90%').clip(true)
  }
}

参与贡献

  1. Fork 本仓库
  2. 新建 Feat_xxx 分支
  3. 提交代码
  4. 新建 Pull Request
阅读全文
资源下载
下载价格免费
下载说明:
1、本站所有资源均从互联网上收集整理而来,仅供学习交流之用,因此不包含技术服务请大家谅解!
2、本站不提供任何实质性的付费和支付资源,所有需要积分下载的资源均为网站运营赞助费用或者线下劳务费用!
3、本站所有资源仅用于学习及研究使用,您必须在下载后的24小时内删除所下载资源,切勿用于商业用途,否则由此引发的法律纠纷及连带责任本站和发布者概不承担!
4、本站站内提供的所有可下载资源,本站保证未做任何负面改动(不包含修复bug和完善功能等正面优化或二次开发),但本站不保证资源的准确性、安全性和完整性,用户下载后自行斟酌,我们以交流学习为目的,并不是所有的源码都100%无错或无bug!如有链接无法下载、失效或广告,请联系客服处理!
5、本站资源除标明原创外均来自网络整理,版权归原作者或本站特约原创作者所有,如侵犯到您的合法权益,请立即告知本站,本站将及时予与删除并致以最深的歉意!
6、如果您也有好的资源或教程,您可以投稿发布,成功分享后有站币奖励和额外收入!
7、如果您喜欢该资源,请支持官方正版资源,以得到更好的正版服务!
8、请您认真阅读上述内容,注册本站用户或下载本站资源即您同意上述内容!
原文链接:https://www.shuli.cc/?p=21662,转载请注明出处。
0

评论0

显示验证码
没有账号?注册  忘记密码?