1. 기본 입력 구조
형식
라벨|옵션|속성1|속성2|...
구분자: | (파이프)로 각 부분을 구분합니다.
- 라벨: 필드 앞에 표시될 제목
- 옵션: 선택 항목, 콤보박스 옵션 등 (타입에 따라 다름)
- 속성: type=, required, class=, style= 등
2. 입력 타입 (type=)
💡 참고: type을 지정하지 않으면 기본값은 text입니다.
text 기본 텍스트 입력
이름||type=text|required|class=input-sm
tel 전화번호 (3칸 분리)
연락처||type=tel
ssn6 주민등록번호 앞 6자리
주민등록번호(앞 6자리)||type=ssn6
ssn7 주민등록번호 앞자리 + 성별구분
주민등록번호 앞자리||type=ssn7|required
date 날짜 선택
생년월일||type=date|required|class=period-input|style=width:120px;
address 주소 검색
주소||type=address|class=input-unit
radio 라디오 버튼
성별|남,여|type=radio|required
radio 라디오+셀렉트 조합 NEW
이용시설|3층::대강당,5층::프로그램실1##프로그램실2##신체활동실,6층::소강당,기타^^^기관 협의( %% )|type=radio
checkbox 체크박스
취미|독서,운동,영화감상|type=checkbox
checkboxinfo 체크박스+안내문구 (우측)
참여방법|현장참여~~~직접 방문하여 참여합니다,온라인참여~~~화상회의로 참여합니다|type=checkboxinfo
checkboxinfo 체크박스+안내문구 (하단)
동의항목|개인정보수집~~~~수집항목: 이름, 연락처, 이메일,마케팅수신~~~~선택사항이며 동의하지 않아도 서비스 이용 가능|type=checkboxinfo
checkboxinfo 체크박스+안내문구 (항상표시)
참여방법|현장참여~~~!!직접 방문하여 참여합니다,온라인참여~~~~!!화상회의로 참여합니다|type=checkboxinfo
radioinfo 라디오+안내문구 (우측)
참여형태|개인~~~1인 참여,단체~~~2인 이상 참여|type=radioinfo
radioinfo 라디오+안내문구 (하단/항상표시)
신청구분|신규신청~~~~!!처음 신청하시는 분,재신청~~~~!!기존 이용자 재신청|type=radioinfo
checkcombo 체크박스+셀렉트
질문항목|국가유공자::독립유공자##무공훈장:cnt,임산부^^^,기타^^^|type=checkcombo
checkcombonew 체크박스+셀렉트 (콘텐츠 폭 자동) 정렬: formin_flex_row formin_flex_lt formin_flex_gap_30 in_auto
선택과목|신생아 돌보기::1순위##2순위##3순위##4순위,스마트폰 과의존::1순위##2순위,영유아 성교육::1순위##2순위|type=checkcombonew
checkcombonew 최소/최대 개수 제한 min=N / max=N
선택과목|신생아 돌보기,스마트폰 과의존,영유아 성교육,동화구연|type=checkcombonew|min=2|max=3
checkcombo 앞라벨 입력폼 뒷라벨 샘플11
가전제품|TV^^^모델명%%대,냉장고::소형##대형:cnt[대],세탁기^^^%%개|type=checkcombo|required
checkcombo2 조건부 체크박스
자녀유형|한자녀,두자녀,세자녀,쌍둥이^^^|type=checkcombo2|twin_if=두자녀,세자녀
checkcombo3 자녀 정보 입력
자녀유형|한자녀,두자녀,세자녀(다자녀),쌍둥이^^^|type=checkcombo3|twin_if=두자녀,세자녀
checkcombo4 시간표
상담시간||type=checkcombo4
select 셀렉트 박스
가구형태|일반,다문화,일반-안내문구|type=select
selectlabel 관리자용 셀렉트
셀렉트|신청,반려,대기,이용,중단,종료|type=selectlabel|required
inputcombo 개수 입력+동적 필드
자녀수|건강보험증^^^:cnt[건강보험증 번호]|type=inputcombo|min=0|max=5|toplabel=자녀 건강보험증 입력|preinput=자녀|postinput=번
textarea 여러 줄 입력 (순수 텍스트)
특이사항||type=textarea|class=input-unit
html HTML 입력 (헬퍼 버튼 포함)
제품설명||type=html|class=input-unit
notice 안내 문구
안내사항|안내 내용을 여기에 입력합니다|type=notice
3. 기호 정의
| 기호 | 의미 | 사용 예시 |
|---|---|---|
| | | 구분자 (라벨|옵션|속성) | 이름||type=text |
| || | 다중 값 구분 (select, checkcombo4 등) | 선택1||선택2||선택3 |
| :: | 콤보박스 구분 (라벨::옵션들) | 국가유공자::독립유공자##무공훈장 |
| ## | 콤보박스 내 옵션 구분 | 독립유공자##무공훈장##기타 |
| ^^^ | 추가 입력 필드 (체크 시 표시) | 기타^^^ → 체크하면 입력창 표시 |
| ^^^! | 항상 보이는 추가 입력 필드 | 기타^^^! → 항상 입력창 표시 |
| ^^^앞라벨%%뒤라벨 | 입력창 앞뒤 라벨 추가 (checkcombo 전용) | TV^^^모델명%%대 → 모델명 [입력창] 대 |
| ^^^앞라벨%% | 입력창 앞 라벨만 (checkcombo 전용) | TV^^^모델명%% → 모델명 [입력창] |
| ^^^%%뒤라벨 | 입력창 뒤 라벨만 (checkcombo 전용) | TV^^^%%대 → [입력창] 대 |
| %% | 라디오 앞뒤 텍스트 (prefix%%suffix) | 옵션%%앞텍스트%%뒤텍스트 |
| >> | 토글 필드 (체크 시 다른 필드 표시/숨김) | 옵션>>25,26 → 체크 시 25,26번 필드 토글 |
| * | 기본 선택 (초기 체크됨) | *기본값 |
| ! | 비활성화/읽기전용 | !비활성값 |
| ^ | 읽기전용 기본값 | ^읽기전용 |
| *! 또는 !* | 기본값이면서 비활성화 | *!기본비활성 |
| : | 값 구분자 (checkcombo 저장 형식) | 라벨:선택값:개수:메모 |
| :cnt | 카운트 필드 (개수 입력) - 항상 보임 | 옵션::선택1##선택2:cnt → 항상 표시 |
| :cnt! | 카운트 필드 (체크 시에만 보임) | 옵션::선택1##선택2:cnt! → 체크 시 표시 |
| :cnt[라벨] | 카운트 필드 라벨 지정 - 항상 보임 | :cnt[건강보험증 번호] |
| :cnt![라벨] | 카운트 필드 라벨 지정 - 체크 시에만 보임 | :cnt![건강보험증 번호] |
| - | 메모/추가값 구분자 | 선택값-추가메모 |
| ;; | 콤마 대체 문자 (옵션 텍스트 내 콤마 표시) | 음향기기(30;;000원) → 음향기기(30,000원) |
| @@ | select 타입에서 다중 셀렉트 구분 | 선택1@@선택2@@선택3 |
| , | 옵션 구분 (라디오, 체크박스 등) | 옵션1,옵션2,옵션3 |
| ~~~ | 안내문구 - 우측 표시 (checkboxinfo/radioinfo) | 옵션~~~안내문구 → 체크/선택 시 우측에 안내 표시 |
| ~~~~ | 안내문구 - 하단 표시 (checkboxinfo/radioinfo) | 옵션~~~~안내문구 → 체크/선택 시 하단에 안내 표시 |
| ~~~!! | 안내문구 - 우측 항상 표시 (checkboxinfo/radioinfo) | 옵션~~~!!안내문구 → 항상 우측에 안내 표시 |
| ~~~~!! | 안내문구 - 하단 항상 표시 (checkboxinfo/radioinfo) | 옵션~~~~!!안내문구 → 항상 하단에 안내 표시 |
4. 속성 (Attributes)
공통 속성
-
required
이름||type=text|required
필수 입력 필드로 지정
-
class=클래스명
이름||type=text|class=input-sm
CSS 클래스 지정
-
style=스타일
이름||type=text|style=width:200px;
인라인 CSS 스타일 지정
-
type=/2
기간||type=date/2
다중 입력 필드 (2개)
inputcombo 전용 속성
-
min=숫자
|type=inputcombo|min=0
최소 개수
-
max=숫자
|type=inputcombo|max=10
최대 개수
-
toplabel=라벨
|type=inputcombo|toplabel=자녀 건강보험증 입력
상단 라벨
-
preinput=텍스트
|type=inputcombo|preinput=자녀
입력 필드 앞 텍스트
-
postinput=텍스트
|type=inputcombo|postinput=번
입력 필드 뒤 텍스트
checkcombo2 전용 속성
-
twin_if=값1,값2
|type=checkcombo2|twin_if=두자녀,세자녀
쌍둥이 옵션 활성화 조건
5. 복잡한 예시
체크박스 + 셀렉트박스 + 추가 입력
질문항목|국가유공자::독립유공자##무공훈장:cns,임산부^^^,기타^^^|type=checkcombo
설명:
•
•
•
•
국가유공자::독립유공자##무공훈장:cns → 체크박스 "국가유공자", 체크 시 셀렉트박스(독립유공자/무공훈장), 개수 입력("대")•
임산부^^^ → 체크박스 "임산부", 체크 시 추가 입력창 표시•
기타^^^ → 체크박스 "기타", 체크 시 추가 입력창 표시
조건부 체크박스 (쌍둥이)
자녀유형|한자녀,두자녀,세자녀,쌍둥이^^^|type=checkcombo2|twin_if=두자녀,세자녀
설명:
• "두자녀" 또는 "세자녀"가 체크되면 "쌍둥이" 옵션이 활성화됨
• "쌍둥이" 체크 시 추가 입력창 표시
• "두자녀" 또는 "세자녀"가 체크되면 "쌍둥이" 옵션이 활성화됨
• "쌍둥이" 체크 시 추가 입력창 표시
개수 입력 + 동적 필드 생성
자녀수|건강보험증^^^:cnt[건강보험증 번호]|type=inputcombo|min=0|max=5|toplabel=자녀 건강보험증 입력|preinput=자녀|postinput=번
설명:
• 개수 입력 필드 (0~5)
• 개수만큼 "자녀 1번", "자녀 2번" 등의 입력 필드가 자동 생성됨
• 상단에 "자녀 건강보험증 입력" 라벨 표시
• 개수 입력 필드 (0~5)
• 개수만큼 "자녀 1번", "자녀 2번" 등의 입력 필드가 자동 생성됨
• 상단에 "자녀 건강보험증 입력" 라벨 표시
라디오 + 셀렉트박스 + 추가 입력 NEW
이용시설|3층::대강당,5층::프로그램실1##프로그램실2##신체활동실,6층::소강당,기타^^^기관 협의( %% )|type=radio
설명:
•
•
•
•
•
3층::대강당 → 라디오 "3층" 선택 시 셀렉트박스(대강당)•
5층::프로그램실1##프로그램실2##신체활동실 → 라디오 "5층" 선택 시 셀렉트박스(프로그램실1/프로그램실2/신체활동실)•
6층::소강당 → 라디오 "6층" 선택 시 셀렉트박스(소강당)•
기타^^^기관 협의( %% ) → 라디오 "기타" 선택 시 "기관 협의( [입력창] )" 형태로 입력창 표시
저장 형식:
예:
라벨:셀렉트값:메모예:
5층:프로그램실2, 기타::협의내용
6. 파일 첨부 필드
⚠️ 주의: 파일 첨부는 별도로 처리됩니다. 여분필드 28번에 첨부파일 제목을 ||로 구분하여 입력하세요.
주민등록등본||건강보험료납부확인서(부)||건강보험료납부확인서(모)||추가 첨부 서류
각 제목이 하나의 파일 첨부 필드로 생성됩니다.