README

yii2-export

使用PhpSpreadsheet库将服务器/数据库数据导出为各种格式（例如excel、html、pdf、csv等）的库。小部件允许您配置数据提供者、列，就像yii\grid\GridView一样。然而，它只以按钮下拉菜单的形式显示导出操作，以便嵌入到您的GridView或其他组件中。

此外，从v1.2.0版本开始，扩展还显示了一个方便的网格列选择器，用于控制导出的列。列选择器可用的功能包括：

显示列选择下拉列表，允许选择导出列。
新的container属性允许您对导出菜单和列选择器下拉菜单进行分组。
新的template属性用于操作菜单、列选择器或按钮组中的额外按钮的显示。
通过columnSelectorOptions配置列选择器下拉按钮。
自动在列选择器中生成列标签。但您可以通过columnSelector属性设置覆盖每个列键显示的列标签。
通过selectedColumns预先选择列（您必须设置选择的列键）
通过disabledColumns在列选择器中禁用列（您必须设置禁用的列键）
通过hiddenColumns在列选择器中隐藏列（您必须设置隐藏的列键）
通过noExportColumns在导出和列选择器中隐藏列（您必须设置不导出的列键）
通过showColumnSelector属性切换列选择器的显示
只有当asDropdown设置为true时，才显示列选择器。

该扩展提供可配置的用户界面，用于使用视图模板的高级情况。

exportColumnsView允许您设置自己的自定义视图文件以渲染列选择器下拉菜单。
afterSaveView允许您设置自己的保存后视图文件，如果您正在配置将导出文件保存到服务器。

演示

您可以在文档和演示中查看该扩展的详细使用说明。

版本更改

注意：有关各种版本更改的详细信息，请参阅变更日志。

安装

安装此扩展的首选方式是通过composer。

注意：阅读此网络提示/wik，了解如何为您的应用的composer.json设置minimum-stability设置。

先决条件

根据您的 Bootstrap 版本安装必要的先决条件（Krajee Dropdown 扩展）

对于 Bootstrap v5.x 版本，安装扩展 kartik-v/yii2-bootstrap5-dropdown
对于 Bootstrap v4.x 版本，安装扩展 kartik-v/yii2-bootstrap4-dropdown
对于 Bootstrap v3.x 版本，安装扩展 kartik-v/yii2-dropdown-x

例如，如果您使用的是 Bootstrap v5.x 版本，请将以下内容添加到您的 composer.json 文件的 require 部分

"kartik-v/yii2-bootstrap5-dropdown": "@dev"

安装

可以执行以下操作之一

$ php composer.phar require kartik-v/yii2-export "@dev"

或者将以下内容添加到您的 composer.json 文件的 require 部分。

"kartik-v/yii2-export": "@dev"

注意：您必须运行 composer update 以获取最新的稳定依赖，如 kartik-v/yii2-krajee-base

注意：您必须运行 composer update 命令以安装最新的稳定依赖，如 kartik-v/yii2-krajee-base

先决条件

yii2-export 扩展依赖于 yii2-grid 扩展模块。为了开始使用 yii2-export，您需要确保在您的应用程序模块配置文件中设置了 gridview 模块。例如

'modules' => [
    'gridview' => [
        'class' => 'kartik\grid\Module',
        // other module settings
    ]
]

用法

ExportMenu

use kartik\export\ExportMenu;
$gridColumns = [
    ['class' => 'yii\grid\SerialColumn'],
    'id',
    'name',
    'color',
    'publish_date',
    'status',
    ['class' => 'yii\grid\ActionColumn'],
];

// Renders a export dropdown menu
echo ExportMenu::widget([
    'dataProvider' => $dataProvider,
    'columns' => $gridColumns,
    'clearBuffers' => true, //optional
]);

// You can choose to render your own GridView separately
echo \kartik\grid\GridView::widget([
    'dataProvider' => $dataProvider,
    'filterModel' => $searchModel,
    'columns' => $gridColumns
]);