Laravel Nova功能实现：允许用户动态选择索引页显示字段

以下是针对Laravel 9 + Nova 4的落地实现步骤，完全替代硬编码字段可见性的方式：

1. 存储用户字段偏好 #

先给用户表添加JSON字段，用来保存每个资源的索引页字段配置：

php artisan make:migration add_nova_index_fields_to_users_table --table=users

修改生成的迁移文件：

public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->json('nova_index_fields')->nullable();
    });
}

public function down()
{
    Schema::table('users', function (Blueprint $table) {
        $table->dropColumn('nova_index_fields');
    });
}

执行迁移：

php artisan migrate

在App\Models\User模型里添加访问器和修改器，方便操作JSON字段：

public function getNovaIndexFieldsAttribute($value)
{
    return json_decode($value, true) ?? [];
}

public function setNovaIndexFieldsAttribute($value)
{
    $this->attributes['nova_index_fields'] = json_encode($value);
}

2. 动态控制资源字段显示 #

在Nova资源类（比如App\Nova\User.php）的fields()方法中，根据用户的配置动态设置字段可见性：

public function fields(NovaRequest $request)
{
    // 封装判断逻辑，简化代码
    $isVisible = fn($fieldKey) => $this->checkFieldVisibility($fieldKey, $request);

    return [
        ID::make()->sortable(),

        Text::make('姓名', 'name')
            ->sortable()
            ->showOnIndex($isVisible('name')),

        Text::make('邮箱', 'email')
            ->sortable()
            ->showOnIndex($isVisible('email')),

        DateTime::make('邮箱验证时间', 'email_verified_at')
            ->showOnIndex($isVisible('email_verified_at')),

        // 其他字段照此格式添加
    ];
}

// 辅助方法：判断字段是否可见
protected function checkFieldVisibility(string $fieldKey, NovaRequest $request): bool
{
    $resourceKey = $this::uriKey();
    $userFields = $request->user()->nova_index_fields[$resourceKey] ?? [];
    
    // 用户未配置时默认显示所有字段
    return empty($userFields) || in_array($fieldKey, $userFields);
}

3. 添加字段选择交互按钮 #

通过Nova Action实现索引页的字段配置按钮，让用户可视化选择：

php artisan nova:action ManageIndexFields

修改生成的Action文件App\Nova\Actions\ManageIndexFields.php：

use Illuminate\Bus\Queueable;
use Illuminate\Queue\SerializesModels;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use Laravel\Nova\Actions\Action;
use Laravel\Nova\Fields\ActionFields;
use Laravel\Nova\Http\Requests\NovaRequest;
use Laravel\Nova\Fields\CheckboxGroup;

class ManageIndexFields extends Action
{
    use InteractsWithQueue, Queueable, SerializesModels;

    public $name = '管理显示字段';

    public function handle(ActionFields $fields, $models)
    {
        $user = request()->user();
        $indexFields = $user->nova_index_fields;
        // 用资源的uriKey作为配置键，区分不同资源
        $indexFields[$fields->resource_key] = $fields->selected_fields;
        
        $user->nova_index_fields = $indexFields;
        $user->save();

        return Action::message('字段配置已保存，页面将自动刷新！');
    }

    public function fields(NovaRequest $request)
    {
        // 获取当前资源的所有可配置字段
        $resource = $request->newResource();
        $allIndexFields = $resource->fields($request)
            ->filter(fn($field) => method_exists($field, 'showOnIndex'));

        // 转换为复选框选项格式
        $fieldOptions = $allIndexFields->mapWithKeys(function ($field) {
            return [$field->attribute => $field->name];
        })->toArray();

        // 获取用户当前已选字段
        $userSelected = $request->user()->nova_index_fields[$resource::uriKey()] ?? [];

        return [
            \Laravel\Nova\Fields\Hidden::make('resource_key')->default($resource::uriKey()),
            CheckboxGroup::make('选择要显示的字段', 'selected_fields')
                ->options($fieldOptions)
                ->default($userSelected)
                ->help('勾选的字段将在索引页展示，未勾选则隐藏'),
        ];
    }

    public function uriKey()
    {
        return 'manage-index-fields';
    }
}

最后在资源类的actions()方法中注册这个Action：

// App\Nova\User.php
public function actions(NovaRequest $request)
{
    return [
        new \App\Nova\Actions\ManageIndexFields,
    ];
}

4. 额外优化建议 #

• 若需要全局默认配置（比如管理员设置所有用户的初始字段），可以新增settings表存储全局配置，在checkFieldVisibility方法中优先使用用户自身配置，无配置时 fallback 到全局配置。
• 可以给Action添加权限控制，仅允许特定角色的用户修改字段配置。

内容的提问来源于stack exchange，提问作者Sebito