Yii高级项目中Kartik GridView添加工具栏后分页组件不显示的解决方法及代码排查

我帮你排查了代码，问题出在Kartik GridView的布局配置上。当你自定义了toolbar之后，默认的布局结构可能没有把分页组件（pager）放在正确的显示位置，导致它被工具栏或者面板遮挡了。

这里有两个关键的修复点：

1. 显式指定布局结构
   Kartik的GridView默认布局在启用面板和工具栏时，可能会把分页组件挤到看不见的地方。你需要手动配置layout属性，明确告诉组件要显示分页的位置。

2. （可选）确保分页组件的配置正常
   虽然你的代码里没写错，但显式配置pager可以确保样式和功能都符合预期。

修改后的完整代码如下：

<?= GridView::widget([
    'dataProvider' => $dataProvider,
    'filterModel' => $searchModel,
    'exportTitle' => $this->title,
    'panel' => ['type' => GridView::TYPE_SECONDARY, 'heading' => $this->title],
    'export' => ['showConfirmAlert' => false,],
    'pjax' => true,
    'toolbar' => [
        '{export}',
        '{perPage}',
    ],
    // 重点：指定布局，确保分页在表格内容后显示
    'layout' => "{toolbar}\n{items}\n{pager}\n{summary}",
    'options' => [
        'class' => 'grid-primary',
    ],
    // 可选：自定义分页组件样式
    'pager' => [
        'class' => 'kartik\widgets\LinkPager',
        'firstPageLabel' => '首页',
        'lastPageLabel' => '末页',
        'prevPageLabel' => '上一页',
        'nextPageLabel' => '下一页',
    ],
    'columns' => [
        ['class' => 'yii\grid\SerialColumn'],
        // 你的其他列配置
    ],
]); ?>

为什么这样修改？ #

• layout属性定义了GridView各个部分的渲染顺序：{toolbar}（工具栏）→ {items}（表格内容）→ {pager}（分页）→ {summary}（摘要信息），这样分页就不会被工具栏或者面板遮挡了。
• 显式配置pager是为了确保分页按钮的样式和文本符合你的需求，同时也能确认分页组件被正确初始化。

另外，你可以检查一下$dataProvider的分页是否开启（默认是开启的），确保$dataProvider->pagination没有被设置为false，不过从你的问题描述来看，之前分页是正常的，只是被隐藏了，所以布局调整应该就能解决问题。

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