Magento 2 开发内容目录
本章节讨论 Magento 2 后台数据网格。如你所知 Magento 2 网格是一种数据表格,用来显示数据库中对应表的数据,并提供了排序、筛选、删除、更新数据的功能。示例网格可以查看后台产品列表和用户列表。
Magento 2 提供了两种创建网格的方式:使用布局文件和使用组件(component)。接下来会讨论他们的实现细节。在此之前请确保已经创建了前几章节的简单模块,并添加了后台菜单和路由文件,这些在本节都会用到。
创建管理网格步骤如下:
- 1 创建数据表
- 2 创建后台路由
- 3 添加后台导航菜单项
- 4 添加控制器
- 5 使用组件创建网格
- 6 使用布局文件创建网格
第一步 创建数据表
编辑安装配置文件 app/code/Aqrun/HelloWorld/Setup/InstallSchema.php
这个文件只会运行一次在模块安装时。创建数据表的代码:
第二步 添加后台路由
文件: app/code/Aqrun/HelloWorld/etc/adminhtml/routes.xml
第三步 添加导航菜单
使用的路由名称是 aqrun_helloworld
,那后台页面链接就会是 aqrun_helloworld/post/index
如何添加查看后台菜单部分内容
第四步 添加控制器
文件: app/code/Aqrun/HelloWorld/Controller/Adminhtml/Post/Index.php
第五步 方式一:使用组件创建后台网格
5.1 定义数据资源
创建依赖注入文件 di.xml 并定义数据资源,为我们的网格提供的数据关联模型。
文件: app/code/Aqrun/HelloWorld/etc/di.xml
代码:
这个文件为数据表定义了定义了 Post 集合类参数是 表名称和资源模型(ResouceModel)。节点说明:
- type 节点是编辑系统的 CollectionFactory 类根据参数会给他的变量 collections 增加一个资源键=>值
['aqrun_helloworld_post_listing_data_source' => 'Aqrun\HelloWorld\Model\ResourceModel\Post\Grid\Collection']
。
- virtualType 节点是定义一个类
Aqrun\HelloWorld\Model\ResourceModel\Post\Grid\Collection
类继承自 Magento\Framework\View\Element\UiComponent\DataProvider\SearchResult
。
在下面的布局文件中网格会调用这个数据资源键来获取数据。
5.2 创建布局文件
控制器动作是 aqrun_helloworld/post/index
, 对应的布局文件就是 aqrun_helloworld_post_index.xml
文件: app/code/Aqrun/HelloWorld/view/adminhtml/layout/aqrun_helloworld_post_index.xml
代码:
当前页面内容通过布局文件中定义的 uiComponet
节点获取对应组件
5.3 创建组件布局文件
根据上一步布局文件内容,现在我们创建组件布局文件 aqrun_helloworld_post_listing.xml
文件: app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_index.xml
代码:
根据以上代码可以了解如何定义网格布局,如何调用数据。现在清除缓存如下显示:
5.4 添加列表工具条
如本文开始所提到的,网格系统也支持一些交互操作如:排序、筛选、删除更新等。排序是网格的默认功能,可以点击表头进行排序显示。接下来看看其它功能如何实现:
添加控件需要在组件布局文件的父节点 listing 下面进行编辑:
文件: app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_listing.xml
5.5 添加书签控件
这个参数会加载模板 Magento/Ui/view/base/web/templates/grid/toolbar.html
,用来处理网格所有异步更新操作。控件窗口可以放在列元素前或后:
文件: app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_listing.xml
书签控件允许管理员设置网格不同状态。每种状态可有不同的字段列表。因此每个管理员用户可以选择它特定的信息显示。
5.6 列控件
这个控件会添加一个字段列表可以控制网格显示指定字段,改动之后可以选择把这个状态操作为一个书签,方便下次快速显示。
文件: app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_listing.xml
5.7 全文搜索
这个节点会在网格上面添加一个搜索框,可以搜索数据表的所有数据
文件: app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_listing.xml
5.8 筛选
这个节点为每个列定义一个筛选框
文件: 'app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_listing.xml'
5.9 批量操作控件
这个节点会添加一个对列表进行批量操作的下拉列表。管理员可以使用这个控件一次性操作多条数据
文件: app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_listing.xml
5.10 分页
这个节点可以为网格添加分页按钮,如果有大量数据就会很实用
文件: app/code/Aqrun/HelloWorld/view/adminhtml/ui_component/aqrun_helloworld_post_listing.xml
5.11 导出
这个节点可以添加导出功能,你可以导出当前网格的数据
清空缓存如下显示
第六步 第二种方式 使用布局文件创建网格
注意! 如果第五步已经完成了就路过这一步,当然也可以新增一个路由在新的页面使用这种方式实现
上面已经使用了组件的方式添加网格,现在这个来看看如何使用普通的 布局/区块 文件实现
6.1 为网格创建区块
文件: app/code/Aqrun/HelloWorld/Block/Adminhtml/Post.php
网格区块继承了 \Magento\Backend\Blcok\Widget\Grid\Container
类,然后在 _construct()
方法中定义了一些变量
- _blockGroup 是我们模块的名称格式为: VendorName_ModuleName
- _controller 是区块文件夹中网格区块的路径,这里放的是 Adminhtml/Post 文件夹在的 Grid.php 文件
- _headerText 是网格页面标题
- _addButtonLabel 是创建按钮的显示文字
6.2 添加布局文件
现在添加布局文件并调用网格区块显示网格:
文件: app/code/Aqrun/HelloWorld/view/adminhtml/layout/aqrun_helloworld_post_index.xml
布局文件中,定义了一些网格需要的参数,最主要的是 dataSource
节点。这个节点调用 di.xml 文件中定义的数据资源可以获取数据
6.4 添加控件
如何要使用批量操作控件可以添加下面的节点
清空缓存如下显示: