SuperAPI AI 工具集

laravel-blade

前端与建站

查看项目

更新于 10-26 16:21

技能介绍

Laravel Blade 是 Laravel 的模板引擎,为 PHP 视图提供简洁语法,最终编译为纯 PHP 以保持运行性能。该技能用于在构建视图、可复用组件或模板化页面时提供结构化指导,内容包括组件选型、布局策略、关键概念、代码模板与最佳实践。

用途与工作流:该技能描述了一套强制的智能体工作流——实施前并行启动三个代理,分别用于检查现有视图与组件结构、通过 Context7 核验最新 Blade 文档、查询组件与插槽等具体模式;实施后运行校验代理。该流程为技能内部约定,可按实际环境取舍。

组件类型:提供四种组件形式的选用建议。匿名组件适合无需逻辑的简单 UI;类组件适合需要依赖注入或复杂逻辑的场景;布局组件用于页面结构与可复用外壳;动态组件用于运行时选择组件。文档给出决策指引:需要依赖注入或复杂属性逻辑时选类组件,否则优先匿名组件;简单页面结构用组件布局,需要细粒度区块时用 @extends/@section。

主要能力与关键概念:@props 显式声明组件属性;$attributes 用于透传并合并 HTML 属性,支持 $attributes->merge() 与条件 class;x-slot 提供命名内容区域;@yield/@section 实现传统布局继承;$loop 提供循环迭代信息。参考文档覆盖组件、插槽与属性、布局、指令(@if、@foreach、@auth、@can)、安全(XSS、CSRF、转义)、Vite 资源打包、高级指令(@once、@use、@inject、@switch、stacks)、自定义指令(Blade::if、Blade::directive)、高级组件(@aware、shouldRender、index)、表单与校验(@error、表单辅助)以及片段(@fragment、HTMX 集成)。

完整代码模板包括:带逻辑或依赖注入的类组件、简单可复用 UI 的匿名组件、页面布局组件、带校验的表单组件、命名插槽卡片、运行时动态组件、高级指令、自定义指令、高级组件与 HTMX 片段更新。

使用方式与规则:始终转义输出,除必要外使用 {{ }} 而非 {!! !!};用 @props 声明预期属性;通过 $attributes->merge() 允许 class 与属性覆盖;优先匿名组件,仅在需要逻辑时用类组件;复杂多区域布局使用命名插槽;表单中始终包含 @csrf。最佳实践还建议保持组件聚焦可复用,避免在模板中放置业务逻辑、避免过深嵌套与硬编码 class。

Laravel 13 说明:控制器类与方法可使用 #[Middleware] 与 #[Authorize] 属性声明中间件与授权,替代构造函数中的中间件样板代码;属性声明的中间件会与分组/路由中间件合并(13.8+)并被子控制器继承(13.5+),支持 only/except 与 #[WithoutMiddleware](13.20+);#[Authorize] 是 can 中间件的简写,策略拒绝时返回 403。另有 @fonts 指令(13.7+),用于注入 laravel-vite-plugin 的 fonts 选项生成的自托管字体。

适用场景:使用 Laravel 进行视图层开发、构建可复用组件库、重构模板结构、制定组件与布局规范,以及需要参考 Blade 安全写法的项目。

限制:资料未提供安装命令、版本兼容范围、性能数据或收费信息,暂未提供。