1.0.2 • Published 1 month ago

@tanzhenxing/zx-no-network v1.0.2

Weekly downloads
-
License
ISC
Repository
-
Last release
1 month ago

zx-no-network 无网络提示组件

组件介绍

zx-no-network 是一个适用于 uni-app 的无网络提示组件,支持 H5、小程序、APP(含 Android/iOS)。组件会自动检测网络状态,无需手动配置,断网时自动弹出遮罩提示。

支持平台

  • H5
  • 微信/支付宝/百度/字节/QQ/快手小程序
  • APP(Android/iOS)

属性(Props)

属性名类型默认值说明
tipsString哎呀,网络信号丢失无网络时的提示语
zIndexString/Number1000遮罩层级
imageString无网络图片(可为 src/base64)

事件(Events)

事件名说明
retry用户点击"重试"按钮时触发
connected网络恢复时触发
disconnected网络断开时触发

用法示例

<template>
  <zx-no-network
    :tips="'网络不可用,请检查设置'"
    :zIndex="2000"
    image="/static/no-network.png"
    @retry="onRetry"
    @connected="onConnected"
    @disconnected="onDisconnected"
  />
</template>

<script setup>
function onRetry() {
  // 重新发起网络请求等操作
}
function onConnected() {
  // 网络恢复
}
function onDisconnected() {
  // 网络断开
}
</script>

APP 设置跳转说明

  • 仅 APP 端支持跳转到系统设置页,H5/小程序端无此功能。
  • Android/iOS 跳转均已适配。

注意事项

  • 组件依赖 uni.getNetworkTypeuni.onNetworkStatusChange,请确保 uni-app 版本支持。
  • 建议配合 zx-overlay、zx-icon、zx-button 组件使用。

相关文档