• Settings
    • Locale
    • Change the locale of the datepicker, schedule and client side validation messages.

      Language
      English
      English
      English
      French
      German
      German
      German
      Italian
      Korean
      Spanish
      Catalan
      Dutch
      Portuguese
      Portuguese
      Arabic
      Arabic
      Bulgarian
      Bangla
      Bosnian
      Czech
      Greek
      Estonian
      Persian
      Finnish
      Danish
      Hindi
      Indonesian
      Icelandic
      Croatian
      Japanese
      Hungarian
      Hebrew
      Georgian
      Central Kurdish
      Khmer
      Kyrgyz
      Kazakh
      Lithuanian
      Latvian
      Malay
      Norwegian
      Polish
      Romanian
      Russian
      Slovak
      Slovenian
      Serbian
      Serbian
      Swedish
      Thai
      Turkish
      Ukrainian
      Uzbek
      Vietnamese
      Chinese
      Chinese
  • Resources

DataTable Multi View State

MultiViewState (MVS) feature enables DataTable to maintain its state across pages by setting multiViewState attribute to true. In this demo, manipulate DataTable with pagination, sorting, filtering and selection, then visit another page and then come back to this page. DataTable state should remain as you've left it.

DataTable Tag Documentation

DataTable is an enhanced version of the standard Datatable that provides built-in solutions to many commons use cases like paging, sorting, selection, lazy loading, filtering and more.

