Initializing help system before first use

Table Layout and Display State Saving

When a table is in an unsized column, its columns stretch to fit their contents. When the total table width hits the section width, it wraps content in the columns.

If it still exceeds the section width after applying word-wrap, the relevant <vdl-section> will display a horizontal scrollbar.

You can set a width attribute in pixels to control the width of a table and its individual columns. You can also control the width of a table with the size attribute of the <vdl-section> or <vdl-column> the table is contained within.

By default, the display state of each table in a view is stored in the user's browser session. If a table is redrawn or the user navigates back and forth between views or apps, the tables will remain in the same state. This includes:
  • Global search values.
  • Column search values.
  • Column sorting.
  • Pagination - page size, current page.

If a user closes the browser window or if they log in as a different user within the same browser window then the state for all tables is wiped. This kind of state is only considered as temporary state, retained while users are working within a given browser window or Xpress Insight session.

During view development, if you are changing the configuration of tables you may wish to disable table state saving temporarily. You may also wish to disable it permanently for particular tables in a view. To do this, add the save-state="false" attribute to the <vdl-table> element.

Parent Topic Working with VDL Tables