# imagebox

**Repository Path**: l-kai/imagebox

## Basic Information

- **Project Name**: imagebox
- **Description**: 基于viewer.js做的laravel-admin图片扩展
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-09-22
- **Last Updated**: 2025-11-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: laravel-admin

## README

# ImageBox 扩展

## 简介

ImageBox 是一个用于 [Laravel Admin](https://laravel-admin.org) 的扩展组件，用于在表格中展示图片，并支持多种图片交互效果。

## 功能特性

- 支持图片灯箱效果（lightbox）
- 支持图片缩放（zooming）
- 支持自定义图片宽高
- 支持自定义图片样式类名
- 基于 Viewer.js 实现，提供丰富的图片查看功能

## 安装

使用 Composer 安装扩展：

```bash
composer require liukai/grid-imagebox
```

发布资源文件：

```bash
php artisan vendor:publish --tag=laravel-admin-grid-viewer
```

## 配置

在 `config/admin.php` 文件中添加以下配置以启用扩展：

```php
'extensions' => [
    'grid-imagebox' => [
        'enable' => true,
    ]
]
```

## 使用方法

在 Laravel Admin 的表格中使用 ImageBox：

```php
// 基础灯箱效果
$grid->picture()->imagebox();

// 启用缩放功能
$grid->picture()->imagebox(['zooming' => true]);

// 自定义宽高
$grid->picture()->imagebox(['width' => 50, 'height' => 50]);

// 添加自定义 CSS 类
$grid->picture()->imagebox(['class' => 'rounded']);
```

## 样式与脚本

扩展基于以下资源实现：
- `viewer.css`：提供图片查看器的样式
- `viewer.js`：提供图片交互功能

## 许可协议

本项目遵循 [MIT License](LICENSE) 协议。