변수 메타데이터

변수에는 값 말고도 “이 변수를 어디에 쓸 수 있는가”를 정하는 정보가 있습니다. variable Jar는 세 가지 메타데이터를 마스터 그리드와 상세 패널에서 관리합니다.

스코프와 설명은 동기화 때 Figma에서 읽어 오고, 웹에서 고친 내용은 다시 Figma 변수 패널에 반영됩니다. 태그는 웹 전용이라 Figma에는 아무 영향이 없습니다.

값과 마찬가지로 스코프와 설명도 충돌할 수 있습니다. 동기화 전에 같은 변수의 스코프나 설명을 Figma와 웹 양쪽에서 서로 다르게 고쳤다면, 충돌 배너에 스코프도 갈렸습니다 · N건 / 설명도 갈렸습니다 · N건으로 건수가 표시되고, 값 충돌과 같은 방식으로 해당 열에서 행마다 Figma 쪽과 VA 쪽 중 하나를 고릅니다 (스코프 열에서 행마다 고르세요 / 설명 열에서 행마다 고르세요). 고르고 적용하는 절차는 Figma 동기화의 충돌 해결 절과 같습니다.

메타데이터 열 켜기

툴바의 열 아이콘(툴팁 보기 — 열·색 기준)을 누르면 열 섹션에서 모드 · 설명 · 태그 · 스코프 열을 켜고 끕니다. 메뉴를 열어 둔 채 여러 열을 연속으로 토글할 수 있습니다.

세 열을 모두 켠 마스터 그리드입니다. 설명은 글로, 태그는 색 점으로, 스코프는 요약 이름으로 한 행에서 함께 읽힙니다.

설명 · 태그 · 스코프 셀에도 값 셀처럼 코멘트를 남길 수 있습니다. 그 열을 숨겨 두어도 코멘트는 남아 있고, 코멘트로 이동하면 숨긴 열이 자동으로 켜집니다.

스코프 — 변수를 쓸 수 있는 곳

스코프는 Figma가 이 변수를 어떤 속성 피커에 보여줄지 정합니다. 예를 들어 색 변수의 스코프를 텍스트 채우기만으로 좁히면, 프레임 배경색을 고를 때는 그 변수가 목록에 나타나지 않습니다.

• 스코프 셀에는 현재 상태가 요약됩니다 — 전체(지원되는 모든 속성), 없음, 고른 스코프 이름(예: “프레임, 텍스트” — 폭이 모자라면 나머지는 +N 배지로 접힘), 또는 아직 Figma에서 수집하지 않아 값을 모르는 ”—”. ”—“에 마우스를 올리면 아직 Figma에서 수집 전 — 다음 Sync에서 채워집니다라고 안내합니다.
• 셀을 클릭하면 Figma의 스코프 다이얼로그와 같은 위계와 아이콘으로 목록이 열리고, 여러 스코프를 연속으로 켜고 끌 수 있습니다. 목록에는 그 변수 타입에 유효한 스코프만 나옵니다 — 색은 채우기 아래 프레임 · 도형 · 텍스트와 선 · 효과, 숫자는 모서리 반경부터 타이포그래피 묶음까지, 문자열은 텍스트 내용 · 글꼴 · 글꼴 두께 또는 스타일.
• 지원되는 모든 속성에 표시는 모든 스코프를 한 번에 켠 상태입니다 — 켜면 개별 항목이 전부 체크되고, 그중 하나를 끄면 맨 위 항목만 풀리고 나머지는 그대로 남습니다. 색 변수의 채우기도 프레임 · 도형 · 텍스트 채우기에 대해 같은 방식으로 동작합니다.
• 불리언 변수의 스코프 셀은 읽기 전용입니다 — Figma는 불리언 변수의 스코프 지정을 지원하지 않습니다.

설명

• 설명 열에서 바로 입력하거나, 상세 패널에서 편집합니다. 설명은 Figma 변수의 설명과 왕복 동기화됩니다.
• 웹에서 설명을 비워도 Figma에 있는 설명이 지워지지는 않습니다 — 동기화가 Figma 쪽 설명을 삭제하는 일은 없습니다.

태그

• 태그는 7색 팔레트(빨강 · 앰버 · 초록 · 파랑 · 보라 · 마젠타 · 회색)에서 고르는 팀 내부 분류입니다. 태그 열의 셀을 클릭해 팔레트에서 색을 켜고 끄며, 한 변수에 여러 태그를 붙일 수 있습니다.
• 셀에는 태그 색 점이 나란히 표시되고, 넷을 넘으면 나머지는 +N으로 접힙니다. 팔레트의 태그 없음을 누르면 전부 해제됩니다.
• 태그는 웹 전용입니다 — Figma에 반영되지 않고, 동기화해도 지워지지 않습니다.

여러 변수 한 번에

행에 마우스를 올리면 나타나는 상세 아이콘으로 오른쪽 상세 패널을 엽니다. 여러 행을 선택하면 패널이 N개 선택됨으로 바뀌어 선택 전체를 다룹니다.

• 설명을 입력하면 선택한 변수 전부에 적용됩니다.
• 스코프와 태그가 선택 간에 다르면 혼합으로 표시되고, 스코프 체크박스나 태그 색 점을 클릭하면 전체가 그 값으로 통일됩니다.
• 타입이 섞여 있으면 스코프는 편집할 수 없습니다 — 같은 타입 변수만 선택하면 됩니다.
• 일괄 변경은 Ctrl(⌘)+Z 한 번으로 전부 되돌립니다.

그래프에서 상태 보기

토큰 그래프 탭에서는 메타데이터를 색으로 입혀 구조 위에서 한눈에 훑을 수 있습니다.

• 그래프 툴바의 색 기준에서 Figma에 없음을 고르면 아직 Figma에 만들어지지 않은 변수가 강조되고, 참조 단계마다 Figma에 없음 N 칩으로 개수가 보입니다. 마스터 그리드에서는 프로젝트가 Figma 파일에 연결돼 있으면 이 상태가 표시됩니다 — 이름 옆 점에 마우스를 올리면 Figma에 아직 없는 변수 — 다음 Sync에서 만들어지면 사라집니다라고 안내합니다.
• 스코프를 고르면 참조 단계마다 스코프 지정 N · 전체 N · 숨김 N(스코프 없음 — 어느 피커에도 안 나옴) · 미수집 N 칩이 표시되어, 어느 토큰의 정리가 덜 됐는지 바로 보입니다.
• 태그 색 점은 그래프의 토큰 옆에도 그대로 표시됩니다.