Graflume · Alpha

Annotation · 차트 고유 기능

시계열의 중요한 사건과 설명을 데이터 좌표에 직접 표시합니다. Graflume 공개 카탈로그에 등록된 이 계열의 모든 실행 모드입니다. 각 탭은 독립 데이터, 옵션, Quick API와 지원 기능 근거를 가집니다.

차트 계열 · 기본 차트 계열

Annotation

시계열의 중요한 사건과 설명을 데이터 좌표에 직접 표시합니다.

Quick API
annotation()
브라우저 스냅샷
graflume
mark
annotation
프리셋
3

차트 고유 기능

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

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

Annotation chart

Annotation chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: datum/layer/range/plot targets · runtime CRUD.

상태불러오는 중

  • annotation
  • datum/layer/range/plot targets
  • runtime CRUD
  • keyboard authoring
Graflume.annotation() Canvas 2D
조작 도움말

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

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

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

불러오는 중

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

브라우저 API

Graflume.annotation()

const data = [
  {
    "annotation": null,
    "date": "2026-01-01",
    "value": 48
  },
  {
    "annotation": null,
    "date": "2026-02-01",
    "value": 53
  },
  {
    "annotation": "Spring release",
    "date": "2026-03-01",
    "value": 51
  },
  {
    "annotation": null,
    "date": "2026-04-01",
    "value": 59
  },
  {
    "annotation": null,
    "date": "2026-05-01",
    "value": 66
  },
  {
    "annotation": null,
    "date": "2026-06-01",
    "value": 70
  },
  {
    "annotation": null,
    "date": "2026-07-01",
    "value": 76
  },
  {
    "annotation": null,
    "date": "2026-08-01",
    "value": 82
  },
  {
    "annotation": "Team plan launch",
    "date": "2026-09-01",
    "value": 80
  },
  {
    "annotation": null,
    "date": "2026-10-01",
    "value": 89
  },
  {
    "annotation": null,
    "date": "2026-11-01",
    "value": 96
  },
  {
    "annotation": null,
    "date": "2026-12-01",
    "value": 104
  }
];

const options = {
  "accessibility": {
    "description": "확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.",
    "label": "Annotation example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "labels": {
        "orientation": "horizontal"
      },
      "position": "bottom",
      "ticks": {
        "count": 4,
        "spacing": 8
      }
    },
    "y": {
      "format": {
        "type": "integer"
      }
    }
  },
  "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": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "날짜",
          "timeZone": "UTC"
        },
        {
          "field": "value",
          "format": "number",
          "label": "값"
        },
        {
          "field": "annotation",
          "format": "auto",
          "label": "설명"
        }
      ],
      "title": "Annotation",
      "trigger": "axis"
    }
  },
  "locale": "ko",
  "mark": {
    "fields": {
      "annotation": "annotation"
    },
    "point": true
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Annotation chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: datum/layer/range/plot targets · runtime CRUD.",
    "text": "Annotation"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Month",
    "type": "temporal"
  },
  "y": {
    "field": "value",
    "title": "Active teams",
    "type": "quantitative"
  }
};

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

이식 가능한 스키마

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "확대·이동은 화면을 살펴보기 위한 기능이며 데이터 축이나 값은 바꾸지 않습니다. 재생 조작이 보이는 차트에서는 원본 데이터에서 고유값이 처음 등장한 순서대로 실제 단계만 이동합니다.",
    "label": "Annotation example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "labels": {
        "orientation": "horizontal"
      },
      "position": "bottom",
      "ticks": {
        "count": 4,
        "spacing": 8
      }
    },
    "y": {
      "format": {
        "type": "integer"
      }
    }
  },
  "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": [
        {
          "dateStyle": "long",
          "field": "date",
          "format": "date",
          "label": "날짜",
          "timeZone": "UTC"
        },
        {
          "field": "value",
          "format": "number",
          "label": "값"
        },
        {
          "field": "annotation",
          "format": "auto",
          "label": "설명"
        }
      ],
      "title": "Annotation",
      "trigger": "axis"
    }
  },
  "locale": "ko",
  "mark": {
    "fields": {
      "annotation": "annotation"
    },
    "point": true
  },
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Annotation chart 모드가 실행 가능한 데이터와 옵션으로 보여주는 핵심 기능: datum/layer/range/plot targets · runtime CRUD.",
    "text": "Annotation"
  },
  "width": "container",
  "x": {
    "field": "date",
    "title": "Month",
    "type": "temporal"
  },
  "y": {
    "field": "value",
    "title": "Active teams",
    "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.

3 modes · 1 compatibility identifiers

Annotation · supported modes · representative annotation
IDNameQuick APImodemarkrenderer
annotationAnnotation chartannotation()defaultannotationcanvas
annotated-timelineAnnotated timelineannotatedTimeline()timelineannotationcanvas
event-flagsEvent flagseventFlags()event-flagsflagscanvas
Annotation · compatibility identifiers
IdentifierCanonical mode ID
flagsevent-flags

매뉴얼

통합 체크리스트

ARIA · table fallback

접근성

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

standard · large · ultra

성능

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

차트 카탈로그