更新记录

1.3.7(2021-05-05)

修复ReadMe

1.3.6(2021-05-05)

新增:

  • showLoading
  • showModal
  • showActionSheet
查看更多

平台兼容性

app 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序 快应用
3.1.0 app-vue app-nvue
h5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox pc-Safari

lyz-uni-api-helper

插件信息

repo:https://gitee.com/dark-bb/uni-api-helper

issue:https://gitee.com/dark-bb/uni-api-helper/issues


愿景

uniapp的部分api在使用时不是很方便,如在等待showToast之后进行操作,或者设置全局的showToast配置等,基于此原因,故对部分api进行增强,同时也期待大家参与进来共同完善或者提出好的意见和需求场景,我会持续迭代


使用文档

首先进行导入

import { showToast } from "@/uni_modules/lyz-uni-api-helper";
export default {
  methods: {
    async show() {
      await showToast("lalala1");
      await showToast("lalala2");
      await showToast("lalala3");
      await showToast("lalala4");
    },
  }
};

设置全局默认配置及默认值

可配置项参考https://uniapp.dcloud.io/api/ui/prompt?id=showtoast

import { setToastConfig, setLoadingConfig, setModalConfig, setActionSheetConfig } from 'uni_modules/lyz-uni-api-helper'

// 以下配置值即为默认值

setToastConfig({
    duration: 1500,
    icon: "none",
    mask: true,
})

setLoadingConfig({
    mask: true,
})

setModalConfig({
    title: "提示",
})

setActionSheetConfig({

})

showToast

showToast(msg: string = "", customConfig?: ToastConfig)

支持搭配await使用,可用于在提示消息后进行其他操作的场景,例如界面跳转,如下

async handler(){
    await showToast('登录信息已过期');
    uni.navigateTo({
        // ***
    })
}

亦可嵌套或者异步其他操作

async handler1() {
  await showToast("lalala1");
  console.log(1);
  await showToast("lalala2");
  console.log(2);
  showToast("lalala3");
  console.log(3);
},

showLoading

showLoading(msg: string = "", customConfig?: LoadingConfig)

handler2() {
  // 带消息内容
  showLoading("lalal");
  setTimeout(() => {
    // 不带内容
    showLoading();

    setTimeout(() => {
      uni.hideLoading();
    }, 1000 * 1.5);
  }, 1000 * 2);
},

showModal

showModal(content: string = "", customConfig?: ModalConfig)

主要调整为promise方式的confirm和cancel

async handler3() {
  try {
    await showModal("确定删除吗");
    console.log("确定");
  } catch (error) {
    console.log("取消");
  }
  showModal("还要如何?")
    .then((res) => {
      console.log(`确定了`);
      console.log(res);
    })
    .catch((res) => {
      console.log(`取消了`);
      console.log(res);
    });
},

showActionSheet

showActionSheet(actions: ActionSheet[] = [], customConfig?: ActionSheetConfig)

调整为配套command,省去index判断,更符合开发习惯

handler4() {
  showActionSheet([
    {
      label: "showToast",
      command: this.handler1,
    },
    {
      label: "loading",
      command: this.handler2,
    },
    {
      label: "什么也不做",
      command: (index) => {
        console.log(index);
      },
    },
  ]);
},

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问