노트 및 링크 위젯
노트 및 링크 위젯 (Notes and Links Widget)
노트 및 링크(Notes & Links) 위젯은 자유 텍스트 위젯과 비슷하지만, 더 다양한 서식(포맷)과 표시 옵션을 제공해요.
참고: 노트 및 링크 위젯은 인라인 HTML을 지원하지 않아요. 마크다운 링크는 같은 탭에서 열려요.
출처: 문서
본문
설정 (Setup)
- 표시할 텍스트를 입력해요. 마크다운을 지원해요.
- 프리셋 템플릿을 선택하거나 표시 옵션을 직접 지정해요.
- 텍스트 크기와 위젯의 배경 색상을 선택해요.
- 텍스트 위치를 조정하려면 정렬(Alignment) 버튼을 클릭해요. 패딩을 포함하지 않으려면 패딩 없음(No Padding)을 클릭해요.
- 포인터를 포함하려면 포인터 표시(Show Pointer)를 클릭하고 드롭다운 메뉴에서 위치를 선택해요.
위젯을 만들 준비가 되면 저장(Save)을 클릭해요.
이 위젯은 템플릿 변수를 지원해요. $<VARIABLE_NAME>.value 구문을 사용해서 위젯 콘텐츠를 동적으로 업데이트할 수 있어요.
이 예시에서 $env.value는 선택된 환경에 대한 링크 값을 업데이트해요.
참고: URL의 템플릿 변수는 호스트 이름이 아닌 URL 경로명(pathname)에서만 채워져요. 예를 들어 https://$env.value.example.com/$env.value는 https://$env.value.example.com/admin으로 렌더링돼요.
API
이 위젯은 **대시보드 API**와 함께 사용할 수 있어요. 위젯 JSON 스키마 정의에 대해서는 다음 표를 참고하세요.
| 필드 | 타입 | 설명 |
|---|---|---|
| background_color | string | 노트의 배경 색상. |
| content [필수] | string | 노트의 내용. |
| font_size | string | 텍스트 크기. |
| has_padding | boolean | 패딩 포함 여부. 기본값: true |
| show_tick | boolean | 틱 표시 여부. |
| text_align | enum | 위젯에서 텍스트 정렬 방식. 허용 enum 값: center,left,right |
| tick_edge | enum | 위젯에서 텍스트 정렬 방식을 정의. 허용 enum 값: bottom,left,right,top |
| tick_pos | string | 가장자리에서 틱을 배치할 위치. |
| type [필수] | enum | 노트 위젯 타입. 허용 enum 값: note 기본값: note |
| vertical_align | enum | 수직 정렬. 허용 enum 값: center,top,bottom |
예시:
{
"background_color": "string",
"content": "",
"font_size": "string",
"has_padding": false,
"show_tick": false,
"text_align": "string",
"tick_edge": "string",
"tick_pos": "string",
"type": "note",
"vertical_align": "string"
}