SimplePagination

SimplePagination - 简单分页 是一个分页加载数据的组件。设计用来在 TableDataGrid 和其他列表组件内部使用。

组件的 XML 名称:simplePagination

基本用法

SimplePagination 的外观很简单,包含行数和导航按钮。与 Pagination 不同,SimplePagination 不支持特定的页数。

SimplePagination 也可以带每页条数的 下拉列表

simple pagination

Jmix Studio 在为实体创建浏览界面和主从界面时,默认生成 SimplePagination

数据绑定

如需创建关联至数据的 SimplePagination,可以用 XML 的 containerProviderloaderProvider 内部元素。

如果是在 TableDataGrid 等列表组件中使用 SimplePagination,则无需指定数据加载器和容器的 provider,会自动从列表组件中获取。

下面示例将 simplePagination 作为 table 的一部分进行声明。

<data>
    <collection id="customersDc" class="ui.ex1.entity.Customer">
        <fetchPlan extends="_base"/>
        <loader id="customersDl">
            <query>
                <![CDATA[select e from uiex1_Customer e]]>
            </query>
        </loader>
    </collection>
</data>
<layout expand="customersTable">
    <table id="customersTable" width="100%" dataContainer="customersDc">
        <actions>
            <action id="create" type="create"/>
            <action id="edit" type="edit"/>
            <action id="remove" type="remove"/>
        </actions>
        <simplePagination itemsPerPageVisible="true"
                          itemsPerPageOptions="2, 4, 6"
                          itemsPerPageDefaultValue="4"/>
        <columns>
            <column id="level"/>
            <column id="age"/>
            <column id="hobby"/>
            <column id="firstName"/>
            <column id="lastName"/>
            <column id="rewardPoints"/>
        </columns>
        <buttonsPanel id="buttonsPanel" alwaysVisible="true">
            <button id="createBtn" action="customersTable.create"/>
            <button id="editBtn" action="customersTable.edit"/>
            <button id="removeBtn" action="customersTable.remove"/>
        </buttonsPanel>
    </table>
</layout>

自动加载

SimplePagination 显示当前数据的行数以及一个问号图标 simple pagination question mark。如果点击问号图标,该组件会加载数据的总行数。

autoLoad 属性设定是否自动加载总行数。当 autoLoad = "false" 时,组件不知道数据的总行数,显示 [?] 按钮。当 autoLoad = "true" 时,组件会执行一个查询语句获取数据的总数并展示。默认为 false

事件和处理器

如需使用 Jmix Studio 生成处理器的桩代码,需要在界面 XML 描述或者 Component Hierarchy 面板选中该组件,然后用 Component Inspector 面板的 Handlers 标签页生成。

或者可以使用界面控制器顶部面板的 Generate Handler 按钮。

AfterRefreshEvent

参阅 AfterRefreshEvent

BeforeRefreshEvent

参阅 BeforeRefreshEvent

TotalCountDelegate

参阅 TotalCountDelegate

XML 属性

可以使用 Studio 界面设计器的 Component Inspector 面板查看和编辑组件的属性。