Charting Table β Column Width Distribution
The charting table in the Zenoti Mobile App distributes horizontal space across its columns so that the table always fills its full container width. This article explains how that distribution works and what to expect when viewing charting data on a tablet or mobile device.
Audience: Employees who use charting tables in the Zenoti Mobile App to review or enter clinical data.
Before you begin
- You must have access to a charting form that includes a table component.
- The charting table layout is configured by your administrator. For information about configuring charting layouts, see your administrator.
- This behavior applies automatically β no employee action is required to trigger column width distribution.
Steps
Understand how column width is distributed
The charting table automatically distributes available horizontal space each time it renders. The following steps describe the order in which the distribution logic runs.
The table measures its container. When a charting table opens, the app measures the total horizontal width available to the table within the screen or form panel.
Each column receives its minimum or maximum width. The table applies any minimum and maximum width bounds that have been configured for each column. Columns that are wide enough to display their full content take their natural width. Columns whose content is wider than the maximum allowed are capped β their header or content text is shortened with an ellipsis.
Free space is identified. After all columns are sized within their bounds, the table checks whether the sum of column widths is less than the available container width. If it is, free (surplus) space remains.
Capped columns receive the surplus first. Any column whose header or content was shortened by the maximum-width cap gets priority for the surplus space. The table allocates free space to these columns until they are wide enough to display their full text β making previously ellipsized headers readable.
Remaining surplus is spread proportionally. If free space still remains after restoring capped columns, the table distributes it proportionally across all columns. This ensures the table spans the full container width with no blank space to the right of the last column.
When columns are already too wide, the table scrolls. If the combined clamped widths of all columns exceed the available width β for example, when a large number of columns are configured β the table does not compress columns below their minimum bounds. Instead, it renders at the natural clamped width and scrolls horizontally so all columns remain accessible.
Read a table that scrolls horizontally
When a charting table scrolls horizontally, all data is still present β it extends beyond the visible area.
- Tap and drag the table to the left to reveal columns to the right.
- Continue scrolling until you have reviewed all columns.
- Scroll back to the right to return to the first column.
Note: Horizontal scrolling occurs only when the total column width exceeds the screen width after applying per-column minimum bounds. On wider tablet screens, most tables fit within the visible area without scrolling.
Worked example
Example: A charting table has four columns: Injection Site, Product, Units, and Notes. The Notes column has a maximum width cap that cuts off its header when the form is open on a phone in portrait orientation. When the same table opens on a tablet in landscape orientation, the container is wider. The table first restores the Notes column to its full readable width using the surplus space. The remaining surplus is then divided proportionally across all four columns, so the table stretches edge to edge with no gap on the right.
Tips
- On a tablet in landscape orientation, charting tables are less likely to scroll horizontally because more width is available. If you find a table difficult to read on a phone, switch to a tablet or rotate the device to landscape orientation.
- If a column header appears cut off with an ellipsis, the table may not have enough free space to restore it in the current screen orientation. Rotating the device or expanding the panel may provide enough additional width.
- If a table consistently scrolls horizontally and makes data entry difficult, ask your administrator to review the column count or maximum width settings on the charting form.
Troubleshooting
| Symptom | Likely cause | What to do |
|---|---|---|
| Table does not fill the full width of the screen; blank space appears to the right | The table width distribution has not yet applied, or the screen width changed after render | Close and reopen the charting form to trigger a fresh layout pass |
| Column headers are cut off with an ellipsis and remain cut off even on a wide screen | All available surplus space was consumed by other columns before this column could be restored | Rotate the device to landscape orientation to increase container width; if the issue persists, ask your administrator to adjust column maximum widths |
| Table scrolls horizontally and shows many columns | The combined clamped column widths exceed the available screen width | Scroll the table to review all columns; if horizontal navigation is significant, ask your administrator to reduce the number of columns on the charting form |