ErrorPage

404、500 等异常的统一展示。

最后更新 2026-10-25 19:27:08

说明

只需设置 Code 即可，标题、描述、角标、图标与主题色都会按状态码自动派生。各状态码的默认文案：404「页面走丢了」（角标 Page Not Found，图标 compass）、403「访问被拒绝」（Access Denied，lock）、500「服务器出错了」（Server Error，server）；未识别的状态码回退到通用「出了点问题」（Something Went Wrong，help-circle）。Title / Description / Label 仅在留空时走自动派生，一旦显式赋值即以传入为准。HomeUrl 为返回首页地址。

常见能力：

仅需 Code 即可用，标题 / 描述 / 角标 / 图标 / 主题色自动派生
内置 404 / 403 / 500 默认文案，未知状态码回退通用文案
Title / Description / Label 可逐个覆盖
返回首页 / 返回上一页

用法

@* 只给 Code，其余自动派生 *@
<ErrorPage Code="403" />

@* 需要时再覆盖文案 *@
<ErrorPage Code="404" Description="页面不存在或已被移动" HomeUrl="/" />

API 参数

参数	类型	默认值	说明
`Code`	`string`	`"404"`	错误码，如 404 / 403 / 500。仅需设置本项即可，标题、描述、角标、图标与主题色都会按状态码自动派生；未识别的状态码回退到通用文案。留空的 Title / Description / Label 才走自动派生，一旦显式赋值则以传入为准。
`Description`	`string`	`null`	描述。留空则按 Code 自动派生对应说明。
`HomeUrl`	`string`	`"/"`	首页地址。
`Label`	`string`	`null`	角标文案（留空则按错误码自动给出英文 kicker，如 PAGE NOT FOUND）。
`Title`	`string`	`null`	主标题。留空则按 Code 自动派生（404 页面走丢了 / 403 访问被拒绝 / 500 服务器出错了）。
`Visible`	`bool`	`true`	取得或设置组件是否可见，默认为false。
`VisibleChanged`	`EventCallback<bool>`	—	事件取得或设置组件可见性变化时的回调事件。
`Class`	`string`	`null`	取得或设置组件的CSS类名，用于自定义样式。
`Disabled`	`bool`	`false`	取得或设置组件是否禁用，默认为false。
`Style`	`string`	`null`	取得或设置组件的内联样式，用于自定义样式。

所有组件均继承 BaseComponent，除上表参数外还支持 Class、Style、Disabled、Visible。