twig-components

Twig 组件（Symfony）

适用场景

• 将重复的 Twig 片段提取为可复用组件。
• 构建具有属性、插槽、计算逻辑或 CVA 变体的组件。
• 使用 Live Components 让组件具有响应性（搜索、计数器、表单）。

默认工作流

1. 选择组件类型：匿名（仅模板）、基于类的 #[AsTwigComponent] 或 #[AsLiveComponent]。
2. 将属性声明为可公开访问且可变的属性；使用 mount() 设置派生值。
3. 通过块（插槽）注入内容，而不是添加更多属性。
4. 对于 Live Components，使用 #[LiveProp(writable: true)] 标记可写状态，并对用户输入进行防抖处理。
5. 使用 InteractsWithTwigComponents 测试 PHP 类。

防护措施

• 切勿将公开属性设为 readonly：实例化后还会为其赋值。
• 将服务注入为 private readonly，切勿将其作为公开属性。
• 仅在浏览器必须修改某个 LiveProp 时，才将其标记为可写。
• 每个组件只承担一项职责。

渐进式披露

• 使用此文件了解执行方式和风险控制。
• 需要深入的实现细节时，打开参考资料。

输出约定

• 组件类和模板，以及其属性和插槽。
• 响应式组件的实时状态和操作。
• 用于测试挂载和渲染的组件测试。

参考资料

• reference.md