nongchang
/
kknongchang_2506


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180
							<?php

namespace App\Module\User\AdminControllers\Helper;

use App\Module\User\Enums\STATUS2;
use Dcat\Admin\Grid;
use Dcat\Admin\Grid\Column;

/**
 * 列表页辅助特性
 *
 * 提供用户模块后台控制器的列表页构建功能的具体实现
 * 只保留具有复用价值的方法
 */
trait GridHelperTrait
{
    /**
     * 添加用户ID列
     *
     * 复用价值：高 - 在多个控制器中使用，提供统一的用户ID显示
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnUserId(string $field = 'id', string $label = '用户ID'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }

    /**
     * 添加用户名列
     *
     * 复用价值：高 - 在多个控制器中使用，提供统一的用户名显示
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnUsername(string $field = 'username', string $label = '用户名'): Column
    {
        return $this->grid->column($field, $label);
    }

    /**
     * 添加用户状态列
     *
     * 复用价值：高 - 统一处理用户状态的显示，包括状态名称和标签样式
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnStatus(string $field = 'status2', string $label = '状态'): Column
    {
        return $this->grid->column($field, $label)
            ->using(STATUS2::getNames())
            ->label([
                STATUS2::Normal->value => 'success',
                STATUS2::Disabled->value => 'danger',
                STATUS2::Ban->value => 'warning',
            ]);
    }

    /**
     * 添加用户头像列
     *
     * 复用价值：高 - 统一处理用户头像的显示，包括图片大小和样式
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param int $width 宽度
     * @param int $height 高度
     * @return Column
     */
    public function columnAvatar(string $field = 'avatar', string $label = '头像', int $width = 50, int $height = 50): Column
    {
        return $this->grid->column($field, $label)->image('', $width, $height);
    }

    /**
     * 添加用户信息组合列
     *
     * 复用价值：高 - 将用户ID、用户名和头像组合显示，提高信息密度
     *
     * @param string $idField 用户ID字段名
     * @param string $usernameField 用户名字段名
     * @param string $avatarField 头像字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnUserInfo(string $idField = 'id', string $usernameField = 'username', string $avatarField = 'avatar', string $label = '用户信息'): Column
    {
        return $this->grid->column($idField, $label)->display(function ($userId) use ($usernameField, $avatarField) {
            $username = $this->{$usernameField} ?? '';
            $avatar = $this->{$avatarField} ?? '';

            $avatarHtml = $avatar ? "<img src='{$avatar}' width='30' height='30' style='border-radius: 50%; margin-right: 5px;'>" : '';

            return <<<HTML
            <div style="display: flex; align-items: center;">
                {$avatarHtml}
                <div>
                    <div>ID: {$userId}</div>
                    <div>{$username}</div>
                </div>
            </div>
            HTML;
        });
    }

    /**
     * 添加用户联系信息组合列
     *
     * 复用价值：高 - 将用户手机号、邮箱和微信号组合显示，提高信息密度
     *
     * @param string $phoneField 手机号字段名
     * @param string $emailField 邮箱字段名
     * @param string $wxIdField 微信号字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnUserContact(string $phoneField = 'phone', string $emailField = 'email', string $wxIdField = 'wx_id', string $label = '联系方式'): Column
    {
        return $this->grid->column($phoneField, $label)->display(function ($phone) use ($emailField, $wxIdField) {
            $email = $this->{$emailField} ?? '';
            $wxId = $this->{$wxIdField} ?? '';

            $phoneHtml = $phone ? "<div>手机: {$phone}</div>" : '';
            $emailHtml = $email ? "<div>邮箱: {$email}</div>" : '';
            $wxIdHtml = $wxId ? "<div>微信: {$wxId}</div>" : '';

            return $phoneHtml . $emailHtml . $wxIdHtml;
        });
    }

    /**
     * 添加用户安全信息组合列
     *
     * 复用价值：高 - 将用户安全相关信息组合显示，提高信息密度
     *
     * @param string $secretPasswordField 安全密码字段名
     * @param string $lastCheckAtField 最后验证时间字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnUserSecurity(string $secretPasswordField = 'secret_password', string $lastCheckAtField = 'last_check_at', string $label = '安全信息'): Column
    {
        return $this->grid->column($secretPasswordField, $label)->display(function ($secretPassword) use ($lastCheckAtField) {
            $lastCheckAt = $this->{$lastCheckAtField} ?? '';

            $secretPasswordHtml = "<div>安全密码: " . ($secretPassword ? '已设置' : '未设置') . "</div>";
            $lastCheckAtHtml = $lastCheckAt ? "<div>最后验证: {$lastCheckAt}</div>" : '';

            return $secretPasswordHtml . $lastCheckAtHtml;
        });
    }

    /**
     * 添加时间信息组合列
     *
     * 复用价值：高 - 将创建时间和更新时间组合显示，提高信息密度
     *
     * @param string $createdAtField 创建时间字段名
     * @param string $updatedAtField 更新时间字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnTimes(string $createdAtField = 'created_at', string $updatedAtField = 'updated_at', string $label = '时间信息'): Column
    {
        return $this->grid->column($createdAtField, $label)->display(function ($createdAt) use ($updatedAtField) {
            $updatedAt = $this->{$updatedAtField} ?? '';

            $createdAtHtml = "<div>创建: {$createdAt}</div>";
            $updatedAtHtml = $updatedAt ? "<div>更新: {$updatedAt}</div>" : '';

            return $createdAtHtml . $updatedAtHtml;
        });
    }
}