适用工程:sapit-ui-framework(基座/源码)、sapit-ui-plus(发布产物)、sapit-base-template(业务示例)
本文档也是基座内置文档页
/docs与组件页/components的数据源。
| 工程 | 角色 | 说明 |
|---|---|---|
sapit-ui-framework |
基座(源码) | 内置组件与常用依赖的库工程,Vite lib 模式打包 |
sapit-ui-plus |
发布产物 | 基座 dist 推送后的 git 仓库(lib/、docs/、vite-plugins/) |
sapit-base-template |
业务使用者 | 以 sapit-ui-plus git 依赖为底层,编写业务页面/配置 |
sapit-ui-framework --(npm run build)--> dist/lib --(git push)--> sapit-ui-plus(git) --> sapit-base-template
sapit-ui-framework/
├─ packages/ # 发布内容来源(入口依赖图)
│ ├─ index.js # 库入口,导出 registerGlobalConfig
│ ├─ components/ # 内置组件 S*
│ ├─ layouts/ # BasicLayout / BlankLayout / UserLayout / RouteView / PageView
│ ├─ router/ # 常量路由 + 动态路由 + 静态路由 + 守卫
│ ├─ store/ api/ utils/ locales/ static/ style/
│ └─ pages-components/ # 登录、工作台、待办、消息、404/403/500、docs 文档页
├─ docs/ # 本文档(供内置 /docs 渲染)
├─ vite-plugins/ # docs-viewer 插件
├─ src/ # 基座自身调试壳
└─ vite.config.js / package.json
packages/index.js 用 import.meta.glob('./components/**/*.vue') 把 components/**/*.vue 按文件名全局注册,模板直接以文件名标签使用(如 <s-modal>、<s-user-select>)。
| 分类 | 组件 |
|---|---|
| 布局类 | SSkeletonLayout(骨架布局:标题 + 按钮组 + 内容区,见 2.16)、SListLayout、SListCardLayout、SListTableTreeLayout、SSuperListLayout、SFormLayout、SPanelLayout、SCollapses/SCollapsesItem、SDrawer |
| 弹层类 | SModal、SModalTemplate、ModalHeader、SIconModal、SImportModal(批量导入,见 2.11) |
| 表单/筛选 | SForm、SFormItem、SExtendFieldsForm/SExtendFieldsFormItem(动态扩展字段)、SFilterWrap、SFilterItem、SCascader、STree、STreeSelect、SDataRangeTreeSelect(数据权限范围树)、SUserSelect、SUserSelectButton、SChooseUser(带数据权限选人弹窗,见 2.14)、SBelowChoosePosition(选岗位弹窗,见 2.15)、SOfficeSelect、SIconSelect(图标选择) |
| 上传类 | SFileUpload、SDraggerUpload、SCopperUpload、CropperModal |
| 展示/其它 | SEditor、SEmpty、SIcon、SSvg、SAnchor、SColorPicker、SToggleLanguage、SettingFilter、SettingColumns、SSideMenu/STopMenu |
组件用法见内置组件页
/components(含「s组件」「工具/配置」两个标签页;「工具/配置」列出 web-config 全部配置项与$utils全部方法)。注册规则:
components/**/*.vue按文件名全局注册(SForm.vue→<SForm>,不是 kebab-case),冲突后者覆盖。Table/index.jsx是.jsx、import.meta.glob匹配不到,基座在packages/index.js里单独注册为全局STable(<s-table>可直接用,无需 import)。@ant-design/icons-vue图标全部全局注册并挂到$icons。 另有内部辅助组件不对外使用:ModalHeader(SModal)、CropperModal(SCopperUpload)、CustomInput/SettingColumns/SettingFilter(SSuperListLayout)。
| 场景 | 用哪个 |
|---|---|
| 标题 + 按钮 + 自定义内容(无表格/分页/表单) | SSkeletonLayout(见 2.16,自带标题条与权限按钮) |
| 普通列表页 | SListLayout |
| 卡片列表 | SListCardLayout |
| 列表 + 左侧树 | SListTableTreeLayout(左侧树容器类名必须是 .side.s-side-tree,见 3.5) |
| 带高级搜索/高级表格的列表 | SSuperListLayout |
| 新增/编辑/详情(路由式) | SFormLayout(#form 插槽放 SForm,#footer-callback 收 save/cancel/prev/next) |
| 表单作为弹窗内容 | SModal(不要套 SFormLayout) |
| 后端下发字段的动态表单 | SExtendFieldsForm(data + defaultValue,ref 调 validate/clearValidate/getModel) |
| 数据权限范围选择 | SDataRangeTreeSelect(autoSysConfig 托管系统 dataScope 配置) |
$registerGlobalConfig 执行后可用(this.$xxx / 模板 $xxx / window.$xxx):
| 名称 | 说明 |
|---|---|
$registerGlobalConfig(config, pages) |
初始化入口(见 5.2) |
$utils |
工具类集合:$utils.env / $utils.ls / $utils.http 及通用方法 |
env |
合并后的环境配置(= $utils.env) |
$i18n / $l(name, key) |
国际化(见 2.7)。挂在 globalProperties 上:模板里直接用 $l('xx');<script setup> 脚本内必须写 window.$l('xx')(setup 作用域没有 this) |
$theme / $staticRoutes / $pinia |
主题对象 / 静态路由列表 / 用户 store 实例 |
$modal / $message / $notice / $confirm |
antd 的 Modal / message / notification / Modal.confirm(列表组件按钮 api 分支会调 this.$confirm) |
$push(path, query) / $open(...) |
站内跳转 / 新窗口(自动拼 VITE_APP_BASE_URL) |
$filter / $icons / $socket |
日期格式化 / 图标集合 / websocket 封装。$icons 是 @ant-design/icons-vue 全量按 Pascal 名注册的映射(InfoCircleOutlined),同时挂在 window.$icons(供 $utils.iconOf 在非组件上下文取用)。<a-icon type="info-circle"> 这类 antd v1 写法用 $utils.iconOf('info-circle') 换算;SIcon 的 name 只吃 Pascal 名 |
packages/layouts/index.js:BasicLayout(头部+侧边菜单+内容区)、BlankLayout、UserLayout(登录)、RouteView、PageView。
BasicLayout 的高度链路(业务布局组件必须与它对齐,详见第三章):
.basic-layout-common (100vh)
→ .ant-layout
→ .main-content
→ .container (height = mainHeight = clientHeight - headerHeight)
└─ 有页脚时再减 footerHeight(56)
→ router-view (height = contentHeight, overflow: hidden auto)
→ 业务布局组件(.list-layout / .form-layout,flex:1)
mainHeight/contentHeight用真实header.offsetHeight(不是写死 58)计算,避免与实际渲染不一致产生溢出滚动条。
常量路由(packages/router/index.js):
| 路径 | 说明 |
|---|---|
/login/index |
登录页(默认基座,可被业务覆盖,见 5.3) |
/workplace/index |
默认首页(VITE_APP_DEFAULT_PATH,可被覆盖) |
/workbench/index、/message/index |
工作台 / 消息 |
/docs、/components |
内置文档 / 组件页(public 免登录、hidden 不进菜单) |
/404、/403、/500、/:pathMatch(.*)* |
错误页;通配渲染 404(不用 redirect,保证刷新动态路由不掉 404)。四者都挂在 BasicLayout 下,只在内容区 router-view 内切换,侧边菜单与顶栏保持不变 |
静态路由(staticRoutes,不依赖后端菜单):见 5.4。基座内置 /docs、/components。
动态路由(packages/router/generator-routers.js):登录后按后端 menus 生成树,根节点 BasicLayout;叶子节点用 item.hrefs 匹配业务 pages(import.meta.glob('@/views/**/*.vue') 的 key),匹配不到回退 404。注册在守卫中完成(内存标记,刷新重注册)。
守卫:公开页(meta.public)直接放行;实时读 token;未登录跳登录;已登录访问登录页/根跳默认首页;取用户信息失败清理并回登录页(避免 pending)。URL 带 code 时在守卫里换取 token(见 5.8 权限与 6.1)。
packages/store/user.js(useUserStore):state user/menus/permissions/clients/dynamicRouter/menuOpenKeys;actions Info()(拉取并写 localStorage)、setDynamicRouter()、setMenuOpenKeys();localStorage 持久化。
$utils)| 模块 | 说明 |
|---|---|
$utils.env |
环境配置对象 |
$utils.ls |
本地存储(命名空间 VITE_APP_SYS_SERVER_NAME) |
$utils.http |
axios 实例(token/client-id 注入、响应解包、登录超时、文件下载) |
parseAppUrl / innerRedirect 等 |
站内地址拼 base(支持子路径),外部 http(s) 原样 |
messageFormat(str, values) |
{0} / {name} 占位符替换,用于确认弹窗等文案 |
filterSelectOption(iv, opt) |
antd4 版 :filterOption(读 option.label / option.value) |
randomDrawerPlacement() |
随机返回 left / right / top / bottom(源项目交互保留) |
iconOf(type) |
antd v1 <a-icon type="info-circle"> 遗留写法的换算:kebab / snake / Pascal 入参 → 图标组件。用法 <component :is="$utils.iconOf('info-circle')" /> |
hasAction(name) |
按钮级权限函数式判断,与 v-action 同源;用于 v-if 里的「或 / 且」、算 disabled |
| 其它 | 类型判断、日期、数组、url、dom、防抖节流、金额、手机号校验等 |
⚠️ 类型判断 ≠ 格式校验:
$utils.isNumber/isInt/isDate是Object.prototype.toString类型判断($utils.isNumber('123')恒false),不是字符串格式校验。业务侧的正则版同名方法(如isNumber(str)用/^(?:-?\d+|...)/)不可按名字替换过来。同理
$utils.uuid(len)是纯随机串,与「时间戳 + 随机数」型getUUID()产出格式不同,涉后端主键时不可换。
v-action:xxx 按钮级权限指令:<a-button v-action="'add'">添加</a-button>。
$utils.hasAction(actionName),指令与函数只有一套判定逻辑permission(单数,router/index.js 守卫写入的「当前路由按钮数组」)→ 取不到再回退 permissions(复数,store/user.js 写入的全量「路由 → 按钮」map)+ CURRENT_ROUTER_KEYString(button_code) === String(actionName),整体相等(add 不会命中 batchAdd)<a-button v-if="$utils.hasAction('add') || $utils.hasAction('edit')">语言包文件名统一为 i18n.js,放在模块的一级文件夹下,不带任何前缀,结构是扁平字典:
// src/views/user/i18n.js -> 命名空间 user
export default {
'取消': 'Cancel'
}
命名空间取 views/ 或 packages/ 之后的第一段目录名(views/user/i18n.js → user,packages/components/i18n.js → components)。构建期由 import.meta.glob 统一聚合,新增文件、新增目录都不用改任何代码。
页面里不用注册也能翻译:$l('中文') 会自动找该页面所在目录的 i18n.js(路由加载组件时按源文件路径打标 __i18nNs,取不到再用路由 path 首段)。需要强制指定别的命名空间时才显式注册:
export default {
created() {
this.useI18n('user') // Options API,显式指定,优先级最高
}
}
// <script setup>:可显式传,也可不传(不传就按当前目录自动推断)
const { $l } = useI18n() // 自动
const { $l } = useI18n('user') // 显式
$l(name) 查找顺序:当前命名空间(显式注册 > 同目录 i18n > 路由首段)→ components 通用词 → 全局兜底字典(packages/locales/lang/dict.js)→ 原样返回 + console.warn(同一个词只提示一次)。命名空间不存在时 useI18n 也会 console.warn,不阻断渲染。
| 调用位置 | 写法 | 是否带命名空间 |
|---|---|---|
模板 / 组件内 this.$l(...) |
{{ $l('取消') }} |
带,自动按上述优先级解析 |
组件内 const { $l } = useI18n() |
$l('取消') |
带,同上 |
| 组件外 JS(api / utils) | window.$l('取消') |
不带,只查 components + 全局字典 |
排查用:控制台执行 $i18nDebug(),会打印已加载的全部命名空间、当前组件解析到的命名空间及其词条数;$i18nNamespaces 是命名空间全量对象。
中文模式直接返回原文;英文模式查不到译文时原样返回中文并告警。antd 自身语言由 a-config-provider 的 locale 控制。
定义只由基座维护:packages/config/web-config.js 的 VITE_APP_THEME(每套含 color/lightColor/darkColor/borderColor/bgColor);业务只用 VITE_APP_THEME_VALUE 选(blue/green/orange)。业务/config.json 传入的 VITE_APP_THEME 会被忽略。
生效方式:
a-config-provider token(colorPrimary/colorLink)。:root:--s-color、--s-light-color、--s-dark-color、--s-border-color、--s-bg-color;并内置工具类 .s-theme-bg、.s-theme-color、.s-theme-border、.s-theme-border-top、.s-theme-icon-bg。theme-<VITE_APP_THEME_VALUE>(如 theme-blue)。#rrggbb,不含透明度,写入 :root 的 --s-menu-bg、--s-menu-sub-bg、--s-menu-text、--s-menu-text-hover、--s-menu-text-active、--s-menu-hover-bg、--s-menu-active-bg、--s-menu-active-text,同时写入 window.$menuTheme(含 antd Menu token,isLightBg 标记实际明暗)。菜单默认是浅色系:取主题色的色相、饱和度压到 30% 以内、亮度取 93%,blue 主题一级底为 #e8ecf3。四处底色由同一个来源算出,改一个参数整套一起变,不会出现「主底浅了、子菜单和选中还是黑」。
| 配置 | 默认 | 说明 |
|---|---|---|
VITE_APP_MENU_THEME |
dark |
菜单外观模式;dark 下也按实际底色明暗自动切文字色 |
VITE_APP_MENU_BG |
theme |
theme 跟随主题色 / dark 用 antd #001529 / #RRGGBB 自定义 |
VITE_APP_MENU_BG_LIGHTNESS |
93 |
菜单底亮度 0-100:越大越白,越小越深 |
VITE_APP_MENU_BG_SATURATION |
30 |
饱和度上限 0-100:越小越接近灰白 |
VITE_APP_MENU_BG_ACTIVE_MIX |
16 |
选中块里主题色的占比 0-100:越大越蓝 |
// 业务 web-config.js / 部署目录 config.json
VITE_APP_MENU_BG_LIGHTNESS: 88, // 想要更浅就往上调,100 接近纯白
VITE_APP_MENU_BG_SATURATION: 20, // 想要更灰就往下调
底色亮度降到 50 以下会自动切换成「深色底 + 浅色文字」体系,文字与底色的对比度按 WCAG 反解保证 ≥ 4.6,不用手工调文字色。侧边菜单、顶部菜单(
VITE_APP_MENU_BAR: 'top')、logo 明暗、顶栏文字色共用这一套判断。
.my-box {
color: var(--s-color);
background: var(--s-bg-color);
}
新增主题:基座
VITE_APP_THEME加一套,业务VITE_APP_THEME_VALUE选它,antd 与var(--s-*)自动跟随。
packages/api:login.js(登录、getCode、verify、rsaPublicKey、getLoginConfig 等)、common.js、upload.js、workbench.js。packages/pages-components:login.vue、login-common/LoginForm.vue、workbench.vue、todo.vue、message.vue、403/404/500.vue、docs.vue、components-doc.vue。packages/static/*;样式 packages/style/*;antd 图标、axios、dayjs、moment、pinia、vue-router、vue-i18n、jodit、vue-cropper、vuedraggable、html2canvas、crypto-js、jsencrypt、nprogress、qs、lodash.* 等已内置。/login/index:账号密码登录;登录失败达 getLoginConfig 策略(enabled + codeThreshold)时出现图片验证码(/user/verify),verificationCode 原文提交 + verificationCodeId。code 时由守卫调 getCode(code) 换 token → 存 $utils.ls → 去掉 code 整页刷新(与参照项目一致)。VITE_APP_CLIENT_ID 必须等于业务在认证中心的 client;接口网关用 VITE_APP_PORTAL_SERVER_NAME。SSO 静态资源已收编进基座:源在 packages/sso/(sso.js / sso.html),随 npm 包分发(files 加 sso,build 拷 dist/sso)。业务项目不再维护 public/ 下的 sso 文件,只需在 vite.config.js 里:
import ssoPlugin from 'sapit-ui-plus/vite-plugins/sso-plugin.js'
ssoPlugin()
dev 由插件中间件提供(注册在内部中间件前,用包内版本遮蔽 public)。sso.html 换token 读的是同源 localStorage(vue-ls 包装),跨 origin 的平台 sso 不能直接用。
redirect_uri三种处理(sso.js):
- 含
{token}→ 用本地 token 直接替换回跳,不换 code。- 跳回当前应用自身(
client_id= 本应用自己的 client,redirect_uri同源、且无{code}占位符)→ 账密登录场景,本地已有登录态,不调用单点(不校验授权、不换 code),直接回跳。- 第三方跳转(功能模块弹窗跳别的 client / 系统)→ 走完整授权码流程:
authorizationCodeValidate校验 +oauth2/code换码;有{code}就替换,无占位符则自动追加?code=xxx。「当前应用自己的 client」用本应用 base 定位 namespace(
loginHref为锚点)精确读取,不走 key 后缀模糊匹配 —— 同 origin 多应用共用 localStorage 时才不会取到别的应用的clientId。
三步式导入:上传文件 → 数据预览(可编辑/删除行)→ 导入结果(含异常数据导出)。文件限制:.xls/.xlsx、≤ 500KB。
<s-import-modal
ref="importModalRef"
:upload-url="IMPORT_UPLOAD_URL"
:columns="importColumns"
:apis="importApis"
:type-select="importTypeSelect"
@reload="handChange"
/>
<script setup>
importModalRef.value.show() // 打开(内部会重置状态)
const importApis = { templateDownload, importPreview, importData, exportExceptionData }
const importColumns = [{ title: '设备SN码', dataIndex: 'sn', width: 150 }]
// 可选:导入时附带的业务参数下拉,选中值以 extraKey 随各接口一起提交
const importTypeSelect = computed(() => ({
options: [{ label: '摄像头', value: '1' }],
placeholder: '选择设备分类'
}))
</script>
| props | 类型 | 默认值 | 说明 |
|---|---|---|---|
value |
Boolean | false |
显隐(v-model:value) |
title |
String | '批量导入' |
弹窗标题 |
width |
String / Number | 1000 |
弹窗宽度 |
uploadUrl |
String | '' |
上传地址(完整网关地址,如 /monitor/DeviceInfo/Uploader) |
columns |
Array | [] |
预览/结果表格列 [{ title, dataIndex, width }] |
apis |
Object | {} |
四个导入接口(见下) |
typeSelect |
Object | null |
{ options, placeholder, loading },不需要业务参数时不传 |
extraKey |
String | 'deviceTypeId' |
typeSelect 选中值提交时的字段名 |
| events | 说明 |
|---|---|
update:value |
显隐变化(v-model) |
reload |
导入成功/关闭后需要刷新列表 |
| methods(ref 调用) | 说明 |
|---|---|
show() |
打开弹窗并重置状态 |
接口约定(均返回 Promise,组件内部兼容 { code, data } 与直接返回数据两种格式):
| 接口 | 入参 | 返回 |
|---|---|---|
templateDownload |
{ ...extraParams } |
{ url }(组件用 url 触发下载) |
importPreview |
{ fileName, ...extra } |
{ dataRow: [] } |
importData |
{ list, ...extra } |
{ resultType, snum, fnum, failResult: [] } |
exportExceptionData |
{ list, ...extra } |
{ url } |
| 上传(内部) | FormData(file) → uploadUrl |
{ name } / { fileName }(后续接口回传 fileName) |
⚠️
SImportModal是三步式(上传 → 预览编辑 → 结果/异常导出)。 业务项目里如果存在「选文件即导入」的单步式导入组件(如 hy-monitor 的views/people/components/ImportModal.vue、views/basicData/components/ImportModal.vue), 两者在布局、API、事件、调用页契约上都不同,不能当同一个组件替换,仍按各自实现保留。
数据权限(组织/校区/单位)范围选择,内部走 findOfficeList / getOfficeByIds / getSysConfigByCode('dataScope')。
<s-data-range-tree-select v-model:value="ids" :auto-sys-config="true" />
常用 props:value(id 数组) / multiple / treeCheckable / allowClear / placeholder / maxTagCount / disabledGroup('1'组织 '2'校区 '3'单位,可传数组)/ showOnlyOrganization / treeSelectData(传数组则不请求接口)/ isDataScopeFilter / autoSysConfig / defaultValue。
events:update:value、change(均输出 id 数组)。
⚠️ 模板写死了
label-in-value+tree-check-strictly,antd 要求内部value必须是{ label, value }对象数组。 因此回显必须先getOfficeByIds(ids)转成节点对象再赋值,直接赋裸 id 字符串会触发Invalid prop value警告且输入框显示成裸数字 ID。
后端下发字段配置(fillModeConfig 为 JSON 串,含 showType / config),前端按配置渲染。
<s-extend-fields-form ref="extRef" :data="fields" :default-value="values" type="edit" :cols="2" />
<script setup>
// ref 暴露三个方法
extRef.value.validate() // Promise<boolean>
extRef.value.clearValidate()
extRef.value.getModel() // [{ fieldCode, value }](对象值已 JSON.stringify)
</script>
| props | 类型 | 默认值 | 说明 |
|---|---|---|---|
data |
Array | [] |
扩展字段定义(fieldCode/fieldName/fillModeConfig) |
type |
String | 'add' |
add / edit / view(view 不校验) |
defaultValue |
Array | [] |
编辑态回显值 [ { fieldCode, value } ] |
cols |
Number | 2 |
每行列数(非整行字段按 100/cols% 宽) |
labelWidth |
String | auto' |
label 宽度 |
自动占满整行的 showType:textarea、upload、select 且 config.multiple。默认值按 showType 转类型:datePicker → dayjs 对象、number → Number、select 多选 → 逗号切数组。
弹窗式人员选择:左侧组织树 + 右侧人员列表(头像/姓名/工号 + 单位),搜索区内置人员类型过滤(全部/教职工/学生/校外人员),支持单选/多选、滚动分页加载、全选/反选、多选时右侧已选清单。确认后自动关闭弹窗。
与 SUserSelect 的差异(选型依据):
| 对比项 | SUserSelect |
SChooseUser |
|---|---|---|
| 形态 | 只读输入框 + 弹窗一体 | 纯弹窗,显隐由业务控制 |
| 数据权限 | 组织树/列表接口不带数据权限 | 走 levelOneChildrenWithAuth / levelTwoChildrenWithAuth / findUsersWithAuth,按登录人权限过滤 |
| 人员类型 | 无过滤 | 内置教职工/学生/校外人员过滤 |
| 取值契约 | v-model:value 直接绑 id(单选字符串/多选数组) |
v-model:value 控显隐;v-model:selectedIds/selectedId 绑已选 id;@callback 回抛选中对象列表 |
<s-choose-user
v-model:value="userScopeVisible"
v-model:selectedIds="userScopeIds"
:multiple="true"
@callback="userScopeCallback"
/>
<script setup>
// 确认(单选/多选): payload = [{ id, name, cover, userid, company, department }](单选也是单元素数组)
// 取消/关闭: payload = undefined
const userScopeCallback = (payload) => {
if (payload) userNames.value = payload.map((u) => u.name).join(',')
userScopeVisible.value = false
}
</script>
| props | 类型 | 默认值 | 说明 |
|---|---|---|---|
value |
Boolean | false |
弹窗显隐(v-model:value) |
title |
String | '选择人员' |
弹窗标题 |
multiple |
Boolean | false |
多选(右侧出现已选清单) |
searchPlaceholder |
String | '按姓名、工号/学号、手机号搜索' |
搜索框占位 |
required |
Boolean | false |
确认时未选则提示且不关闭 |
selectedIds |
Array | [] |
多选回显 id 数组(v-model:selectedIds),内部 getBUseryIds 拉对象渲染已选 |
selectedId |
String | '' |
单选回显 id(v-model:selectedId),内部 getUserById 拉对象 |
| events | 说明 |
|---|---|
update:value |
关闭弹窗(确认/取消均自动置 false,业务无需手动关) |
update:selectedIds |
已选 id 数组双向绑定 |
update:selectedId |
单选 id |
callback |
确认回抛选中对象数组;关闭时无参 |
⚠️ 接口全部内置在基座
packages/api/common.js(findUsersWithAuth=/user/users/authorized等),业务无需传接口;无后端的预览环境树/列表为空属正常。列表中userid展示的是loginName(工号/学号)。
弹窗式岗位选择(源自业务项目 /components/BelowChoosePosition,已收编进基座):左侧树用 getBelowUnit 一次性拉「根节点及其以下所有单位」的完整树(范围由 rootId 决定),右侧列表查岗位(findJobs),支持单选/多选。
与基座其它选择器的差异:SOfficeSelect/SUserSelect 查组织/人员且左树递归懒加载;本组件查岗位、左树一次性全量。确认后不自动关闭弹窗,业务需在 callback 中手动关闭(与源项目行为一致)。
<s-below-choose-position
v-model:value="visible"
v-model:selectedIds="positionIds"
multiple
:root-id="campusId"
@callback="onCallback"
/>
<script setup>
// 确认(多选): payload = { selectedList: [{ id, name, deptName, nameOrCount }] }
// 确认(单选): payload = { selected: { id, name, ... } }
// 取消/关闭: payload = false
const onCallback = (payload) => {
if (payload && payload.selectedList) {
names.value = payload.selectedList.map((i) => i.name).join(',')
}
visible.value = false // 确认后组件不自动关闭,必须手动关
}
</script>
props 与 SChooseUser 相同(title 默认 '选择岗位'、searchPlaceholder 默认 '按岗位名称、岗位编号搜索'),另有一个专有 prop:
| props | 类型 | 默认值 | 说明 |
|---|---|---|---|
rootId |
String | '' |
左树根节点 id,决定树的数据范围;变化时自动重载左树,未传按 '-1' 查 |
| methods(ref 调用) | 说明 |
|---|---|
initLeftTreeData(id) |
手动重载左侧组织树 |
| events | 说明 |
|---|---|
update:value |
仅取消时置 false;确认不关窗,业务手动关 |
update:selectedIds |
已选岗位 id 数组双向绑定(回显走 getPositionByIds) |
update:selectedId |
单选 id(回显走 getPositionById) |
callback |
确认回抛 { selectedList } / { selected } 对象;关闭回抛 false |
⚠️
callback载荷形态与SChooseUser不同(对象{ selectedList }vs 数组),且确认后关窗行为相反,两个组件的 callback 写法不可混用。
2026-10-28 新增。用于页面级「标题条 + 操作按钮 + 内容区」的骨架外观,与
SListLayout/SFormLayout同级但更轻:不带表格、不带表单、不带分页,内容区完全由插槽决定。
<s-skeleton-layout
:title="$l('采集任务')"
:buttons="[
{ key: 'add', name: '新增', icon: true },
{ key: 'remove', name: '删除', disabled: true },
{ key: 'export', name: '导出', icon: 'DownloadOutlined' }
]"
bg-color="#fff"
@btnCallback="onBtnClick"
>
<div class="my-content">...</div>
<template #otherBtns><a-button>自定义</a-button></template>
<template #other>底部内容</template>
</s-skeleton-layout>
| props | 类型 | 默认 | 说明 |
|---|---|---|---|
title |
String | — | 必填,标题条文本 |
buttons |
Array | [] |
按钮配置数组,见下表 |
bgColor |
String | '' |
根节点背景色 |
buttons 每项字段:
| 字段 | 类型 | 说明 |
|---|---|---|
key |
String | 唯一键,点击时回抛该值;'add' 时按钮自动为 primary |
name |
String | 按钮文案(内部走 $l,可直接写源中文) |
icon |
String | Boolean | 字符串 = 图标组件名(如 'PlusOutlined');true = 按 key 查内置 iconMap;缺省不出图标 |
action |
String | v-action 权限码,缺省用 key(会真正做权限过滤,无权限时按钮被移除) |
show |
Boolean | 默认 true;false 时 v-show 隐藏(仍占位、仍注册权限) |
disabled |
Boolean | 置灰 |
type |
String | 覆盖 a-button 的 type |
| slots | 说明 |
|---|---|
| 默认 | 内容区(.skeleton-layout-main) |
otherBtns |
按钮组右侧追加内容 |
other |
底部区域 |
| events | 说明 |
|---|---|
btnCallback |
回抛被点击按钮的 key |
| methods(ref 调用) | 说明 |
|---|---|
| — | 无。高度由 flex 自动分配,不需要业务调任何方法(见下) |
内置 iconMap 的 key:add / edit / delete / remove / import / export / assign / execute / pause / resume / approve / setting / TopOfType / TOP / synchronize。
高度实现(2026-10-28 修订):根节点
height:100%; display:flex; flex-direction:column,标题条flex:0 0 60px,内容区flex:1 1 auto; min-height:0; overflow:hidden auto,底部槽flex:0 0 auto。零 JS、零 resize 监听,窗口缩放 / 侧栏折叠自动跟随。前提:父容器要有确定高度。基座
BasicLayout的router-view已带:style="{ height: contentHeight + 'px' }",会透传到页面根组件,通常无需额外处理;若页面外层是自己写的height:auto容器,需给该容器一个确定高度。旧版本的
initLayoutHeight()方法已移除,layoutHeight也不再暴露(原实现是parentNode.offsetHeight - 76且只在mounted算一次)。
本章是基座内部布局组件的强制约定。业务页面只管用 layout,不要自己写高度;如果要新增布局组件,必须先满足本章规则。
2026-10-28 修订:旧标题「禁止 JS 减法算高度」已作废。业务内容区需要出滚动条时,高度就该动态计算,只是必须按下面的约束写,不能每页抄魔数。
错误做法(早期 SListLayout / SFormLayout 都犯过):
// ❌ 用 offsetHeight 减法算子区域高度
this.layoutHeight = this.$refs.layout.offsetHeight - toolsH - footerH - tabsH - 16
为什么必错:offsetHeight 读的是当前渲染结果,而这个结果又取决于你即将写入的 height —— 循环依赖。表现是:
tpH = 103)其它页面全歪。首选做法(零 JS):父容器 height:100% + display:flex; flex-direction:column,主体区 flex:1 1 auto; min-height:0; overflow:auto,底部条 flex:0 0 auto。列表页、表单页绝大多数场景用这个就够。
需要 JS 动态计算的情形(内容区要出滚动条、容器高度随窗口或兄弟节点变化):允许并推荐动态计算,但必须满足三条:
calcXxxHeight(),不要每页一份魔数ResizeObserver 观察父容器重算,别只监听 window.resize$parent.$el:父级 DOM 结构一变就错,用 ref 取自己的容器仍然禁止的错法:拿「自己即将写入 height 的那个祖先」的 offsetHeight 做减法 —— 循环依赖。要读就读不依赖自身高度的量(window.innerHeight、上级固定头/脚节点的高度)。
STable 的 body 要靠 flex 拿到剩余高度,链路上任何一层漏掉都会导致撑不开:
.table-content {
flex: 1;
display: flex;
flex-direction: column;
min-height: 0;
}
.tabs-wrap {
flex: 0 0 auto;
}
.table-container {
flex: 1 1 auto;
min-height: 0;
display: flex;
flex-direction: column;
}
.table-wrapper {
flex: 1 1 auto;
...;
} /* STable 组件根节点,漏它整条链断 */
.ant-table-wrapper {
flex: 1 1 auto;
...;
}
.ant-spin-nested-loading .ant-spin-container .ant-table .ant-table-container {
margin-left: 10px;
} /* 表格缩进走 margin,不走 padding */
.ant-table-header {
flex: 0 0 auto;
}
.ant-table-body {
flex: 1 1 auto;
min-height: 0;
max-height: none !important;
}
.ant-table-pagination {
margin-bottom: 0;
flex: 0 0 auto;
} /* 差一个 margin 就是 15~16px 空隙 */
要点:
.table-wrapper 不能漏 —— 它是 STable 组件根节点,实测漏掉它 body 就撑不开;scroll.y 写入的 max-height 必须 none !important 覆盖掉,否则和 flex 打架;margin-bottom: 0,否则分页与容器底边恒差一个 margin;:deep(.ant-table-container){margin-left:10px},不要用 padding-left(会挤压 body 宽度计算)。.tools 头部条统一 60px所有布局的 .tools(标题 + 按钮条)统一:
.tools {
height: 60px;
display: flex;
justify-content: space-between;
align-items: center;
padding: 0 16px;
box-sizing: border-box;
border-bottom: 1px solid #f0f2f5;
}
.list-filter-wrap {
padding: 10px 16px;
box-sizing: border-box;
}
⚠️ 若某天调整了
.tools高度,所有布局里initTable()的减数(如- 76)必须同步改,否则全站列表页一起歪。
.form-layout 用同一套 flex 撑满,initStyle() 里只算 footer 宽度(collapses + anchor 场景要避开右侧锚点),不再算高度:
.form-layout {
height: 100%;
overflow: hidden;
:deep(.ant-spin-nested-loading),
:deep(.ant-spin-container) {
/* a-spin 包裹层必须逐层撑满,否则 form-layout 高度取不到 */
height: 100%;
display: flex;
flex-direction: column;
min-height: 0;
}
}
.tools,
.step-wrap,
.tabs-wrap,
.modal,
.form-fixed-footer {
flex: 0 0 auto;
}
.form-layout-main {
flex: 1 1 auto;
min-height: 0;
overflow: hidden auto;
}
.form-fixed-footer {
height: 60px;
}
.s-side-tree)SListLayout / SListTableTreeLayout / SListCardLayout 的 .side 都带 padding: 10px 0,树容器高度必须等于「.side 盒高 − 上下 padding」,否则双滚动条或树被截断。
规则写在全局 packages/style/common.less 的 .s-side-tree(.side 的唯一化追加类,避免通用名被业务覆盖),业务页面 scoped 里禁止再写副本。覆盖两种树来源:
<s-tree>:根节点即 .s-tree-common,height:100%;<a-spin><a-tree>:逐层撑高 .ant-spin-container → .ant-tree → .ant-tree-list → .ant-tree-list-holder,由 .ant-tree-list-holder 承担 overflow-y:auto。⚠️ ② 的分支必须用
>从.s-side-tree直接起算,不能写成后代选择器 ——STree内部同样是.ant-tree,后代写法会误伤 ①。
STree 的 height prop 默认值必须是 undefined(不能写死 300):
height: { type: Number, default: undefined }
原因:antd 的 Tree 会把 height 转成虚拟列表 holder 的行内 max-height:300px,导致树被截断且自身产生内层滚动条。
横向文字不换行、超出省略、宽度随父容器拉伸:
.s-tree-common {
height: 100%;
width: 100%;
overflow-x: hidden;
overflow-y: auto;
}
:deep(.ant-tree),
:deep(.ant-tree-list),
:deep(.ant-tree-list-holder),
:deep(.ant-tree-list-holder-inner) {
width: 100%;
min-width: 0;
}
:deep(.ant-tree-node-content-wrapper) {
min-width: 0;
overflow: hidden;
}
:deep(.ant-tree-title),
.node-title {
display: block;
width: 100%;
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
页面渲染/高度问题必须用 puppeteer 登录后量真实 offsetHeight/offsetLeft/盒模型,禁止静态读代码猜根因。
// 量:容器高、主体高、底部条位置差、文档溢出
const r = await page.evaluate(() => {
const q = (s) => document.querySelector(s)
const box = (s) => {
const el = q(s)
if (!el) return null
const b = el.getBoundingClientRect()
return { h: el.offsetHeight, top: Math.round(b.top), bottom: Math.round(b.bottom) }
}
return {
container: box('.list-layout-main'),
tableContent: box('.table-content'),
pagination: box('.ant-table-pagination'),
docOverflowY: document.documentElement.scrollHeight - document.documentElement.clientHeight
}
})
验收标准(全部为 0 才算过):
| 指标 | 通过条件 |
|---|---|
documentOverflowY |
0(页面不出现滚动条) |
pagination.bottom 减容器底 |
0(分页刚好卡在视口底部) |
| 表格主体溢出容器 | 0 |
多视口抽查(建议 1920×1080 / 1600×900 / 1440×900 / 1366×768 / 1280×720 / 2560×1440)全过才算改完。
npm run dev # 基座本地开发
npm run build # lib 构建 + 复制 docs/vite-plugins/package.json 到 dist + git push
npm run lint
基座构建 不 drop console(
$utils/i18n 调试输出由运行时VITE_CONFIG_sapit-base-template控制);业务构建才 drop。
产物:入口 ./packages/index.js,vue external,输出 dist/lib,打包内容为入口依赖图(不是整个项目);package.json 的 files: ["lib","docs","vite-plugins"]。
基座默认 defaultEnv < 业务 web-config.js < .env.[sapit-base-template](构建时写入 config.json) < 部署 config.json(运行时覆盖)
web-config.js:可写默认值或 import.meta.env.VITE_APP_*;.env / .env.[sapit-base-template]:各环境一套(dev/test/uat/prod),由业务 vite.config.js 写入 config.json;config.json:站点根(子路径为 <base>config.json),启动时 loadRemoteConfig() 拉取并覆盖,部署后可直接改、无需重打包;.env 值为字符串,基座会把 "true"/"false" 归一为布尔。常用开关(业务可按需覆盖;判断统一用 !== false,即未配置时取基座默认值):
| 配置项 | 默认值 | 说明 |
|---|---|---|
VITE_APP_FOOTER_VISIBLE |
false |
是否显示页脚 |
VITE_APP_MESSAGE_VISIBLE |
true |
是否显示右上角消息铃铛(设 false 隐藏) |
VITE_APP_SOCKET_URL |
ws://127.0.0.1:8080/websocket |
消息推送 socket 地址;为空或 / 时走同源;本地占位地址在非本机环境下自动跳过 |
VITE_APP_SOCKET_PATH |
/apig/ws/websocket |
socket.io 握手路径,需与后端一致 |
VITE_APP_LANG_ENABLE |
false |
是否启用国际化 |
VITE_APP_MENU_BAR |
left |
菜单布局:left / top |
VITE_APP_MENU_THEME |
dark |
菜单主题:dark / light |
VITE_APP_MENU_BG |
theme |
菜单底色:theme 跟随主题色 / dark 用 #001529 / #RRGGBB 自定义 |
VITE_APP_MENU_BG_LIGHTNESS |
93 |
菜单底亮度 0-100:越大越白 |
VITE_APP_MENU_BG_SATURATION |
30 |
菜单配色饱和度上限 0-100 |
VITE_APP_MENU_BG_ACTIVE_MIX |
16 |
选中块里主题色的占比 0-100 |
右上角消息铃铛的数量逻辑:进入系统先调 message/center/counts 取 totalCount,之后由 socket 推送的 wsEvent 触发重新拉取。socket 连接为单例(packages/utils/message-socket.js),连上后 emit('sendUserId', userId),后端按用户推送。业务侧无需额外注册,只要 VITE_APP_SOCKET_URL / VITE_APP_SOCKET_PATH 配到消息服务即可。
npm start)业务项目(sapit-base-template)的 npm start 执行内置脚本 refresh-sapit-base-template.ps1:
node_modules/.vite、node_modules/sapit-ui-plus 及锁文件(package-lock.json/yarn.lock/pnpm-lock.yaml/node_modules/.package-lock.json);npm install 拉取 sapit-ui-plus 最新发布版本;npm run dev 启动。作用:清理依赖缓存,更新业务依赖并一键启动。也可双击
refresh-sapit-base-template.cmd;-NoStart仅更新不启动。 这个命令通常在基座项目有更新时才会用到。
{ "dependencies": { "sapit-ui-plus": "git+http://192.168.200.4:6110/sapit/sapit-ui-plus.git" } }
main.jsimport { createApp } from 'vue'
import App from './App.vue'
import config from './config/web-config'
import appConfig from './config/app-config'
import SapitUiPlus from 'sapit-ui-plus'
import 'sapit-ui-plus/lib/css/style.css'
async function init() {
const pages = import.meta.glob('@/views/**/*.vue')
const app = createApp(App)
app.use(SapitUiPlus)
await app.config.globalProperties.$registerGlobalConfig({ ...config, ...appConfig }, pages)
app.mount('#app')
}
init()
config:环境配置(web-config);appConfig:构建期配置(登录/首页覆盖、静态路由、语言包),不进入 config.json;pages:业务所有页面,用于动态路由按 hrefs 匹配。app-config.js:
export default {
components: {
login: () => import('@/views/login/index.vue'),
home: () => import('@/views/home/index.vue')
}
}
不配置则用基座默认(pages-components/login.vue、todo.vue)。
staticRoutesexport default {
staticRoutes: [
{
path: '/help',
name: 'Help',
component: () => import('@/views/help/index.vue'),
meta: { title: '帮助' } // hidden: 不进菜单;public: 免登录
}
]
}
layout: false / raw: true 时不包 BasicLayout;同 path 时业务覆盖基座内置。
后端菜单 hrefs 需匹配业务 views 路径(或组件名);页面放 src/views/** 即可被动态路由识别。侧边菜单渲染「动态菜单 + staticRoutes」,基座常量菜单不进菜单。
views/<模块>/i18n.js(扁平 { '中文': 'English' }),页面不用写 useI18n,$l('中文') 自动按页面所在目录命中;要跨目录强制指定时再 this.useI18n('<模块>')。业务自己的 i18n.js 在业务 main.js 里 glob 一次传给 $registerGlobalConfig({ locales }),即与基座合并(同名业务优先)。VITE_APP_THEME_VALUE;样式用 var(--s-*) 或 .s-theme-*。/monitor/).env:VITE_APP_BASE_URL=/monitor/;vite.config.js:base: getViteEnv(res.sapit-base-template, 'VITE_APP_BASE_URL') || '/';$push/$open、redirectLogin、parseAppUrl 均读该值自动带前缀;location /monitor/ {
alias /home/project/tmp/dist/;
index index.html;
try_files $uri $uri/ /monitor/index.html;
}
location = /monitor/config.json {
alias /home/project/tmp/dist/config.json;
add_header Cache-Control "no-store";
}
createWebHistorybase、Vitebase、window.location跳转三者必须都是/monitor/(带尾斜杠)。
<template>
<s-list-layout :columns="columns" :loadData="page" title="示例" />
<s-user-select v-sapit-base-templatel:value="ids" />
<a-button v-action="'add'">添加</a-button>
</template>
后端下发 permissions 后基座写入 permission,用 v-action:xxx 控制按钮级权限。文档访问:<业务base>/docs、<业务base>/components。
sapit-ui-plus 的 dependencies 会随基座一起装进业务 node_modules,业务无需再装即可直接 import(业务 package.json 里通常只见 sapit-ui-plus 一项)。
| 依赖 | 版本 | 用途 |
|---|---|---|
dayjs |
^1.11.12 | 日期格式化(推荐,$utils 内也用) |
axios |
^1.7.3 | 请求(已封装为 window.$utils.http,一般不用直接用) |
qs |
^6.13.0 | 参数序列化(stringify) |
lodash.get / lodash.clonedeep |
^4.4.2 / ^4.5.0 | 安全取值 / 深拷贝 |
crypto-js |
^4.2.0 | 加解密 |
js-base64 |
^3.7.2 | Base64 编解码 |
jsencrypt |
^3.3.2 | RSA 加密 |
moment |
^2.30.1 | 日期(老代码兼容,新代码用 dayjs) |
html2canvas |
^1.4.1 | 页面截图 |
nprogress |
^0.2.0 | 顶部加载进度条 |
@vueuse/core |
^11.0.3 | 组合式工具函数 |
vue-cropper |
^1.1.4 | 图片裁剪(SCopperUpload 用它) |
vuedraggable |
^4.1.0 | 拖拽排序 |
v-clipboard |
^3.0.0-next.1 | 复制到剪贴板(v-clipboard 指令) |
vue-ls |
^4.2.0 | localStorage 封装(已包成 $utils.ls) |
jodit |
3.24.7 | 富文本编辑器(SEditor) |
less / less-loader |
^4.2.0 / ^12.2.0 | 样式编译 |
vite-plugin-html / vite-plugin-generate-file |
^3.2.2 / ^0.2.0 | 构建插件(生成 config.json 等) |
@ant-design/icons-vue |
随 ant-design-vue | 图标,全部已全局注册为组件 |
单例依赖:基座不做打包,业务必须自己安装(vite.config.js 的 external),否则会出现两个模块实例(路由注入不上、pinia 对不上、主题/消息上下文丢失):
| 依赖 | 版本 |
|---|---|
vue |
^3.4.29 |
vue-router |
^4.3.3 |
pinia |
^2.1.7 |
vue-i18n |
^9.14.0 |
ant-design-vue |
4.x |
用法:
import dayjs from 'dayjs'直接可用;但不要在业务里再装一份与基座不同大版本的vue/ant-design-vue/pinia,版本以基座为准。
| 名称 | 说明 |
|---|---|
$utils |
工具类:$utils.http(请求)、$utils.ls(本地存储)、$utils.env(配置)等 |
$message / $modal / $notice |
ant-design-vue 的 message / Modal / notification |
$push / $open |
站内跳转 / 新窗口打开(自动拼接部署 base) |
$l |
国际化取词($l('中文')) |
$theme |
当前主题变量;CSS 变量 --s-color 等 |
$icons |
全部 antd 图标组件 |
$socket / $filter / $pinia / $i18n |
websocket / 过滤器 / 用户 store / i18n 实例 |
env |
同 $utils.env |
$staticRoutes |
静态页面路由(含业务自定义) |
npm run build 推送且业务重装依赖才生效;基座 dev 立即生效。package-lock.json、yarn.lock、node_modules/.package-lock.json。VITE_APP_BASE_URL 与 Vite base 保持一致且带尾斜杠。SForm.vue → <SForm>,不是 kebab-case);冲突后者覆盖。lib/js/index.js 一个入口,内部模块被 rollup 打进 chunk。想让业务用某能力,必须挂全局属性($utils / $modal 那样)。vite build:会报 Rollup failed to resolve import "sapit-ui-plus",是缓存冲突的假报错,串行重跑即恢复。若串行仍报错,检查 node_modules/sapit-ui-plus 是否被清空(npm 重装常清掉)——恢复方式: # 基座 dist 就是 npm 包内容(build 脚本把 package.json + docs + vite-plugins 拷进 dist)
cp -r <基座>/dist/lib <基座>/dist/docs <基座>/dist/vite-plugins <基座>/dist/package.json <业务>/node_modules/sapit-ui-plus/
cp -r <基座>/packages/sso <基座>/packages/static <业务>/node_modules/sapit-ui-plus/
vite build --emptyOutDir false:清空 dist 会被批量删除守卫拦截;只验证编译时用这个参数,不要为了验证去执行会 git push 内网仓库的 npm run build(对外发布动作,须先确认)。vite build 不检查未定义变量:模板/脚本里引用不存在的变量照样通过。改完大段代码必须 git diff 复核增删行,配合未使用 import 扫描发现误删。npm 国内网络:registry.npmjs.org 基本不通,装 sapit-ui-plus 会卡在大包上(最重的是 ant-design-vue 解压 78MB、jodit 23MB)。装包指定国内源:
npm i git+http://192.168.200.4:6110/sapit/sapit-ui-plus.git --registry=https://registry.npmmirror.com
若 npm 进程内的 git ls-remote 返回 403(沙箱/网络拦截,手工 git ls-remote 却通),只能临时摘掉该 git 依赖装其余包,再按第 8 条从基座本地 dist 恢复。
static/:lib 构建不重写 new URL('../../static/...', import.meta.url),运行时从 lib/js/*.js 解析到包根 static/。缺它业务 dev 登录页图片全 404,而基座自身 dev 正常、生产正常,极具迷惑性。build.lib 强制内联所有资产 → 产物可能出现 MB 级 base64 data URI(超 Chrome URL 上限)。vite-plugins/sso-plugin 的 closeBundle 会把 >100KB 的 data URI 抽为 lib/img/ 真实文件;源码资产引用一律改 import。value(字典值),绝不用 id(主键)。字典调mapByDictTypes('a','b') 一次性取多个,按下划线转驼峰取返回值(recycle_status → res.recycleStatus),项为 {label, value, id}。a-select 的 placeholder 只在值为 undefined/null 时显示,空字符串 '' 会被视为已有值。所有下拉类字段(搜索参数、表单字段)初始值一律 undefined,禁用 ''(多选绑定 [] 正常)。dayjs(x).valueOf()),不是 unix 秒。依据:源码 DateRange 的 onChange 输出 date.map(o => dayjs(o).valueOf()),useFormValues.fieldMapToTime 默认 format='' 原样透传。catch(错误由全局拦截器统一提示)。但三类 catch 必须保留:① 表单校验链 .catch(() => {});② try { await validate() } catch { return };③ JSON.parse 解析容错。/403、404 → /404,在内容区 router-view 内切换(保留侧边菜单与顶栏,不整页顶掉外壳),且不再叠加通知。跳转 URL 带 ?api=<接口地址>&status=<原始状态码>,错误页据此切换成接口口径文案(403「接口无权限」、301「接口地址已变更」、404「接口不存在」)并显示接口地址;不带 ?api= 时仍是页面口径(页面无权限 / 页面不存在)。5xx 不跳错误页,仍走原来的通知提示(/500 页面保留,可直接访问)。后台轮询等非主流程请求若要保住当前页面,可传 { skipErrorPage: true } 跳过跳转:this.$utils.http.post('/api/msg/count', {}, { skipErrorPage: true })
| 调用 | 作用 |
|---|---|
$l('中文'[, key]) |
国际化 |
$push(path, query) / $open(path, query) |
跳转 / 新窗口(自动拼 base) |
$message.* / $modal.* / $notice.* / $confirm(...) |
轻提示 / 弹窗 / 通知 / 确认框 |
this.$utils.ls.get/set/clear |
本地存储 |
this.$utils.http(config) |
发起请求(默认 POST) |
$filter.dateFormat(v, fmt) |
日期格式化 |
v-action:code |
按钮级权限(按 button_code 全等匹配) |
$utils.hasAction(code) |
按钮级权限(函数式,可做「或 / 且」) |
$utils.iconOf('info-circle') |
antd v1 type 写法换图标组件 |
$utils.messageFormat(str, values) |
{0} / {name} 占位符替换 |
$utils.filterSelectOption(iv, opt) |
antd4 版下拉过滤 |
$utils.randomDrawerPlacement() |
随机抽屉方向 |
var(--s-color) / .s-theme-color |
主题色(CSS 变量 / 工具类) |
| 地址 | 内容 |
|---|---|
<base>/docs |
说明文档(本文) |
<base>/components |
s组件(基座内置组件:左菜单 + 预览 + 源码) |