NameTypeRequiredDefaultDescription
id String false generated Unique identifier of the component in a namingContainer.
rendered boolean false true Boolean value to specify the rendering of the component, when set to false component will not be rendered.
binding UIComponent false generated An EL expression referring to a server side UIComponent instance in a backing bean.
widgetVar String false generated ('widget_' + componentClientId) Name of the client side widget.
allowUnsorting boolean false false Defines whether columns are allowed to be unsorted.
ariaRowLabel String false Label to read by screen readers on checkbox and radio selection.
cellEditMode String false eager Defines the cell edit behavior, valid values are "eager" and "lazy".
cellNavigation boolean false true Enables cell navigation with the keyboard for WCAG and screen reader compliance.
cellSeparator String false Separator text to use in output mode of editable cells with multiple components.
clientCache boolean false false Caches the next page asynchronously.
currentPageReportTemplate String false ({currentPage} of {totalPages}) Template of the currentPageReport UI.
dataLocale Object false The view locale Locale to be used in features such as sorting.
dir String false ltr Defines text direction, valid values are ltr and rtl.
disableContextMenuIfEmpty boolean false false Decides whether to disable context menu or not if a table has no records.
draggableColumns boolean false false Decides whether datatable columns can be reordered using dragdrop.
draggableRows boolean false false When enabled, rows can be reordered using dragdrop.
draggableRowsFunction MethodExpression false Method expression to execute after dragging row.
editInitEvent String false click Defines a client side event to open cell on editable table.
editMode String false row Defines edit mode, valid values are "row" and "cell".
editable boolean false false Controls incell editing.
editingRow boolean false false Defines if cell editors of row should be displayed as editable or not. False means display mode.
emptyMessage String false i18n Text to display when there is no data to display.
escapeText boolean false true Defines if headerText and footerText values on columns are escaped or not.
expandedRow boolean false false Defines if row should be rendered as expanded by default.
exportRowTag String false If XML data exporter in use, this allows customization of the row tag in the XML.
exportTag String false If XML data exporter in use, this allows customization of the document tag in the XML.
filterBy Object false Property to be used for filtering.
filterDelay int false 300 Delay to wait in milliseconds before sending each filter query.
filterEvent String false keyup Client side event to invoke filtering. If "enter" it will only filter after ENTER key is pressed.
filterNormalize boolean false false Defines if filtering would be done using normalized values (accents will be removed from characters).
filteredValue Object false List to keep the filtered data if filtering is enabled.
first int false 0 Index of the first data to display.
frozenColumns int false 0 Number of columns to freeze
frozenColumnsAlignment String false left Defines the alignment of frozen columns, valid values are 'left' and 'right'.
frozenRows int false 0 Number of rows to freeze starting from the beginning.
globalFilter String false Value of the global filter to use when filtering by default.
globalFilterFunction MethodExpression false Custom implementation to globally filter a value against a constraint.
globalFilterOnly boolean false false When true this will hide all column filters and allow all columns to be filtered by global filter only.
lazy boolean false True, if the value-binding is instance of LazyDataModel. Defines if lazy loading is enabled for the data component.
liveResize boolean false false Columns are resized live in this mode without using a resize helper.
liveScroll boolean false false Enables live scrolling.
liveScrollBuffer int false 0 Percentage height of the buffer between the bottom of the page and the scroll position to initiate the load for the new chunk. Value is defined in integer.
multiViewState boolean false false Whether to keep component state across views.
nativeElements boolean false false In native mode, treetable uses native checkboxes.
onExpandStart String false Client side callback to execute before row expansion.
onRowClick String false Client side callback to execute after clicking row.
pageLinks int false 10 Maximum number of page links to display.
paginator boolean false false Enables pagination.
paginatorAlwaysVisible boolean false true Defines if paginator should be hidden if total data count is less than number of rows per page.
paginatorPosition String false bottom Position of the paginator.
paginatorTemplate String false {FirstPageLink} {PreviousPageLink} {PageLinks} {NextPageLink} {LastPageLink} {RowsPerPageDropdown} Template of the paginator.
partialUpdate boolean false true When disabled, it updates the whole table instead of updating a specific field such as body element in the client requests of the dataTable.
reflow boolean false false Reflow mode is a responsive mode to display columns as stacked depending on screen size.
renderEmptyFacets boolean false false Render facets even if their children are not rendered.
resizableColumns boolean false false Decides whether datatable columns are resizable or not.
resizeMode String false fit Defines the resize behavior, valid values are "fit" and expand.
rowDragSelector String false td,span:not(.ui-c) Defines the element used to reorder rows using dragdrop.
rowEditMode String false eager Defines the row edit behavior, valid values are "eager" and "lazy".
rowExpandMode String false multiple Defines row expand mode, valid values are "single" and "multiple".
rowHover boolean false false Adds hover effect to rows, default is false. Hover is always on when selection is enabled.
rowIndexVar String false Name of iterator to refer each row index.
rowKey String false Unique identifier of row data.
rowSelector String false Client side check if rowclick triggered row click event not a clickable element in row content.
rowStatePreserved boolean false false Keeps state of its children on a per-row basis.
rowStyleClass String false Style class for each row.
rowTitle String false Title for each row.
rows int false 0 Number of rows to display per page. Default value is 0 meaning to display all data available.
rowsPerPageTemplate String false Template of the rowsPerPage dropdown.
saveOnCellBlur boolean false true Saves the changes in cell editing on blur, when set to false changes are discarded.
scrollHeight String false Height for scrollable data.
scrollRows int false 0 Number of rows to display in virtual scrolling mode.
scrollWidth String false Width for scrollable data.
scrollable boolean false false Makes data scrollable with fixed header.
selectAllFilteredOnly boolean false false When enabled, toggle select will only apply on filtered items.
selection Object false Reference to the selection data.
selectionDisabled boolean false false Disables row selection when true.
selectionMode String false Detected though the "selection" value expression. Enables data selection, valid values are "single" and "multiple".
selectionPageOnly boolean false true When using paginator and checkbox selection mode the select all checkbox in header will select the current page if true or all rows if false. When false, individual row unselections after 'select all' are preserved even across page navigation.
selectionRowMode String false new Indicates how rows of a DataTable may be selected, when clicking on the row itself (not the checkbox / radiobutton from p:column). The value `new` always unselects other rows, `add` preserves the currently selected rows, and `none` disables row selection.
selectionTextDisabled boolean false true Disables text selection on row click.
showGridlines boolean false false When enables, cell borders are displayed.
showSelectAll boolean false true Whether to show the select all checkbox inside the column's header.
size String false regular Size of the table content, valid values are "small", "regular" and "large".
skipChildren boolean false false Ignores processing of children during lifecycle, improves performance if table only has output components.
sortBy Object false Property to be used for sorting.
sortMode String false multiple Defines sorting mode, valid values are "single" and "multiple".
stickyHeader boolean false false Sticky header stays in window viewport during scrolling.
stickyTopAt String false Selector to position on the page according to other fixing elements on the top of the table.
stripedRows boolean false false Whether to display striped rows to visually separate content.
style String false Inline style of the component.
styleClass String false Style class of the component.
summary String false Summary attribute for WCAG.
tabindex String false 0 Position of the element in the tabbing order.
tableStyle String false Inline style of the table element.
tableStyleClass String false Style class of the table element.
touchable Boolean false Enable touch if supported by device. NULL uses global default or primefaces.TOUCHABLE. Default: globally enabled.
value Object true Datasource of the component.
var String true Name of the iterator variable that references each element in the data set.
virtualScroll boolean false false Loads data on demand as the scrollbar gets close to the bottom.
Loading...
Tag DocumentationNew DocumentationNew Documentation JSDoc Basic ColumnToggler ContextMenu Crud DisplayPriority Dynamic Columns Edit Facets Field Filter Gridlines Group Lazy MultiViewState Paginator Reorder Resize Responsive RowAdd RowColor RowExpansion RowGroup RowTitle RTL Scroll Selection Size Sort StickyHeader StripedRows SubTable
Basic
Search all fields:
NameCountryRepresentativeStatus
Izzy S Garufi RussiaIoni Bowcher NEGOTIATION
Darci D Gillian RussiaAnna Fali NEW
Greenwood E Bowley United KingdomOnyama Limba QUALIFIED
Munro C Sergi GermanyStephen Shaw PROPOSAL
Misaki U Malet FranceIvan Magalhaes RENEWAL
Stacey Q Briddick JapanOnyama Limba UNQUALIFIED
Jones K Garufi United KingdomOnyama Limba PROPOSAL
Darci Z Vocelka SpainXuxue Feng PROPOSAL
Munro B Garufi BrazilAsiya Javayant RENEWAL
Sinclair O Rulapaugh RussiaAnna Fali NEGOTIATION

