docs: document progress bar cell decoration in Lens tables (#7430) - #7720
docs: document progress bar cell decoration in Lens tables (#7430)#7720florent-leborgne wants to merge 1 commit into
Conversation
Renames "Color by value" to "Cell decoration" and "Cell" to "Background" per Kibana PR elastic/kibana#272407, and documents the new Progress bar option (bar color, value range, alignment restriction) for numeric metric columns.
Elastic Docs AI PR menuCheck the box to run an AI review for this pull request.
Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team. |
🔍 Preview links for changed docs |
✅ Elastic Docs Style Checker (Vale)No issues found on modified lines! The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale. |
There was a problem hiding this comment.
Generated by Docs review agent for #7720 · sonnet50 · 85 AIC · ⌖ 6.3 AIC · ⊞ 15.9K
| 3. In the field configuration, look for the **Color by value** option: | ||
| * For data tables: Select **Cell** or **Text** | ||
| 3. In the field configuration, look for the **Cell decoration** or **Color by value** (depending on your version) option: | ||
| * For data tables: Select **Background** or **Cell** (depending on your version), or **Text** |
There was a problem hiding this comment.
Minor clarity nit: "Select Background or Cell (depending on your version), or Text" reads ambiguously because two "or"s are stacked with a parenthetical in between, making it look like three loosely-joined options rather than "old/new label pair, plus Text". Consider clarifying the grouping, e.g.:
| * For data tables: Select **Background** or **Cell** (depending on your version), or **Text** | |
| * For data tables: Select **Background**, **Cell** (depending on your version), or **Text** |
mdbirnstiehl
left a comment
There was a problem hiding this comment.
One little question, otherwise LGTM.
| - **Color by value**: Apply colors to cells based on their values, and choose which cell element to color: | ||
| - **None**: No coloring (default). | ||
| - **Cell**: Color cell backgrounds. | ||
| - **Cell decoration** or **Color by value** (depending on your version): Apply a color or a progress bar to cells based on their values, and choose which cell element to decorate: |
There was a problem hiding this comment.
This page also says "Depending on your Kibana version" in the tables.md doc. Would it make sense to align that language?
Summary
This PR addresses #7430 with the following changes:
explore-analyze/_snippets/lens-tables-column-appearance-settings.md: Renames Color by value to Cell decoration and Cell to Background (inline, version-agnostic phrasing, since this is a simple rename), and documents the new Progress bar decoration for numeric metric columns: bar color (Single/Solid/Gradient, Gradient default), value range (Auto/Custom, including negative bounds), the Left/Right-only alignment restriction (with the auto-switch from Center), and the empty/null/NaN fallback to plain text. This snippet is shared by both Metrics settings > Appearance and Rows settings > Appearance on Build tables with Kibana, so one edit updates both. Progress bar is explicitly scoped to numeric metric columns in the text, since it isn't offered for row/breakdown columns.explore-analyze/visualize/lens.md: Updates the Assign colors to terms procedure's reference to the renamed control (Cell decoration/Color by value, Background/Cell), so the steps still match the current UI.explore-analyze/visualize/charts/tables.md: Updates the Color by value mention in the "Document comparison with custom ranges" example to Cell decoration.Resolves
Closes #7430