Graflume · Alpha

Waterfall · 차트 고유 기능

양수와 음수 변화가 누적 결과에 기여하는 과정을 단계별로 보여줍니다. Graflume 공개 카탈로그에 등록된 이 계열의 모든 실행 모드입니다. 각 탭은 독립 데이터, 옵션, Quick API와 지원 기능 근거를 가집니다.

차트 계열 · 기본 차트 계열

Waterfall

양수와 음수 변화가 누적 결과에 기여하는 과정을 단계별로 보여줍니다.

Quick API: waterfall()
브라우저 스냅샷: graflume
mark: waterfall
프리셋: 1

차트 고유 기능

이 차트만의 고유한 실행 기능

Graflume 공개 카탈로그에 등록된 이 계열의 모든 실행 모드입니다. 각 탭은 독립 데이터, 옵션, Quick API와 지원 기능 근거를 가집니다.

Waterfall chart

Waterfall chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: running sum · connectors.

상태불러오는 중

waterfall
running sum
connectors
positive and negative styling
explicit relative/absolute/subtotal/total semantics

Graflume.waterfall() Canvas 2D

조작 도움말

확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.

Tab으로 조작부를 이동하고 Enter 또는 Space로 실행하세요. 차트에 초점이 있을 때 더하기·빼기 키로 확대·축소하고 화살표 키로 이동할 수 있습니다.

자동 배치는 둘레 후보를 비교해 차트·범례·다른 말풍선과의 겹침을 가능한 한 피합니다. 명시한 위치는 필요한 안전 보정만 적용해 유지합니다. 말풍선 글자는 상자 안에서 안전하게 자동 줄바꿈됩니다. 끊어지지 않는 긴 토큰은 정해진 줄 수 안에서 시각적으로 축약하지만, 보조 기술에는 원문 전체를 유지합니다.

불러오는 중

Waterfall chart · 행 데이터
`category`ordinal	`value`quantitative
Opening MRR	420
New teams	86
Plan upgrades	34
Reactivations	12
Downgrades	-18
Churn	-41
Currency impact	-5

Waterfall chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: running sum · connectors.

브라우저 API · 이식 가능한 스키마

브라우저 API

Graflume.waterfall()

const data = [
  {
    "category": "Opening MRR",
    "value": 420
  },
  {
    "category": "New teams",
    "value": 86
  },
  {
    "category": "Plan upgrades",
    "value": 34
  },
  {
    "category": "Reactivations",
    "value": 12
  },
  {
    "category": "Downgrades",
    "value": -18
  },
  {
    "category": "Churn",
    "value": -41
  },
  {
    "category": "Currency impact",
    "value": -5
  }
];

const options = {
  "accessibility": {
    "description": "확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.",
    "label": "Waterfall example"
  },
  "axes": {
    "x": {
      "labels": {
        "orientation": "horizontal"
      }
    },
    "y": {
      "format": {
        "fractionDigits": 0,
        "prefix": "₩",
        "suffix": "M",
        "type": "compact"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "차트 조작",
        "enterFullscreen": "전체 화면 열기",
        "exitFullscreen": "전체 화면 닫기",
        "exportPng": "PNG 다운로드",
        "hideAnnotations": "설명 말풍선 숨기기",
        "loop": "반복 재생",
        "nextFrame": "다음 프레임",
        "pause": "일시 정지",
        "play": "재생",
        "previousFrame": "이전 프레임",
        "reset": "보기 초기화",
        "seek": "재생 위치",
        "showAnnotations": "설명 말풍선 표시",
        "speed": "재생 속도",
        "zoomIn": "확대",
        "zoomOut": "축소"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "field": "category",
          "format": "auto",
          "label": "범주"
        },
        {
          "field": "value",
          "format": "number",
          "label": "값"
        }
      ],
      "title": "Waterfall",
      "trigger": "axis"
    }
  },
  "locale": "ko",
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Waterfall chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: running sum · connectors.",
    "text": "Waterfall"
  },
  "width": "container",
  "x": {
    "field": "category",
    "title": "Revenue driver",
    "type": "ordinal"
  },
  "y": {
    "field": "value",
    "title": "MRR change (kUSD)",
    "type": "quantitative"
  }
};

