Skip to content

spec: add bar-horizontal specification#1950

Merged
MarkusNeusinger merged 1 commit intomainfrom
specification/bar-horizontal
Dec 25, 2025
Merged

spec: add bar-horizontal specification#1950
MarkusNeusinger merged 1 commit intomainfrom
specification/bar-horizontal

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

New Specification: bar-horizontal

Related to #1946


specification.md

bar-horizontal: Horizontal Bar Chart

Description

A horizontal bar chart displaying categorical data with rectangular bars extending horizontally from the y-axis. The length of each bar is proportional to the value it represents. This orientation is particularly effective when category names are long or numerous, as horizontal labels are easier to read than rotated vertical labels. Horizontal bar charts excel at rankings, comparisons, and survey results visualization.

Applications

  • Displaying survey results with descriptive response options
  • Showing ranked lists such as top products, countries by population, or employee performance
  • Creating population pyramid base charts for demographic analysis

Data

  • category (categorical) - Labels for each bar on the y-axis
  • value (numeric) - Length of the bars representing the measured quantity
  • Size: 5-20 categories recommended for readability
  • Example: Survey response counts, country statistics, product performance metrics

Notes

  • Bar heights should be consistent across all categories
  • Consider sorting bars by value for easier comparison (largest to smallest or vice versa)
  • Use a single color for all bars, or highlight specific bars to draw attention
  • Ensure adequate spacing between bars for visual clarity
  • Value labels can be placed at the end of bars or inside them

Next: Add approved label to the issue to merge this PR.


🤖 spec-create workflow

@MarkusNeusinger MarkusNeusinger added the approved Approved for implementation label Dec 25, 2025
@MarkusNeusinger MarkusNeusinger merged commit 6e2f73b into main Dec 25, 2025
5 checks passed
@MarkusNeusinger MarkusNeusinger deleted the specification/bar-horizontal branch December 25, 2025 08:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Approved for implementation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant