SuperAPI AI 工具集

typo3-webcomponents

通用与其它

查看项目

更新于 10-16 05:54

技能介绍

用途:该技能用于 TYPO3 v14 后端编程,基于标准 Web Components 与 Lit 构建、审查或迁移后端界面组件。仅以 v14 为兼容目标,除非用户明确要求迁移说明,否则不添加 TYPO3 12/13 回退,实施前应在官方 TYPO3 文档中核对当前 v14 API。

主要能力:涵盖 Custom Elements、Shadow DOM、模板/插槽等基础概念;指导使用 ES 模块、导入映射、@typo3/* 模块标识符、后端模块配置、FormEngine/Form Editor JavaScript 与 Lit 组件。定位为“小型交互式后端界面孤岛”,而非独立 SPA。Lit 适用于有响应式状态、模板渲染、重复 DOM 更新或可复用公共 API 的元素;一次性微小行为可用原生 JavaScript。

使用方式:开发前先检查扩展结构,包括 Configuration/JavaScriptModules.php、Resources/Public/JavaScript、后端模块控制器、Fluid 模板、Configuration/Backend/Modules.php、AjaxRoutes.php 及 Form Framework YAML;优先复用现有后端 API 与组件。模块在 JavaScriptModules.php 中注册,使用 @vendor/... 绝对导入映射标识符,避免相对导入;通过控制器 PageRenderer->loadJavaScriptModule() 或 Fluid 的 <f:asset.module identifier="..."/> 加载,不添加内联脚本引导。小配置走属性,较大或受限数据由 PHP 生成后端路由 URL,组件用 @typo3/core/ajax/ajax-request.js 获取。写入保持服务端并做权限校验,TCA 记录用 DataHandler,相关 AJAX 路由配置 inheritAccessFromModule。

适用场景与限制:仅用于已认证的 TYPO3 后端页面;默认不将后端组件与 @typo3/* 模块用于前端。前端使用 Lit 时应经 Vite 等前端构建管线打包,不要假设后端导入映射、top.TYPO3、后端 CSS 或组件模块在前端请求中存在。验证需用真实后端用户而非仅管理员,检查键盘访问、焦点、减少动效、加载/错误/空状态与权限。性能方面,render() 应纯且轻量,昂贵派生数据在 render 外计算,高频输入做防抖,替换而非变更数组/对象,中止过期请求,按需懒加载后端模块。v14 核心已移除前端资源合并/压缩,前端生产资源需外部构建工具。参考资料包括官方 TYPO3 文档、lit_demo 示例、Lit 文档与 MDN Web Components;相关本地技能可按领域配合使用。