Files
crawler-plugin/admin-frontend-vue/src/plugins/element.ts
T
huangzd1997 3a7669fbe7 fix(按需注册): 「编辑用户→角色」渲染成一行裸文本——radio 子组件是 withNoopInstall,要 use 父组件
根因不在样式也不在文案,在注册表:src/plugins/element.ts 登记的是 ElRadioButton /
ElRadioGroup,而 EP 里子组件由 withNoopInstall 造(component.install = NOOP),
app.use 它们注册不出任何东西;只有父组件 ElRadio 的 withInstall(radio, {RadioButton,
RadioGroup}) 才会把三个名字一起 app.component 出去。于是模板里的 <el-radio-group> /
<el-radio-button> 解析失败,被当成未知自定义元素渲染成裸标签,两个按钮文案连成一行
「普通账号管理员」。全站 30 条注册项只注册出 33 个名字,缺的就是这两个;
ElFormItem / ElTableColumn / ElOption 等同为 no-op 的子组件都因父组件在表里而正常注册。

取证四路:像素扫描(角色栏 y=174-184 只有字形反锯齿点,同页三个输入框在 y=104/204/404
都是 723px 宽的完整边框)→ DOM(.el-radio-group 为 null,innerHTML 是原样标签)→
控制台(Failed to resolve component: el-radio-group / el-radio-button 各 2 条)→
运行期 app._context.components 键集合(无 ElRadioGroup/ElRadioButton)。

护栏原本 7/7 全绿而页面是坏的:perf_ep_registry_covers_every_used_tag 只比对注册数组的
文本里有没有那个名字——"登记过"被当成了"生效过"。改成对每个条目真跑 install(假 app)、
拿运行期注册出来的名字集合比对;修前红且红的正好是这两条。同时给
perf_ep_registry_has_no_dead_entries 补父组件豁免,否则正确修法(加 ElRadio,它自己没有
标签)反会被那条判成死条目——旧尺子会把人往错方向推。

验证:node --test 全量 1738 例 0 红、vue-tsc --noEmit rc=0、浏览器实测角色已渲染成分段
按钮("普通账号"高亮)且无解析告警。未提交未发布,现网 admin-vue 仍是 20261005-182523。
2026-10-05 22:29:53 +08:00

135 lines
4.8 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* Element Plus 按需注册(替代旧的 `app.use(ElementPlus)` + `dist/index.css`)。
*
* 为什么要这一份:旧写法把整库打进每个后台页面的首屏 —— 实测入口
* index-*.js 1,129,621 B(gzip 374,350 B)、index-*.css 383,458 B(gzip 52,413 B),
* 而 src 里模板只用到 29 个 `el-*` 标签。
*
* 两条不成文但会咬人的规矩,改这个文件前先读:
* 1. 新增/换用任何 `el-*` 标签,这里必须同时加「组件导入」和「按组件样式导入」。
* 少一条不会让构建变红,只会让那个页面渲染成裸标签 —— 护栏在
* tests/perf-element-on-demand.test.ts,它从源码推标签清单来比对这份文件。
* 1b. 子组件(`el-radio-group` / `el-form-item` / `el-table-column` 这类)在 EP 里是
* `withNoopInstall` 造的,`app.use` 它们注册不出任何东西;要引的是**父组件**
* (`ElRadio` / `ElForm` / `ElTable`),由父组件的 install 把子组件一起注册。
* 10-05「编辑用户 → 角色」渲染成裸文本就是只登记了两个 radio 子组件漏的。
* 护栏按运行期 install 出来的名字集合比对,不看这份清单的字符串。
* 2. 样式一律走 `element-plus/es/components/<短名>/style/css`,它会带上 base
* 与依赖组件的样式(例如 message-box 自带 input/button/overlay);
* 不要图省事改回 `theme-chalk/index.css` 或 `dist/index.css`。
*
* 语言包见 src/App.vue 的 `<el-config-provider :locale="zhCn">` —— 摘掉整包插件后
* 全局配置只能从 config-provider 走,别再指望 use(ElementPlus, { locale })。
*/
import type { App } from 'vue'
import {
ElAlert,
ElBreadcrumb,
ElBreadcrumbItem,
ElButton,
ElCheckbox,
ElConfigProvider,
ElDatePicker,
ElDescriptions,
ElDescriptionsItem,
ElDialog,
ElDrawer,
ElEmpty,
ElForm,
ElFormItem,
ElInput,
ElInputNumber,
ElLoadingDirective,
ElMenu,
ElMenuItem,
ElOption,
ElProgress,
ElRadio,
ElResult,
ElScrollbar,
ElSelect,
ElSubMenu,
ElTable,
ElTableColumn,
ElTree,
ElUpload,
} from 'element-plus'
// 模板在用的组件:样式按组件引(顺序与标签名字典序一致,方便和护栏清单对读)
import 'element-plus/es/components/alert/style/css'
import 'element-plus/es/components/breadcrumb/style/css'
import 'element-plus/es/components/breadcrumb-item/style/css'
import 'element-plus/es/components/button/style/css'
import 'element-plus/es/components/checkbox/style/css'
import 'element-plus/es/components/config-provider/style/css'
import 'element-plus/es/components/date-picker/style/css'
import 'element-plus/es/components/descriptions/style/css'
import 'element-plus/es/components/descriptions-item/style/css'
import 'element-plus/es/components/dialog/style/css'
import 'element-plus/es/components/drawer/style/css'
import 'element-plus/es/components/empty/style/css'
import 'element-plus/es/components/form/style/css'
import 'element-plus/es/components/form-item/style/css'
import 'element-plus/es/components/input/style/css'
import 'element-plus/es/components/input-number/style/css'
import 'element-plus/es/components/menu/style/css'
import 'element-plus/es/components/menu-item/style/css'
import 'element-plus/es/components/option/style/css'
import 'element-plus/es/components/progress/style/css'
import 'element-plus/es/components/radio-button/style/css'
import 'element-plus/es/components/radio-group/style/css'
import 'element-plus/es/components/result/style/css'
import 'element-plus/es/components/scrollbar/style/css'
import 'element-plus/es/components/select/style/css'
import 'element-plus/es/components/sub-menu/style/css'
import 'element-plus/es/components/table/style/css'
import 'element-plus/es/components/table-column/style/css'
import 'element-plus/es/components/tree/style/css'
import 'element-plus/es/components/upload/style/css'
// 命令式 API:不写在模板里,但同样要自带样式,否则弹层是裸 HTML
import { ElMessage, ElMessageBox } from 'element-plus'
import 'element-plus/es/components/message/style/css'
import 'element-plus/es/components/message-box/style/css'
// v-loading 指令与其服务样式
import 'element-plus/es/components/loading/style/css'
export { ElMessage, ElMessageBox }
const components = [
ElAlert,
ElBreadcrumb,
ElBreadcrumbItem,
ElButton,
ElCheckbox,
ElConfigProvider,
ElDatePicker,
ElDescriptions,
ElDescriptionsItem,
ElDialog,
ElDrawer,
ElEmpty,
ElForm,
ElFormItem,
ElInput,
ElInputNumber,
ElMenu,
ElMenuItem,
ElOption,
ElProgress,
ElRadio,
ElResult,
ElScrollbar,
ElSelect,
ElSubMenu,
ElTable,
ElTableColumn,
ElTree,
ElUpload,
]
export function installElement(app: App): void {
for (const component of components) app.use(component)
app.directive('loading', ElLoadingDirective)
}