Segmented Gauge

Installation

Examples

Props

Schema

Type aliases from this item's source — use them to shape the data you pass in.

interface GaugeSegment {
  /** Relative size of the segment. Segments are normalised by their sum. */
  value: number
  /** Optional override; defaults to chart-1..N from the registry palette. */
  color?: string
  /** Optional label, surfaced via the default slot for consumers that
   *  want to render their own legend. */
  label?: string
}

Used by

Files installed (2)

• app/components/ui/charts/segmented-gauge/SegmentedGauge.vue3.7 kB

  Copy

  <script setup lang="ts">
  import { computed } from 'vue'
  import type { HTMLAttributes } from 'vue'
  import { cn } from '@/lib/utils'
  
  interface GaugeSegment {
    /** Relative size of the segment. Segments are normalised by their sum. */
    value: number
    /** Optional override; defaults to chart-1..N from the registry palette. */
    color?: string
    /** Optional label, surfaced via the default slot for consumers that
     *  want to render their own legend. */
    label?: string
  }
  
  interface Props {
    segments: GaugeSegment[]
    /** Container height (px when numeric, raw CSS when string). Default 200. */
    height?: number | string
    /** Stroke width of the arc in SVG units. Default 18. */
    stroke?: number
    /** Angular gap between segments, in degrees. Default 4. */
    gap?: number
    /** Optional fallback palette when `color` is omitted on a segment. */
    colors?: string[]
    /** Show a faint background track behind the arc. Default true. */
    showTrack?: boolean
    class?: HTMLAttributes['class']
    /** Accessible name announced for the chart image. Defaults to "Chart". */
    ariaLabel?: string
  }
  
  const props = withDefaults(defineProps<Props>(), {
    height: 200,
    stroke: 18,
    gap: 4,
    showTrack: true,
    colors: () => ['var(--chart-1)', 'var(--chart-2)', 'var(--chart-3)', 'var(--chart-4)', 'var(--chart-5)'],
  })
  
  // SVG geometry. The viewBox uses the centre + radius + stroke so the
  // canvas grows with the stroke width and the labels in the default slot
  // can sit underneath without overlapping the arc.
  const cx = 140
  const cy = 124
  const r = 100
  
  function polar(angleDeg: number) {
    const a = ((angleDeg - 90) * Math.PI) / 180
    return [cx + r * Math.cos(a), cy + r * Math.sin(a)] as const
  }
  
  function arcPath(startA: number, endA: number) {
    const [sx, sy] = polar(startA)
    const [ex, ey] = polar(endA)
    const largeArc = endA - startA > 180 ? 1 : 0
    return `M ${sx.toFixed(2)} ${sy.toFixed(2)} A ${r} ${r} 0 ${largeArc} 1 ${ex.toFixed(2)} ${ey.toFixed(2)}`
  }
  
  const startAngle = 180
  const sweep = 180
  
  const arcs = computed(() => {
    const total = props.segments.reduce((acc, s) => acc + s.value, 0) || 1
    let cursor = startAngle
    return props.segments.map((s, i) => {
      const span = (s.value / total) * sweep
      const isLast = i === props.segments.length - 1
      const segEnd = cursor + span - (isLast ? 0 : props.gap)
      const arc = { d: arcPath(cursor, segEnd), color: s.color ?? props.colors[i % props.colors.length] }
      cursor = cursor + span
      return arc
    })
  })
  
  const trackPath = computed(() => arcPath(startAngle, startAngle + sweep))
  
  const heightStyle = computed(() => (/^\d+$/.test(String(props.height)) ? `${props.height}px` : String(props.height)))
  </script>
  
  <template>
    <div
      data-uipkge
      data-slot="segmented-gauge"
      tabindex="0"
      :style="{ height: heightStyle }"
      :class="cn('focus-visible:ring-ring relative w-full focus-visible:ring-2 focus-visible:outline-none', props.class)"
    >
      <svg
        :viewBox="`0 0 ${cx * 2} ${cy + stroke}`"
        class="block h-full w-full"
        preserveAspectRatio="xMidYMid meet"
        role="img"
        :aria-label="ariaLabel || 'Chart'"
      >
        <path
          v-if="showTrack"
          :d="trackPath"
          fill="none"
          stroke="currentColor"
          :stroke-width="stroke"
          stroke-linecap="round"
          class="text-muted/40"
          opacity="0.35"
        />
        <path
          v-for="(a, i) in arcs"
          :key="i"
          :d="a.d"
          fill="none"
          :stroke="a.color"
          :stroke-width="stroke"
          stroke-linecap="round"
        />
      </svg>
      <div v-if="$slots.center" class="pointer-events-none absolute inset-x-0 bottom-[8%] flex flex-col items-center">
        <slot name="center" />
      </div>
    </div>
  </template>
  

• app/components/ui/charts/segmented-gauge/index.ts0.1 kB

  Copy

Raw manifest:https://uipkge.dev/r/vue/segmented-gauge.json

Related components