当前位置：首页 > 文章列表 > 文章 > php教程 > Magento2自定义页面分页设置教程

Magento2自定义页面分页设置教程

2026-03-04 12:58:04 0浏览收藏

本文手把手教你如何在 Magento 2 自定义模块页面（如客户报价单列表）中正确集成原生分页功能，涵盖 Collection 分页配置、Block 层 Pager 实例化、模板调用及易踩坑的关键细节——从 setPageSize/setCurPage 的精准设置，到 load() 调用时机、URL 参数命名规范、Collection 复用防护，再到响应式适配与 SEO 验证，提供一套经生产环境验证、开箱即用的完整方案，助你快速构建风格统一、性能稳定、可扩展性强的专业级分页体验。

Magento 2 自定义页面添加分页功能的完整实现指南

本文详解如何在 Magento 2 自定义模块页面（如报价单列表页）中正确集成原生分页器，涵盖 Collection 分页配置、Block 中 Pager 实例化、模板调用及关键注意事项，确保每页显示指定数量记录并支持页码跳转。

本文详解如何在 Magento 2 自定义模块页面（如报价单列表页）中正确集成原生分页器，涵盖 Collection 分页配置、Block 中 Pager 实例化、模板调用及关键注意事项，确保每页显示指定数量记录并支持页码跳转。

在 Magento 2 中为自定义页面（例如客户报价单列表页）添加分页，不能仅依赖前端渲染或手动切片数据——必须结合 EAV Collection 的分页机制与框架内置的 Magento\Theme\Block\Html\Pager 组件协同工作。以下是一个经过生产环境验证的完整实现方案。

✅ 核心步骤概览

在 Block 类中重写 _prepareLayout()，动态创建并绑定 Pager 实例；
确保 getSavedQuotes() 方法返回已配置分页参数（setPageSize + setCurPage）的 Collection；
在 .phtml 模板中调用 getPagerHtml() ?> 渲染分页控件；
注意请求参数解析、Collection 加载时机及模板输出位置。

? Block 层实现（推荐继承 \Magento\Framework\View\Element\Template）

customerSession = $customerSession;
        $this->_quoteMainFactory = $quoteMainFactory;
        parent::__construct($context, $data);
    }

    protected function _prepareLayout()
    {
        parent::_prepareLayout();
        $this->pageConfig->getTitle()->set(__('My Quotes'));

        $collection = $this->getSavedQuotes();
        if ($collection && $collection->getSize()) {
            $pager = $this->getLayout()->createBlock(
                \Magento\Theme\Block\Html\Pager::class,
                'quotes.pager'
            )
                ->setAvailableLimit([10 => 10, 20 => 20, 30 => 30])
                ->setShowPerPage(true) // 启用「每页显示」下拉框（设为 false 则隐藏）
                ->setCollection($collection);

            $this->setChild('pager', $pager);
            // ⚠️ 关键：必须显式调用 load()，否则 pager 无法获取总条数
            $collection->load();
        }

        return $this;
    }

    public function getPagerHtml()
    {
        return $this->getChildHtml('pager');
    }

    public function getSavedQuotes()
    {
        $page = (int)$this->getRequest()->getParam('p', 1);
        $pageSize = (int)$this->getRequest()->getParam('limit', 10);

        $collection = $this->_quoteMainFactory->create()->getCollection()
            ->addFieldToFilter('is_deleted', 0)
            ->addFieldToFilter('status', 1)
            ->addFieldToFilter('customer_id', $this->customerSession->getCustomer()->getId());

        // 必须在 load() 前设置分页参数
        return $collection->setPageSize($pageSize)->setCurPage($page);
    }
}

? 对应 PHTML 模板（如 quote/list.phtml）

在循环展示数据的下方，插入分页 HTML：


getSavedQuotes() as $quote): ?>
    
        escapeHtml($quote->getName()) ?>
        Status: escapeHtml($quote->getStatus()) ?>
    




    getPagerHtml() ?>

⚠️ 关键注意事项

load() 调用时机：$collection->load() 必须在 setCollection($collection) 后、$this->setChild() 前执行，否则 Pager 无法读取 getTotalCount()；
参数命名规范：Magento 默认识别 p（当前页）和 limit（每页条数），勿自定义为 page/size，否则需重写 Pager 的 getPageRouteParams()；
Collection 复用风险：getSavedQuotes() 被多次调用时，避免重复 load()；建议加缓存或使用 clone 避免状态污染；
响应式适配：如需移动端优化，可在 CSS 中调整 .pages, .limiter 等 pager 默认类；
SEO 友好性：分页链接自动包含 canonical 标签，无需额外处理。

✅ 验证方式

访问页面后检查 URL 是否支持如下格式：

yourdomain.com/quotes/?p=2 → 第二页
yourdomain.com/quotes/?p=1&limit=20 → 每页 20 条，第一页

同时查看 HTML 源码，确认

和

忘记密码

登录即同意用户协议和隐私政策

返回登录

重置密码