Graflume.waterfall('#chart', data, options);

이식 가능한 스키마

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.",
    "label": "Waterfall example"
  },
  "axes": {
    "x": {
      "labels": {
        "orientation": "horizontal"
      }
    },
    "y": {
      "format": {
        "fractionDigits": 0,
        "prefix": "₩",
        "suffix": "M",
        "type": "compact"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "차트 조작",
        "enterFullscreen": "전체 화면 열기",
        "exitFullscreen": "전체 화면 닫기",
        "exportPng": "PNG 다운로드",
        "hideAnnotations": "설명 말풍선 숨기기",
        "loop": "반복 재생",
        "nextFrame": "다음 프레임",
        "pause": "일시 정지",
        "play": "재생",
        "previousFrame": "이전 프레임",
        "reset": "보기 초기화",
        "seek": "재생 위치",
        "showAnnotations": "설명 말풍선 표시",
        "speed": "재생 속도",
        "zoomIn": "확대",
        "zoomOut": "축소"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "axis": "x",
      "fields": [
        {
          "field": "category",
          "format": "auto",
          "label": "범주"
        },
        {
          "field": "value",
          "format": "number",
          "label": "값"
        }
      ],
      "title": "Waterfall",
      "trigger": "axis"
    }
  },
  "locale": "ko",
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Waterfall chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: running sum · connectors.",
    "text": "Waterfall"
  },
  "width": "container",
  "x": {
    "field": "category",
    "title": "Revenue driver",
    "type": "ordinal"
  },
  "y": {
    "field": "value",
    "title": "MRR change (kUSD)",
    "type": "quantitative"
  }
}

Catalog

Modes · compatibility identifiers

The source-controlled catalog maps callable modes in this family and compatibility identifiers to their canonical modes. This table contains executable entries only.

Mode / compatibility ID search

1 modes · 1 compatibility identifiers

Waterfall · supported modes · representative `waterfall`
ID	Name	Quick API	mode	mark	renderer
`waterfall`	Waterfall chart	`waterfall()`	`default`	`waterfall`	`canvas`

Waterfall · compatibility identifiers
Identifier	Canonical mode ID
`waterfall`	`waterfall`

ChartSpec · SpatialSpec

범례와 강조

계열을 구분하고 특정 데이터나 범위를 강조하며, 원하는 위치에 설명 말풍선을 놓고 독자가 표식을 선택하게 할 수 있습니다.

범례: 색·선·기호가 나타내는 계열과 척도를 차트 안에서 바로 설명합니다.
포인트·범위 하이라이트: 데이터 한 점, 값 집합, 축 구간 또는 차트 영역을 원본 값을 바꾸지 않고 강조합니다.
설명 말풍선: 데이터, 축 범위 또는 화면 위치에 사용자가 작성한 안전한 텍스트 설명을 연결합니다. 자동 배치는 둘레 후보를 비교해 차트·범례·다른 말풍선과의 겹침을 가능한 한 피합니다. 명시한 위치는 필요한 안전 보정만 적용해 유지합니다. 말풍선 글자는 상자 안에서 안전하게 자동 줄바꿈됩니다. 끊어지지 않는 긴 토큰은 정해진 줄 수 안에서 시각적으로 축약하지만, 보조 기술에는 원문 전체를 유지합니다.
대화형 선택: 표식을 클릭해 선택하고 Escape로 해제하며 선택 상태와 이벤트를 애플리케이션에서 이용합니다.

매뉴얼

통합 체크리스트

ARIA · table fallback

접근성

Canvas ARIA 메타데이터에 텍스트 요약과 표 대체 표현을 함께 제공합니다.

standard · large · ultra

성능

standard·large·ultra 프로필은 렌더링 작업량을 제한합니다.

차트 카탈로그