001 /*
002 * Copyright (c) 2009 The openGion Project.
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
013 * either express or implied. See the License for the specific language
014 * governing permissions and limitations under the License.
015 */
016 package org.opengion.hayabusa.taglib;
017
018 import org.opengion.hayabusa.common.HybsSystem;
019 import org.opengion.hayabusa.common.HybsSystemException;
020
021 import static org.opengion.fukurou.util.StringUtil.nval ;
022 import org.opengion.fukurou.util.XHTMLTag;
023
024 /**
025 * TagSupport から継承されたサブクラスですã?
026 *
027 * 汎用属æ? のsetterメソãƒ?ƒ‰を持ってã�?�¾すã?
028 * それ以外に、{@XXXX} 変数の対応と、lang属æ?のメソãƒ?ƒ‰も用意してã�?�¾すã?
029 *
030 * ロケールは、ユーザーæƒ??の lang 属æ?をデフォルトで使用しã?
031 * セãƒ?ƒˆされてã�?�ªã�??合ã?、リクエスト情報のロケールから取得しますã?
032 *
033 * å�?±žæ?は、{@XXXX} 変数が使用できますã?
034 * これは、ServletRequest から、XXXX をキーに値を取りå?ã�?こã?変数に
035 * 割り当てますã?つまりã?こã?XXXXをキーにリクエストすれã?ã€?
036 * こã?変数に値をセãƒ?ƒˆすることができますã?
037 *
038 * http://localhost/query.jsp?KEY1=VLA1&KEY2=VAL2
039 *
040 * のようなリクエストで、{@KEY1} とすればã€?VAL1 がセãƒ?ƒˆされますã?
041 *
042 * こã?タグは、ラベル部åˆ?�¨入力フィールド部åˆ?�Œãƒ??ブルタグの<td>
043 * により左右にåˆ?‰²されますã?HTML 表示時ã?、前後に<tr>タグで囲って,
044 * 整形できますã?
045 *
046 * ※ readonly , disabled , autofocus[HTML5] , required[HTML5] は、論理属æ?ですã?
047 * 通常は、キーワードã?みのæŒ?®šで、有効ですã?
048 * よって、readonly="false" としてもã?readonly とã�?�†キーワードが存在すると、有効になりますã?
049 * 記述ä¾? â‘?eadonly ②readonly="" ③readonly="readonly" の?“種類が推奨されますã?
050 * 「属æ?名ã? 「属æ?å�?""ã€?「属æ?å�?"属æ?å�?ã€?
051 * フレーãƒ?ƒ¯ーク側の問題として、①ã‚?‘¡の渡し方は他ã?属æ?との関係や、動çš?�ªリクエスト変数の処ç�??
052 * 関係で、③を利用しますã?またã?動的åˆ?›¿の為に、④readonly="[true/false]" も受け付けますã?
053 * å†?ƒ¨çš?�«は、readonly="true" の場合ã?、readonly="readonly" を作æ?しã?readonly="false" の場合ã?ã€?
054 * なにも作æ?しなã�?�¨ã�?�†処ç�?‚’行ってã�?�¾すã?
055 *
056 * @og.group 画面部å“?
057 *
058 * @version 4.0
059 * @author Kazuhiko Hasegawa
060 * @since JDK5.0,
061 */
062 abstract class HTMLTagSupport extends CommonTagSupport {
063 //* こã?プログラãƒ??VERSIONæ–?—å?を設定しますã? {@value} */
064 private static final String VERSION = "5.7.2.0 (2014/01/10)" ;
065
066 private static final long serialVersionUID = 572020140110L ;
067
068 // 5.2.1.0 (2010/10/01) must , mustAny 属æ?をè?動化しますã?
069 private String mustType = null; // 5.2.1.0 (2010/10/01)
070 // 5.7.2.0 (2014/01/10) 自動化の制御をできるようにしますã?(初期は自å‹?
071 private boolean useMustHidden = true; // 5.7.2.0 (2014/01/10)
072
073 /**
074 * Taglibの終äº?‚¿グが見つかったときに処ç�?�™ã‚?doEndTag() ã‚?オーバã?ライドしますã?
075 *
076 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応ã?release2() ã‚?doEndTag()で呼ぶã€?
077 * @og.rev 4.0.0.0 (2005/11/30) ロール をè?慮しますã?
078 * @og.rev 4.3.0.0 (2008/07/04) ロールモードã?ルチ対å¿?
079 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
080 *
081 * @return 後続å?ç�?
082 */
083 @Override
084 public int doEndTag() {
085 debugPrint(); // 4.0.0 (2005/02/28)
086 // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属æ?対å¿?
087 if( useTag() && getUser().isAccess( get( "roles" ) ) ) { // 4.3.0.0 (2008/07/04) ロールモードã?ルチ対å¿?
088 jspPrint( makeTag() );
089 }
090 return EVAL_PAGE ;
091 }
092
093 /**
094 * タグリブオブジェクトをリリースしますã?
095 * キャãƒ?‚·ュされて再利用されるã?で、フィールドã?初期設定を行いますã?
096 *
097 * @og.rev 5.2.1.0 (2010/10/01) mustType 属æ?を追åŠ??
098 * @og.rev 5.7.2.0 (2014/01/10) useMustHidden追åŠ?
099 */
100 @Override
101 protected void release2() {
102 super.release2();
103 mustType = null; // 5.2.1.0 (2010/10/01)
104 useMustHidden = true; // 5.7.2.0 (2013/12/10)
105 }
106
107 /**
108 * ボタンを作æ?しますã?
109 *
110 * <button type="submit" name="名前" value="値">
111 *
112 * @return ボタンタグæ–?—å?
113 */
114 abstract protected String makeTag() ;
115
116 /**
117 * 【HTML】要ç´?�«対して固有ã?名前(id)をつける場合に設定しますã?
118 *
119 * @og.tag
120 * 特別な使用方法として、id="FOCUS" とすることで、フィールド系要ç´?�«
121 * フォーカスを移動させますã?これは、そのペã?ジå†?�§唯ä¸?? id 属æ?として使用くださいã€?
122 *
123 * ※ HTML5 より、autofocus属æ?の使用が可能になりましたã€?
124 *
125 * @param id 固有ã?名前
126 */
127 @Override
128 public void setId( final String id ) {
129 set( "id",getRequestParameter( id ) );
130 }
131
132 /**
133 * 【HTML】要ç´?�«対して class 属æ?を設定しますã?
134 *
135 * @og.tag
136 * Javaのè¨?ªž使用上ã?class で作æ?できなã�?�Ÿめã?代用として
137 * clazz を使用してã�?�¾すã?
138 * html で作æ?される属æ?はã€?class で作æ?されますã?
139 *
140 * @og.rev 3.5.0.0 (2003/09/17) set ではなくã?add を利用しますã?
141 *
142 * @param cls classを表す文字å?
143 */
144 public void setClazz( final String cls ) {
145 add( "class",getRequestParameter( cls ) ); // 3.5.5.9 (2004/06/07) セパレータ引数付きのメソãƒ?ƒ‰に変更
146 }
147
148 /**
149 * 【HTML】要ç´??å†?®¹と他ã?属æ?値のè¨?ª?lang,xml:lang)を指定しますã?
150 *
151 * @og.tag
152 * HTMLのè¨?ªž属æ?に使われますã?æŒ?®šするå?は、ISO 639で規定されてã�?‚‹「è¨?ªžコードã?ですã?
153 * [ja/en/zh/…]などのほかに、en-US:アメリカ英語ã?en-cockney:コãƒ?‚¯ニã?英èª?などã€?
154 * 副è¨?ªžをæŒ?®šする方法も定められてã�?�¾すã?
155 * ここでは、lang と xml:lang の両方に同じ値がセãƒ?ƒˆされますã?
156 * タグの language 属æ?とは使用用途が異なりますã?
157 *
158 * @og.tag lang セãƒ?ƒˆ
159 *
160 * @param lang è¨?ªž[ja/en/zh/…]
161 */
162 public void setLang( final String lang ) {
163 String lng = getRequestParameter( lang );
164 if( lng != null ) {
165 set( "lang",lng );
166 set( "xml:lang",lng );
167 }
168 }
169
170 /**
171 * 【HTML】文字表記ã?方å�?dir)を指定しますã?
172 *
173 * @og.tag
174 * 当該要ç´??書字方向をæŒ?®šする属æ?ですã?
175 * ltr で、左から右に、rtl で、右から左に並べますã?
176 *
177 * @param dir (ltr:左から右、rtl:右から左 )
178 */
179 public void setDir( final String dir ) {
180 set( "dir",getRequestParameter( dir ) );
181 }
182
183 /**
184 * 【HTML】要ç´?�«対する補足çš?ƒ…報(title)を設定しますã?
185 *
186 * @og.tag
187 * title セãƒ?ƒˆは、ã?タンなどに適用すると、ã?ウスオーバã?によりこã?メãƒ?‚»ージã�?
188 * チップスのように表示されますã?これを利用して、説明文を登録することが可能ですã?
189 * ここに登録したæ–?—å?がã?メãƒ?‚»ージリソースに存在する場合ã?、そのメãƒ?‚»ージã‚?
190 * 存在しなã�??合ã?、そのままの値を設定しますã?
191 *
192 * @og.rev 3.5.5.8 (2004/05/20) メãƒ?‚»ージリソースから読み込んだæ–?—を使用しますã?
193 * @og.rev 4.0.0.0 (2007/10/18) メãƒ?‚»ージリソース統å�? getResource().getMessage â‡?getResource().getLabel )
194 *
195 * @param title 補足çš?ƒ…報(title)
196 */
197 public void setTitle( final String title ) {
198 String str = nval( getRequestParameter( title ),null );
199 if( str != null ) {
200 set( "title",getResource().getLabel( str ) );
201 }
202 }
203
204 /**
205 * 【HTML】この要ç´?�«対して適用させるスタイルシーãƒ?style)を設定しますã?
206 *
207 * @og.tag
208 * タグにstyle属æ?を設定しますã?これは、キー:値; のセãƒ?ƒˆをè¤?•°記述できますã?
209 * 通常は、class属æ?ã‚??id属æ?で登録しておきã€?lt;style type="text/css"> で
210 * 外部からæŒ?®šする方がソースは読みã‚?�™くなりますã?
211 *
212 * @param style スタイルシーãƒ?style="color:red; font-size:24pt;" など)
213 */
214 public void setStyle( final String style ) {
215 set( "style",getRequestParameter( style ) );
216 }
217
218 /**
219 * 【TAG】その部品に対して変更がå?来なã�?‚ˆã�?�«(readonly)æŒ?®šしまã�?サーバã?に送信されã‚?ã€?
220 *
221 * @og.tag
222 * INPUT/TEXTAREA 系に対して、指定可能ですã?
223 * readonly="readonly" , readonly="true" が指定された場合ã?、有効ですã?
224 * false も指定å?としては、有効ですã?(大æ–?—小文字ã?区別も不è¦?
225 * それ以外ã?æŒ?®šã?、エラーとしますã?
226 *
227 * ※ readonly は、論理属æ?ですã?
228 *
229 * @og.rev 3.7.1.0 (2005/04/26) readonly,true,false が指定できるように変更ã€?
230 *
231 * @param ronly 読み取り専用属æ?[readonly/true/false]
232 */
233 public void setReadonly( final String ronly ) {
234 String readonly = nval( getRequestParameter( ronly ),null );
235 if( readonly != null ) {
236 if( "readonly".equalsIgnoreCase( readonly ) ||
237 "true".equalsIgnoreCase( readonly ) ) {
238 set( "readonly","readonly" );
239 }
240 else if( ! "false".equalsIgnoreCase( readonly ) ) {
241 String errMsg = "readonly には、[readonly,true,false]以外ã?æ–?—ã?æŒ?®šできませんã€?
242 + " readonly=[" + readonly + "]" + HybsSystem.CR ;
243 throw new HybsSystemException( errMsg );
244 }
245 }
246 }
247
248 /**
249 * 【TAG】その部品に対してã€?�¸択や変更がå?来なã�?‚ˆã�?�«(disabled)æŒ?®šしまã�?サーバã?に送信されなã�?ã€?
250 *
251 * @og.tag
252 * BUTTON/INPUT/OPTGROUP/OPTION/SELECT/TEXTAREA 系に対して、指定可能ですã?
253 * disabled="disabled" , disabled="true" が指定された場合ã?、有効ですã?
254 * false も指定å?としては、有効ですã?(大æ–?—小文字ã?区別も不è¦?
255 * それ以外ã?æŒ?®šã?、エラーとしますã?
256 *
257 * ※ disabled は、論理属æ?ですã?
258 *
259 * @og.rev 3.7.1.0 (2005/04/26) disabled,true,false が指定できるように変更ã€?
260 *
261 * @param dis 選択や変更がå?来なã�?‚ˆã�?�«するかどã�?�‹[disabled/true/false]
262 */
263 public void setDisabled( final String dis ) {
264 String disabled = nval( getRequestParameter( dis ),null );
265 if( disabled != null ) {
266 if( "disabled".equalsIgnoreCase( disabled ) ||
267 "true".equalsIgnoreCase( disabled ) ) {
268 set( "disabled","disabled" );
269 }
270 else if( ! "false".equalsIgnoreCase( disabled ) ) {
271 String errMsg = "disabled には、[disabled/true/false]以外ã?æ–?—ã?æŒ?®šできませんã€?
272 + " disabled=[" + disabled + "]" + HybsSystem.CR ;
273 throw new HybsSystemException( errMsg );
274 }
275 }
276 }
277
278 /**
279 * 【HTML】タブã?移動é?(tabindex)を指定しまã�?0 ??32767)ã€?
280 *
281 * @og.tag
282 * Tabキーを押したときに要ç´?�Œ選択されるé ?•ªを指定しますã?
283 * 値にはã€?�¸択させたã�??番を数値で記述しますã?
284 *
285 * @param tabindex タブã?移動é?(0 ??32767)
286 */
287 public void setTabindex( final String tabindex ) {
288 set( "tabindex",getRequestParameter( tabindex ) );
289 }
290
291 /**
292 * 【HTML】アクセスキー(alt+キーで直接æŒ?®?を割り当てますã?
293 *
294 * @og.tag
295 * アクセスキーは、ã?ウスの使えなã�?’°å¢?�§もã?リンクにジャンプするã?ボタンを押すã?入力フォーãƒ?�«
296 * フォーカスを移すなどの操作を簡単に行うことができるようにè€??されたものですã?
297 * Windows の「ファイル(F)」メニューにつã�?�¦ã�?‚‹、F と同じような働きをしますã?
298 *
299 * @param accesskey アクセスキー
300 */
301 public void setAccesskey( final String accesskey ) {
302 set( "accesskey",getRequestParameter( accesskey ) );
303 }
304
305 /**
306 * 【TAG】JavaScript などの HTML基本タグ以外ã?属æ?をã?そã?ままタグとして使用しますã?
307 *
308 * @og.tag
309 * JavaScript などの HTML基本タグ以外ã?属æ?をã?そã?まま
310 * タグとして使用しますã?
311 *
312 * @og.rev 3.1.0.1 (2003/03/26) (')ã‚?")に置き換えå?ç�?�—てã�?�Ÿのを止めるã€?
313 *
314 * @param optionAttributes HTML基本タグ以外ã?属æ?
315 */
316 public void setOptionAttributes( final String optionAttributes ) {
317 String optAttri = getRequestParameter( optionAttributes );
318 if( optAttri != null && optAttri.length() > 0 ) {
319 set( "optionAttributes",optAttri );
320 }
321 }
322
323 /**
324 * 【HTML】JavaScriptのイベンãƒ?onClick を設定しまã�?ä¾?onClick="renew('query.jsp','QUERY');")ã€?
325 *
326 * @og.tag
327 * onClick をセãƒ?ƒˆしますã?
328 * 例えばã€?lt;og:column name="KBSAKU" onClick="renew('query.jsp','QUERY');" />
329 * のようにæŒ?®šすることで、ã?ルãƒ?‚¦ンメニューの絞込み検索が可能になりますã?
330 *
331 * @og.rev 3.5.0.0 (2003/09/17) 新規追åŠ?
332 * @og.rev 3.5.5.9 (2004/06/07) セパレータ付きの追åŠ?ƒ¡ソãƒ?ƒ‰に変更
333 *
334 * @param onClick onClickイベンãƒ?ä¾?onClick="renew('query.jsp','QUERY');")
335 */
336 public void setOnClick( final String onClick ) {
337 add( "onClick",getRequestParameter( onClick ),";" );
338 }
339
340 /**
341 * 【HTML】JavaScriptのイベンãƒ?onChange を設定しまã�?ä¾?onChange="renew('query.jsp','QUERY');")ã€?
342 *
343 * @og.tag
344 * onChange をセãƒ?ƒˆしますã?
345 * 例えばã€?lt;og:column name="KBSAKU" onChange="renew('query.jsp','QUERY');" />
346 * のようにæŒ?®šすることで、ã?ルãƒ?‚¦ンメニューの絞込み検索が可能になりますã?
347 *
348 * @og.rev 3.5.0.0 (2003/09/17) 新規追åŠ?
349 * @og.rev 3.5.5.9 (2004/06/07) セパレータ付きの追åŠ?ƒ¡ソãƒ?ƒ‰に変更
350 *
351 * @param onChange onChangeイベンãƒ?ä¾?onChange="renew('query.jsp','QUERY');")
352 */
353 public void setOnChange( final String onChange ) {
354 add( "onChange",getRequestParameter( onChange ),";" );
355 }
356
357 /**
358 * 【HTML】JavaScriptのイベンãƒ?onBlur を設定しまã�?ä¾?onBlur="this.value=value.toUpperCase();")ã€?
359 *
360 * @og.tag
361 * onBlur は、フォーカスが離れたときに発生するイベントですã?
362 *
363 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
364 *
365 * @param onBlur onBlurイベンãƒ?ä¾?onBlur="this.value=value.toUpperCase();")
366 */
367 public void setOnBlur( final String onBlur ) {
368 add( "onBlur",getRequestParameter( onBlur ),";" );
369 }
370
371 /**
372 * 【HTML】JavaScriptのイベンãƒ?onFocus を設定しますã?
373 *
374 * @og.tag
375 * onFocus は、フォーカスされたときに発生するイベントですã?
376 *
377 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
378 *
379 * @param onFocus onFocusイベンãƒ?
380 */
381 public void setOnFocus( final String onFocus ) {
382 add( "onFocus",getRequestParameter( onFocus ),";" );
383 }
384
385 /**
386 * 【HTML】JavaScriptのイベンãƒ?onSelect を設定しますã?
387 *
388 * @og.tag
389 * onSelect は、テキストフィールãƒ?ãƒ?‚ストエリアのãƒ?‚ストが
390 * 選択されたときに発生するイベントですã?
391 *
392 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
393 *
394 * @param onSelect onSelectイベンãƒ?
395 */
396 public void setOnSelect( final String onSelect ) {
397 add( "onSelect",getRequestParameter( onSelect ),";" );
398 }
399
400 /**
401 * 【HTML】JavaScriptのイベンãƒ?ondblClick を設定しますã?
402 *
403 * @og.tag
404 * ondblClick は、ã?ウスでãƒ?ƒ–ルクリãƒ?‚¯されたときに発生するイベントですã?
405 *
406 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
407 *
408 * @param ondblClick ondblClickイベンãƒ?
409 */
410 public void setOndblClick( final String ondblClick ) {
411 add( "ondblClick",getRequestParameter( ondblClick ),";" );
412 }
413
414 /**
415 * 【HTML】JavaScriptのイベンãƒ?onMouseDown を設定しますã?
416 *
417 * @og.tag
418 * onMouseDown は、ã?ウスãƒ?‚¦ンされたときに発生するイベントですã?
419 *
420 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
421 *
422 * @param onMouseDown onMouseDownイベンãƒ?
423 */
424 public void setOnMouseDown( final String onMouseDown ) {
425 add( "onMouseDown",getRequestParameter( onMouseDown ),";" );
426 }
427
428 /**
429 * 【HTML】JavaScriptのイベンãƒ?onMouseUp を設定しますã?
430 *
431 * @og.tag
432 * onMouseUp は、ã?ウスアãƒ??されたときに発生するイベントですã?
433 *
434 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
435 *
436 * @param onMouseUp onMouseUpイベンãƒ?
437 */
438 public void setOnMouseUp( final String onMouseUp ) {
439 add( "onMouseUp",getRequestParameter( onMouseUp ),";" );
440 }
441
442 /**
443 * 【HTML】JavaScriptのイベンãƒ?onMouseMove を設定しますã?
444 *
445 * @og.tag
446 * onMouseMove は、ã?ウスが移動されたときに発生するイベントですã?
447 *
448 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
449 *
450 * @param onMouseMove onMouseMoveイベンãƒ?
451 */
452 public void setOnMouseMove( final String onMouseMove ) {
453 add( "onMouseMove",getRequestParameter( onMouseMove ),";" );
454 }
455
456 /**
457 * 【HTML】JavaScriptのイベンãƒ?onMouseOut を設定しますã?
458 *
459 * @og.tag
460 * onMouseOut は、ã?ウスが離れたときに発生するイベントですã?
461 *
462 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
463 *
464 * @param onMouseOut onMouseOutイベンãƒ?
465 */
466 public void setOnMouseOut( final String onMouseOut ) {
467 add( "onMouseOut",getRequestParameter( onMouseOut ),";" );
468 }
469
470 /**
471 * 【HTML】JavaScriptのイベンãƒ?onMouseOver を設定しますã?
472 *
473 * @og.tag
474 * onMouseOver は、ã?ウスが重なったときに発生するイベントですã?
475 *
476 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
477 *
478 * @param onMouseOver onMouseOverイベンãƒ?
479 */
480 public void setOnMouseOver( final String onMouseOver ) {
481 add( "onMouseOver",getRequestParameter( onMouseOver ),";" );
482 }
483
484 /**
485 * 【HTML】JavaScriptのイベンãƒ?onKeydown を設定しますã?
486 *
487 * @og.tag
488 * onKeydown は、キーが押されたときに発生するイベントですã?
489 *
490 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
491 *
492 * @param onKeydown onKeydownイベンãƒ?
493 */
494 public void setOnKeydown( final String onKeydown ) {
495 add( "onKeydown",getRequestParameter( onKeydown ),";" );
496 }
497
498 /**
499 * 【HTML】JavaScriptのイベンãƒ?onKeypress を設定しますã?
500 *
501 * @og.tag
502 * onKeypress は、キーが押され続けてã�?�Ÿときに発生するイベントですã?
503 *
504 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
505 *
506 * @param onKeypress onKeypressイベンãƒ?
507 */
508 public void setOnKeypress( final String onKeypress ) {
509 add( "onKeypress",getRequestParameter( onKeypress ),";" );
510 }
511
512 /**
513 * 【HTML】JavaScriptのイベンãƒ?onKeyup を設定しますã?
514 *
515 * @og.tag
516 * onKeyup は、キーが押された状態から離されたときに発生するイベントですã?
517 *
518 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
519 *
520 * @param onKeyup onKeyupイベンãƒ?
521 */
522 public void setOnKeyup( final String onKeyup ) {
523 add( "onKeyup",getRequestParameter( onKeyup ),";" );
524 }
525
526 /**
527 * 【HTML5】å?力å?補を提示して入力å?容をè?動補完する[on/off]?ˆå?期å?はon?‰ã?
528 *
529 * @og.tag
530 * HTML5から追åŠ?�•れた新機è?ですã?
531 * オートコンプリートを有効にする場合ã?、on 、無効にする場合ã?、off を設定しますã?
532 * 初期値は、on(有効) ですã?
533 *
534 * <datalist> タグを使用して、å?力å?補となるデータリストを定義できますã?
535 * å�?ƒ‡ータのリストé?目はã€?lt;option>で定義しますã? <datalist>をサポã?トしたブラウザではã€?
536 * <option>でæŒ?®šされた値がユーザーに対して入力å?補として提案表示されますã?
537 * <input>のlist属æ?の値と<datalist>のid属æ?の値を同じにして、å?力æ¬?�¨
538 * ãƒ??タリストを関連付けますã?
539 *
540 * 利用可能type:[text,search,url,tel,email,password,datetime,date,month,week,time,datetime-local,number,range,color]
541 *
542 * <pre>
543 * <og:input type="text" name="yourarea" autocomplete="on" list="tokyo" />
544 *
545 * <og:datalist id="tokyo" >
546 * <og:option value="渋谷" />
547 * <og:option value="新宿" />
548 * <og:option value="æ±?¢? />
549 * </og:datalist><
550 * </pre>
551 *
552 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
553 *
554 * @param autocomplete 入力å?補ã?自動補完ã?設å®?[on/off]?ˆå?期å?はon??
555 * @see <a href="http://www.htmq.com/html5/input_autocomplete.shtml">autocomplete</a>
556 */
557 public void setAutocomplete( final String autocomplete ) {
558 set( "autocomplete" , getRequestParameter( autocomplete ) );
559 }
560
561 /**
562 * 【HTML5】指定したå?力æ¬?�«カーソルが当たって自動的にフォーカスされますã?
563 *
564 * @og.tag
565 * HTML5から追åŠ?�•れた新機è?ですã?
566 * autofocus属æ?を指定すると、ウェブã?ージが表示された際にã€?
567 * æŒ?®šしたå?力æ¬?�«カーソルが当たって自動的にフォーカスされますã?
568 *
569 * autofocus="autofocus" , autofocus="true" が指定された場合ã?、有効ですã?
570 * false も指定å?としては、有効ですã?(大æ–?—小文字ã?区別も不è¦?
571 * それ以外ã?æŒ?®šã?、エラーとしますã?
572 *
573 * 利用可能type:[text,search,url,tel,email,password]
574 *
575 * ※ autofocus は、論理属æ?ですã?
576 *
577 * <pre>
578 * <og:input type="text" name="userid" autofocus="autofocus" />
579 * </pre>
580 *
581 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
582 *
583 * @param atfocus カーソルが当たって自動的にフォーカスされã‚?
584 * @see <a href="http://www.htmq.com/html5/input_autofocus.shtml">autofocus</a>
585 */
586 public void setAutofocus( final String atfocus ) {
587 String autofocus = nval( getRequestParameter( atfocus ),null );
588 if( autofocus != null ) {
589 if( "autofocus".equalsIgnoreCase( autofocus ) ||
590 "true".equalsIgnoreCase( autofocus ) ) {
591 set( "autofocus","autofocus" );
592 }
593 else if( ! "false".equalsIgnoreCase( autofocus ) ) {
594 String errMsg = "autofocus には、[autofocus,true,false]以外ã?æ–?—ã?æŒ?®šできませんã€?
595 + " autofocus=[" + autofocus + "]" + HybsSystem.CR ;
596 throw new HybsSystemException( errMsg );
597 }
598 }
599 }
600
601 /**
602 * 【HTML5】正規表現で入力å?のパターンを指定しますã?
603 *
604 * @og.tag
605 * HTML5から追åŠ?�•れた新機è?ですã?
606 * 正規表現を使って入力å?のパターンを指定することができますã?
607 *
608 * 利用可能type:[text,search,url,tel,email,password]
609 *
610 * <pre>
611 * <og:input type="text" name="userid" pattern="^[0-9A-Za-z]+$" /> ※半角英数
612 * </pre>
613 *
614 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
615 *
616 * @param pattern 正規表現で入力å?のパターンを指å®?
617 * @see <a href="http://www.htmq.com/html5/input_pattern.shtml">pattern</a>
618 */
619 public void setPattern( final String pattern ) {
620 set( "pattern",getRequestParameter( pattern ) );
621 }
622
623 /**
624 * 【HTML5】å?力æ¬?�«初期表示するå†?®¹を指定しますã?
625 *
626 * @og.tag
627 * HTML5から追åŠ?�•れた新機è?ですã?
628 * placeholder属æ?でæŒ?®šしたå?がã?入力æ¬?�«初期値として表示されますã?
629 * 例えば、テキストフィールドに初期値としてã€?「検索するキーワードを入力してくださいã€?
630 * などのヒントを示してユーザーの操作を補助することができますã?
631 *
632 * 利用可能type:[text,search,url,tel,email,password]
633 *
634 * <pre>
635 * <og:input type="search" name="q" placeholder="キーワードを入åŠ? />
636 * </pre>
637 *
638 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
639 *
640 * @param placeholder 入力æ¬?�«初期表示するå†?®¹
641 * @see <a href="http://www.htmq.com/html5/input_placeholder.shtml">placeholder</a>
642 */
643 public void setPlaceholder( final String placeholder ) {
644 set( "placeholder",getRequestParameter( placeholder ) );
645 }
646
647 /**
648 * 【HTML5】ユーザーに入力å?補として提案するデータリストã?要ç´??id属æ?の値を指定しますã?
649 *
650 * @og.tag
651 * HTML5から追åŠ?�•れた新機è?ですã?
652 * ユーザーに入力å?補として提案するデータリストタグ(<datalist>)のid属æ?ã‚?
653 * こã?、list 属æ?に設定することでã€?–¢連付けができますã?
654 *
655 * ※
656 * å†?ƒ¨事情で、list属æ? に設定するキーもã?datalistタグのid属æ?に設定するキーもã?
657 * inputタグ(columnタグ)の name属æ???.sel" を標準的に使用してくださいã€?
658 *
659 * 利用可能type:[text,search,url,tel,email,datetime,date,month,week,time,datetime-local,number,range,color]
660 *
661 * <pre>
662 * <og:input type="search" name="keywords" autocomplete="on" list="keywords.sel" />
663 * <og:datalist id="keywords.sel">
664 * <og:option value="ウィキペディア" />
665 * <og:option value="ウィルス対ç? />
666 * <og:option value="ウィンドウズ" />
667 * </og:datalist>
668 * </pre>
669 *
670 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
671 *
672 * @param list 入力å?補として提案するデータリストã?id属æ?の値を指å®?
673 * @see <a href="http://www.htmq.com/html5/datalist.shtml">list</a>
674 */
675 public void setList( final String list ) {
676 set( "list",getRequestParameter( list ) );
677 }
678
679 /**
680 * 【HTML5】å?力æ¬?�§入力できるæœ?°�å?を指定しますã?
681 *
682 * @og.tag
683 * HTML5から追åŠ?�•れた新機è?ですã?
684 * 数値型や日付型の入力æ¬?�§入力できるæœ?°�å?を指定することができますã?
685 *
686 * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
687 *
688 * <pre>
689 * <og:input type="number" name="ninzu" min="1" max="4" />ã€??1人以ä¸?人以ä¸?
690 * </pre>
691 *
692 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
693 *
694 * @param min 入力できるæœ?°�å?
695 * @see <a href="http://www.htmq.com/html5/input_min.shtml">min</a>
696 */
697 public void setMin( final String min ) {
698 set( "min",getRequestParameter( min ) );
699 }
700
701 /**
702 * 【HTML5】å?力æ¬?�§入力できるæœ?¤§値を指定しますã?
703 *
704 * @og.tag
705 * HTML5から追åŠ?�•れた新機è?ですã?
706 * 数値型や日付型の入力æ¬?�§入力できるæœ?¤§値を指定することができますã?
707 *
708 * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
709 *
710 * <pre>
711 * <og:input type="number" name="ninzu" min="1" max="4" />ã€??1人以ä¸?人以ä¸?
712 * </pre>
713 *
714 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
715 *
716 * @param max 入力できるæœ?¤§値
717 * @see <a href="http://www.htmq.com/html5/input_min.shtml">max</a>
718 */
719 public void setMax( final String max ) {
720 set( "max",getRequestParameter( max ) );
721 }
722
723 /**
724 * 【HTML5】å?力æ¬?�§刻ã‚?‚¹ãƒ?ƒƒプå?を指定するã?
725 *
726 * @og.tag
727 * HTML5から追åŠ?�•れた新機è?ですã?
728 * step属æ?を指定するとã€?数値型や日付型の入力æ¬?�§刻ã‚?‚¹ãƒ?ƒƒプå?を指定することができますã?
729 *
730 * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
731 *
732 * <pre>
733 * <og:input type="number" name="lot" step="0.5" />ã€??単ä½?.5
734 * </pre>
735 *
736 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
737 *
738 * @param step 入力æ¬?�§刻ã‚?‚¹ãƒ?ƒƒプå?
739 * @see <a href="http://www.htmq.com/html5/input_step.shtml">step</a>
740 */
741 public void setStep( final String step ) {
742 set( "step",getRequestParameter( step ) );
743 }
744
745 /**
746 * 【HTML5】å?力å¿??を指定するã?
747 *
748 * @og.tag
749 * HTML5から追åŠ?�•れた新機è?ですã?
750 * 入力é?目がå?力å¿??であることをブラウザに知らせることができますã?
751 * 単独で、required 属æ?を使用できるようにしておきますã?
752 *
753 * フレーãƒ?ƒ¯ークの入力å¿??は、must 属æ?ですが、must 属æ?を指定したå?合にもã?
754 * シスãƒ?ƒ リソースの USE_HTML5_HEADER ã‚?true に設定してã�?‚‹場合ã?ã€?
755 * required 属æ?をå?力しますã?
756 *
757 * 利用可能type:[text,search,url,tel,email,datetime,date,month,week,time,datetime-local,number,checkbox,radio,file]
758 *
759 * ※ required は、論理属æ?ですã?
760 *
761 * <pre>
762 * <og:input type="text" name="yourname" required="required" />
763 * </pre>
764 *
765 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
766 *
767 * @param req 入力å¿??を指å®?
768 * @see <a href="http://www.htmq.com/html5/input_required.shtml">required</a>
769 */
770 public void setRequired( final String req ) {
771 String required = nval( getRequestParameter( req ),null );
772 if( required != null ) {
773 if( "required".equalsIgnoreCase( required ) ||
774 "true".equalsIgnoreCase( required ) ) {
775 set( "required","required" );
776 }
777 else if( ! "false".equalsIgnoreCase( required ) ) {
778 String errMsg = "required には、[required/true/false]以外ã?æ–?—ã?æŒ?®šできませんã€?
779 + " required=[" + required + "]" + HybsSystem.CR ;
780 throw new HybsSystemException( errMsg );
781 }
782 }
783 }
784
785 /**
786 * 【TAG】ロールをセãƒ?ƒˆしますã?
787 *
788 * @og.tag
789 * ここでæŒ?®šしたカラãƒ?ƒールをå?に、ユーザー毎ã?アクセス許可がチェãƒ?‚¯されますã?
790 * アクセス許可されなã�?�¨、表示されませんã€?
791 * こã?ロールを指定しなã�??合ã?、カラãƒ?ƒªソースのロールが使用されますã?
792 *
793 * @og.rev 4.0.0.0 (2005/11/30) 新規追åŠ?
794 *
795 * @param roles ロール
796 */
797 public void setRoles( final String roles ) {
798 set( "roles",getRequestParameter( roles ) );
799 }
800
801 /**
802 * 【TAG】å¿??入力を表す色に変えるかどã�?�‹[true/false]を指定しまã�?初期値:false)ã€?
803 *
804 * @og.tag
805 * 初期値は、å¿??でなã�?"false") ですã?
806 * シスãƒ?ƒ リソースの USE_HTML5_HEADER がã?true にæŒ?®šされてã�?‚‹場合ã?ã€?
807 * HTML5 適用として、required 属æ?もã?出力しますã?
808 *
809 * <og:input name="PN" must="true" />
810 *
811 * @og.rev 5.2.1.0 (2010/10/01) 新規追åŠ?
812 * @og.rev 5.7.1.0 (2013/12/06) HTML5 対å¿?required属æ?)ã€?
813 *
814 * @param flag å¿??入力色に変えるかどã�?�‹[true:å¿??入åŠ?それ以å¤?å¿??でない]
815 */
816 public void setMust( final String flag ) {
817 mustType = nval( getRequestParameter( flag ),null );
818 if( "true".equalsIgnoreCase( mustType ) ) {
819 mustType = "must";
820 add( "class","must" );
821
822 // 5.7.1.0 (2013/12/06) HTML5 対å¿?required属æ?)ã€?
823 if( isUseHTML5() ) {
824 set( "required","required" );
825 }
826 }
827 }
828
829 /**
830 * 【TAG】選択å¿??入åŠ?どれかひとつå¿??)を表す色[true/mustAny/そã?他]を指定しまã�?初期値:無æŒ?®?ã€?
831 *
832 * @og.tag
833 * è¤?•°のカラãƒ??ã�?�¡、どれかひとつをå¿??とする選択å¿??入力を示す色を指定しますã?
834 * true またã?、mustAny を設定すると、class属æ?に、mustAny がセãƒ?ƒˆされますã?
835 * mustAny は、CSSファイルに初期設定されてã�?�¾すã?true またã?、mustAny 以外ã?値をセãƒ?ƒˆ
836 * すると、その値がそのまま、class属æ?にセãƒ?ƒˆされますã?でã€?�¸択å¿??のグループ化ã�?
837 * 可能ですã?
838 * なおã?実際の選択å¿??入力チェãƒ?‚¯は、ここではなくã?columnCheck タグでæŒ?®šがå¿?¦�ですã?
839 * 自動å?ç�??、mustAny="true" æŒ?®šã?場合ã?み有効ですã?
840 * 初期値は、無æŒ?®šですã?
841 *
842 * @og.rev 5.2.1.0 (2010/10/01) 新規追åŠ?
843 *
844 * @param flag 選択å¿??入のæŒ?®š[true/mustAny/そã?他]
845 */
846 public void setMustAny( final String flag ) {
847 if( mustType == null ) { // must 属æ?と同時設定時には、must 属æ?を優先しますã?
848 mustType = nval( getRequestParameter( flag ),null );
849 if( "true".equalsIgnoreCase( mustType ) ) {
850 mustType = "mustAny";
851 }
852 add( "class",mustType ); // mustType == null の場合ã?、add されませんã€?
853 }
854 }
855
856 /**
857 * 【TAG】å¿??の自動チェãƒ?‚¯用Hiddenをå?力するかどã�?�‹[true/false]を指定しまã�?初期値:true)ã€?
858 *
859 * @og.tag
860 * query.jsp上でmust/mustAnyæŒ?®šしたå?合に検索時ã?å¿??チェãƒ?‚¯をè?動化するための
861 * hiddenをå?力するかどã�?�‹を選択しますã?
862 * 初期値は、å?力すã‚?"true") ですã?
863 * 通常は初期値で問題ありませんがã?å¿??のåˆ?›¿をScriptで行う場合等に邪魔になるå?合が
864 * あるため出力ã?åˆ?›¿をå?来るよã�?�«しておきますã?
865 *
866 *
867 * @og.rev 5.7.2.0 (2013/01/10) 新規作æ?
868 *
869 * @param flag 自動チェãƒ?‚¯用hiddenをå?力するか[true:出åŠ?それ以å¤?出力しない]
870 */
871 public void setUseMustHidden( final String flag ) {
872 useMustHidden = nval( getRequestParameter( flag ),useMustHidden );
873 }
874
875 /**
876 * mustType 属æ?を取得しますã?
877 *
878 * must , mustAny 属æ?を設定するå?合に、mustType 属æ?を設定しますã?
879 * そã?設定された値を取りå?しますã?
880 * 何も設定されてã�?�ªã�?ж態では、null を返しますã?
881 *
882 * @og.rev 5.2.1.0 (2010/10/01) 新規追åŠ??
883 *
884 * @return mustType属æ?
885 */
886 protected String getMustType() {
887 return mustType ;
888 }
889
890 /**
891 * must , mustAny 属æ?をè?動化するためのhiddenタグを生成しますã?
892 *
893 * HybsSystem.MUST_KEY + mustType をキーに、指定ã?カラãƒ?��をå?として
894 * hidden を作æ?しますã?こã?値ã‚?columnChack タグで拾って must 処ç�?�—ますã?
895 * なおã?must , mustAny 属æ?を使用してã�?�ªã�??合ã?、null を返しますã?
896 *
897 * @og.rev 5.2.1.0 (2010/10/01) 新規追åŠ??
898 * @og.rev 5.7.2.0 (2014/01/10) useMustHidden対å¿?
899 *
900 * @param name mustæŒ?®šするカラãƒ?‰ã?名称
901 *
902 * @return 自動化するためのhiddenタグ
903 */
904 protected String makeMustHidden( final String name ) {
905 String rtn = "";
906 if( mustType != null && useMustHidden ) { // 5.7.2.0 (2014/01/10)
907 rtn = XHTMLTag.hidden( HybsSystem.MUST_KEY + mustType, name );
908 }
909 return rtn;
910 }
911
912 /**
913 * HTML5を使用するかどã�?�‹(true:使用する/false:使用しなã�?を取得しますã?
914 *
915 * HTML5 の機è?を有効にするには、ネイãƒ?‚£ブモードで動作させるå¿?¦�がありますã?
916 * â‘?USE_IE7_HEADER = "false" に設定するã?
917 * ② USE_HTML5_HEADER = "true" に設定するã?
918 * ③ IEのãƒ??ル⇒互換表示設定で、互換表示に追åŠ?�—たWebサイトから削除するã€?
919 * ④ 同上ã?設定で、イントラサイトを互換表示で表示するのチェãƒ?‚¯を外すã€?
920 * å¿?¦�がありますã?
921 * こã?メソãƒ?ƒ‰で返すのは、①と②の設定ができてã�?‚Œば true、そã�?�§なければ、false を返しますã?
922 *
923 * (初期値:USE_IE7_HEADER[={@og.value org.opengion.hayabusa.common.SystemData#USE_IE7_HEADER}])ã€?
924 * (初期値:USE_HTML5_HEADER[={@og.value org.opengion.hayabusa.common.SystemData#USE_HTML5_HEADER}])ã€?
925 *
926 * @og.rev 5.7.1.0 (2013/12/06) 新規追åŠ?
927 *
928 * @return HTML5を使用するかどã�?�‹(true:使用する/false:使用しなã�?
929 */
930 protected boolean isUseHTML5() {
931 boolean useHTML5 = ! HybsSystem.sysBool( "USE_IE7_HEADER" ) // â‘?IE7互換モードが、false
932 && HybsSystem.sysBool( "USE_HTML5_HEADER" ); // ② HTML5 ヘッãƒ??ã�?true
933
934 return useHTML5 ;
935 }
936 }