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             * &lt;og:input type="text" name="yourarea" autocomplete="on" list="tokyo" /&gt;
544             *
545             *  &lt;og:datalist id="tokyo" &gt;
546             *      &lt;og:option value="渋谷" /&gt;
547             *      &lt;og:option value="新宿" /&gt;
548             *      &lt;og:option value="æ±?¢? /&gt;
549             *  &lt;/og:datalist&gt;&lt;
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             * &lt;og:input type="text" name="userid" autofocus="autofocus" /&gt;
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             * &lt;og:input type="text" name="userid" pattern="^[0-9A-Za-z]+$" /&gt; ※半角英数
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             * &lt;og:input type="search" name="q" placeholder="キーワードを入åŠ? /&gt;
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             * ユーザーに入力å?補として提案するデータリストタグ(&lt;datalist&gt;)の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             *              &lt;og:input type="search" name="keywords" autocomplete="on" list="keywords.sel" /&gt;
663             *              &lt;og:datalist id="keywords.sel"&gt;
664             *                      &lt;og:option value="ウィキペディア" /&gt;
665             *                      &lt;og:option value="ウィルス対ç­? /&gt;
666             *                      &lt;og:option value="ウィンドウズ" /&gt;
667             *              &lt;/og:datalist&gt;
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             * &lt;og:input type="number" name="ninzu" min="1" max="4" /&gt;ã€??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             * &lt;og:input type="number" name="ninzu" min="1" max="4" /&gt;ã€??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             * &lt;og:input type="number" name="lot" step="0.5" /&gt;ã€??単ä½?.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             * &lt;og:input type="text" name="yourname" required="required" /&gt;
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             * &lt;og:input name="PN" must="true" /&gt;
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    }