Lazy Loading
NameCountryRepresentativeStatus
Aika C Bowley BrazilElwin Sharvill QUALIFIED
Tony F Caldarera RussiaXuxue Feng UNQUALIFIED
Stacey D Rulapaugh SpainAmy Elsner RENEWAL
James O Rulapaugh JapanStephen Shaw QUALIFIED
Arvin X Flosi RussiaIoni Bowcher RENEWAL
Deepesh E Schemmer ArgentinaAsiya Javayant PROPOSAL
Mujtaba U Oldroyd BrazilElwin Sharvill UNQUALIFIED
Salvatore G Dilliard AustraliaBernardo Dominic PROPOSAL
Rodrigues T Shinko CanadaStephen Shaw PROPOSAL
Mujtaba E Campain JapanBernardo Dominic UNQUALIFIED

Usage


<style>
    .ui-datatable .ui-datatable-header {
        text-align: right !important;
    }

    .ui-selectcheckboxmenu-panel .ui-selectcheckboxmenu-header .ui-chkbox {
        display: none;
    }
</style>

<h:form id="form">

    <p:messages id="messages"/>

    <div class="card">
        <h5>Basic</h5>
        <p:dataTable id="tableStateDT" var="customer" value="#{dtMultiViewStateView.customers}"
                     widgetVar="customersTable" multiViewState="true" rows="10" paginator="true"
                     paginatorTemplate="{CurrentPageReport} {FirstPageLink} {PreviousPageLink} {PageLinks} {NextPageLink} {LastPageLink} {RowsPerPageDropdown}"
                     rowsPerPageTemplate="5,10,15" selectionMode="single"
                     selection="#{dtMultiViewStateView.selectedCustomer}" rowKey="#{customer.id}"
                     emptyMessage="No customers found with given criteria"
                     filteredValue="#{dtMultiViewStateView.filteredCustomers}">

            <f:facet name="header">
                <p:outputPanel>
                    <h:outputText value="Search all fields:"/>
                    <p:inputText id="globalFilter" onkeyup="PrimeFaces.debounce(() => PF('customersTable').filter())" style="width:150px"
                                 placeholder="Enter keyword"/>
                </p:outputPanel>
            </f:facet>

            <p:ajax event="rowSelect" update=":form:customerDetail" oncomplete="PF('customerDialog').show()"/>

            <p:column headerText="Name" filterBy="#{customer.name}" sortBy="#{customer.name}"
                      filterMatchMode="contains">
                <h:outputText value="#{customer.name}"/>
            </p:column>

            <p:column headerText="Country" filterBy="#{customer.country.name}" sortBy="#{customer.country.name}"
                      filterMatchMode="startsWith">
                <span class="flag flag-#{customer.country.code}" style="width: 30px; height: 20px"/>
                <h:outputText style="vertical-align: middle; margin-left: .5rem"
                              value="#{customer.country.name}"/>
            </p:column>

            <p:column headerText="Representative" filterBy="#{customer.representative.name}"
                      sortBy="#{customer.representative.name}" filterMatchMode="startsWith">
                <p:graphicImage name="images/avatar/#{customer.representative.image}" library="demo"
                                width="32" style="vertical-align: middle"/>
                <h:outputText style="vertical-align: middle; margin-left: .5rem"
                              value="#{customer.representative.name}"/>
            </p:column>

            <p:column headerText="Status" filterBy="#{customer.status}" sortBy="#{customer.status}"
                      filterMatchMode="exact">
                <f:facet name="filter">
                    <p:selectOneMenu onchange="PF('customersTable').filter()"
                                     style="width:100%; box-sizing: border-box;">
                        <f:selectItem itemLabel="Select One" itemValue="#{null}" noSelectionOption="true"/>
                        <f:selectItems value="#{dtMultiViewStateView.customerStatus}"/>
                    </p:selectOneMenu>
                </f:facet>
                <span class="customer-badge status-#{customer.status.name().toLowerCase()}">#{customer.status}</span>
            </p:column>

            <f:facet name="paginatorTopLeft">
                <p:commandButton value="Clear table state" action="#{dtMultiViewStateView.clearMultiViewState}"
                                 update="@form"/>
            </f:facet>
        </p:dataTable>
    </div>

    <br/>

    <div class="card">
        <h5>Lazy Loading</h5>
        <p:dataTable var="customer" value="#{dtLazyView.lazyModel}" paginator="true" rows="10"
                     paginatorTemplate="{RowsPerPageDropdown} {FirstPageLink} {PreviousPageLink} {CurrentPageReport} {NextPageLink} {LastPageLink}"
                     rowsPerPageTemplate="5,10,15" id="customerTable" multiViewState="true">
            <p:column headerText="Name" sortBy="#{customer.name}" filterBy="#{customer.name}">
                <h:outputText value="#{customer.name}"/>
            </p:column>
            <p:column headerText="Country" sortBy="#{customer.country}" filterBy="#{customer.country}">
                <span class="flag flag-#{customer.country.code}" style="width: 30px; height: 20px"/>
                <h:outputText style="vertical-align: middle; margin-left: .5rem" value="#{customer.country}"/>
            </p:column>

            <p:column headerText="Representative" sortBy="#{customer.representative}"
                      filterBy="#{customer.representative}" filterMatchMode="startsWith">
                <p:graphicImage name="images/avatar/#{customer.representative.image}" library="demo"
                                width="32" style="vertical-align: middle"/>
                <h:outputText style="vertical-align: middle; margin-left: .5rem"
                              value="#{customer.representative.name}"/>
            </p:column>

            <p:column headerText="Status" sortBy="#{customer.status}" filterBy="#{customer.status}">
                <span class="customer-badge status-#{customer.status.name().toLowerCase()}">#{customer.status}</span>
            </p:column>

            <f:facet name="paginatorTopLeft">
                <p:commandButton value="Clear table state" action="#{dtMultiViewStateView.clearMultiViewState}"
                                 update="@form"/>
            </f:facet>
        </p:dataTable>
    </div>

    <p:dialog header="Customer Info" widgetVar="customerDialog" modal="true" showEffect="fade" hideEffect="fade"
              resizable="false">
        <p:outputPanel id="customerDetail" style="text-align:center;">
            <p:panelGrid columns="2" rendered="#{not empty dtMultiViewStateView.selectedCustomer}"
                         columnClasses="label,value">
                <h:outputText value="Name:"/>
                <h:outputText value="#{dtMultiViewStateView.selectedCustomer.name}"/>

                <h:outputText value="Country"/>
                <p:column>
                    <span class="flag flag-#{dtMultiViewStateView.selectedCustomer.country.code}"
                          style="width: 30px; height: 20px"/>
                    <h:outputText style="vertical-align: middle; margin-left: .5rem"
                                  value="#{dtMultiViewStateView.selectedCustomer.name}"/>
                </p:column>

                <h:outputText value="Representative"/>
                <p:column>
                    <p:graphicImage
                            name="images/avatar/#{dtMultiViewStateView.selectedCustomer.representative.image}"
                            library="demo"
                            width="32" style="vertical-align: middle"/>
                    <h:outputText style="vertical-align: middle; margin-left: .5rem"
                                  value="#{dtMultiViewStateView.selectedCustomer.representative}"/>
                </p:column>

                <h:outputText value="Status:"/>
                <span class="customer-badge status-#{dtMultiViewStateView.selectedCustomer.status.name().toLowerCase()}">#{dtMultiViewStateView.selectedCustomer.status}</span>
            </p:panelGrid>
        </p:outputPanel>
    </p:dialog>

</h:form>