kknongchang_2506/app/Module/Article/AdminControllers/Helper/GridHelperTrait.php

<?php

namespace App\Module\Article\AdminControllers\Helper;

use App\Module\Article\Enums\STATUS;
use App\Module\Article\Models\ArticleCate;
use Dcat\Admin\Grid;
use Dcat\Admin\Grid\Column;

/**
 * 列表页辅助特性
 *
 * 提供文章模块后台控制器的列表页构建功能的具体实现
 */
trait GridHelperTrait
{
    /**
     * 添加文章标题列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param int $limit 限制长度
     * @return Column
     */
    public function columnTitle(string $field = 'title', string $label = '标题', int $limit = 30): Column
    {
        return $this->grid->column($field, $label)->limit($limit);
    }

    /**
     * 添加文章描述列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param int $limit 限制长度
     * @return Column
     */
    public function columnDescription(string $field = 'description', string $label = '简述', int $limit = 50): Column
    {
        return $this->grid->column($field, $label)->limit($limit);
    }

    /**
     * 添加文章分类列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnCategory(string $field = 'category_id', string $label = '分类'): Column
    {
        return $this->grid->column($field, $label)->using(ArticleCate::getCate());
    }

    /**
     * 添加文章状态列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnStatus(string $field = 'status', string $label = '状态'): Column
    {
        return $this->grid->column($field, $label)
            ->using(STATUS::getValueDescription())
            ->label([
                STATUS::DISABLE->value => 'danger',
                STATUS::SHOW->value => 'success',
            ]);
    }

    /**
     * 添加文章排序列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnSortOrder(string $field = 'sort_order', string $label = '排序'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }

    /**
     * 添加文章是否置顶列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnIsTop(string $field = 'is_top', string $label = '置顶'): Column
    {
        return $this->grid->column($field, $label)->switch();
    }

    /**
     * 添加文章是否推荐列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnIsRecommend(string $field = 'is_recommend', string $label = '推荐'): Column
    {
        return $this->grid->column($field, $label)->switch();
    }

    /**
     * 添加文章浏览量列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnViewsCount(string $field = 'views_count', string $label = '浏览量'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }

    /**
     * 添加文章创建者列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnCreatedBy(string $field = 'created_by', string $label = '创建者'): Column
    {
        return $this->grid->column($field, $label);
    }

    /**
     * 添加文章创建时间列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnCreatedAt(string $field = 'created_at', string $label = '创建时间'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }

    /**
     * 添加文章更新时间列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnUpdatedAt(string $field = 'updated_at', string $label = '更新时间'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }
}