var z = Object.defineProperty, W = Object.defineProperties;
var q = Object.getOwnPropertyDescriptors;
var F = Object.getOwnPropertySymbols;
var J = Object.prototype.hasOwnProperty, Y = Object.prototype.propertyIsEnumerable;
var V = (e, t, o) => t in e ? z(e, t, { enumerable: !0, configurable: !0, writable: !0, value: o }) : e[t] = o, I = (e, t) => {
for (var o in t || (t = {}))
J.call(t, o) && V(e, o, t[o]);
if (F)
for (var o of F(t))
Y.call(t, o) && V(e, o, t[o]);
return e;
}, E = (e, t) => W(e, q(t));
var P = (e, t, o) => new Promise((w, i) => {
var d = (p) => {
try {
$(o.next(p));
} catch (k) {
i(k);
}
}, u = (p) => {
try {
$(o.throw(p));
} catch (k) {
i(k);
}
}, $ = (p) => p.done ? w(p.value) : Promise.resolve(p.value).then(d, u);
$((o = o.apply(e, t)).next());
});
import { resolveComponent as m, openBlock as r, createElementBlock as c, Fragment as h, createVNode as _, withCtx as T, createElementVNode as l, withDirectives as N, vModelText as U, toDisplayString as n, renderList as b, normalizeClass as L, createCommentVNode as y, createTextVNode as g, createBlock as O, resolveDynamicComponent as R, markRaw as Q, h as a } from "vue";
import { Input as S, Form as X, Button as Z } from "ant-design-vue";
import { n as ee, dg as B, df as j, ad as le } from "./index2.js";
import { D as te } from "./docs-back-top.js";
import { _ as oe } from "./index16.js";
const K = () => {
try {
le().setDynamicRouter([
{
path: "/",
children: [
{
path: "/workplace",
name: "Workplace",
meta: { title: window.$l("工作台") },
children: []
},
{
path: "/sys",
name: "Sys",
meta: { title: window.$l("系统管理") },
children: [
{
path: "/sys/user",
name: "SysUser",
meta: { title: window.$l("用户管理") },
children: []
},
{
path: "/sys/role",
name: "SysRole",
meta: { title: window.$l("角色管理") },
children: []
}
]
}
]
}
]);
} catch (e) {
}
}, ae = {
STab: [
{
name: "default",
desc: window.$l(
'标签项,里面放 标签;一旦使用默认插槽,tabs 属性不再参与渲染'
)
}
],
SFilterTableToolbar: [
{ name: "filter", desc: window.$l("查询条件区(透传给 SFilterToolbar)") },
{ name: "filterMore", desc: window.$l('更多查询条件,点击"更多"展开(透传)') },
{
name: "其它插槽",
desc: window.$l(
"全部透传给内部表格:列名插槽(按 dataIndex 命名)、bodyCell、expandedRowRender 等"
)
}
],
SListLayout: [
{ name: "filter", desc: window.$l("常用查询条件区(配合 SFilterWrap/SFilterItem)") },
{ name: "filterMore", desc: window.$l('更多查询条件(点击"更多"展开)') },
{ name: "action", desc: window.$l("操作列(作用域 { record })") },
{ name: "otherBtns", desc: window.$l("标题右侧自定义按钮(作用域 { selections } 选中行)") },
{ name: "tree", desc: window.$l("左侧树") },
{ name: "tabs", desc: window.$l("表格上方 tabs") },
{ name: "desc", desc: window.$l("筛选区下方描述") },
{ name: "empty", desc: window.$l("无权限/空内容替换") },
{ name: "other", desc: window.$l("底部其它内容") }
],
SFormLayout: [
{ name: "form", desc: window.$l("表单主体(放在 a-form 内)") },
{ name: "collapses", desc: window.$l("折叠分组内容(配合 showAnchor 用)") },
{ name: "anchor", desc: window.$l("右侧锚点导航") },
{ name: "otherBtns", desc: window.$l("标题右侧按钮") },
{ name: "footer", desc: window.$l("底部按钮区(附加在默认按钮之后)") },
{ name: "other", desc: window.$l("弹层等其它内容") }
],
SModal: [
{ name: "default", desc: window.$l("弹窗内容") },
{
name: "footer",
desc: window.$l(
"自定义底部按钮;不传则用内置底部(关闭 / 保存,或分步弹窗的关闭 / 上一步 / 下一步 / 保存)"
)
}
],
SImportModal: [{ name: "footer", desc: window.$l("底部按钮(组件内置,一般不覆盖)") }],
SDrawer: [{ name: "default", desc: window.$l("抽屉内容") }],
SPanelLayout: [
{ name: "default", desc: window.$l("面板内容区") },
{ name: "title", desc: window.$l("自定义标题(不传则用 title 属性)") },
{ name: "extra", desc: window.$l("标题栏右侧按钮区") },
{ name: "footer", desc: window.$l("底部操作区(不传则无底部)") }
],
SFilterWrap: [{ name: "default", desc: window.$l("SFilterItem 列表") }],
SModalTemplate: [{ name: "default", desc: window.$l("弹窗内容") }],
SListCardLayout: [
{ name: "cardHeader", desc: window.$l("卡片头部(不传则取数据项 title,两者都空则不渲染)") },
{ name: "default", desc: window.$l("卡片内容区,完全自定义(作用域 item / index)") },
{
name: "cardFooter",
desc: window.$l("卡片底部(不传则为默认按钮区:编辑 / 删除),作用域 item / index")
},
{ name: "tree", desc: window.$l("左侧树") },
{ name: "filter", desc: window.$l("查询条件") },
{ name: "filterMore", desc: window.$l("更多查询") },
{ name: "tabs", desc: window.$l("页签区") },
{ name: "otherBtns", desc: window.$l("工具条右侧追加按钮") },
{ name: "other", desc: window.$l("页面底部区域") },
{ name: "empty", desc: window.$l("整页空态(替换整个列表区)") }
],
SListTableTreeLayout: [
{ name: "tree", desc: window.$l("左侧树") },
{ name: "filter", desc: window.$l("查询条件") }
],
SSuperListLayout: [
{ name: "filter", desc: window.$l("查询条件") },
{ name: "filterMore", desc: window.$l("更多查询") }
]
}, D = (e) => e ? Array.isArray(e) ? e.map(D).join(" | ") : e.name || String(e) : "-", G = /* @__PURE__ */ Object.assign({ "/packages/components/SAnchor/SAnchor.vue": () => import("./SAnchor.js"), "/packages/components/SBelowChoosePosition/SBelowChoosePosition.vue": () => import("./SBelowChoosePosition.js"), "/packages/components/SCascader/SCascader.vue": () => import("./SCascader.js"), "/packages/components/SChooseUser/SChooseUser.vue": () => import("./SChooseUser.js"), "/packages/components/SCollapses/SCollapses.vue": () => import("./SCollapses.js"), "/packages/components/SCollapses/SCollapsesItem.vue": () => import("./SCollapsesItem.js"), "/packages/components/SColorPicker/SColorPicker.vue": () => import("./SColorPicker.js"), "/packages/components/SDataRangeTreeSelect/SDataRangeTreeSelect.vue": () => import("./SDataRangeTreeSelect.js"), "/packages/components/SDrawer/SDrawer.vue": () => import("./SDrawer.js"), "/packages/components/SEditor/SEditor.vue": () => import("./SEditor.js"), "/packages/components/SEditor/SEditorImageAdjust.vue": () => import("./SEditorImageAdjust.js"), "/packages/components/SEmpty/SEmpty.vue": () => import("./SEmpty.js"), "/packages/components/SExtendFieldsForm/SExtendFieldsForm.vue": () => import("./SExtendFieldsForm.js"), "/packages/components/SExtendFieldsForm/SExtendFieldsFormItem.vue": () => import("./SExtendFieldsFormItem.js"), "/packages/components/SFileUpload/CropperModal.vue": () => import("./CropperModal.js"), "/packages/components/SFileUpload/SCopperUpload.vue": () => import("./SCopperUpload.js"), "/packages/components/SFileUpload/SDraggerUpload.vue": () => import("./SDraggerUpload.js"), "/packages/components/SFileUpload/SFilePreview.vue": () => import("./SFilePreview.js"), "/packages/components/SFileUpload/SFileUpload.vue": () => import("./SFileUpload.js"), "/packages/components/SFilterItem/SFilterItem.vue": () => import("./SFilterItem.js"), "/packages/components/SFilterItem/SFilterWrap.vue": () => import("./SFilterWrap.js"), "/packages/components/SFilterTableToolbar/SFilterTableToolbar.vue": () => import("./SFilterTableToolbar.js"), "/packages/components/SFilterToolbar/SFilterToolbar.vue": () => import("./SFilterToolbar.js"), "/packages/components/SFooterToolBar/SFooterToolBar.vue": () => import("./SFooterToolBar.js"), "/packages/components/SFormBasicLayout/SFormBasicLayout.vue": () => import("./SFormBasicLayout.js"), "/packages/components/SFormLayout/SForm.vue": () => import("./SForm.js"), "/packages/components/SFormLayout/SFormItem.vue": () => import("./SFormItem.js"), "/packages/components/SFormLayout/SFormLayout.vue": () => import("./SFormLayout.js"), "/packages/components/SIcon/SIcon.vue": () => import("./SIcon.js"), "/packages/components/SIcon/SIconModal.vue": () => import("./SIconModal.js"), "/packages/components/SIcon/SIconSelect.vue": () => import("./SIconSelect.js"), "/packages/components/SIcon/SIconSelectPopover.vue": () => import("./SIconSelectPopover.js"), "/packages/components/SIcon/SSvg.vue": () => import("./SSvg.js"), "/packages/components/SImportModal/SImportModal.vue": () => import("./SImportModal.js"), "/packages/components/SListBasicLayout/SListBasicLayout.vue": () => import("./SListBasicLayout.js"), "/packages/components/SListCardLayout/SListCardLayout.vue": () => import("./SListCardLayout.js"), "/packages/components/SListLayout/SListLayout.vue": () => import("./SListLayout.js"), "/packages/components/SListTableTreeLayout/SListTableTreeLayout.vue": () => import("./SListTableTreeLayout.js"), "/packages/components/SMenu/SSideMenu.vue": () => import("./SSideMenu.js"), "/packages/components/SMenu/STopMenu.vue": () => import("./STopMenu.js"), "/packages/components/SModal/SModal.vue": () => import("./SModal.js"), "/packages/components/SModal/components/ModalHeader.vue": () => import("./ModalHeader.js"), "/packages/components/SModalTemplate/SModalTemplate.vue": () => import("./SModalTemplate.js"), "/packages/components/SNewestDataListLayout/SNewestDataListLayout.vue": () => import("./SNewestDataListLayout.js"), "/packages/components/SOfficeSelect/SOfficeSelect.vue": () => import("./SOfficeSelect.js"), "/packages/components/SPanelLayout/SPanelLayout.vue": () => import("./SPanelLayout.js"), "/packages/components/SSkeletonLayout/SSkeletonLayout.vue": () => import("./SSkeletonLayout.js"), "/packages/components/SSuperListLayout/Drawer/CustomInput.vue": () => import("./CustomInput.js"), "/packages/components/SSuperListLayout/Drawer/SettingColumns.vue": () => import("./SettingColumns.js"), "/packages/components/SSuperListLayout/Drawer/SettingFilter.vue": () => import("./SettingFilter.js"), "/packages/components/SSuperListLayout/SSuperListLayout.vue": () => import("./SSuperListLayout.js"), "/packages/components/STab/STab.vue": () => import("./STab.js"), "/packages/components/STab/STabItem.vue": () => import("./STabItem.js"), "/packages/components/STableToolbar/STableToolbar.vue": () => import("./STableToolbar.js"), "/packages/components/SThemeConfig/SThemeConfig.vue": () => import("./SThemeConfig.js"), "/packages/components/SToggleLanguage/SToggleLanguage.vue": () => import("./SToggleLanguage.js"), "/packages/components/STree/STree.vue": () => import("./STree.js"), "/packages/components/STreeSelect/STreeSelect.vue": () => import("./STreeSelect.js"), "/packages/components/SUserSelect/SUserSelect.vue": () => import("./SUserSelect.js"), "/packages/components/SUserSelectButton/SUserSelectButton.vue": () => import("./SUserSelectButton.js") });
function ne(e) {
try {
return e();
} catch (t) {
return;
}
}
const v = (e, t = {}, o) => ({
name: "Demo" + e,
render() {
const w = m(e);
return a("div", { class: "demo-render" }, [a(w, t, o ? { default: o } : void 0)]);
}
}), H = (e, t = {}) => ({
name: "Demo" + e,
data() {
var o;
return { model: (o = t.value) != null ? o : "" };
},
render() {
const o = m(e);
return a("div", { class: "demo-render" }, [
a(o, E(I({}, t), { value: this.model, "onUpdate:value": (w) => this.model = w }))
]);
}
}), C = (e, t, o = {}, w = window.$l("内容")) => ({
name: "Demo" + e,
data() {
return { visible: !1 };
},
render() {
const i = m(e);
return a("div", { class: "demo-render" }, [
a(
"button",
{
class: "demo-btn",
style: "padding:6px 16px;color:var(--s-text-color-inverse);background:var(--s-color);border:none;border-radius:6px;cursor:pointer",
onClick: () => this.visible = !0
},
t
),
a(
i,
E(I({}, o), { value: this.visible, "onUpdate:value": (d) => this.visible = d }),
{ default: () => a("div", w) }
)
]);
}
}), ie = (e = {}) => ({
name: "DemoSTab",
data() {
var t, o;
return {
tabs: e.tabs || [],
activeKey: (o = (t = e.activeKey) != null ? t : e.defaultActiveKey) != null ? o : ""
};
},
render() {
const t = m("STab");
return a("div", { class: "demo-render" }, [
a(t, {
tabs: this.tabs,
activeKey: this.activeKey,
"onUpdate:activeKey": (o) => this.activeKey = o
}),
a(
"div",
{ style: "margin-top:10px;font-size:12px;color:var(--s-text-color-secondary)" },
window.$l("当前选中:") + (this.activeKey === "" ? window.$l("无") : this.activeKey)
)
]);
}
}), M = (e, t) => a(
"button",
{
style: "padding:6px 16px;color:var(--s-text-color-inverse);background:var(--s-color);border:none;border-radius:6px;cursor:pointer",
onClick: t
},
e
), se = () => ({
name: "DemoSModalDefault",
data() {
return { visible: !1 };
},
render() {
const e = m("SModal");
return a("div", { class: "demo-render" }, [
M(window.$l("打开弹窗(默认底部)"), () => this.visible = !0),
a(
e,
{
value: this.visible,
"onUpdate:value": (t) => this.visible = t,
title: window.$l("新增岗位"),
width: "640px",
onHandSave: () => {
this.visible = !1, window.$message.success(window.$l("已触发保存(handSave)"));
}
},
{
default: () => a("div", { style: "line-height:2" }, [
a("div", window.$l("弹窗内容由默认插槽提供,底部按钮由组件内置,业务不用自己写。")),
a("div", window.$l("点「保存」触发 handSave,点「关闭」触发 handCancel。"))
])
}
)
]);
}
}), de = () => ({
name: "DemoSModalStep",
data() {
return {
visible: !1,
index: 0,
steps: [window.$l("填写基本信息"), window.$l("补充详细配置"), window.$l("确认并提交")],
tips: [
window.$l("第 1 步:选择组织,填写名称与编码"),
window.$l("第 2 步:配置参数,上传附件"),
window.$l("第 3 步:核对信息后点「保存」提交")
]
};
},
render() {
const e = m("SModal"), t = Math.min(this.index, this.steps.length - 1);
return a("div", { class: "demo-render" }, [
M(window.$l("打开步骤弹窗"), () => {
this.index = 0, this.visible = !0;
}),
a(
e,
{
value: this.visible,
"onUpdate:value": (o) => this.visible = o,
title: window.$l("分步新建"),
width: "700px",
steps: this.steps,
// 演示直接放行;真实业务在这里做当前步骤的表单校验,返回 Promise
stepValid: () => Promise.resolve(!0),
onStepCallback: (o, w) => this.index = w,
onHandSave: () => {
this.visible = !1, window.$message.success(window.$l("保存成功"));
}
},
{
default: () => a("div", { style: "min-height:120px" }, [
a("div", { style: "font-weight:600;margin-bottom:8px" }, this.steps[t]),
a("div", { style: "color:var(--s-text-color-regular);line-height:2" }, this.tips[t])
])
}
)
]);
}
}), re = () => ({
name: "DemoSModalTabs",
data() {
const e = [
{ label: window.$l("基本信息"), value: "basic" },
{ label: window.$l("扩展信息"), value: "extend" },
{ label: window.$l("操作日志"), value: "log" }
];
return {
visible: !1,
tabs: e,
// 页签条回传的就是 pane 的 key,默认取 value
tab: e[0].value,
texts: [
window.$l("基础字段:名称、编码、排序、是否启用"),
window.$l("扩展字段:负责人、生效日期、备注说明"),
window.$l("操作日志:谁在什么时间修改了哪些字段")
]
};
},
render() {
const e = m("SModal"), t = this.tabs.findIndex((o) => o.value === this.tab);
return a("div", { class: "demo-render" }, [
M(window.$l("打开页签弹窗"), () => this.visible = !0),
a(
e,
{
value: this.visible,
"onUpdate:value": (o) => this.visible = o,
title: window.$l("分组信息"),
width: "720px",
tabs: this.tabs,
onTabsChange: (o) => this.tab = o,
onHandSave: () => {
this.visible = !1, window.$message.success(window.$l("保存成功"));
}
},
{
default: () => a(
"div",
{ style: "min-height:100px;line-height:2;color:var(--s-text-color-regular)" },
this.texts[t < 0 ? 0 : t]
)
}
)
]);
}
}), ce = {
templateDownload: () => Promise.resolve({ data: { url: "" } }),
importPreview: () => Promise.resolve({
data: {
dataRow: [
{ sn: "SN001", name: window.$l("示例设备一") },
{ sn: "SN002", name: window.$l("示例设备二") }
]
}
}),
importData: () => Promise.resolve({ data: { resultType: 0, snum: 2, fnum: 0, failResult: [] } }),
exportExceptionData: () => Promise.resolve({ data: { url: "" } })
}, we = () => [
{ title: window.$l("设备SN码"), dataIndex: "sn", width: 150 },
{ title: window.$l("设备名称"), dataIndex: "name", width: 150 }
], x = () => Promise.resolve({
list: [
{ id: "1", name: window.$l("示例数据一"), campusName: window.$l("东校区"), allowTruck: 1 },
{ id: "2", name: window.$l("示例数据二"), campusName: window.$l("西校区"), allowTruck: 0 }
],
pagination: { total: 2, current: 1, pageSize: 20 }
}), me = ({ pageNo: e = 1, pageSize: t = 20 } = {}) => {
const o = [
{
id: "1",
title: window.$l("示例数据一"),
name: window.$l("示例数据一"),
campusName: window.$l("东校区")
},
{
id: "2",
title: window.$l("示例数据二"),
name: window.$l("示例数据二"),
campusName: window.$l("西校区")
},
{ id: "3", name: window.$l("无标题卡片"), campusName: window.$l("南校区") },
{
id: "4",
title: window.$l("示例数据四"),
name: window.$l("示例数据四"),
campusName: window.$l("北校区")
},
{
id: "5",
title: window.$l("示例数据五"),
name: window.$l("示例数据五"),
campusName: window.$l("东校区")
},
{
id: "6",
title: window.$l("示例数据六"),
name: window.$l("示例数据六"),
campusName: window.$l("西校区")
}
];
return Promise.resolve({
list: o.slice((e - 1) * t, e * t),
total: o.length
});
}, A = () => [
{ title: window.$l("名称"), dataIndex: "name", width: 120 },
{ title: window.$l("校区"), dataIndex: "campusName", width: 120 },
{ title: window.$l("操作"), dataIndex: "action", width: 100 }
], ue = {
name: "ComponentsDoc",
components: { DocsBackTop: te },
data() {
return {
keyword: "",
active: "",
error: "",
renderKey: 0,
// 页面视图:components(组件文档)/ tools(工具/配置)
view: "components",
propsDefs: [],
propsObj: {},
events: [],
methodsList: [],
slots: [],
loaders: {},
// 基座内置依赖(package.json dependencies),业务可直接 import 使用
depRows: [
{ name: "dayjs", ver: "^1.11.12", desc: window.$l("日期格式化(推荐)") },
{ name: "axios", ver: "^1.7.3", desc: window.$l("请求(已封装为 $utils.http)") },
{ name: "qs", ver: "^6.13.0", desc: window.$l("参数序列化 stringify") },
{ name: "lodash.get", ver: "^4.4.2", desc: window.$l("安全取值") },
{ name: "lodash.clonedeep", ver: "^4.5.0", desc: window.$l("深拷贝") },
{ name: "crypto-js", ver: "^4.2.0", desc: window.$l("加解密") },
{ name: "js-base64", ver: "^3.7.2", desc: window.$l("Base64 编解码") },
{ name: "jsencrypt", ver: "^3.3.2", desc: window.$l("RSA 加密") },
{ name: "moment", ver: "^2.30.1", desc: window.$l("日期(老代码兼容)") },
{ name: "html2canvas", ver: "^1.4.1", desc: window.$l("页面截图($getPdf 动态加载)") },
{ name: "jspdf", ver: "^4.2.1", desc: window.$l("导出 PDF($getPdf 动态加载)") },
{ name: "nprogress", ver: "^0.2.0", desc: window.$l("顶部加载进度条") },
{ name: "@vueuse/core", ver: "^11.0.3", desc: window.$l("组合式工具函数") },
{ name: "vue-cropper", ver: "^1.1.4", desc: window.$l("图片裁剪(SCopperUpload)") },
{ name: "vuedraggable", ver: "^4.1.0", desc: window.$l("拖拽排序") },
{ name: "v-clipboard", ver: "^3.0.0-next.1", desc: window.$l("复制到剪贴板") },
{ name: "vue-ls", ver: "^4.2.0", desc: window.$l("localStorage(已包成 $utils.ls)") },
{ name: "jodit", ver: "3.24.7", desc: window.$l("富文本编辑器(SEditor)") },
{ name: "less / less-loader", ver: "^4.2.0 / ^12.2.0", desc: window.$l("样式编译") },
{
name: "@ant-design/icons-vue",
ver: window.$l("随 ant-design-vue"),
desc: window.$l("图标,全部已全局注册")
},
{ name: "vue", ver: "^3.4.29", desc: window.$l("★ 单例依赖:基座不打包,业务必须安装") },
{
name: "vue-router",
ver: "^4.3.3",
desc: window.$l("★ 单例依赖:基座不打包,业务必须安装")
},
{ name: "pinia", ver: "^2.1.7", desc: window.$l("★ 单例依赖:基座不打包,业务必须安装") },
{
name: "vue-i18n",
ver: "^9.14.0",
desc: window.$l("★ 单例依赖:基座不打包,业务必须安装")
},
{
name: "ant-design-vue",
ver: "4.x",
desc: window.$l("★ 单例依赖:基座不打包,业务必须安装")
}
],
// web-config 配置项清单(packages/config/web-config.js 的 defaultEnv,可被 .env / config.json 覆盖)
configRows: [
{
name: "VITE_APP_PROJECT_NAME",
def: "window.$l('前端项目架构')",
desc: window.$l("项目名称")
},
{ name: "VITE_APP_VERSION", def: "'v1.0'", desc: window.$l("版本号") },
{ name: "VITE_APP_JSS_LICENSE", def: "''", desc: "JSS license" },
{ name: "VITE_APP_TITLE", def: "window.$l('平台')", desc: window.$l("浏览器页签名称") },
{
name: "VITE_APP_BASE_URL",
def: "'/'",
desc: window.$l("站点基础路径,子路径部署如 /monitor/")
},
{ name: "VITE_APP_FOOTER_VISIBLE", def: "false", desc: window.$l("是否显示页脚版权") },
{
name: "VITE_APP_MESSAGE_VISIBLE",
def: "true",
desc: window.$l("是否显示右上角消息铃铛(设 false 隐藏)")
},
{ name: "VITE_APP_LANG_ENABLE", def: "false", desc: window.$l("是否启用国际化") },
{ name: "VITE_APP_LANG", def: "'zh'", desc: window.$l("默认语言:zh / en") },
{ name: "VITE_APP_API_PATH", def: "'/apig'", desc: window.$l("API 地址前缀") },
{ name: "VITE_APP_SYS_SERVER_NAME", def: "'monitor'", desc: window.$l("业务网关") },
{ name: "VITE_APP_MESSAGE_SERVER_NAME", def: "'message'", desc: window.$l("消息网关") },
{
name: "VITE_APP_PORTAL_SERVER_NAME",
def: "'portal'",
desc: window.$l("平台网关(用户/权限/字典等)")
},
{ name: "VITE_APP_FLOW_SERVER_NAME", def: "'flow'", desc: window.$l("工作流网关") },
{
name: "VITE_APP_CLIENT_ID",
def: "'mm0001'",
desc: window.$l("认证中心 clientId(须与业务注册的一致)")
},
{
name: "VITE_APP_PREVIEW_ONLINE",
def: "'/filePreview/onlinePreview?url='",
desc: window.$l("文件在线预览地址前缀")
},
{
name: "VITE_APP_WEB_SITE",
def: "'https://sapit.com.cn/#/home'",
desc: window.$l("版权链接地址")
},
{
name: "VITE_APP_LOGIN_CASE_NAME",
def: "window.$l('辽ICP备14008719号-2')",
desc: window.$l("登录页备案号")
},
{
name: "VITE_APP_BASE_CASE_NAME",
def: "window.$l('辽ICP备14008719号-2')",
desc: window.$l("默认 ICP 备案信息,可传 html 片段")
},
{
name: "VITE_APP_SOCKET_URL",
def: "'ws://127.0.0.1:8080/websocket'",
desc: window.$l("WebSocket 服务地址(顶部栏消息数量实时推送)")
},
{
name: "VITE_APP_SOCKET_PATH",
def: "'/apig/ws/websocket'",
desc: window.$l("socket.io 握手路径,需与后端一致")
},
{
name: "VITE_CONFIG_MODE",
def: "MODE === 'development'",
desc: window.$l("开发模式:控制台打印 $utils 等调试信息")
},
{
name: "VITE_APP_API_BASE_URL",
def: window.$l("取 env"),
desc: window.$l("默认接口请求地址")
},
{ name: "VITE_APP_API_FILE_URL", def: "'/'", desc: window.$l("文件服务地址") },
{
name: "VITE_APP_MENU_THEME",
def: "'light'",
desc: window.$l(
"菜单配色模式(业务可选):light 跟随主题色的浅色系 / dark antd 黑色(#001529)。开启 VITE_APP_THEME_FOLLOW_SYSTEM 后,系统切深色时自动临时按 dark 走"
)
},
{
name: "VITE_APP_MENU_BG",
def: "'theme'",
desc: window.$l(
"菜单底色(仅 light 生效):theme 跟随主题色(默认,一级底/子底/悬停/选中都由主题色相推导)/ #RRGGBB 自定义;dark 模式固定 #001529,此配置无效。属基座锁定项,业务传了会被回填"
)
},
{
name: "VITE_APP_THEME_FOLLOW_SYSTEM",
def: "true",
desc: window.$l(
"跟随系统深浅色(prefers-color-scheme):开启后系统切深色,菜单自动换暗色、中性色令牌换暗色版,运行时即时生效不用刷新;关掉则固定按 VITE_APP_MENU_THEME 走"
)
},
{
name: "VITE_APP_MENU_BG_LIGHTNESS",
def: "93",
desc: window.$l("菜单底亮度 0-100:越大越白,越小越深(默认 93 浅色)")
},
{
name: "VITE_APP_MENU_BG_SATURATION",
def: "66",
desc: window.$l("菜单配色饱和度上限 0-100:越小越接近灰白")
},
{
name: "VITE_APP_MENU_BG_ACTIVE_MIX",
def: "16",
desc: window.$l("选中项底色里主题色的占比 0-100:越大选中块越蓝")
},
{
name: "VITE_APP_MENU_SUB_BG",
def: "''",
desc: window.$l("子菜单展开区底色,留空按主题色推导(默认留空)")
},
{
name: "VITE_APP_MENU_HOVER_BG",
def: "''",
desc: window.$l("菜单悬停项底色,留空按主题色推导(默认留空)")
},
{
name: "VITE_APP_MENU_ACTIVE_BG",
def: "''",
desc: window.$l("菜单选中块底色,留空按主题色推导(默认留空)")
},
{
name: "VITE_APP_MENU_TEXT",
def: "''",
desc: window.$l("菜单普通文字色,留空按底色推导")
},
{
name: "VITE_APP_MENU_TEXT_HOVER",
def: "''",
desc: window.$l("菜单悬停文字色,留空按底色推导")
},
{
name: "VITE_APP_MENU_TEXT_ACTIVE",
def: "''",
desc: window.$l("菜单选中文字色,留空按底色推导")
},
{
name: "VITE_APP_MENU_GROUP_TITLE",
def: "''",
desc: window.$l("菜单分组标题文字色,留空按底色推导")
},
{
name: "VITE_APP_MENU_BAR",
def: "'left'",
desc: window.$l("菜单布局:left(左侧)/ top(顶部)")
},
{
name: "VITE_APP_LOGIN_PATH_THEME",
def: "'3'",
desc: window.$l(
"登录页布局:1 左图右表单 / 2 左表单+背景 / 3 居中 / 4 深蓝品牌区+白卡片(完整版,含记住我、图形验证码、账号锁定倒计时、激活入口、扫码/找回密码跳转)。四个主题各自为独立页面级组件 packages/pages/login/login-themes/LoginTheme1~4.vue,登录页只按编号用 component :is 渲染"
)
},
{
name: "VITE_APP_THEME_VALUE",
def: "'blue'",
desc: window.$l("主题色:blue / green / orange")
},
{
name: "VITE_APP_THEME",
def: window.$l("基座维护"),
desc: window.$l("主题定义集合,只由基座维护,业务配置会被忽略")
},
{ name: "VITE_APP_LOGIN_PATH", def: "'/login'", desc: window.$l("登录页地址") },
{
name: "VITE_APP_DEFAULT_PATH",
def: "'/workplace/index'",
desc: window.$l("登录后默认首页地址")
}
],
// $utils 方法全表(packages/utils/utils.js),按用途分组
utilGroups: [
{
title: window.$l("全局 / 环境"),
items: [
{
name: "$utils.env",
desc: window.$l(
"合并后的环境配置(web-config → .env → config.json),即 VITE_APP_* 全集"
)
},
{
name: "$utils.http(config)",
desc: window.$l(
"axios 请求封装,自动携带网关前缀与 user-token 鉴权;返回 Promise,兼容 { code, data } 包裹格式"
)
},
{
name: "$utils.ls",
desc: window.$l("本地存储对象,方法见「本地存储」分组;key 自动带应用后缀")
},
{ name: "messageFormat(str, values)", desc: window.$l("格式化 {key} 占位符字符串") },
{
name: "signOutClearKeys(storage)",
desc: window.$l("退出登录时要清除的本地缓存 key 集合操作")
},
{ name: "appStoreKeySuffix()", desc: window.$l("获取应用本地存储 key 的后缀") }
]
},
{
title: window.$l("本地存储($utils.ls)"),
items: [
{ name: "ls.set(key, value)", desc: window.$l("写入本地存储") },
{ name: "ls.get(key)", desc: window.$l("读取本地存储") },
{ name: "ls.remove(key)", desc: window.$l("移除指定 key") },
{ name: "ls.getParse(key)", desc: window.$l("读取并 JSON.parse") },
{ name: "ls.clear(keys)", desc: window.$l("按 clearStorageMap 登出清理") }
]
},
{
title: window.$l("类型判断"),
items: [
{ name: "isType(type)", desc: window.$l("生成指定类型的判断函数") },
{
name: "isArray(obj) / isString(obj) / isBoolean(obj) / isFunction(obj) / isDate(obj) / isNumber(obj)",
desc: window.$l("基础类型判断")
},
{
name: "isInt(obj) / isNumeric(obj)",
desc: window.$l("整数 / 数字(含数字字符串)判断")
},
{
name: "isNull(obj) / isUndefined(obj) / isNullOrUndefined(obj)",
desc: window.$l("空值判断")
},
{ name: "isPlainObject(obj) / isObject(obj)", desc: window.$l("对象判断") },
{
name: "isEmpty(obj)",
desc: window.$l("空值判断(undefined/null/空串/空数组/空对象)")
}
]
},
{
title: window.$l("DOM 操作"),
items: [
{ name: "query(el, dom) / queryAll(el, dom)", desc: window.$l("querySelector 封装") },
{
name: "isDom(el) / transformToDom(html)",
desc: window.$l("DOM 判断 / html 字符串转 DOM")
},
{
name: "on(el, event, handler) / off(el, event, handler) / once(el, event, handler)",
desc: window.$l("事件绑定 / 解绑 / 单次绑定")
},
{
name: "hasClass(el, cls) / addClass(el, cls) / removeClass(el, cls)",
desc: window.$l("class 操作(支持空格分隔多个)")
},
{
name: "getStyle(el, styleName) / setStyle(el, styleName, value)",
desc: window.$l("样式读取 / 设置(对象或键值)")
},
{
name: "getMaxZIndex(currDom)",
desc: window.$l("获取页面最大 zIndex(可排除当前元素)")
},
{ name: "isHidden(el)", desc: window.$l("元素是否隐藏") }
]
},
{
title: window.$l("字符串 / 文本"),
items: [
{ name: "uuid(len = 27)", desc: window.$l("生成随机 uuid") },
{ name: "trim(string)", desc: window.$l("去除首尾空白") },
{ name: "capitalize(letter)", desc: window.$l("首字母大写") },
{ name: "capitalizeTypeName(type)", desc: window.$l("类型名首字母大写") },
{
name: "camelCase(name)",
desc: window.$l("转驼峰(如 recycle_status → recycleStatus)")
},
{ name: "amountToChinese(amount)", desc: window.$l("数字金额转中文大写") },
{
name: "escapeHtml(target) / unescapeHtml(target)",
desc: window.$l("HTML 转义 / 反转义")
}
]
},
{
title: window.$l("数字 / 计算"),
items: [
{
name: "parseInt(number, defaultValue)",
desc: window.$l("安全转整数(非法返回默认值)")
},
{
name: "parseDecimal(number, places, min, max, defaultValue)",
desc: window.$l("安全转小数,可限制范围与位数")
},
{
name: "parsePercent(number, places, defaultValue)",
desc: window.$l("转百分比字符串(number * 100 + %)")
},
{ name: "toThousands(number, places, defaultValue)", desc: window.$l("千分位格式化") },
{
name: "math.max(values, option) / math.min(values, option)",
desc: window.$l("取最大 / 最小值")
},
{
name: "math.sum(values, option) / math.average(values, option)",
desc: window.$l("求和 / 平均值")
}
]
},
{
title: window.$l("数组 / 对象"),
items: [
{ name: "unique(arr)", desc: window.$l("数组去重") },
{ name: "merge(...args)", desc: window.$l("数组合并(可去重)") },
{ name: "transpose(arr, index1, index2)", desc: window.$l("交换数组/对象两个位置") },
{
name: "namespace(namespace, root) / isExistNamespace(namespace, root)",
desc: window.$l("创建 / 检测对象命名空间(a.b.c)")
},
{ name: "forEach(data, callback)", desc: window.$l("数组/对象通用遍历") },
{
name: "hasOwn(obj, prop) / hasOwns(obj, props)",
desc: window.$l("判断是否有(多个)非继承属性")
},
{
name: "assign(target, obj, bCover, bDepth)",
desc: window.$l("属性并入,默认不覆盖,支持深度合并")
},
{ name: "getSingleton(fn)", desc: window.$l("单例工厂(仅执行一次)") },
{
name: "getter(target, path, valid)",
desc: window.$l("按属性路径取值(utils.get(object, path, defaultValue))")
},
{ name: "matchPairElement(html, tagName)", desc: window.$l("匹配 html 中成对标签") }
]
},
{
title: window.$l("日期 / 时间"),
items: [
{
name: "parseDate(strDate, defaultValue)",
desc: window.$l("字符串转 Date(非法返回默认值)")
},
{
name: "formatDate(date, fmt)",
desc: window.$l("日期格式化,默认 yyyy-MM-dd hh:mm:ss")
},
{
name: "getDateInterval(start, end, unit, defaultValue)",
desc: window.$l("两个时间差(d/h/m/s/ms)")
},
{
name: "getDateByDaysApart(date, number, defaultValue)",
desc: window.$l("相隔几天后的日期")
},
{
name: "getDateByMonthApart(date, number, defaultValue)",
desc: window.$l("相隔几月后的日期")
},
{
name: "getDateByMonthApartExtend(date, number, isStart, defaultValue)",
desc: window.$l("几月后的月初/月末滚动日期")
},
{
name: "getDateByYearApart(date, number, defaultValue)",
desc: window.$l("相隔几年后的日期")
},
{
name: "getDateByYearApartExtend(date, number, isStart, defaultValue)",
desc: window.$l("几年后的年初/年末滚动日期")
},
{
name: "setWorkDays(days) / isWorkDay(date)",
desc: window.$l("设置工作日(默认周一~周五)/ 判断是否工作日")
}
]
},
{
title: window.$l("URL / 路由跳转"),
items: [
{ name: "getQueryString(name, url, isDeCode)", desc: window.$l("读取 URL 查询参数") },
{
name: "setQueryString(params, url, transcoding)",
desc: window.$l("向 URL 追加查询参数(覆盖同名)")
},
{
name: "appendQuery(params, url)",
desc: window.$l("给当前 URL 追加参数(新的覆盖原有的)")
},
{
name: "parseQuery(url, separator, decode)",
desc: window.$l("解析 URL 查询参数为对象")
},
{
name: "replacePathParams(url, params)",
desc: window.$l("替换请求 api 上的 path 占位符")
},
{
name: "addRandomQuery(url, random, refresh)",
desc: window.$l("给 URL 追加随机参数(防缓存)")
},
{ name: "getDomain(hostname)", desc: window.$l("获取域名信息") },
{
name: "isSiteUrl(url) / isOnlineAppUrl(url, client)",
desc: window.$l("是否站内地址 / 在线应用地址")
},
{
name: "parseAppUrl(url)",
desc: window.$l(
"站内地址拼接 base(支持 /monitor/ 子路径部署),完整 http(s) 原样返回"
)
},
{
name: "innerRedirect(url) / innerReplace(url) / innerOpen(url)",
desc: window.$l("站内跳转(支持子路径):重定向 / 替换(不留历史)/ 新窗口打开")
},
{ name: "joinPath(...paths)", desc: window.$l("拼接路径(自动处理斜杠)") },
{ name: "validPhone(phone)", desc: window.$l("手机号校验") },
{ name: "getImg(path)", desc: window.$l("解析资源路径为完整地址") }
]
},
{
title: window.$l("函数 / 其它"),
items: [
{ name: "debounce(fn, delay, immediate)", desc: window.$l("函数防抖(可立即执行)") },
{ name: "throttle(fn, interval)", desc: window.$l("函数节流") },
{ name: "delay(fn, callback, maxTime)", desc: window.$l("延迟执行") },
{ name: "animate(opts)", desc: window.$l("动画(delay/duration/step/delta/callback)") }
]
}
],
list: Q([
{
key: "scollapses",
notes: [
window.$l(
"column 是 SCollapsesItem 的 prop(不是 SCollapses 的),写在 上不生效。"
),
window.$l("分组里的某一项要独占整行时加 full。")
],
name: "SCollapses",
title: window.$l("折叠面板"),
desc: window.$l(
"折叠分组容器 SCollapses + 分组项 SCollapsesItem(两个为一组,合并展示)。"
),
demo: {
render() {
const e = m("SCollapses"), t = m("SCollapsesItem");
return a("div", { class: "demo-render" }, [
a(e, null, {
default: () => [
a(
t,
{ title: window.$l("基础信息"), column: 2 },
{
default: () => [
a("div", window.$l("姓名:张三")),
a("div", window.$l("年龄:18"))
]
}
),
a(
t,
{ title: window.$l("其他信息"), column: 1 },
{ default: () => a("div", window.$l("备注:无")) }
)
]
})
]);
}
},
code: `
姓名:张三
年龄:18
备注:无
`
},
{
key: "s-modal",
name: "SModal",
title: window.$l("弹窗"),
desc: window.$l(
"通用模态框:标题可拖动、支持全屏、内容区自动测量高度并限高滚动。底部按钮按场景三选一——不传任何配置用内置「关闭/保存」,传 steps 走分步导航,传 tabs 在内容上方加页签条;也可以用 #footer 插槽完全自定义。"
),
demos: [
{
label: window.$l("默认底部按钮区(不传 footer 插槽)"),
desc: window.$l(
"最常用形态。底部由组件内置:左侧「关闭」触发 handCancel,右侧「保存」触发 handSave;保存按钮文案用 save-btn-text 改,不要重复写 #footer。"
),
demo: se(),
code: `
弹窗内容
// 不传 #footer 时,组件主动渲染两个按钮:
// 关闭 -> emit handCancel
// 保存 -> emit handSave(primary,文案用 save-btn-text 改,默认「保存」)
const onSave = () => {
// 自己调接口保存,成功后关闭
visible.value = false
}`
},
{
label: window.$l("步骤弹窗"),
desc: window.$l(
"传 steps(步骤标题数组)后底部换成「关闭 / 上一步 / 下一步」,走到最后一步才出现「保存」。点「下一步」先调 stepValid(当前索引),返回 Promise 才前进;每次切换 emit stepCallback(方向, 当前索引),内容显隐由业务按索引控制。"
),
demo: de(),
code: `
第 1 步内容
第 2 步内容
第 3 步内容
// 下一步前的校验:返回 Promise,true 才允许前进
const stepValid = (index) =>
formRef.value.validate().then(() => true).catch(() => false)
// 方向为 'next' / 'prev',索引从 0 开始
const onStepChange = (dir, index) => (step.value = index)`
},
{
label: window.$l("页签弹窗"),
desc: window.$l(
`传 tabs([{ label, value }])后内容上方出现页签条,切换 emit tabsChange(选中 key);pane 的 key 默认取 value,打开时默认高亮第一项。页签条只负责切换,内容由默认插槽按当前页签 v-if 控制。数据字段不是 label/value 时,用 tab-key="{ label: '名称字段', value: '值字段' }" 指定。`
),
demo: re(),
code: `
基础字段
扩展字段
操作日志
const tabs = [
{ label: '基本信息', value: 'basic' },
{ label: '扩展信息', value: 'extend' },
{ label: '操作日志', value: 'log' }
]
// 回传的就是 pane 的 key(默认取 value),打开时默认高亮第一项
const onTabChange = (key) => (tab.value = key)`
},
{
label: window.$l("自定义底部(footer 插槽)"),
desc: window.$l(
"按钮不是「关闭/保存」时用 #footer 完全接管;传了 footer 插槽后内置按钮与分步按钮都不再渲染。"
),
demo: C("SModal", window.$l("打开弹窗(自定义底部)"), {
title: window.$l("标题"),
width: "600px"
}),
code: `
弹窗内容
取消
确定
`
}
]
},
{
key: "s-modal-template",
name: "SModalTemplate",
title: window.$l("弹窗内容模板"),
desc: window.$l(
"弹窗内容容器(内部组件):为弹窗内容提供统一内边距/排版,SModal 内容区已内置使用,一般无需直接引入。"
),
code: `
内容
`
},
{
key: "s-drawer",
name: "SDrawer",
title: window.$l("抽屉"),
desc: window.$l("侧边抽屉。"),
demo: C("SDrawer", window.$l("打开抽屉"), { title: window.$l("抽屉标题") }),
code: `
内容
`
},
{
key: "s-panel-layout",
name: "SPanelLayout",
title: window.$l("新开页/空页面"),
desc: window.$l(
"内容面板容器。不传 title 与 extra/footer 插槽时退化为纯容器;传 title 后为「标题栏 + 内容区 + 底部操作区」骨架,内容区自适应剩余高度并可滚动。"
),
demo: v(
"SPanelLayout",
{ title: window.$l("面板标题") },
() => a("div", window.$l("面板内容"))
),
code: `
操作
内容
保存
`
},
{
key: "s-filter-wrap",
name: "SFilterWrap",
title: window.$l("筛选区"),
desc: window.$l(
"筛选条件布局 SFilterWrap + 表单项 SFilterItem(合并展示)。SFilterItem 加 full 可独占一行。"
),
demo: {
render() {
const e = m("SFilterWrap"), t = m("SFilterItem");
return a("div", { class: "demo-render" }, [
a(e, null, {
default: () => [
a(
t,
{ label: window.$l("名称") },
{ default: () => a(S, { placeholder: window.$l("请输入") }) }
),
a(
t,
{ label: window.$l("状态") },
{ default: () => a(S, { placeholder: window.$l("请选择") }) }
),
a(
t,
{ label: window.$l("备注"), full: !0 },
{ default: () => a(S, { placeholder: window.$l("full:独占一行") }) }
)
]
})
]);
}
},
code: `
`
},
{
key: "s-filter-toolbar",
notes: [
window.$l(
"内部已包 SFilterWrap,业务只写 SFilterItem;不传 filterMore 插槽时「更多 / 收起」按钮不渲染。"
),
window.$l("reset 只抛事件:清空查询参数、重新取数由业务自己做。"),
window.$l(
"表格区配 STableToolbar 时不用管 toggle(它自己观察容器尺寸);自建表格才需要按 isMoreFilter 重算表体高度。"
),
window.$l(
"ref 暴露 isMoreFilter / toggleFilter() / filterReset() / collapse()(切页签时主动收起)。"
)
],
name: "SFilterToolbar",
title: window.$l("查询区"),
desc: window.$l(
"查询区外壳:主查询区 + 「更多 / 收起」折叠 + 条件重置。内部已包 SFilterWrap,业务只写 SFilterItem。"
),
demo: {
render() {
const e = m("SFilterToolbar"), t = m("SFilterItem");
return a("div", { class: "demo-render" }, [
a(
e,
{ onReset: () => {
}, onToggle: () => {
} },
{
filter: () => [
a(
t,
{ label: window.$l("名称"), width: 280 },
{ default: () => a(S, { placeholder: window.$l("请输入") }) }
),
a(
t,
{ label: window.$l("状态"), width: 220 },
{ default: () => a(S, { placeholder: window.$l("请选择") }) }
)
],
filterMore: () => [
a(
t,
{ label: window.$l("备注"), full: !0 },
{
default: () => a(S, {
placeholder: window.$l("展开「更多」后才显示,full 独占一行")
})
}
)
]
}
)
]);
}
},
code: `
`
},
{
key: "s-table-toolbar",
notes: [
window.$l("单元格插槽名就是列的 dataIndex,写法与 SListLayout 一致。"),
window.$l(
"不要再写 #bodyCell:组件内部已占用它做列分发,业务再写会被忽略,表现为该列整列空白(操作列「消失」就是这个原因)。"
),
window.$l(
"父级根节点要有确定高度(height:100% + flex 纵向),组件靠 flex 接管剩余空间;不要在父级写死表格高度。"
),
window.$l("scroll.y 由组件自己算,父级传 scroll 会被忽略。"),
window.$l("ref 暴露 resize() / refresh(deleteFlag) / reload() / tableRef / scrollY。")
],
name: "STableToolbar",
title: window.$l("表格区"),
desc: window.$l(
"表格区外壳:STable + 分页 + 表体高度自适应(纯 flex 撑满剩余区域)。与 SFilterToolbar 成对使用,不会出页面级滚动条。单元格插槽与 SListLayout 一致:列 dataIndex 即插槽名,不要写 #bodyCell。"
),
demo: {
render() {
const e = m("STableToolbar"), t = [
{ title: window.$l("名称"), dataIndex: "name", ellipsis: !0 },
{ title: window.$l("状态"), dataIndex: "status", ellipsis: !0, width: 120 }
];
return a(
"div",
{ class: "demo-render", style: "height:320px;display:flex;flex-direction:column" },
[a(e, { columns: t, data: () => Promise.resolve({
pageNo: 1,
total: 3,
list: [
{ id: "1", name: window.$l("示例数据一"), status: window.$l("已生效") },
{ id: "2", name: window.$l("示例数据二"), status: window.$l("未生效") },
{ id: "3", name: window.$l("示例数据三"), status: window.$l("已生效") }
]
}), rowKey: "id", pageSize: 10 })]
);
}
},
code: `
`
},
{
key: "s-filter-table-toolbar",
name: "SFilterTableToolbar",
title: window.$l("查询 + 表格组合件"),
desc: window.$l(
"SFilterToolbar + STableToolbar 的现成组合:上半查询区、下半表格区,表格吃掉剩余高度并在内部滚动。"
),
notes: [
window.$l(
"data 传取数函数(返回 { list, total }),不是数据对象;其余属性透传给 s-table。"
),
window.$l(
"filter / filterMore 归查询区,剩下插槽(列名插槽、expandedRowRender…)全部透传给表格。"
),
window.$l("reset 只抛事件,查询参数在业务侧,清空后自己调 refresh()。"),
window.$l(
"必须放在有确定高度的容器里(SFormLayout 的 #form、SSkeletonLayout 默认插槽都行);丢进普通 div 会退化成内容高度。"
),
window.$l("ref 暴露 refresh(deleteFlag) / reload() / resize() / tableRef。")
],
code: `
修改
`
},
{
key: "s-form-layout",
notes: [
window.$l(
"#form 插槽放 SForm,#footer-callback 收 save / cancel / prev / next 四个动作。"
),
window.$l("表单作为弹窗内容时用 SModal,不要再套 SFormLayout(否则高度会被算两次)。"),
window.$l(
"多列用 :column,某一项要独占整行时加 full;单列下 full 等价于一整行,1 列与 N 列之间切换不用改代码。"
),
window.$l("column 是 SCollapsesItem 的 prop,写在 上不生效。")
],
name: "SFormLayout",
title: window.$l("表单布局"),
desc: window.$l(
"表单页布局(SFormLayout)+ 表单项(SFormItem)。表单主体必须放在 #form 插槽内。"
),
demo: {
render() {
const e = m("SFormLayout"), t = m("SFormItem"), o = { name: window.$l("张三"), remark: "" };
return a("div", { class: "demo-render", style: "height:360px" }, [
a(
e,
{
title: window.$l("表单布局示例"),
goBack: !1,
style: "height:100%",
onFooterCallback: () => {
}
},
{
form: () => a(
X,
{ model: o, layout: "vertical" },
{
default: () => [
a(
t,
{ label: window.$l("名称"), name: "name" },
{ default: () => a(S, { value: o.name }) }
),
a(
t,
{ label: window.$l("备注"), name: "remark" },
{ default: () => a(S, { value: o.remark }) }
)
]
}
)
}
)
]);
}
},
code: `
自定义按钮
// 插槽:form / collapses / anchor / otherBtns / footer / other
// 事件:footer-callback('save'|'cancel'|'prev'|'next')、tabsChange`
},
{
key: "s-icon",
name: "SIcon",
title: window.$l("图标"),
desc: window.$l("antd 图标封装。color 缺省取主题主色(--s-color),size 单位为 px。"),
demo: v("SIcon", { name: "SearchOutlined", size: 22 }),
code: ''
},
{
key: "s-icon-select",
name: "SIconSelect",
title: window.$l("图标选择"),
desc: window.$l(
"基于 a-select 的图标下拉:支持搜索、多选、可清空(required 时禁用清空),图标全量虚拟滚动。"
),
demo: H("SIconSelect", { value: "SearchOutlined" }),
code: `
`
},
{
key: "s-icon-select-popover",
name: "SIconSelectPopover",
title: window.$l("图标下拉面板"),
desc: window.$l(
"图标选择器(面板版):点击输入框弹出图标网格,支持搜索与选中高亮,适合需要直观浏览图标的场景。"
),
demo: H("SIconSelectPopover", { value: "SearchOutlined", width: 300 }),
code: ''
},
{
key: "s-icon-modal",
name: "SIconModal",
title: window.$l("图标弹窗"),
desc: window.$l(
"全量 antd 图标浏览弹窗,顶部页签按线框 / 实底 / 双色 分类并支持搜索,点击图标名可复制 标签。"
),
demo: C("SIconModal", window.$l("打开图标弹窗"), { width: 900 }),
code: ''
},
{
key: "s-svg",
name: "SSvg",
title: window.$l("SVG 图标"),
desc: window.$l(
"SVG sprite 图标(symbol 引用 #icon-{name}),依赖站点引入的 iconfont sprite 文件。"
),
code: ''
},
{
key: "s-color-picker",
name: "SColorPicker",
title: window.$l("颜色选择"),
desc: window.$l("颜色选择器:色块触发 Popover,内置常用色板 + 自定义取色,hex 格式。"),
demo: v("SColorPicker", { value: "#1677ff", width: 60 }),
code: ``
},
{
key: "s-empty",
name: "SEmpty",
title: window.$l("空状态"),
desc: window.$l("空数据占位。"),
demo: v("SEmpty", { description: window.$l("暂无数据") }),
code: ''
},
{
key: "s-tab",
notes: [
window.$l(
"两种用法:传 tabs 数组由组件渲染,或自己写 s-tab-item(需要自定义标签内容时)。"
),
window.$l(
"不传 activeKey、也不传 default-active-key 时自动选中第一项;只给标签栏,不给内容区。"
),
window.$l(
"内容自己按 activeKey 渲染,切显隐必须用 v-show 不能用 v-if —— 隐藏页签的组件实例会丢,保存时读不到勾选数据。"
),
window.$l(
"放得下不出箭头,超出才出;点箭头 = 选中上一个/下一个标签并滚进可视区,到头则退化为滚动一屏。"
),
window.$l(
"配色跟主题走,需要单独调时覆盖 --s-tab-color / --s-tab-active-color / --s-tab-disabled-color。"
)
],
name: "STab",
title: window.$l("标签栏"),
desc: window.$l(
"横向标签栏:放不下时自动出左右箭头,可按住鼠标左键拖动滑动。activeKey 未传时用 defaultActiveKey,两者都没传默认选中第一项。"
),
demo: ie({
tabs: [
{ label: window.$l("任务配置"), value: "1" },
{ label: window.$l("执行日志"), value: "2" },
{ label: window.$l("统计报表"), value: "3" },
{ label: window.$l("权限设置"), value: "4" },
{ label: window.$l("客户端管理"), value: "5" },
{ label: window.$l("告警配置"), value: "6" },
{ label: window.$l("数据字典"), value: "7" },
{ label: window.$l("外部对接"), value: "8" }
],
defaultActiveKey: "1"
}),
code: `
任务配置
执行日志
// tabs: [{ label, value }],字段名不同用 tabKey 映射
// 事件:change(key, item);插槽模式 item 为 undefined`
},
{
key: "s-cascader",
name: "SCascader",
title: window.$l("级联选择"),
desc: window.$l(
"级联选择器(options 用 fieldNames 映射,默认 label=name、value=value)。"
),
demo: v("SCascader", {
modelValue: ["hz"],
multiple: !1,
options: [
{
name: window.$l("浙江省"),
value: "zj",
children: [
{ name: window.$l("杭州市"), value: "hz" },
{ name: window.$l("宁波市"), value: "nb" }
]
},
{
name: window.$l("江苏省"),
value: "js",
children: [{ name: window.$l("南京市"), value: "nj" }]
}
]
}),
code: `
// options: { name, value, children: [...] }(fieldNames 默认 label=name、value=value)`
},
{
key: "s-tree",
notes: [
window.$l("height 默认不传、自适应父容器;写死 height 会让树被截断并出现内层滚动条。"),
window.$l("横向超长自动省略,样式统一走 --s-tree-* 变量,页面里不要写 scoped 副本。"),
window.$l(
"常用变量:--s-tree-node-height / --s-tree-row-gap / --s-tree-selected-bg / --s-tree-hover-bg,换主题色时按需覆盖。"
),
window.$l(
"放进左侧栏时容器加 .side.s-side-tree(SListLayout / SListTableTreeLayout 已内置),不要在页面里自己算高度。"
)
],
name: "STree",
title: window.$l("树"),
desc: window.$l(
"树组件,数据通过 levelTwoChildren()/levelOneChildren(id) 异步获取(这里用基座真实组织树接口)。"
),
demo: v("STree", {
expandAll: !0,
checkable: !0,
levelTwoChildren: (e) => j(e),
levelOneChildren: (e) => B(e)
}),
code: `import { levelTwoChildren, levelOneChildren } from '@p/api/common'
`
},
{
key: "s-tree-select",
notes: [
window.$l("下拉弹层里的树与 STree 共用同一套 --s-tree-* 变量,样式不用另配。"),
window.$l("数据权限范围选择直接用 SDataRangeTreeSelect,不用自己拼组织树。")
],
name: "STreeSelect",
title: window.$l("树选择"),
desc: window.$l(
"树形下拉选择,数据通过 recursionChildren(pid, excludeIds) 异步获取(与树组件同源)。"
),
demo: v("STreeSelect", {
multiple: !1,
expandAll: !0,
recursionChildren: () => P(this, null, function* () {
return [
{
id: "1",
name: window.$l("研发部"),
value: "1",
children: [
{ id: "1-1", name: window.$l("前端组"), value: "1-1", children: [] },
{ id: "1-2", name: window.$l("后端组"), value: "1-2", children: [] }
]
},
{ id: "2", name: window.$l("行政部"), value: "2", children: [] }
];
})
}),
code: ``
},
{
key: "s-file-upload",
name: "SFileUpload",
title: window.$l("文件上传"),
desc: window.$l(
'文件上传/回显列表。listType="card"(默认)图片显示原图、其他类型显示文件类型;listType="list" 每行显示文件类型、文件名与预览/下载/删除按钮(均为图标)。detailMode 为详情只读:隐藏新增入口、禁止删除与拖拽,只保留预览与下载;showPreview / showDownload / showRemove 可单独控制三个按钮显隐,@download 回传被点击的列表项。'
),
demo: v("SFileUpload", {
label: window.$l("附件"),
listType: "list",
list: [
{
uid: "demo-1",
name: "示例附件.pdf",
imageUrl: "/files/demo.pdf",
url: "/files/demo.pdf"
},
{
uid: "demo-2",
name: "示例附件.xlsx",
imageUrl: "/files/demo.xlsx",
url: "/files/demo.xlsx"
}
]
}),
code: `
`
},
{
key: "s-dragger-upload",
name: "SDraggerUpload",
title: window.$l("拖拽上传"),
desc: window.$l(
"拖拽上传区域。与 SFileUpload 同一套实现与参数,listType(card / list)、detailMode(详情只读)、showPreview / showDownload / showRemove(按钮显隐)用法完全一致。"
),
demo: v("SDraggerUpload", { listType: "list", list: [] }),
code: ''
},
{
key: "s-copper-upload",
name: "SCopperUpload",
title: window.$l("头像/裁剪上传"),
desc: window.$l(
'选图后逐张弹出裁剪框,裁剪结果再统一上传。aspectRatio 控制比例:1(1:1 头像)、"16:9"(封面)、0(自由裁剪);取消某张直接跳过该张,@handChange 回传文件列表。同样支持 listType(card / list)、detailMode(详情只读)与 showPreview / showDownload / showRemove 按钮显隐。'
),
demo: v("SCopperUpload", { list: [], aspectRatio: 1 }),
code: `
// aspectRatio:1 = 1:1 头像;"16:9" = 封面;0 = 自由裁剪
// :crop="false" 关闭裁剪,退回原图直传
// list-type="list" + detail-mode 可做成详情页的只读文件列表
// 内部裁剪弹窗 CropperModal 为内部组件,不直接使用`
},
{
key: "s-editor",
name: "SEditor",
title: window.$l("富文本"),
desc: window.$l("基于 jodit 的富文本编辑器。"),
demo: v("SEditor", { value: window.$l("富文本示例
") }),
code: ''
},
{
key: "s-skeleton-layout",
name: "SSkeletonLayout",
title: window.$l("骨架布局"),
desc: window.$l(
"页面级「标题条 + 按钮组 + 内容区」骨架,不带表格、表单与分页,内容区完全由插槽决定。"
),
notes: [
window.$l(
"buttons 每项 { key, name, icon, action, show, disabled, type };key 为 add 时按钮自动 primary。"
),
window.$l(
"icon 传 true 时按 key 查内置图标(add / edit / delete / remove / import / export / assign / execute / pause / resume / approve / setting / TopOfType / TOP / synchronize),也可直接写图标组件名。"
),
window.$l("action 是 v-action 权限码,不写就用 key;没权限的按钮会被移除,不是置灰。"),
window.$l("点击抛 btnCallback(key),业务按 key 分发。"),
window.$l(
"另有 subTitle / tabs / steps 三个可选 props;高度靠 flex 撑满,父容器要有确定高度(放在路由页面里即可)。"
)
],
code: `
内容区
`
},
{
key: "s-list-layout",
name: "SListLayout",
title: window.$l("列表布局"),
desc: window.$l("列表页标准布局:标题、按钮、筛选区、表格、分页。"),
demo: {
render() {
const e = m("SListLayout"), t = m("SFilterWrap"), o = m("SFilterItem");
return a("div", { class: "demo-render", style: "height:360px" }, [
a(
e,
{
title: window.$l("基础列表示例"),
columns: A(),
buttons: [
{
name: window.$l("添加"),
key: "add",
show: !0,
type: "primary",
icon: !0
},
{
name: window.$l("批量删除"),
key: "remove",
action: "remove",
show: !0,
icon: !0
}
],
loadData: x
},
{
filter: () => a(t, null, {
default: () => [
a(
o,
{ label: window.$l("名称") },
{ default: () => a(S, { placeholder: window.$l("请输入名称") }) }
),
a(
o,
{ label: window.$l("状态") },
{ default: () => a(S, { placeholder: window.$l("请选择") }) }
)
]
}),
filterMore: () => a(
t,
{ type: "filter-more" },
{
default: () => [
a(
o,
{ label: window.$l("更多条件一"), mb: 10 },
{ default: () => a(S, { placeholder: window.$l("请输入") }) }
),
a(
o,
{ label: window.$l("更多条件二"), mb: 10 },
{ default: () => a(S, { placeholder: window.$l("请输入") }) }
)
]
}
),
action: ({ record: w }) => a("div", [
a("a", { onClick: () => {
} }, window.$l("修改")),
a("span", { style: "margin:0 8px;color:var(--s-border-color-light)" }, "|"),
a(
"a",
{ style: "color:var(--s-color-error)", onClick: () => {
} },
window.$l("删除")
)
]),
otherBtns: () => a(Z, { style: "margin-left:8px" }, window.$l("自定义按钮"))
}
)
]);
}
},
code: `
修改
删除
提交审核
// columns 项:{ title, dataIndex, width, ellipsis, align, isClick, template, customRender }
// isClick:true → 该列可点击,触发 @tableColCallback
// template:true → 用同名插槽渲染(如 #name / #action)
// buttons 项:{ name, key, action, show, disabled, type, icon, confirm, selection, api }
// 方法(ref):reload() 刷新;setStateBtn(key|keys, {disabled,icon,show}) 改按钮状态;sethsitoryPath()`
},
{
key: "s-list-card-layout",
notes: [
window.$l("三个插槽作用域都是 { item, index }:cardHeader / default / cardFooter。"),
window.$l(
"cardFooter 不传时是默认「编辑 / 删除」,点击抛 card-action(key, item, index)。"
),
window.$l(
"取数入参 ({ pageNo, pageSize }),返回 { list, total };也兼容 data / pagination.total / totalCount。"
),
window.$l("rowKey 取不到值时退回下标,列表有排序或增删时要保证 rowKey 稳定。")
],
name: "SListCardLayout",
title: window.$l("卡片列表"),
desc: window.$l(
"卡片形式的列表布局:横向按列排布(column 控制每行个数,默认 5)、卡片正方形(宽高一致、圆角 8px),内容 / 头部 / 底部全部由插槽控制。"
),
demo: {
render() {
const e = m("SListCardLayout");
return a("div", { class: "demo-render", style: "height:460px" }, [
a(
e,
{
title: window.$l("卡片列表"),
style: "height:100%",
buttons: [
{
name: window.$l("添加"),
key: "add",
show: !0,
type: "primary",
icon: !0
}
],
loadData: me
},
{
// 不传 header 插槽时,标题取数据项 title;title 也为空则不渲染 header
default: ({ item: t }) => a("div", { style: "color:var(--s-text-color-regular);line-height:24px" }, [
a("div", `${window.$l("名称")}:${t.name}`),
a("div", `${window.$l("校区")}:${t.campusName}`)
])
// 不传 footer 插槽时,底部是默认按钮区(编辑 / 删除),点击抛 @cardAction
}
)
]);
}
},
code: `
{{ item.title }}
...
编辑
`
},
{
key: "s-list-table-tree-layout",
name: "SListTableTreeLayout",
title: window.$l("树表布局"),
desc: window.$l("左树右表的列表布局:右侧表格 + 左侧 #tree 插槽。"),
demo: {
render() {
const e = m("SListTableTreeLayout"), t = m("STree");
return a("div", { class: "demo-render", style: "height:360px" }, [
a(
e,
{
title: window.$l("树表"),
style: "height:100%",
columns: A(),
loadData: x
},
{
tree: () => a(t, {
expandAll: !0,
levelTwoChildren: (o) => j(o),
levelOneChildren: (o) => B(o)
})
}
)
]);
}
},
code: `
`
},
{
key: "s-super-list-layout",
notes: [
window.$l(
"右上角两个抽屉都是「草稿 + 确定生效」:抽屉里改的是副本,点确定才回写并刷新,关闭直接丢弃。"
),
window.$l("只有配了 filterConfig 的列才会出现在高级搜索里;列被隐藏后仍可参与筛选。"),
window.$l(
"filterType 可选:INPUT / INT / FLOAT / DATE / DATETIME / SINGLE_SELECT / MULTIPLE_SELECT / GANDER / IS / USER / OFFICE;下拉选项优先取 filterData,没配才用 filterApi。"
),
window.$l(
"提交取数时除 filterConditions 外,equal / includes 这类单值条件会铺平成同名字段,后端可直接按字段名取用。"
),
window.$l("列宽写 px 或纯数字才带进「高级表格」的列宽输入框,写百分比只作表头宽度。")
],
name: "SSuperListLayout",
title: window.$l("高级列表"),
desc: window.$l(
"高级列表布局:右上角「高级表格」改列(显示 / 隐藏、冻结 / 取消冻结、列宽),「高级搜索」加条件。两个抽屉都是草稿 + 确定生效,关闭即丢弃。"
),
demo: {
render() {
const e = m("SSuperListLayout");
return a("div", { class: "demo-render", style: "height:360px" }, [
a(e, {
title: window.$l("高级列表"),
style: "height:100%",
columns: A(),
buttons: [
{ name: window.$l("添加"), key: "add", show: !0, type: "primary", icon: !0 }
],
loadData: x
})
]);
}
},
code: `
// columns 里配 filterConfig 的列才会进「高级搜索」的可选字段;
// width 为 px / 数字时带入「高级表格」的列宽输入框,% 宽度不带入。
// 高级筛选结果合并进取数入参:loadData({ pageNo, pageSize, filterMode, filterConditions })`
},
{
key: "s-data-range-tree-select",
name: "SDataRangeTreeSelect",
title: window.$l("数据权限范围选择"),
desc: window.$l(
"数据权限(组织 / 校区 / 单位)范围选择,内置组织树加载与系统 dataScope 配置读取。"
),
notes: [
window.$l(
"回显必须先 getOfficeByIds(ids) 转成 { label, value } 节点对象再赋值;直接赋 id 字符串会告警,输入框还会显示成裸 ID。"
),
window.$l(
"multiple / treeCheckable 决定单选还是多选;maxTagCount 控制最多显示几个 tag(默认 1)。"
),
window.$l(
"disabledGroup 控制哪些层级不可选:1 组织 / 2 校区 / 3 单位,可传字符串或数组。"
),
window.$l(
"autoSysConfig 为 true 时自动读系统 dataScope 配置;treeSelectData 传数组则完全不请求接口。"
),
window.$l("change 与 update:value 输出的都是 id 数组。")
],
code: ``
},
{
key: "s-user-select",
name: "SUserSelect",
title: window.$l("人员选择"),
desc: window.$l(
"人员选择:只读输入框 + 弹窗(左组织树 + 右人员列表),依赖后端组织架构接口。"
),
demo: v("SUserSelect", { multiple: !0, placeholder: window.$l("点击选择人员") }),
code: ''
},
{
key: "s-user-select-button",
name: "SUserSelectButton",
title: window.$l("人员选择按钮"),
desc: window.$l(
"按钮形态的人员选择:点击按钮弹窗选择,选中值与 s-user-select 一致(单选字符串/多选数组)。"
),
demo: v("SUserSelectButton", { multiple: !0, buttonText: window.$l("选择人员") }),
code: ``
},
{
key: "s-office-select",
name: "SOfficeSelect",
title: window.$l("岗位/组织选择"),
desc: window.$l("岗位/组织选择:只读输入框 + 弹窗,依赖后端组织架构接口。"),
demo: v("SOfficeSelect", {
multiple: !0,
placeholder: window.$l("点击选择岗位/组织")
}),
code: ''
},
{
key: "s-choose-user",
notes: [
window.$l(
"显隐用 v-model:value;已选 id 多选用 v-model:selectedIds,单选用 v-model:selectedId。"
),
window.$l("确认与取消都会自动关闭弹窗,业务不用手动置 false。"),
window.$l(
"@callback 确认时回抛选中对象数组(单选也是单元素数组,含 id/name/cover/userid/company/department),关闭时不带参数。"
),
window.$l(
"接口走带数据权限的版本(按登录人权限过滤),业务不用传接口;没有后端的环境里树和列表为空是正常的。"
),
window.$l(
"和 SUserSelect 的区别:SUserSelect 是「输入框 + 弹窗」一体并直接绑 id;本组件是纯弹窗、自带人员类型过滤与数据权限。"
)
],
name: "SChooseUser",
title: window.$l("选择人员弹窗(带数据权限)"),
desc: window.$l(
"弹窗式人员选择(纯弹窗,无输入框,显隐由业务控制):左侧带数据权限的组织树 + 右侧人员列表,内置人员类型过滤(教职工/学生/校外人员),确认后自动关闭。callback 回抛选中对象数组。依赖后端接口,预览中无数据属正常。"
),
demo: C("SChooseUser", window.$l("打开选人弹窗"), { multiple: !0 }),
code: `
// 确认: payload = [{ id, name, cover, userid }];关闭: payload = undefined`
},
{
key: "s-below-choose-position",
notes: [
window.$l(
"查的是岗位:左树一次性拉「根节点及其以下所有单位」,范围由 rootId 决定;rootId 变化会自动重载左树。"
),
window.$l("确认后不自动关窗,必须在 callback 里自己把 visible 置 false。"),
window.$l(
"@callback 的载荷是对象:确认 { selectedList } 或 { selected },取消/关闭是 false —— 与 SChooseUser 的数组不同,两个写法不能混用。"
),
window.$l(
"回显走 getPositionByIds / getPositionById;也可以 ref 调 initLeftTreeData(id) 手动重载左树。"
)
],
name: "SBelowChoosePosition",
title: window.$l("选择岗位弹窗"),
desc: window.$l(
"弹窗式岗位选择:左侧 getBelowUnit 全量组织树(rootId 决定范围)+ 右侧岗位列表。确认后不自动关闭,业务在 callback 中自行关闭;callback 回抛 { selectedList }(多选)/ { selected }(单选)。依赖后端接口,预览中无数据属正常。"
),
demo: C("SBelowChoosePosition", window.$l("打开选岗位弹窗"), { multiple: !0 }),
code: `
// 确认: payload = { selectedList: [...] };关闭: payload = false`
},
{
key: "s-side-menu",
name: "SSideMenu",
title: window.$l("左侧菜单"),
desc: window.$l("侧边菜单(读取基座 store 的动态菜单/静态路由);此处注入示例菜单。"),
demo: {
render() {
K();
const e = m("SSideMenu");
return a(
"div",
{
class: "demo-render",
style: "width:210px;border-right:1px solid var(--s-border-color-split)"
},
[a(e)]
);
}
},
code: `// 基座布局内使用:菜单来自后端权限菜单 + $staticRoutes
`
},
{
key: "s-top-menu",
name: "STopMenu",
title: window.$l("顶部菜单"),
desc: window.$l("顶部菜单(基座布局内使用);此处注入示例菜单。"),
demo: {
render() {
K();
const e = m("STopMenu");
return a("div", { class: "demo-render", style: "height:360px" }, [a(e)]);
}
},
code: `// 基座布局内使用
`
},
{
key: "s-toggle-language",
name: "SToggleLanguage",
title: window.$l("语言切换"),
desc: window.$l(
"中英文切换按钮(VITE_APP_LANG_ENABLE=true 时显示;切换后写本地缓存 lang 并整页刷新)。注意:预览中点击会真实刷新页面。"
),
demo: v("SToggleLanguage", { blockType: "button" }),
code: ''
},
{
key: "inner-components",
name: "Inner",
title: window.$l("内部辅助组件"),
desc: window.$l(
"以下组件为其它组件/布局的内部实现,不对外直接使用:ModalHeader(SModal 头部)、CropperModal(SCopperUpload 裁剪弹窗)、CustomInput / SettingColumns / SettingFilter(SSuperListLayout 的自定义列与筛选抽屉)。"
),
code: `// 源码位置
packages/components/SModal/components/ModalHeader.vue
packages/components/SFileUpload/CropperModal.vue
packages/components/SSuperListLayout/Drawer/{CustomInput, SettingColumns, SettingFilter}.vue`
},
{
key: "s-anchor",
name: "SAnchor",
title: window.$l("锚点"),
desc: window.$l("锚点导航,自动收集容器内 .s-collapses-item-title 生成锚点。"),
demo: {
render() {
const e = m("SAnchor"), t = m("SCollapses"), o = m("SCollapsesItem");
return a("div", { class: "demo-render", style: "height:360px" }, [
a(
"div",
{ id: "form-container", style: "position:relative;height:320px;overflow:auto" },
[
a(t, null, {
default: () => [
a(
o,
{ title: window.$l("基本信息") },
{
default: () => a("div", { style: "height:200px" }, window.$l("内容 1"))
}
),
a(
o,
{ title: window.$l("详细配置") },
{
default: () => a("div", { style: "height:200px" }, window.$l("内容 2"))
}
)
]
}),
a(e)
]
)
]);
}
},
code: `
...
...
`
},
{
key: "s-extend-fields-form",
name: "SExtendFieldsForm",
title: window.$l("动态扩展字段表单"),
desc: window.$l(
"按后端下发的字段配置(fillModeConfig JSON)动态渲染表单,新增 / 编辑 / 查看共用一套。"
),
notes: [
window.$l("type 取 add / edit / view,view 不做校验。"),
window.$l(
"编辑态回显传 defaultValue([{ fieldCode, value }]);值按 showType 转类型:日期 → dayjs 对象、数字 → Number、多选 → 逗号切数组。"
),
window.$l("textarea、upload、多选 select 自动独占整行,其余按 column 分列。"),
window.$l(
"ref 暴露 validate()(返回 Promise)、clearValidate()、getModel()(返回 [{ fieldCode, value }],对象值已 JSON.stringify)。"
)
],
code: `
// 保存前
const ok = await extRef.value.validate()
const model = extRef.value.getModel()`
},
{
key: "s-import-modal",
notes: [
window.$l(
"三步式:上传文件 → 数据预览(可增删改行)→ 导入结果(异常数据可导出);文件限 .xls/.xlsx、≤ 500KB。"
),
window.$l(
"打开用 ref 调 show(),内部会重置状态;uploadUrl 传完整网关地址(如 /monitor/DeviceInfo/Uploader)。"
),
window.$l(
"apis 传四个接口:templateDownload / importPreview / importData / exportExceptionData,组件兼容 { code, data } 与直接返回数据两种格式。"
),
window.$l(
"导入时要附带业务参数(如设备分类)就传 typeSelect,选中值以 extraKey 随各接口一起提交,默认字段名 deviceTypeId。"
),
window.$l(
"和「选文件即导入」的单步式导入组件不是同一个东西,接口与事件契约都不同,不能互相替换。"
)
],
name: "SImportModal",
title: window.$l("批量导入弹窗"),
desc: window.$l(
"三步式通用批量导入:上传文件 -> 数据预览(可编辑/删除行)-> 导入结果(含异常数据导出)。四个导入接口由业务传入。"
),
demo: C("SImportModal", window.$l("打开导入弹窗"), {
title: window.$l("批量导入"),
columns: we(),
apis: ce
}),
code: `
// 打开
importModalRef.value.show()
// 四个接口(业务 api 文件夹提供,返回 Promise)
const importApis = { templateDownload, importPreview, importData, exportExceptionData }
// 预览/结果表格列
const importColumns = [{ title: window.$l('设备SN码'), dataIndex: 'sn', width: 150 }]
// 可选:导入时附带的业务参数下拉(选中值以 extraKey 随各接口一起提交)
const importTypeSelect = computed(() => ({
options: [{ label: window.$l('摄像头'), value: '1' }],
placeholder: window.$l('选择设备分类')
}))`
},
{
key: "table",
name: "Table",
title: window.$l("表格"),
desc: window.$l("增强表格(.jsx,未全局注册,需手动引入)。"),
code: `import Table from 'sapit-ui-plus/lib/js/Table.js'
// 或按项目实际路径引入后局部注册`
}
])
};
},
computed: {
filterNames() {
const e = this.keyword.trim().toLowerCase();
return e ? this.list.filter(
(t) => t.title.toLowerCase().includes(e) || t.name.toLowerCase().includes(e)
) : this.list;
},
current() {
return this.list.find((e) => e.key === this.active) || null;
},
// 当前组件是否走「多示例」渲染(demos 数组)
hasDemos() {
return !!(this.current && Array.isArray(this.current.demos) && this.current.demos.length);
}
},
errorCaptured(e) {
return this.error = e && e.message || String(e), !1;
},
methods: {
// 示例代码块:英文模式下把代码里的中文按字典翻译;中文模式原样返回
lcode(e) {
if (typeof e != "string" || !/[\u4e00-\u9fa5]/.test(e)) return e;
const t = (o) => {
const w = String(o).trim();
if (!w) return o;
const i = window.$l(w);
return i === w ? o : o.replace(w, i);
};
return e.split(`
`).map((o) => {
let w = o.replace(//g, (d, u) => "");
const i = w.indexOf("//");
return i >= 0 && w[i - 1] !== ":" && /[\u4e00-\u9fa5]/.test(w.slice(i)) && (w = w.slice(0, i + 2) + t(w.slice(i + 2))), w = w.replace(
/(["'])([^"'\n]*[\u4e00-\u9fa5][^"'\n]*)\1/g,
(d, u, $) => u + t($) + u
), w = w.replace(
/>([^<>\n]*[\u4e00-\u9fa5][^<>\n]*) ">" + t(u) + "<"
), w = w.replace(
/[\u4e00-\u9fa5][\u4e00-\u9fa5:,。、;;()()【】《》…\-_/]*/g,
(d) => t(d)
), w;
}).join(`
`);
},
select(e) {
return P(this, null, function* () {
this.active = e.key, this.error = "", this.propsDefs = [], this.propsObj = {}, this.events = [], this.methodsList = [], this.slots = ae[e.name] || [], this.renderKey++;
const t = this.loaders[e.name];
if (t)
try {
const o = (yield t()).default;
this.propsDefs = this.extractProps(o);
const w = {};
this.propsDefs.forEach((u) => {
u.hasDefault && (w[u.name] = u.defaultRaw);
}), this.propsObj = w;
const i = o && (o.emits || o.default && o.default.emits);
Array.isArray(i) ? this.events = i.filter((u) => typeof u == "string").map((u) => ({ name: u })) : i && typeof i == "object" && (this.events = Object.keys(i).map((u) => ({ name: u })));
const d = o && (o.methods || o.default && o.default.methods);
this.methodsList = d ? Object.keys(d) : [], this.renderKey++;
} catch (o) {
this.error = window.$l("加载组件失败:") + (o && o.message || o);
}
});
},
extractProps(e) {
const t = e && (e.props || e.default && e.default.props) || {}, o = [];
return Object.keys(t).forEach((w) => {
const i = t[w], d = i && typeof i == "object" && !Array.isArray(i) ? i : { type: i };
let u = "-", $ = !1, p;
if (d && "default" in d) {
$ = !0;
const k = d.default;
p = typeof k == "function" && d.type !== Function ? ne(k) : k, u = typeof p == "object" ? JSON.stringify(p) : String(p);
} else D(d.type).includes("Boolean") && ($ = !0, p = !1, u = "false");
o.push({
name: w,
type: D(d.type),
default: u,
hasDefault: $,
defaultRaw: p,
required: !!d.required,
desc: d.description || d.desc || "",
value: $ ? typeof p == "object" ? JSON.stringify(p) : String(p == null ? "" : p) : ""
});
}), o;
},
applyValue(e) {
const t = e.type || "";
let o = e.value;
if (t.includes("Number")) o = o === "" ? void 0 : Number(o);
else if (t.includes("Boolean")) o = o === "true" || o === !0;
else if (t.includes("String")) o = String(o);
else
try {
o = o === "" ? void 0 : JSON.parse(o);
} catch (w) {
o = String(o);
}
this.propsObj = E(I({}, this.propsObj), { [e.name]: o }), this.renderKey++;
}
},
mounted() {
const e = {};
Object.keys(G).forEach((t) => {
const o = t.slice(t.lastIndexOf("/") + 1, t.lastIndexOf("."));
e[o] || (e[o] = G[t]);
}), this.loaders = e, this.list.length && this.select(this.list[0]);
}
}, pe = { class: "s-docs-page" }, ve = { class: "sd-main" }, $e = {
key: 0,
class: "sd-side"
}, he = { class: "side-search" }, fe = ["placeholder"], ye = { class: "side-title" }, Se = ["onClick"], be = {
key: 1,
class: "sd-content"
}, ge = { class: "title" }, ke = { class: "en" }, _e = { class: "lead" }, Te = {
key: 0,
class: "block"
}, Ce = { class: "block-title" }, Ie = { class: "notes" }, Ee = { class: "block" }, Pe = { class: "block-title" }, Le = { class: "demo-item-title" }, xe = {
key: 0,
class: "demo-item-desc"
}, Ae = { class: "preview" }, De = {
key: 1,
class: "muted"
}, Me = {
key: 1,
class: "code"
}, Fe = {
key: 1,
class: "preview"
}, Ve = {
key: 1,
class: "muted"
}, Ne = {
key: 2,
class: "err"
}, Ue = { class: "block" }, Oe = { class: "block-title" }, Re = { class: "props-table" }, Be = { class: "desc-cell" }, je = ["onUpdate:modelValue", "onChange"], Ke = { key: 0 }, Ge = {
colspan: "6",
class: "muted"
}, He = {
key: 1,
class: "block"
}, ze = { class: "block-title" }, We = { class: "info-table" }, qe = {
key: 2,
class: "block"
}, Je = { class: "block-title" }, Ye = { class: "info-table" }, Qe = {
key: 3,
class: "block"
}, Xe = { class: "block-title" }, Ze = { class: "info-table" }, el = {
key: 4,
class: "block"
}, ll = { class: "block-title" }, tl = { class: "code" }, ol = {
key: 1,
class: "empty"
}, al = {
key: 2,
class: "sd-content"
}, nl = { class: "title" }, il = { class: "lead" }, sl = { class: "block" }, dl = { class: "block-title" }, rl = { class: "lead" }, cl = { class: "info-table" }, wl = { style: { width: "220px" } }, ml = { style: { width: "140px" } }, ul = { class: "block" }, pl = { class: "block-title" }, vl = { class: "info-table" }, $l = { style: { width: "260px" } }, hl = { style: { width: "200px" } }, fl = { class: "block" }, yl = { class: "block-title" }, Sl = { class: "group-title" }, bl = { class: "info-table" }, gl = { style: { width: "320px" } };
function kl(e, t, o, w, i, d) {
const u = m("router-link"), $ = oe, p = m("s-panel-layout"), k = m("docs-back-top");
return r(), c(h, null, [
_(p, {
title: "sapit-ui 基座组件",
headerSticky: !0,
height: "100vh"
}, {
extra: T(() => [
_(u, {
class: "nav-item",
to: "/"
}, {
default: T(() => [
g(n(e.$l("首页")), 1)
]),
_: 1
}),
_($, { type: "vertical" }),
_(u, {
class: "nav-item",
to: "/docs"
}, {
default: T(() => [
g(n(e.$l("说明文档")), 1)
]),
_: 1
}),
_($, { type: "vertical" }),
_(u, {
class: L(["nav-item", { active: i.view === "components" }]),
onClick: t[0] || (t[0] = (s) => i.view = "components")
}, {
default: T(() => [
g(n(e.$l("组件")), 1)
]),
_: 1
}, 8, ["class"]),
_($, { type: "vertical" }),
_(u, {
class: L(["nav-item", { active: i.view === "tools" }]),
onClick: t[1] || (t[1] = (s) => i.view = "tools")
}, {
default: T(() => [
g(n(e.$l("工具/配置")), 1)
]),
_: 1
}, 8, ["class"])
]),
default: T(() => [
l("div", pe, [
l("div", ve, [
i.view === "components" ? (r(), c("aside", $e, [
l("div", he, [
N(l("input", {
"onUpdate:modelValue": t[2] || (t[2] = (s) => i.keyword = s),
placeholder: e.$l("搜索组件")
}, null, 8, fe), [
[U, i.keyword]
])
]),
l("div", ye, n(e.$l("组件")) + " · " + n(d.filterNames.length), 1),
l("ul", null, [
(r(!0), c(h, null, b(d.filterNames, (s) => (r(), c("li", {
key: s.key,
class: L({ active: i.active === s.key }),
onClick: (f) => d.select(s)
}, n(s.title), 11, Se))), 128))
])
])) : y("", !0),
i.view === "components" ? (r(), c("section", be, [
d.current ? (r(), c(h, { key: 0 }, [
l("h1", ge, [
g(n(d.current.title) + " ", 1),
l("span", ke, n(d.current.name), 1)
]),
l("p", _e, n(d.current.desc), 1),
d.current.notes && d.current.notes.length ? (r(), c("div", Te, [
l("div", Ce, n(e.$l("使用说明")), 1),
l("ul", Ie, [
(r(!0), c(h, null, b(d.current.notes, (s, f) => (r(), c("li", { key: f }, n(s), 1))), 128))
])
])) : y("", !0),
l("div", Ee, [
l("div", Pe, n(e.$l("预览")), 1),
d.hasDemos ? (r(!0), c(h, { key: 0 }, b(d.current.demos, (s, f) => (r(), c("div", {
class: "demo-item",
key: f
}, [
l("div", Le, n(s.label), 1),
s.desc ? (r(), c("p", xe, n(s.desc), 1)) : y("", !0),
l("div", Ae, [
s.demo ? (r(), O(R(s.demo), {
key: i.renderKey + "-" + f
})) : (r(), c("span", De, n(e.$l("该示例暂无独立预览,见下方示例代码。")), 1))
]),
s.code ? (r(), c("pre", Me, [
l("code", null, n(d.lcode(s.code)), 1)
])) : y("", !0)
]))), 128)) : (r(), c("div", Fe, [
d.current.demo ? (r(), O(R(d.current.demo), { key: i.renderKey })) : (r(), c("span", Ve, n(e.$l("该组件为内部布局组件,暂无独立预览,见下方示例代码。")), 1))
])),
i.error ? (r(), c("div", Ne, n(e.$l("渲染出错:")) + n(i.error), 1)) : y("", !0)
]),
l("div", Ue, [
l("div", Oe, n(e.$l("属性(props)")), 1),
l("table", Re, [
l("thead", null, [
l("tr", null, [
l("th", null, n(e.$l("属性")), 1),
l("th", null, n(e.$l("类型")), 1),
l("th", null, n(e.$l("默认值")), 1),
l("th", null, n(e.$l("必填")), 1),
l("th", null, n(e.$l("说明")), 1),
l("th", null, n(e.$l("值(可编辑,实时预览)")), 1)
])
]),
l("tbody", null, [
(r(!0), c(h, null, b(i.propsDefs, (s) => (r(), c("tr", {
key: s.name
}, [
l("td", null, [
l("code", null, n(s.name), 1)
]),
l("td", null, n(s.type), 1),
l("td", null, n(s.default), 1),
l("td", null, n(s.required ? e.$l("是") : e.$l("否")), 1),
l("td", null, [
l("span", Be, n(s.desc), 1)
]),
l("td", null, [
N(l("input", {
class: "val-input",
"onUpdate:modelValue": (f) => s.value = f,
onChange: (f) => d.applyValue(s)
}, null, 40, je), [
[U, s.value]
])
])
]))), 128)),
i.propsDefs.length ? y("", !0) : (r(), c("tr", Ke, [
l("td", Ge, n(e.$l("该组件未声明 props")), 1)
]))
])
])
]),
i.events.length ? (r(), c("div", He, [
l("div", ze, n(e.$l("事件(events)")), 1),
l("table", We, [
l("thead", null, [
l("tr", null, [
l("th", null, n(e.$l("事件名")), 1),
l("th", null, n(e.$l("说明")), 1)
])
]),
l("tbody", null, [
(r(!0), c(h, null, b(i.events, (s) => (r(), c("tr", {
key: s.name
}, [
l("td", null, [
l("code", null, n(s.name), 1)
]),
t[3] || (t[3] = l("td", null, null, -1))
]))), 128))
])
])
])) : y("", !0),
i.methodsList.length ? (r(), c("div", qe, [
l("div", Je, n(e.$l("方法(methods,通过 ref 调用)")), 1),
l("table", Ye, [
l("thead", null, [
l("tr", null, [
l("th", null, n(e.$l("方法名")), 1),
l("th", null, n(e.$l("说明")), 1)
])
]),
l("tbody", null, [
(r(!0), c(h, null, b(i.methodsList, (s) => (r(), c("tr", { key: s }, [
l("td", null, [
l("code", null, n(s), 1)
]),
t[4] || (t[4] = l("td", null, null, -1))
]))), 128))
])
])
])) : y("", !0),
i.slots.length ? (r(), c("div", Qe, [
l("div", Xe, n(e.$l("插槽(slots)")), 1),
l("table", Ze, [
l("thead", null, [
l("tr", null, [
l("th", null, n(e.$l("插槽名")), 1),
l("th", null, n(e.$l("说明")), 1)
])
]),
l("tbody", null, [
(r(!0), c(h, null, b(i.slots, (s) => (r(), c("tr", {
key: s.name
}, [
l("td", null, [
l("code", null, n(s.name), 1)
]),
l("td", null, n(s.desc), 1)
]))), 128))
])
])
])) : y("", !0),
d.current.code || !d.hasDemos ? (r(), c("div", el, [
l("div", ll, n(e.$l("源码 / 示例")), 1),
l("pre", tl, [
l("code", null, n(d.lcode(d.current.code)), 1)
])
])) : y("", !0)
], 64)) : (r(), c("div", ol, n(e.$l("左侧选择一个组件查看预览、属性与源码。")), 1))
])) : y("", !0),
i.view === "tools" ? (r(), c("section", al, [
l("h1", nl, [
g(n(e.$l("工具 / 配置")) + " ", 1),
t[5] || (t[5] = l("span", { class: "en" }, "$utils & web-config", -1))
]),
l("p", il, n(e.$l("基座初始化($registerGlobalConfig)后可用:模板 / this.$xxx / window.$xxx。")) + " " + n(e.$l(
"配置优先级:基座默认 < 业务 web-config.js < .env(写入 config.json)< 部署目录 config.json(运行时覆盖,改完刷新即生效)。"
)) + " " + n(e.$l('.env 中的 "true"/"false" 字符串会被归一为布尔。')), 1),
l("div", sl, [
l("div", dl, n(e.$l("内置依赖(业务开箱即用,无需再安装)")), 1),
l("p", rl, [
g(n(e.$l("随")), 1),
t[6] || (t[6] = l("code", null, "sapit-ui-plus", -1)),
g(" " + n(e.$l("一起装进业务 node_modules,可直接")) + " ", 1),
t[7] || (t[7] = l("code", null, "import", -1)),
t[8] || (t[8] = g("。 ", -1)),
l("b", null, n(e.$l("vue / vue-router / pinia / vue-i18n / ant-design-vue 为单例依赖")), 1),
g(n(e.$l(",基座不打包,业务必须自己安装且版本以基座为准。")), 1)
]),
l("table", cl, [
l("thead", null, [
l("tr", null, [
l("th", wl, n(e.$l("依赖")), 1),
l("th", ml, n(e.$l("版本")), 1),
l("th", null, n(e.$l("用途")), 1)
])
]),
l("tbody", null, [
(r(!0), c(h, null, b(i.depRows, (s) => (r(), c("tr", {
key: s.name
}, [
l("td", null, [
l("code", null, n(s.name), 1)
]),
l("td", null, n(s.ver), 1),
l("td", null, n(s.desc), 1)
]))), 128))
])
])
]),
l("div", ul, [
l("div", pl, n(e.$l("web-config 配置项(VITE_APP_*)")), 1),
l("table", vl, [
l("thead", null, [
l("tr", null, [
l("th", $l, n(e.$l("配置项")), 1),
l("th", hl, n(e.$l("默认值")), 1),
l("th", null, n(e.$l("说明")), 1)
])
]),
l("tbody", null, [
(r(!0), c(h, null, b(i.configRows, (s) => (r(), c("tr", {
key: s.name
}, [
l("td", null, [
l("code", null, n(s.name), 1)
]),
l("td", null, n(d.lcode(s.def)), 1),
l("td", null, n(s.desc), 1)
]))), 128))
])
])
]),
l("div", fl, [
l("div", yl, n(e.$l("$utils 方法全表")) + "(" + n(i.utilGroups.length) + " " + n(e.$l("类")) + ") ", 1),
(r(!0), c(h, null, b(i.utilGroups, (s) => (r(), c("div", {
key: s.title,
style: { "margin-bottom": "24px" }
}, [
l("h3", Sl, n(s.title), 1),
l("table", bl, [
l("thead", null, [
l("tr", null, [
l("th", gl, n(e.$l("方法")), 1),
l("th", null, n(e.$l("说明")), 1)
])
]),
l("tbody", null, [
(r(!0), c(h, null, b(s.items, (f) => (r(), c("tr", {
key: f.name
}, [
l("td", null, [
l("code", null, n(f.name), 1)
]),
l("td", null, n(f.desc), 1)
]))), 128))
])
])
]))), 128))
])
])) : y("", !0)
])
])
]),
_: 1
}),
_(k)
], 64);
}
const Ll = /* @__PURE__ */ ee(ue, [["render", kl], ["__scopeId", "data-v-b3536812"]]);
export {
Ll as default
};