틀:폼
{{#CI form: title = 하고싶은말을 적어주세요.
| 메세지 [text] *
}}
- 메세지 :
사용자의 입력을 받을 수 있는 양식문을 생성합니다.
사용법
문법이 복잡하기에 설명을 이해하기 보다는 아래 예시문단의 내용을 낙서장에 붙여넣어 실제 결과를 확인하고 용도에 맞게 수정하는것을 권장드립니다.
{{틀:폼}}
{{:틀:폼|이동할 위치(기본값 현재)|보존=보존여부(기본값 false)}}
CI Form을 사용하기 전에 이 틀을 선언하고 이동할 위치를 지정합니다. 특정 위치가 지정되지 않으면 현재 문서로 이동하게 됩니다.
{{틀:폼/라벨}}
{{{{FULLPAGENAME}}/라벨|파라미터 키|파라미터 표시될 값}}
CI Form 파서함수에서 표시되는 텍스트 값과 키 값을 분리할 수 있습니다.
이렇게 입력된 변수는 이동된 페이지의 {{#urlget:변수명}}이나 0으로 호출 가능합니다.
예시
초기 {{CGI}} 값을 위한 사용자 입력 받기
CGI 틀도 URL 매개 변수를 사용하기 때문에 'offset'이라는 키 값으로 CGI 틀의 출력 값을 변경할 수 있습니다. 아래 예시는 CGI 게임에서 사용되는 변수 값을 변경하는 방법을 보여줍니다.
{{폼|백괴복권/길}} {{#CI form:|title= 백괴복권 치트 |{{폼/라벨|offset|초기 금액}} [number]* |submit_text=시작! }}
{{#CI form:|title= 백괴복권 치트
|초기 금액 [number]*
|submit_text=시작!
}}
텍스트를 입력받아 퀴즈문제 내기
사용자에게 텍스트로 입력을 받고 도착지 페이지에 #ifeq로 사용자가 입력한 값과 예상한 값을 비교하여 다른 결과를 도출 할 수 있습니다.
{{폼|{{틀:폼/예시1}}}} {{#CI form: |title=아침에 네발 점심에 두발 저녁에 세발이며 세상에서 가장 멍청한 것은? |{{폼/라벨|answer|정답}} [text] * |submit_text=정답 제출 }}
{{#CI form:
|title=아침에 네발 점심에 두발 저녁에 세발이며 세상에서 가장 멍청한 것은?
|정답 [text] *
|submit_text=정답 제출
}}
선택지에서 사용자에게 입력받기
셀렉트박스나 라디오박스로 선택지를 고르게 할 수 있습니다.
아래는 문서의 편집과 역사확인등의 동작이 action 파라미터로 이루어짐을 응용한 라디오박스로 입력값을 받는 예시입니다.
{{#CI form: |title={{폼/라벨|action|무엇을 할까?}} |type=multiple choice |{{폼/라벨|edit|수정}} |{{폼/라벨|history|역사}} |{{폼/라벨|delete|삭제}} |{{폼/라벨|protect|보호}}
{{#CI form:
|title=무엇을 할까?
|type=multiple choice
|수정
|역사
|삭제
|보호
|submit_text=확인
}}
마찬가지로 사용자에게 선택지를 제시하는 한가지 방법인 셀렉트박스로 입력값을 받는 예시입니다. 라디오박스로 입력받기엔 리스트의 내용이 클 때 사용됩니다. 아래는 한가지 예시입니다.
{{폼|폼/예시2}} {{#CI form: title= {{폼/라벨|gender|당신의 성별을 선택 해 주세요.}} |type= inputs |[골라=select=시스 남성, 시스 여성, 논 바이너리, 트랜스 남성, 트랜스 여성, 트랜스페미닌, 트랜스메스큘린, 에이젠더, 젠더리스, 그레이젠더, 데미젠더, 안드로진, 뉴트로이스, 바이젠더, 트라이젠더, 젠더플루이드, 젠더플럭스, 옴니젠더, 폴리젠더, 젠더퀴어, 젠더 논컨포밍, 젠더 베리언트, 젠더 뉴트럴]*
{{#CI form: title = 당신의 성별을 선택 해 주세요.
|type = inputs
|[골라=select=시스 남성, 시스 여성, 논 바이너리, 트랜스 남성, 트랜스 여성, 트랜스페미닌, 트랜스메스큘린, 에이젠더, 젠더리스, 그레이젠더, 데미젠더, 안드로진, 뉴트로이스, 바이젠더, 트라이젠더, 젠더플루이드, 젠더플럭스, 옴니젠더, 폴리젠더, 젠더퀴어, 젠더 논컨포밍, 젠더 베리언트, 젠더 뉴트럴]*
|submit_text=시작
}}
셀렉트박스의 내용물에 규칙성이 있으면 다른 틀과 응용해 리스트의 생성을 간편화 할 수 있습니다. 아래는 리스트를 작성하는 예시입니다.
{{#CI form: title = {{폼/라벨|answer|자료형 int의 최대값은?}} |type= inputs |[골라=select={{loop|<nowiki>{{#expr: 2^{{{index}}} - 1 }} ,</nowiki>|40|1|10}}]* |submit_text=제출 }} }}
{{#CI form: title= 자료형 int의 최대값은?
|type= inputs
|[골라=select=1023 ,2047 ,4095 ,8191 ,16383 ,32767 ,65535 ,131071 ,262143 ,524287 ,1048575 ,2097151 ,4194303 ,8388607 ,16777215 ,33554431 ,67108863 ,134217727 ,268435455 ,536870911 ,1073741823 ,2147483647 ,4294967295 ,8589934591 ,17179869183 ,34359738367 ,68719476735 ,137438953471 ,274877906943 ,549755813887 ,1099511627775 ,]*
|submit_text=제출
}}
체크박스로 입력받기
다중선택 가능한 여러개의 선택지를 제시해 쉼표로 구분된 문자열로 입력 받을 수 있습니다.
{{:{{FULLPAGENAME}}|{{FULLPAGENAME}}/예시4}} {{#CI form: type= multiple choice | title = {{폼/라벨|answer|만두를 만들기 위해 적절한 재료 8개를 골라주세요.}} | type = multiple choice | max answers=8 |{{폼/라벨|돼지고기}} |{{폼/라벨|두부}} |{{폼/라벨|양파}} |{{폼/라벨|양배추}} |{{폼/라벨|계란}} |{{폼/라벨|참기름}} |{{폼/라벨|에이스}} |{{폼/라벨|매운고추}} |{{폼/라벨|마늘}} |{{폼/라벨|치즈}} |{{폼/라벨|대파}} |{{폼/라벨|고추장}} |{{폼/라벨|마요네즈}} |{{폼/라벨|옹스짱}} |{{폼/라벨|쌀가루}} |{{폼/라벨|밀가루}} |{{폼/라벨|콩가루}} |{{폼/라벨|물}} |{{폼/라벨|쥬스}} |{{폼/라벨|와인}} }}
{{#CI form: type= multiple choice |title = 만두를 만들기 위해 적절한 재료 8개를 골라주세요. |type = multiple choice |max answers=8 |돼지고기 |두부 |양파 |양배추 |계란 |참기름 |에이스 |매운고추 |마늘 |치즈 |대파 |고추장 |마요네즈 |옹스짱 |쌀가루 |밀가루 |콩가루 |물 |쥬스 |와인 }}
기타 예시
섹션타입의 ci폼 함수를 사용 해 한번에 여러값을 입력 받을 수 있습니다. 아래는 그에 대한 예시입니다.
{{#CI form: title= 캐릭터 정보를 입력 해 주세요. |{{폼/라벨|name|캐릭터 명}} [] * |{{#CI form section: type= inputs |title= {{폼/라벨|gender|캐릭터 성별}} * |type= multiple choice |{{폼/라벨|m|남성}} | {{폼/라벨|f|여성}} }} }}
{{#CI form: title= 캐릭터 정보를 입력 해 주세요.
|캐릭터 명 [] * |{{#CI form section: type= inputs |title= 캐릭터 성별 * |type= multiple choice |남성 |여성 }}
}}
아래는 좀 더 다양한 정보를 입력받는 예시입니다. 더 다양한 응용방법은 도보시오의 링크를 참조바랍니다.
{{#CI form: title = 캐릭터 정보를 입력 해 주세요. | {{폼/라벨|name|게임에서 불릴 이름}} [] * | {{폼/라벨|amount|초기 금액}} [number] * | {{#CI form section: type = inputs | title = {{폼/라벨|job|선택할 직업}} * | type = multiple choice | {{폼/라벨|warrior|전사}} | {{폼/라벨|magic|마법사}}| {{폼/라벨|bus|버스기사}} }} | {{#CI form section: type = multiple choice | title = {{폼/라벨|pearks|선택할 특성}} (2개 선택 가능) | type = multiple choice | max answers=2 | {{폼/라벨|heal|회복}}| {{폼/라벨|haste|헤이스트}}| {{폼/라벨|exp|경험치상승}}| {{폼/라벨|attack|공격력증가}}| {{폼/라벨|sight|공격력증가}} }} | {{#CI form section: type = inputs | title = {{폼/라벨|state|상태 메세지(최대 1000자)}} | [textarea=1000] }} | {{#CI form section: 다음 행동 | type = inputs | [골라=select=가만히 있기, 숨쉬기, 코파기]* }} }}
{{#CI form: title = 캐릭터 정보를 입력 해 주세요. | 게임에서 불릴 이름 [] * | 초기 금액 [number] * |
{{#CI form section: type = inputs
| title = 선택할 직업 *
| type = multiple choice
| 전사 | 마법사| 버스기사
}}
|
{{#CI form section: type = multiple choice
| title = 선택할 특성 (2개 선택 가능)
| type = multiple choice
| max answers=2
| 회복| 헤이스트| 경험치상승| 공격력증가| 공격력증가
}}
|
{{#CI form section: type = inputs
| title = 상태 메세지(최대 1000자)
| [textarea=1000]
}}
|
{{#CI form section: 다음 행동
| type = inputs
| [골라=select=가만히 있기, 숨쉬기, 코파기]*
}}
}}
상세
이 틀은 사용자의 입력을 받아 처리하는 기존의 확장기능 파서함수 #CI를 자바스크립트로 래핑해주는 역할을 맡습니다. #CIForm의 기존 기능은 받은 데이터를 이메일로 보내거나 사이트 db로 전송하는 용도로 쓰이는데, 리버티게임에서는 해당 용도로 쓰일 일이 적으니 CGI와 CGI2와 호환되게끔 바꿔주는 틀입니다. 입력된 폼의 내용은 현재 SearchParams에 추가되거나 변경되어 다음 페이지로 전송합니다.