error-凯发app官方网站

更新时间：2023-11-30 19:03:57

贡献者

订阅更新

我的文档

设置

简介

用以提供常见类型的业务异常展示视图。

使用场景

●

界面的视图界面依赖网络接口返回数据，当业务服务器

触发限流或发生异常

时，可展示

统一异常页

，避免白屏等现象，提升用户体验。

●

业务预期内的异常状态，如该用户无订单记录，无社保记录等

空状态

。

●

业务非预期内的一些逻辑执行失败，可跳转到统一异常页。

使用限制

●

版本要求基础库

2.7.0

及以上，若版本较低，建议做

兼容处理

。

●

native 渲染引擎

：暂不支持。可以通过

my.caniuse('error-view')

判断是否支持。

使用

示例代码

定制文案

可以通过

title

字段和

message

定制默认文案。

<error-view fullscreen type="default" title="主要文案" message="次要文案">

error-view>

定制按钮行为

可以通过在 error-view 内嵌入组件的方式，定制默认行为：

●

可以直接使用

button

组件，通过绑定 tap 自定义事件的方式，自定义操作行为。

●

如果希望自主触发返回（navigateback） / 刷新（reload）行为，可以使用

navigator

导航组件来完成。

自定义异常详细信息

当发生特定业务异常时，可以传递

data-

字段信息。

属性说明

属性	类型	描述
fullscreen	boolean	是否展示全屏错误视图，状态图案及文案大小会有差异。
type	string	异常类型。可选值：default、busy、error、network、trade 默认值：default
title	string	异常状态主要文案，详情可查看默认界面及文案。
message	string	异常状态次要文案，仅在全屏状态显示，详情可查看全屏状态。
title-color	hexcolor	异常状态主要文案的自定义颜色。
message-color	hexcolor	异常状态次要文案的自定义颜色。