用途:面向 TYPO3 v14 后端,使用基于标准的 Web Components 与 Lit 进行开发、审查或迁移。仅以 v14 为兼容目标,除非用户明确要求迁移说明,否则不添加 TYPO3 12/13 回退;实现前应在官方 TYPO3 文档中核对当前 v14 API。
主要能力:覆盖 ES 模块与导入映射、@typo3/* 模块标识、后端模块配置、FormEngine/Form Editor JavaScript,以及基于 Lit 的后端 UI 组件。定位为“小型交互式后端 UI 孤岛”,而非独立 SPA。Lit 适合具有响应式状态、模板渲染、重复 DOM 更新、插槽或可复用公共 API 的元素;极小的一次性行为可用原生 JavaScript。
使用方式:先确认是 v14 后端任务;检查扩展结构(Configuration/JavaScriptModules.php、Resources/Public/JavaScript、后端模块控制器、Fluid 模板、Configuration/Backend/Modules.php、Configuration/Backend/AjaxRoutes.php、Form Framework YAML)。优先复用现有后端 API 与组件。在 Configuration/JavaScriptModules.php 中注册 ES 模块导入,使用绝对导入映射标识(如 @vendor/my-extension/backend/status-card.js),避免相对导入。通过控制器的 PageRenderer->loadJavaScriptModule() 或 Fluid 的 <f:asset.module identifier="..."/> 加载模块,不要用内联脚本引导。小配置用属性传递;较大或需权限的数据由 PHP 生成后端路由 URL,组件用 @typo3/core/ajax/ajax-request.js 获取。后端写入保持服务端并做权限校验,TCA 记录使用 DataHandler,相关 AJAX 路由配置 inheritAccessFromModule。
适用场景:TYPO3 v14 后端交互组件、后端模块、FormEngine/Form Editor 现代化、组件审查与迁移。前端默认不使用后端组件与 @typo3/* 模块;若前端使用 Lit,应通过前端构建管线(如 Vite)打包,不能假定后端导入映射、top.TYPO3、后端 CSS 或组件模块存在。
限制:Lit 不会让低效代码变快,render() 应保持纯粹轻量,昂贵派生数据在 render 外计算,高频输入做防抖,替换而非原地修改数组/对象,中止过期请求,按需懒加载后端模块。v14 前端资源拼接/压缩已从 Core 移除,生产前端资源需外部构建工具。需用真实后端用户(非仅管理员)验证键盘访问、焦点、减少动效、加载/错误/空状态与权限。相关技能:typo3-datahandler、typo3-workspaces、typo3-visual-editor、typo3-vite、typo3-testing、typo3-translations。