rtSurvey의 appearance 열은 설문의 질문에 대한 시각적 표현과 동작을 사용자 정의할 수 있습니다. 이 기능은 사용자 경험을 향상시키고 데이터 수집 효율을 크게 향상시킬 수 있습니다. rtSurvey는 표준 XLSForm appearance 속성을 지원하고 추가 옵션으로 확장합니다.

표준 XLSForm Appearance 속성

rtSurvey는 다음 표준 XLSForm appearance 속성을 지원합니다:

Appearance 속성질문 유형설명
multilinetext여러 줄 텍스트 상자 생성 (웹 클라이언트에 최적)
minimalselect_one, select_multiple선택지를 드롭다운 메뉴로 표시
quickselect_one선택 후 다음 질문으로 자동 이동 (모바일 전용)
no-calendardate달력 표시 억제 (모바일 전용)
month-yeardate월 및 연도만 선택 허용
yeardate연도만 선택 허용
horizontal-compactselect_one, select_multiple선택지를 수평으로 표시 (웹 전용)
horizontalselect_one, select_multiple선택지를 열 형태로 수평 표시 (웹 전용)
likertselect_one선택지를 Likert 척도로 표시
compactselect_one, select_multiple최소 패딩으로 선택지를 나란히 표시
quickcompactselect_one컴팩트 표시와 자동 이동 결합 (모바일 전용)
field-listgroups한 화면에 전체 그룹 표시 (모바일 전용)
labelselect_one, select_multiple입력 없이 선택지 레이블만 표시
list-nolabelselect_one, select_multiple레이블 없이 입력만 표시 (label과 함께 사용)
table-listgroups표 형식으로 질문 표시
signatureimage서명 캡처 활성화 (모바일 전용)
drawimage자유형 그리기 허용 (모바일 전용)
map, quick mapselect_one, select_one_from_file지도 기능에서 선택 활성화

Appearance 사용 모범 사례

  1. 일관성: 통일된 모양을 위해 설문 전체에 걸쳐 appearance 속성을 일관되게 사용합니다.
  2. 모바일 대 웹: 다양한 기기와 플랫폼에서 appearance가 어떻게 렌더링될지 고려합니다.
  3. 성능: 양식 로딩 속도를 늦출 수 있는 appearance 속성에 주의합니다 (예: 대형 그룹의 table-list).
  4. 사용자 경험: 응답자에게 데이터 입력을 더 쉽고 직관적으로 만드는 appearance를 선택합니다.
  5. 테스트: 항상 대상 기기에서 양식을 테스트하여 appearance가 예상대로 작동하는지 확인합니다.

고급 기술

Appearance 결합

일부 appearance 속성은 더 복잡한 레이아웃을 위해 결합할 수 있습니다:

  | type | name | label | appearance |
|------|------|-------|------------|
| select_one options | choice | 하나를 선택하세요: | minimal compact |

동적 Appearance

rtSurvey는 양식 논리에 따라 동적 appearance 변경을 허용합니다:

  | type | name | label | appearance | relevant |
|------|------|-------|------------|----------|
| text | time | 시간 입력: | inline-[%H:%M] | ${show_time} = 'yes' |

모바일 앱 고려 사항

  • 일부 appearance (예: quick, signature)는 모바일 기기에만 해당됩니다.
  • 일관된 동작을 보장하기 위해 Android와 iOS 모두에서 철저히 테스트합니다.

rtSurvey 확장 Appearance 속성

표준 XLSForm appearance 외에 rtSurvey는 다음 플랫폼별 옵션을 지원합니다:

데이터 및 표시 제어

Appearance 속성질문 유형설명
invisibleany값을 수집하거나 계산하면서 필드를 보이지 않게 합니다. hidden 유형과 다릅니다 — 필드는 여전히 논리에 참여합니다.
displaytitleany그렇지 않으면 억제될 경우에도 필드의 레이블/제목 표시를 강제합니다.
autopullselect_one, select_multiple양식이 로드되거나 트리거 필드가 변경될 때 선택지를 채우기 위해 자동으로 외부 데이터를 가져옵니다.
floating_hinttext, integer, decimal힌트 텍스트를 입력 필드 아래가 아닌 위에 떠있는 레이블로 표시합니다.
calculate-buttoncalculate자동으로 계산하는 대신 필드의 재계산을 온디맨드로 트리거하는 버튼을 추가합니다.

레이아웃

Appearance 속성질문 유형설명
1screengroup그룹 크기에 관계없이 전체 그룹을 단일 화면에 강제로 표시합니다.
columns(n)select_one, select_multiplen 열로 선택지를 표시합니다. 예시: columns(3)은 세 열의 라디오 버튼을 표시합니다.
gridformat<row=R col=C colspan=S align=center>any행 R, 열 C, S 열에 걸쳐 CSS 그리드 레이아웃에서 필드를 배치합니다. advanced-extension/grid-layout에서 사용됩니다.
ignore-simplifyany양식 렌더러가 이 필드의 레이아웃 자동 단순화 또는 압축을 건너뛰도록 지시합니다.

위젯

Appearance 속성질문 유형설명
likertselect_one선택지를 Likert 척도 행으로 표시합니다 (이미 표준 표에 있음; 지원 확인됨).
distressselect_one선택지를 감정 아이콘이 있는 Kessler 심리적 고통 척도 (K10) 시각적 위젯으로 렌더링합니다.

API 통합

Appearance 속성질문 유형설명
callapitext, integer, decimal, select_one이 필드에 대한 API 호출 통합을 활성화합니다. calculation 열에는 callapi() 표현식이 포함되어야 합니다. API 호출을 참조하세요.
callapi-verify(params)text, integer, decimal정적 매개변수를 사용하여 API 검증 호출을 트리거합니다. API가 값을 확인할 때까지 양식이 진행을 차단합니다.
callapi-verify(dynamicParams)text, integer, decimalcallapi-verify와 동일하지만 런타임에 다른 필드 값에서 파생된 매개변수를 사용합니다.

인라인 날짜/시간 형식

date, time 및 datetime 필드의 경우 appearance에 형식 문자열을 추가하여 사용자 정의 표시 형식을 지정할 수 있습니다:

  inline-[%d/%m/%Y]
inline-1line-[%d/%m/%Y %H:%M]

형식 토큰은 format-date() 및 format-date-time()과 동일합니다. 함수 — 날짜 및 시간 함수를 참조하세요.

예시:

typenamelabelappearance
datetimeevent_time이벤트 날짜 및 시간inline-[%d/%m/%Y %I:%M %p]
datebirth_date생년월일inline-[%d/%m/%Y]

알려진 제한 사항

  • 복잡한 appearance는 모든 플랫폼에서 동일하게 렌더링되지 않을 수 있습니다.
  • 일부 고급 rtSurvey appearance는 오프라인 모드에서 지원되지 않을 수 있습니다.

Appearance 문제 해결

  1. Appearance가 적용되지 않음: appearance 열에 오타가 없는지 확인합니다.
  2. 일관되지 않은 렌더링: 질문 유형 및 플랫폼과의 호환성을 확인합니다.
  3. 성능 문제: 복잡한 appearance를 단순화하는 것을 고려합니다, 특히 대형 설문의 경우.
이 페이지가 도움이 되었나요?