id: stacked-composition
name:
  ja: 100%構成比バー
  en: Stacked Composition
purpose:
  ja: 対象別の構成比を同じ長さの帯で比較し、母数も併記する。
  en: Stacked Composition with explicit source values and reading conditions.
status: published
still: ./still.png
category: analysis
catalogOrder: 240
jobs:
  - measure-change
useCases:
  - kpi
layoutKinds:
  - stack
tags:
  - stacked-composition
  - analysis
  - offline
  - responsive
whenToUse:
  - ja: 対象別の構成比を同じ長さの帯で比較し、母数も併記する。
    en: Use to communicate stacked composition.
avoidWhen:
  - ja: 同じ条件・単位で比較できないデータには使わない
    en: Do not compare values with incompatible units, populations, or assumptions.
requiredInputs:
  - ja: 帯は構成比。総量を比較するときは母数を見る。
    en: Provide the source values, labels and decision conditions described by the schema.
relatedLayouts:
  - grouped-bar-comparison
dataSchema:
  title: string — 結論を伝える見出し
  subtitle: string? — 出典・時点・母集団や仮定
  unit: string — 入力した実数の単位
  series: array (0, 1, 2) — 内訳のラベル
  items: array (label, values) — 各対象の非負の実数。合計は正
sources: []