MenuToggle Menu
주석 (Annotations)
주석(Annotations)은 인터랙션 구성 요소(트리거 및 리스폰스) 사이에 배치할 수 있는 문서화 블록으로, 작업의 맥락과 설명을 제공합니다. 인터랙션 플로우에 직접 표시되는 인라인 주석 역할을 하며, 다음과 같은 상황에 활용 가능합니다.
- 팀 핸드오프 혹은 인수인계를 위한 인터랙션 로직 문서화
- 복잡한 프로토타입 동작 방식 설명
- 개발자를 위한 구현 참고 노트 작성
- 이해관계자들의 리뷰를 위한 맥락 추가
![[object Object]](https://cdn.sanity.io/images/vidqzkll/production/0afb035da53fe0b0b09c1ea25609a07483b2ec29-1920x1080.gif/Annotations1.gif)
주석 생성하기
상단 바에서 생성
상단 툴바의 주석(Annotation) 버튼을 클릭하여 주석을 추가할 수 있습니다:
- 인터랙션 요소가 선택된 경우: 선택한 요소 바로 아래에 트리거 레벨 또는 리스폰스 레벨의 주석을 생성합니다.
- 선택된 요소가 없는 경우: 인터랙션 패널의 가장 하단에 트리거 레벨 주석을 생성합니다.
- 레이어가 선택된 경우: 레이어 선택을 해제하고 가장 하단에 트리거 레벨 주석을 생성합니다.
![[object Object]](https://cdn.sanity.io/images/vidqzkll/production/79e6b38cab6840f46608667735980cd9de86200f-1920x1080.gif/HoverAnnotation.gif)
인터랙션 요소 사이에서 생성
인터랙션 요소 사이에 마우스를 올리면 표시되는 + 버튼을 클릭한 후, 주석(Annotation)을 선택하세요. 해당 위치에 리스폰스 레벨(Response-level) 주석이 생성됩니다.
![[object Object]](https://cdn.sanity.io/images/vidqzkll/production/fce07a6cb28fead469ab73af2676aa944b3b8799-1920x1080.gif/TriggerAnotation.gif)
주석 레벨
주석은 계층 구조에 따라 두 가지 레벨로 나뉩니다.
트리거 레벨
인터랙션에 대한 전반적인 맥락을 제공하는 상위 주석입니다. 상단 바에서 생성하거나, 리스폰스 레벨 주석을 트리거 위치로 드래그하여 만들 수 있습니다.
![[object Object]](https://cdn.sanity.io/images/vidqzkll/production/715cb1f489fe3e3d9988bdd24e5f2c45b399671f-1920x1080.gif/ResponseAnnotation.gif)
리스폰스 레벨
특정 리스폰스나 인터랙션 시퀀스를 문서화하기 위해 트리거 내부에 포함되는 주석입니다. 인터랙션 요소 사이에서 생성하거나, 트리거 레벨 주석을 트리거 아래로 드래그하여 만들 수 있습니다.
![[object Object]](https://cdn.sanity.io/images/vidqzkll/production/8d415cb196353219a8f668fbb35cfabb4ba921bc-1920x1080.gif/MoveAnnotation.gif)
💡팁: 인터랙션 계층 내에서 주석을 다른 위치로 드래그하여 레벨을 쉽게 전환할 수 있습니다. 추가로, 단축키를 사용하여 위치를 이동할 수도 있습니다:
- 맨 위로 이동:
- Mac:
]또는⌥⌘ ] - PC:
]또는Ctrl + Alt + ]
- Mac:
- 맨 아래로 이동:
- Mac:
[또는⌥⌘ [ - PC:
[또는Ctrl + Alt + [
- Mac:
주석 편집하기
주석을 클릭하면 속성(Property) 패널에서 내용을 편집할 수 있습니다. 주석은 마크다운 형식을 지원하며 아래와 같은 작업을 수행할 수 있습니다:
- 제목 추가 및 텍스트 강조 (굵게, 기울임꼴)
- 리스트 및 표 생성
- 기술 문서화를 위한 코드 블록 포함
- 외부 리소스 링크 추가
편집 중에는 마크다운 원본 텍스트가 표시되며, 편집 영역을 벗어나면 서식이 적용된 결과물이 렌더링됩니다.