然而，很快我就发现这简直是一场噩梦！想象一下，在一个普通的文本框里编辑几百行的JSON配置，没有任何语法高亮，括号匹配全靠肉眼，更别提自动补全了。一个小小的逗号错误就能导致整个配置失效，而定位问题则需要耗费大量时间。对于PHP和JavaScript代码来说，情况更是糟糕，代码的可读性极差，修改起来战战兢兢，生怕引入新的Bug。

我急切地需要一个解决方案，一个能在FilamentPHP后台提供专业代码编辑体验的组件。它应该具备语法高亮、行号显示、甚至代码自动补全等功能，让代码管理变得像在IDE中一样舒适。

Composer在线学习地址：学习地址

幸好，我很快发现了 creagia/filament-code-field 这个Composer包，它简直是为解决我的问题而生！

creagia/filament-code-field 是一个专为FilamentPHP管理面板和表单构建器设计的输入字段，它基于强大的 CodeMirror 编辑器。这意味着，你可以在Filament后台拥有一个功能丰富的代码编辑器，支持代码自动补全、明暗主题、多种语言（JSON、PHP、HTML、XML、JavaScript）以及只读模式等高级特性。

如何引入 creagia/filament-code-field？

首先，通过Composer安装这个包。请注意，根据你使用的Filament和Laravel版本，可能需要安装不同的版本：

# 对于 Filament 3 和 Laravel 11+
composer require creagia/filament-code-field

# 对于 Filament 3 和 Laravel 10-12
composer require "creagia/filament-code-field:^2.0.0"

# 对于 Filament 2
composer require "creagia/filament-code-field:^1.0.0"

安装完成后，你就可以在你的Filament资源或页面中轻松使用它了。

核心功能与使用示例

使用 CodeField 非常简单，只需像其他Filament字段一样实例化它：

use Creagia\FilamentCodeField\CodeField;
use Filament\Forms\Form;

public static function form(Form $form): Form
{
    return $form
        ->schema([
            CodeField::make('my_json_data')
                ->label('JSON 配置'),
            // 其他字段...
        ]);
}

默认情况下，它会创建一个JSON代码字段。但你可以轻松切换到其他支持的语言：

1. 选择代码语言

creagia/filament-code-field 支持 JSON, PHP, HTML, XML 和 JavaScript (JS)。你可以使用 setLanguage() 方法或便捷的辅助方法来指定语言：

use Creagia\FilamentCodeField\CodeField;

// 示例：创建 JavaScript 代码字段
CodeField::make('js_script')
    ->setLanguage(CodeField::JS),
    // 或者更简洁的方式：
    // ->jsField(),

// 示例：创建 PHP 代码字段
CodeField::make('php_code')
    ->phpField(),

// 示例：创建 HTML 模板字段
CodeField::make('html_template')
    ->htmlField(),

2. 禁用代码自动补全

如果你觉得某些场景下不需要自动补全，可以轻松禁用它：

CodeField::make('config_code')
    ->jsonField()
    ->disableAutocompletion(),

3. 显示行号

对于较长的代码片段，行号是必不可少的功能，可以这样开启：

CodeField::make('large_script')
    ->phpField()
    ->withLineNumbers(),

4. 只读模式

如果你只想展示代码而不允许编辑，可以利用Filament自带的 disabled() 方法：

CodeField::make('view_only_code')
    ->jsonField()
    ->disabled() // 使字段只读
    ->label('查看配置'),

5. 兼容Filament的其他字段方法

由于 CodeField 继承自Filament的字段类，因此你可以继续使用所有常见的Filament字段方法，如 label()、hint()、helper() 等，以增强用户体验：

CodeField::make('my_json')
    ->label('你的 JSON 数据')
    ->hint('请确保JSON格式正确')
    ->helper('此处可以编辑应用程序的JSON配置。')
    // 更多方法...

总结与实际应用效果

引入 creagia/filament-code-field 后，我的Filament后台管理系统焕然一新！

• 用户体验大幅提升： 管理员现在可以在一个专业、舒适的环境中编辑代码，就像在本地IDE中一样，大大减少了心理负担。
• 代码质量和数据准确性提高： 语法高亮和自动补全显著减少了拼写错误和格式错误，确保了配置文件的有效性。
• 开发效率加速： 定位和修改代码变得更加直观和快捷，节省了宝贵的开发和调试时间。
• 应用场景广泛： 无论是编辑网站的元数据（JSON）、自定义的业务逻辑（PHP/JS）、电子邮件模板（HTML），还是查看API响应的原始数据，这个字段都能提供完美的解决方案。

creagia/filament-code-field 不仅仅是一个简单的输入框，它为FilamentPHP开发者提供了一个强大且优雅的代码管理工具。如果你也曾为在Filament后台编辑代码而烦恼，那么我强烈推荐你尝试一下这个Composer包，它一定会让你的开发工作事半功倍！