用途:帮助开发者创建 MoonShine 管理面板的自定义表单字段,覆盖从字段类到视图的数据处理与交互。
主要能力:依据技能资料,字段由两部分组成——PHP 类(app/MoonShine/Fields/)与 Blade 视图(resources/views/admin/fields/)。需读取 .guidelines/fields-development.md 了解字段结构、字段类方法(resolveValue、resolvePreview、resolveOnApply 等)、Alpine.js 视图模板模式、流式方法、字段模式(default、preview、raw)及示例。
用法要点:流式方法必须返回 static 以支持链式调用;resolveOnApply() 必须返回模型,结尾 return $item;涉及关联时使用 resolveOnAfterApply();viewData() 只传额外数据,value、attributes、label、column、errors 由 systemViewData() 自动提供;根元素必须加 {{ $attributes }};一页多字段用 uniqid() 生成唯一 ID;assets() 必须为 protected;需要原始值用 toValue(),预览格式化用 toFormattedValue();不要手动调用 resolveValue();逻辑放在 prepareBeforeRender(),不要在 Blade 中写 @php。字段在 FormBuilder 中为可交互输入,在 TableBuilder 中为只读预览,由上下文自动切换。
适用场景:为 MoonShine 后台构建自定义输入类型、展示字段或带 Alpine.js 交互的字段组件。
限制:资料未提供收费、价格、支持平台与具体版本信息;示例代码片段仅作说明,实际开发需以官方指南为准。