SuperAPI AI 工具集

craft-garnish

前端与建站

查看项目

更新于 10-16 00:30

技能介绍

用途:Garnish 是 Craft CMS 控制面板内置的 JavaScript UI 框架,本技能是其参考文档,适用于编写、编辑或审查在 Craft 控制面板中运行的 JavaScript。

主要能力:涵盖类系统(Garnish.Base、继承、事件、监听器、生命周期)、UI 组件(Modal、HUD、DisclosureMenu、MenuBtn、SelectMenu、CustomSelect、ContextMenu、Select)、拖拽系统(BaseDrag、Drag、DragSort、DragDrop、DragMove)、工具函数(键常量、自定义 jQuery 事件、ARIA 与焦点管理、几何检测、动画、表单辅助)以及与 Craft CP 的集成。

使用方式:按任务读取对应参考文件,如创建模态框读 class-system.md 与 ui-widgets.md,拖拽排序读 drag-system.md,键盘事件读 utilities.md,webpack 配置读 integration.md。涉及 PHP 侧插件开发时加载 craftcms 技能,编辑 PHP 文件时加载 craft-php-guidelines。

限制与注意:无官方外部文档,本技能即文档;Garnish 依赖 jQuery,需在 DOM 就绪后实例化;用 this.addListener() 而非 jQuery .on(),重写 destroy() 需调用 this.base(),非 button 元素用 activate 事件,ESC 用 Garnish.uiLayerManager.registerShortcut,避免使用已废弃的 Garnish.Menu、escManager、shortcutManager;webpack 中应使用 external 而非打包 Garnish。