{{wikiTitle}}
前端配置说明
目录:
业务配置
除了 setting.env.js 配置外,还有另外一个配置,即src/setting.js
配置,基本上绝大部分的配置都在这个文件里完成。使用者可根据自己的 UI 习惯来修改不同的配置,从而实现不同的布局效果。
详细的配置介绍如下:
基础配置
- titleSuffix:网页标题的后缀,配置后,每个页面的标题都会带有后缀,比如 “业务配置 - iView Admin Pro”,为空则不显示后缀
- routerMode:路由模式,可选值为 history 或 hash,默认为
history
2.2.0
routerBase:应用的基路径。例如,如果整个单页应用服务在 /app/ 下,然后 routerBase 就应该设为 ‘/app/‘。默认为/
- showProgressBar:页面切换时,是否显示模拟的进度条,默认为
true
- apiBaseURL:统一的接口请求地址,可根据当前环境配置不同的值
- modalDuration:接口请求返回错误时,弹窗的持续时间,单位:秒,默认
3
- errorModalType:接口请求返回错误时,弹窗的类型,可选值为 Message 或 Notice,默认
Message
- cookiesExpires:Cookies 默认保存时间,单位:天,默认
1
多语言配置1.2.0
- i18n:
- default:默认语言,默认为简体中文,值为
zh-CN
- auto:是否根据用户电脑配置自动设置语言(仅第一次有效),默认
false
- default:默认语言,默认为简体中文,值为
布局配置
- menuSideWidth:侧边菜单宽度,单位 px,不可动态修改,如若修改,需同时修改
src/styles/setting.less
文件的 @menuSideWidth 且数值保持一致,默认256
- layout:布局配置,如下:
- siderTheme:侧边栏风格,可选值为 dark 或 light,默认
dark
- headerTheme:顶栏风格,可选值为 light、dark 或 primary,默认
light
- headerStick:顶栏是否置顶,开启后顶栏会覆盖在侧边栏之上,需开启 headerFix,默认
false
,建议在有顶级菜单时使用 - tabs:是否开启多 Tabs 页签,默认
true
- showTabsIcon:多 Tabs 页签是否显示图标,开启 tabs 时有效,默认
true
- tabsFix:是否固定多 Tabs 多页签,开启 tabs 时有效,默认
true
2.2.0
tabsReload:再次点击 Tabs 当前页签时,是否重载当前页面,默认false
- siderFix:是否固定侧边栏,默认
true
- headerFix:是否固定顶栏,默认
true
- headerHide:是否在下滑时隐藏顶栏,需开启 headerFix,如果开启了 tabsFix,Tabs 也会被隐藏,默认
false
- headerMenu:是否显示顶部菜单栏,一般来说,侧边的菜单栏足以满足大部分业务,如需动态切换侧边栏,可开启此选项启用顶部一级菜单,此时侧边栏将作为二级菜单,默认
false
- menuAccordion:侧边菜单栏是否开启手风琴模式,默认
true
- showSiderCollapse:是否显示折叠侧边栏按钮,移动端下会自动强制开启,默认
true
- menuCollapse:侧边菜单栏是否默认折起,默认
false
2.2.0
menuSiderReload:再次点击当前侧边菜单时,是否重载当前页面,默认false
2.2.0
menuHeaderReload:再次点击当前顶部菜单时,是否重载当前页面,默认false
1.2.0
showCollapseMenuTitle:侧边菜单折起时,是否在子菜单前显示父级菜单名称,默认false
1.2.0
showReload:是否显示重载按钮,默认true
- showSearch:是否显示搜索,默认
true
- showNotice:是否显示通知,默认
true
- showFullscreen:是否显示全屏,默认
true
- showMobileLogo:在手机访问时,是否在顶部显示小尺寸 logo,默认
true
- showBreadcrumb:是否显示全局面包屑,开启 headerMenu 时不可用(如若在开启 headerMenu 时显示,可以在页面中的 PageHeader 使用该组件)
- showBreadcrumbIcon:全局面包屑是否显示图标,开启 showBreadcrumb 时有效,默认
false
- showLog:是否显示日志入口,开启与否,不影响日志记录,如不希望用户看到可关闭,默认
true
1.2.0
showI18n:是否显示多语言切换按钮,默认true
- enableSetting:是否支持动态修改布局配置,移动端下会自动强制关闭,此功能主要用于开发阶段实时预览各种布局效果,建议在生产环境关闭,默认
true
- logoutConfirm:退出登录时,是否二次确认,默认
true
- siderTheme:侧边栏风格,可选值为 dark 或 light,默认
多页 Tabs
- page:配置如下:
- opened:默认打开的页签,默认
[]
- opened:默认打开的页签,默认
功能配置
2.1.0
sameRouteForceUpdate:相同路由,不同参数间进行切换,是否强力更新,默认为false
。说明:由于 vue-router 限制,相同路由,不同参数,进行切换时,组件并不是重新加载,而是共享,这会导致切换时,数据状态并没有重置。开启该选项后,在两个相同路由,不同参数间切换时,页面会重载。
说明:使用该功能,该页面在路由配置时,必须设置name
字段。1.3.0
dynamicSiderMenu:是否使用动态侧边菜单,默认为false
。说明:框架默认是在
main.js
中获取本地侧边菜单的,开启该选项,则认为是从服务端动态获取侧边菜单,系统将不再主动获取本地菜单,而相关菜单获取逻辑,需开发者自己完成。详见文档基础功能-添加菜单。
其中,绝大部分布局配置都支持动态配置并实时更新效果。
{{cateWiki.like_num}}人点赞
0人点赞
评论({{cateWiki.comment_num}})
{{commentWhere.order ? '评论从旧到新':'评论从新到旧'}}
{{cateWiki.page_view_num}}人看过该文档
评论(0)
{{commentWhere.order ? '评论从旧到新':'评论从新到旧'}}
342人看过该文档
{{item.user ? item.user.nickname : ''}} (自评)
{{item.content}}
{{item.create_time}} 删除
{{item.like ? item.like.like_num : 0}}
{{replyIndex == index ? '取消回复' : '回复'}}
搜索结果
为您找到{{wikiCount}}条结果
位置:{{path.name}} {{(i+1) == item.catalogue.path_data.length ? '':'/'}}
{{item.page_view_num}}
{{item.like ? item.like.like_num : 0}}
{{item.comment ? item.comment.comment_num : 0}}