---
title: 대시보드 테마
description: 내장 차트 테마를 선택하고, 테마 우선순위를 설정하고, 시리즈 색상을 고정하거나 조직 테마를 만들어 검증합니다.
species: reference
---
# 대시보드 테마

테마는 차트 표면, 글자와 선의 색, 주변 장식, 범주형 및 수치형 팔레트, 상태 색상, 타이포그래피, 보조 요소, 테이블, 시각적 마크 스타일을 제어합니다. 표현만 바꾸며 쿼리 데이터는 바꾸지 않습니다.

## 테마 우선순위

가장 가까운 명시적 설정이 우선합니다.

1. 차트의 `theme="slug"` 속성.
2. 대시보드의 `theme:` 프런트매터.
3. 조직 기본값.
4. 조직 기본값이 없으면 `supernova`.

## 내장 테마

| 슬러그 | 특징 |
|---|---|
| `supernova` | 검정에 가까운 배경, 따뜻한 강조색 1개, 표준 팔레트 |
| `mercury` | 따뜻한 종이 배경 위 세리프 제목과 절제된 색상. 밝은 모드 전용 |
| `starlight` | 흑요석 같은 검정 위 새벽의 따뜻한 빛. 어두운 모드 전용 |
| `redshift` | 잿불색과 녹슨색에 차가운 시리즈 색상 조합 |
| `blueshift` | 차가운 과학적 색조, 촘촘한 격자, 고정폭 숫자 |
| `pulsar` | 강렬한 전기적 분위기의 어두운 색상. 어두운 모드 전용 |
| `aurora` | 극지의 녹색과 보라색, 부드러운 모서리 |
| `eclipse` | 최소한의 주변 장식과 코로나 금빛 강조색 1개 |
| `apollo` | 콘솔의 검정 위 형광색과 호박색. 어두운 모드 전용 |
| `voyager` | 크림색 위 구리색, 금색, 남색 |

**테마**를 열면 같은 샘플 대시보드로 모든 내장 테마를 미리 보고 조직 기본값을 설정할 수 있습니다.

특정 모드 전용 테마는 지원하는 모드에서 작성된 팔레트를 유지합니다. 앱을 다른 모드로 전환하면 다시 돌아올 때까지 대시보드가 Supernova의 밝은 테마나 어두운 테마를 사용합니다. 두 모드를 모두 지원하는 테마는 어느 모드에서든 자체 팔레트를 유지합니다.

## 상태 색상

시리즈 팔레트와 별개로 각 테마에는 값의 *의미*를 나타내는 긍정, 부정, 경고, 중립의 의미적 색상 4개가 있습니다. 큰 숫자 컴포넌트의 변화량은 이 색상으로 긍정과 부정을 표현합니다. 부호도 항상 표시하므로 의미가 색상에만 의존하지 않습니다.

상태 색상은 시리즈 색상으로 사용하지 않습니다. 어떤 컴포넌트 속성으로도 시리즈에 상태 색상을 지정할 수 없습니다. 시리즈를 “긍정” 색으로 표시하면 팔레트가 숫자의 의미와 충돌할 수 있기 때문입니다.

상태 색상을 지정하지 않은 테마는 자체 팔레트에서 4가지 색상을 모두 도출합니다. 긍정, 부정, 경고는 각각 녹색, 빨간색, 호박색에 가장 가까운 시리즈 색상의 색조를 가져오고 텍스트로 읽을 수 있는 명도를 적용합니다. 중립은 테마의 보조 글자색을 사용합니다. 따라서 조직 고유의 녹색을 유지할 수 있고, 상태 색상 도입 전에 작성한 테마 파일도 수정 없이 계속 동작합니다.

직접 지정한 색상과 도출한 색상 모두 저장할 때 동일한 2가지 규칙을 적용받습니다.

## 고정된 시리즈

기본적으로 차트는 자체 결과에 시리즈가 나타나는 순서대로 팔레트 색상을 할당합니다. 따라서 같은 엔터티를 다른 순서로 나열하는 두 차트는 색상이 달라지고, 필터로 시리즈가 제거되면 나머지 시리즈의 색상 위치가 바뀝니다.

중요한 엔터티의 색상을 고정하면 두 현상을 모두 방지할 수 있습니다.

```json
{
  "seriesSlots": { "Northern region": 1, "Southern region": 4 }
}
```

고정된 시리즈는 해당 이름을 사용하는 모든 차트에서 같은 색상 슬롯을 사용합니다. 선, 막대, 도넛 조각, 범례 색상 표시, 도구 설명, `compare`의 흐린 표시에도 적용됩니다. 이름은 대소문자와 앞뒤 공백을 무시하고 비교합니다. 고정되지 않은 시리즈는 고정 색상이 차지한 슬롯을 건너뛰고 각 차트의 순서를 따릅니다. 단, 차트에서 9위 이하인 고정 시리즈는 다른 시리즈와 마찬가지로 “기타”에 합쳐집니다. “기타”에는 자체 색상이 있습니다. 이 색상을 제어하려면 표시 이름인 “기타”가 아니라 설정 키 `Other`를 그대로 입력해 고정하세요.

필터로 시리즈가 제거되어도 유지되는 색상 할당은 고정뿐이며, 의도적으로 명시적 설정을 사용합니다. 자동으로 페이지 전체에 적용하는 방식은 두 요구를 동시에 충족할 수 없습니다. 존재하는 시리즈를 무시하는 할당은 이름만으로 계산해야 하는데, 슬롯이 8개이면 한 차트의 두 이름에 같은 색상이 배정될 수 있습니다. 이를 피하려면 어떤 이름이 있는지 알아야 하고, 그러면 시리즈 집합이 바뀔 때 순서가 달라집니다. 중요한 엔터티를 이름으로 지정하면 두 특성을 모두 만족할 수 있습니다.

## 조직 테마 만들기

**테마 편집**을 선택하고 내장 테마를 바탕으로 브랜드 색상과 표현 옵션을 입력합니다. 상태 색상과 고정 시리즈도 여기서 설정합니다. 저장하면 데이터 저장소에 테마 파일이 기록됩니다. 내장 슬러그는 예약되어 있어 덮어쓸 수 없습니다.

저장할 때마다 대비, 색각에 따른 구별 가능성, 수치형 색상 단계, 필수 모드, 상태 색상의 가독성과 긍정·부정 색상 조합, 고정 슬롯의 중복 여부, 허용 필드가 제한된 테마 스키마를 검증합니다. 유효하지 않은 테마는 렌더링 시 품질이 떨어지도록 두지 않고 실패한 규칙을 알려주며 거부합니다.

## 차트 하나의 테마 재정의

```text
<Chart data={revenue-daily} type="bar" x="day" y="revenue" theme="mercury" />
```

데이터에 페이지의 나머지 부분과 다른 표현이 필요하면 차트별 재정의를 사용합니다. 팔레트 슬롯은 테마에 고정 할당이 있으면 이를 따르고, 없으면 해당 차트의 시리즈 순서를 따릅니다.