Skip to content

NoNetwork 无网络提示

监听设备网络状态,在断网时显示友好的提示信息,支持手动重试和自动重试。

平台兼容性

App(vue)App(nvue)H5小程序

代码示例

基础用法

通过 v-model:show 控制显示与隐藏,设置 autoCheckfalse 关闭自动监听。

html
<see-no-network v-model:show="show" :auto-check="false" />

自定义文案

通过 textretryText 自定义提示文案和重试按钮文案。

html
<see-no-network
  v-model:show="show"
  text="哎呀,网络开小差了~"
  retry-text="点击重试"
  :auto-check="false"
/>

全屏模式

设置 isFullscreentrue,组件将以全屏遮罩形式展示。

html
<see-no-network v-model:show="show" is-fullscreen :auto-check="false" />

重试事件

监听 onRetry 事件,在用户点击重试按钮时执行自定义逻辑。

html
<see-no-network v-model:show="show" :auto-check="false" @on-retry="handleRetry" />

自动监听网络状态

autoCheck 默认为 true,组件会自动监听网络变化。断网时自动显示,恢复时自动隐藏。

html
<see-no-network v-model:show="show" />

自动重试

设置 retryInterval(毫秒),组件会在断网期间自动触发网络检测。

html
<see-no-network v-model:show="show" :retry-interval="5000" />

API

Props

参数说明类型默认值可选值
show是否显示(v-model)booleanfalsetrue / false
text提示文案string'网络异常,请检查网络连接'-
retryText重试按钮文案string'重新连接'-
isFullscreen是否全屏显示booleanfalsetrue / false
icon图标名称string'📡'-
autoCheck是否自动监听网络状态booleantruetrue / false
retryInterval自动重试间隔(毫秒),0 表示不自动重试number0-

Events

事件名说明回调参数
onRetry点击重试按钮时触发-
onNetworkChange网络状态变化时触发online: boolean
update:show显示状态变化时触发(v-model)value: boolean

辽 ICP 备 2025070134 号