    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 */
    016package org.opengion.hayabusa.taglib;
    017
    018import org.opengion.hayabusa.common.HybsSystem;
    019import org.opengion.hayabusa.common.HybsSystemException;
    020
    021import org.opengion.fukurou.util.TagBuffer;                                             // 6.2.0.0 (2015/02/27)
    022import org.opengion.fukurou.util.XHTMLTag;
    023import org.opengion.fukurou.util.StringUtil;                                    // 6.4.1.1 (2016/01/16)
    024import static org.opengion.fukurou.util.StringUtil.nval ;
    025
    026/**
    027 * CommonTagSupport から継承されたサブクラスです。
    028 *
    029 * HTML関連の共通属性を、設定する為のメソッドを持っています。
    030 * 主な、HTMLタグは、このクラスを継承して作ることで、必要な属性は、
    031 * Attributes オブジェクト にセットされるため、#set(String,String)
    032 * get(String) メソッドで扱う事が可能になります。
    033 * 不要な属性は、tld ファイルに記述しなければ、使用されません。
    034 *
    035 * 以下に、このメソッド内で定義される属性を記述します。
    036 *
    037 *       roles              【TAG】ロールをセットします
    038 *       must               【TAG】必須入力を表す色に変えるかどうか[true/false]を指定します(初期値:false)
    039 *       mustAny            【TAG】選択必須入力(どれかひとつ必須)を表す色[true/mustAny/その他]を指定します(初期値:無指定)
    040 *       useMustHidden      【TAG】必須の自動チェック用Hiddenを出力するかどうか[true/false]を指定します(初期値:true)
    041 *       aimai              【TAG】曖昧検索可能フィールドとして、曖昧検索方法を指定します(初期値:null)
    042 *       optionAttributes   【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します
    043 *       id                 【HTML】要素に対して固有の名前(id)をつける場合に設定します
    044 *       clazz              【HTML】要素に対して class 属性を設定します
    045 *       lang               【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します
    046 *       dir                【HTML】文字表記の方向(dir)を指定します
    047 *       title              【HTML】要素に対する補足的情報(title)を設定します
    048 *       style              【HTML】この要素に対して適用させるスタイルシート(style)を設定します
    049 *       readonly           【TAG】その部品に対して変更が出来ないように(readonly)指定します(サーバーに送信される)
    050 *       disabled           【TAG】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない)
    051 *       tabindex           【HTML】タブの移動順(tabindex)を指定します(0 ～ 32767)
    052 *       accesskey          【HTML】アクセスキー(alt+キーで直接指定)を割り当てます
    053 *       onClick            【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');")
    054 *       onChange           【HTML】JavaScriptのイベント onChange を設定します(例:onChange="renew('query.jsp','QUERY');")
    055 *       onBlur             【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();")
    056 *       onFocus            【HTML】JavaScriptのイベント onFocus を設定します
    057 *       onSelect           【HTML】JavaScriptのイベント onSelect を設定します
    058 *       ondblClick         【HTML】JavaScriptのイベント ondblClick を設定します
    059 *       onMouseDown        【HTML】JavaScriptのイベント onMouseDown を設定します
    060 *       onMouseUp          【HTML】JavaScriptのイベント onMouseUp を設定します
    061 *       onMouseMove        【HTML】JavaScriptのイベント onMouseMove を設定します
    062 *       onMouseOut         【HTML】JavaScriptのイベント onMouseOut を設定します
    063 *       onMouseOver        【HTML】JavaScriptのイベント onMouseOver を設定します
    064 *       onKeydown          【HTML】JavaScriptのイベント onKeydown を設定します
    065 *       onKeypress         【HTML】JavaScriptのイベント onKeypress を設定します
    066 *       onKeyup            【HTML】JavaScriptのイベント onKeyup を設定します
    067 *       autocomplete       【HTML5】入力候補を提示して入力内容を自動補完する[on/off]（初期値はon）。
    068 *       autofocus          【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます。
    069 *       pattern            【HTML5】正規表現で入力値のパターンを指定します。
    070 *       placeholder        【HTML5】入力欄に初期表示する内容を指定します。
    071 *       list               【HTML5】ユーザーに入力候補として提案するデータリストの要素のid属性の値を指定します。
    072 *       min                【HTML5】入力欄で入力できる最小値を指定します。
    073 *       max                【HTML5】入力欄で入力できる最大値を指定します。
    074 *       step               【HTML5】入力欄で刻むステップ値を指定する。
    075 *       required           【HTML5】入力必須を指定します
    076 *
    077 * 各属性は、{&#064;XXXX} 変数が使用できます。
    078 * これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に
    079 * 割り当てます。つまり、このXXXXをキーにリクエストすれば、
    080 * この変数に値をセットすることができます。
    081 *
    082 * http://localhost/query.jsp?KEY1=VLA1&amp;KEY2=VAL2
    083 *
    084 * のようなリクエストで、{&#064;KEY1} とすれば、 VAL1 がセットされます。
    085 *
    086 * このタグは、ラベル部分と入力フィールド部分がテーブルタグの&lt;td&gt;
    087 * により左右に分割されます。HTML 表示時は、前後に&lt;tr&gt;タグで囲って,
    088 * 整形できます。
    089 *
    090 * ※ readonly , disabled , autofocus[HTML5] , required[HTML5]  は、論理属性です。
    091 * 通常は、キーワードのみの指定で、有効です。
    092 * よって、readonly="false" としても、readonly というキーワードが存在すると、有効になります。
    093 * 記述例  ①readonly ②readonly="" ③readonly="readonly" の３種類が推奨されます。
    094 *          「属性名」 「属性名=""」 「属性名="属性名"」
    095 * フレームワーク側の問題として、①や②の渡し方は他の属性との関係や、動的なリクエスト変数の処理の
    096 * 関係で、③を利用します。また、動的切替の為に、④readonly="[true/false]" も受け付けます。
    097 * 内部的には、readonly="true" の場合は、readonly="readonly" を作成し、readonly="false" の場合は、
    098 * なにも作成しないという処理を行っています。
    099 *
    100 * 7.4.2.1 (2021/05/21)
    101 *   ｼｽﾃﾑ定数 USE_ACCESSKEY を false に設定すると、accesskey は使用されません。
    102 *
    103 * @og.group 画面部品
    104 *
    105 * @version  4.0
    106 * @author   Kazuhiko Hasegawa
    107 * @since    JDK5.0,
    108 */
    109abstract class HTMLTagSupport extends CommonTagSupport {
    110        /** このプログラムのVERSION文字列を設定します。   {@value} */
    111        private static final String VERSION = "6.9.5.0 (2018/04/23)" ;
    112        private static final long serialVersionUID = 695020180423L ;
    113
    114        // 6.4.0.4 (2015/12/26) HTML5使用時の must="true" での required属性の出力制御
    115        private static final boolean USE_MUST_REQUIRED = HybsSystem.sysBool( "USE_MUST_REQUIRED" );
    116
    117        // 6.2.0.0 (2015/02/27) AimaiPicker のタイプに対応したキーワード
    118        private static final String[] AIMAI_TEXT = { " V ", " V*", "*V ", "*V*" };
    119        private static final String[] AIMAI_TITL = { "完全一致", "前方一致", "後方一致", "前後曖昧" };
    120
    121        // 7.4.2.1 (2021/05/21) accesskey の設定の有効(true)/無効(false)を設定します(要再起動)
    122        private static final boolean useAccessKey = HybsSystem.sysBool( "USE_ACCESSKEY" );
    123
    124        // 5.2.1.0 (2010/10/01) must , mustAny 属性を自動化します。
    125        private String  mustType        ;                       // 5.2.1.0 (2010/10/01)
    126        // 5.7.2.0 (2014/01/10) 自動化の制御をできるようにします。(初期は自動)
    127        private boolean useMustHidden = true;   // 5.7.2.0 (2014/01/10)
    128        // 6.2.0.0 (2015/02/27) aimai 属性を追加。
    129        private int             aimai           = -1;           // 6.2.0.0 (2015/02/27)
    130
    131        /**
    132         * デフォルトコンストラクター
    133         *
    134         * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
    135         */
    136        public HTMLTagSupport() { super(); }            // これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。
    137
    138        /**
    139         * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    140         *
    141         * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
    142         * @og.rev 4.0.0.0 (2005/11/30) ロール を考慮します。
    143         * @og.rev 4.3.0.0 (2008/07/04) ロールモードマルチ対応
    144         * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
    145         * @og.rev 6.1.0.0 (2014/12/26) HTML5のrequired属性は、useMustHidden==true でも制御可能とする。
    146         * @og.rev 6.4.0.4 (2015/12/26) USE_MUST_REQUIRED で、HTML5使用時の must="true" での required属性の出力制御
    147         * @og.rev 6.9.5.0 (2018/04/23) isUseHTML5() 廃止(true固定)
    148         *
    149         * @return      後続処理
    150         */
    151        @Override
    152        public int doEndTag() {
    153                debugPrint();           // 4.0.0 (2005/02/28)
    154                // 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
    155                if( useTag() && getUser().isAccess( get( "roles" ) ) ) {                        // 4.3.0.0 (2008/07/04) ロールモードマルチ対応
    156                        // 6.1.0.0 (2014/12/26) HTML5のrequired属性は、useMustHidden==true でも制御可能とする。
    157//                      if( "must".equals( mustType ) && useMustHidden && isUseHTML5() && USE_MUST_REQUIRED ) {
    158                        if( "must".equals( mustType ) && useMustHidden && USE_MUST_REQUIRED ) {         // 6.9.5.0 (2018/04/23) isUseHTML5() 廃止(true固定)
    159                                set( "required","required" );
    160                        }
    161                        jspPrint( makeTag() );
    162                }
    163                return EVAL_PAGE ;
    164        }
    165
    166        /**
    167         * タグリブオブジェクトをリリースします。
    168         * キャッシュされて再利用されるので、フィールドの初期設定を行います。
    169         *
    170         * @og.rev 5.2.1.0 (2010/10/01) mustType 属性を追加。
    171         * @og.rev 5.7.2.0 (2014/01/10) useMustHidden追加
    172         * @og.rev 6.2.0.0 (2015/02/27) aimai 属性を追加
    173         */
    174        @Override
    175        protected void release2() {
    176                super.release2();
    177                mustType                = null;         // 5.2.1.0 (2010/10/01)
    178                useMustHidden   = true;         // 5.7.2.0 (2013/12/10)
    179                aimai                   = -1;           // 6.2.0.0 (2015/02/27) aimai 属性を追加。
    180        }
    181
    182        /**
    183         * タグ文字列を作成します。
    184         *
    185         * ここでは、#doEndTag() で、jspPrint の出力として書き出されます。
    186         * 各サブクラスで、実装してください。
    187         *
    188         * @return  タグ文字列
    189         */
    190        protected abstract String makeTag() ;
    191
    192        /**
    193         * 【HTML】要素に対して固有の名前(id)をつける場合に設定します。
    194         *
    195         * @og.tag
    196         * 特別な使用方法として、id="FOCUS" とすることで、フィールド系要素に
    197         * フォーカスを移動させます。これは、そのページ内で唯一の id 属性として使用ください。
    198         *
    199         * ※ HTML5 より、autofocus属性の使用が可能になりました。
    200         *
    201         * @param   id 固有の名前
    202         */
    203        @Override
    204        public void setId( final String id ) {
    205                set( "id",getRequestParameter( id ) );
    206        }
    207
    208        /**
    209         * 【HTML】要素に対して class 属性を設定します。
    210         *
    211         * @og.tag
    212         * Javaの言語使用上、class で作成できないため、代用として
    213         * clazz を使用しています。
    214         * html で作成される属性は、 class で作成されます。
    215         *
    216         * @og.rev 3.5.0.0 (2003/09/17) set ではなく、add を利用します。
    217         *
    218         * @param   cls class属性
    219         */
    220        public void setClazz( final String cls ) {
    221                add( "class",getRequestParameter( cls ) );      // 3.5.5.9 (2004/06/07) セパレータ引数付きのメソッドに変更
    222        }
    223
    224        /**
    225         * 【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します。
    226         *
    227         * @og.tag
    228         * HTMLの言語属性に使われます。指定する値は、ISO 639で規定されている「言語コード」です。
    229         * [ja/en/zh/…]などのほかに、en-US:アメリカ英語、en-cockney:コックニー英語 など、
    230         * 副言語を指定する方法も定められています。
    231         * ここでは、lang と xml:lang の両方に同じ値がセットされます。
    232         * タグの language 属性とは使用用途が異なります。
    233         *
    234         * @og.tag lang セット
    235         *
    236         * @param   lang 言語 [ja/en/zh/…]
    237         */
    238        public void setLang( final String lang ) {
    239                final String lng = getRequestParameter( lang );
    240                if( lng != null ) {
    241                        set( "lang",lng );
    242                        set( "xml:lang",lng );
    243                }
    244        }
    245
    246        /**
    247         * 【HTML】文字表記の方向(dir)を指定します。
    248         *
    249         * @og.tag
    250         * 当該要素の書字方向を指定する属性です。
    251         * ltr で、左から右に、rtl で、右から左に並べます。
    252         *
    253         * @param   dir 文字表記方向 [ltr:左から右、rtl:右から左]
    254         */
    255        public void setDir( final String dir ) {
    256                set( "dir",getRequestParameter( dir ) );
    257        }
    258
    259        /**
    260         * 【HTML】要素に対する補足的情報(title)を設定します。
    261         *
    262         * @og.tag
    263         * title セットは、ボタンなどに適用すると、マウスオーバーによりこのメッセージが
    264         * チップスのように表示されます。これを利用して、説明文を登録することが可能です。
    265         * ここに指定した文字列が、ラベルリソースに存在する場合は、そのラベルを表示し、
    266         * 存在しない場合は、そのままの値を表示します。
    267         *
    268         * 6.1.1.0 (2015/01/17)
    269         *  ① 1.引数を、{&#064;XXXX} 処理せずに、XXXX でラベルリソースの概要をチェックします。
    270         *     2.存在しなければ、ラベルをチェックします。
    271         *     3.そこにもなければ、全体を、RequestParameter 処理します。
    272         *  ② 変換後の文字列から、"￥n" を、"&amp;#13;&amp;#10;" に変換することで、改行に対応します。
    273         *     実際は、CR か LF のどちらでも改行するようです。
    274         *
    275         * @og.rev 3.5.5.8 (2004/05/20) メッセージリソースから読み込んだ文字を使用します。
    276         * @og.rev 4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage ⇒ getResource().getLabel )
    277         * @og.rev 6.1.1.0 (2015/01/17) 直接、ラベルリソースを表示できるようにする。
    278         *
    279         * @param   title タイトル情報
    280         */
    281        public void setTitle( final String title ) {
    282                // 6.1.1.0 (2015/01/17)
    283                if( title != null ) {
    284                        String lbl = getResource().getDescription( title );                     // ①1.まずは概要
    285                        // 存在しないか、引数と同じ場合(変換できなかった=存在しない)は、再検索
    286                        if( lbl == null || lbl.isEmpty() || lbl.equals( title ) ) {
    287                                lbl = getResource().getLabel( title );                                  // ①2.なければ、ラベル
    288                                if( lbl == null || lbl.isEmpty() || lbl.equals( title ) ) {
    289                                        lbl = nval( getRequestParameter( title ),null );        // ①3.RequestParameter 処理する
    290                                }
    291                        }
    292
    293                        if( lbl != null ) {
    294                                // "\n" という文字列の正規表現は、"\\n" で本物の改行コードになるので、４つ \ が必要になる。
    295                                lbl = lbl.replaceAll( "\\\\n","&#13;&#10;" );                           // ②.改行に対応
    296                                set( "title",lbl );
    297                        }
    298                }
    299        }
    300
    301        /**
    302         * 【HTML】この要素に対して適用させるスタイルシート(style)を設定します。
    303         *
    304         * @og.tag
    305         * タグにstyle属性を設定します。これは、キー:値; のセットを複数記述できます。
    306         * 通常は、class属性や、id属性で登録しておき、&lt;style type="text/css"&gt; で
    307         * 外部から指定する方がソースは読みやすくなります。
    308         *
    309         * @param   style スタイルシート (例 style="color:red; font-size:24pt;" など)
    310         */
    311        public void setStyle( final String style ) {
    312                set( "style",getRequestParameter( style ) );
    313        }
    314
    315        /**
    316         * 【TAG】その部品に対して変更が出来ないように(readonly)指定します(サーバーに送信される)。
    317         *
    318         * @og.tag
    319         * INPUT/TEXTAREA 系に対して、指定可能です。
    320         * readonly="readonly" , readonly="true" が指定された場合は、有効です。
    321         * false も指定値としては、有効です。(大文字小文字の区別も不要)
    322         * それ以外の指定は、エラーとします。
    323         *
    324         * ※ readonly は、論理属性です。
    325         *
    326         * @og.rev 3.7.1.0 (2005/04/26) readonly,true,false が指定できるように変更。
    327         *
    328         * @param   ronly 読取専用 [readonly/true/false]
    329         */
    330        public void setReadonly( final String ronly ) {
    331                final String readonly = nval( getRequestParameter( ronly ),null );
    332                if( readonly != null ) {
    333                        if( "readonly".equalsIgnoreCase( readonly ) ||
    334                                "true".equalsIgnoreCase( readonly ) ) {
    335                                        set( "readonly","readonly" );
    336                        }
    337                        else if( ! "false".equalsIgnoreCase( readonly ) ) {
    338                                final String errMsg = "readonly には、[readonly,true,false]以外の文字は指定できません。"
    339                                                                + " readonly=[" + readonly + "]" + CR ;
    340                                throw new HybsSystemException( errMsg );
    341                        }
    342                }
    343        }
    344
    345        /**
    346         * 【TAG】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない)。
    347         *
    348         * @og.tag
    349         * BUTTON/INPUT/OPTGROUP/OPTION/SELECT/TEXTAREA 系に対して、指定可能です。
    350         * disabled="disabled" , disabled="true" が指定された場合は、有効です。
    351         * false も指定値としては、有効です。(大文字小文字の区別も不要)
    352         * それ以外の指定は、エラーとします。
    353         *
    354         * ※ disabled は、論理属性です。
    355         *
    356         * @og.rev 3.7.1.0 (2005/04/26) disabled,true,false が指定できるように変更。
    357         *
    358         * @param   dis disabled指定 [disabled,true:disabled/false:設定なし]
    359         */
    360        public void setDisabled( final String dis ) {
    361                final String disabled = nval( getRequestParameter( dis ),null );
    362                if( disabled != null ) {
    363                        if( "disabled".equalsIgnoreCase( disabled ) ||
    364                                "true".equalsIgnoreCase( disabled ) ) {
    365                                        set( "disabled","disabled" );
    366                        }
    367                        else if( ! "false".equalsIgnoreCase( disabled ) ) {
    368                                final String errMsg = "disabled には、[disabled/true/false]以外の文字は指定できません。"
    369                                                                + " disabled=[" + disabled + "]" + CR ;
    370                                throw new HybsSystemException( errMsg );
    371                        }
    372                }
    373        }
    374
    375        /**
    376         * 【HTML】タブの移動順(tabindex)を指定します(0 ～ 32767)。
    377         *
    378         * @og.tag
    379         * Tabキーを押したときに要素が選択される順番を指定します。
    380         * 値には、選択させたい順番を数値で記述します。
    381         *
    382         * @param       tabindex        タブ移動順 (0～32767)
    383         */
    384        public void setTabindex( final String tabindex ) {
    385                set( "tabindex",getRequestParameter( tabindex ) );
    386        }
    387
    388        /**
    389         * 【HTML】アクセスキー(alt+キーで直接指定)を割り当てます。
    390         *
    391         * @og.tag
    392         * アクセスキーは、マウスの使えない環境でも、リンクにジャンプする、ボタンを押す、入力フォームに
    393         * フォーカスを移すなどの操作を簡単に行うことができるように考慮されたものです。
    394         * Windows の「ファイル(F)」メニューについている、F と同じような働きをします。
    395         *
    396         * 7.4.2.1 (2021/05/21)
    397         *   ｼｽﾃﾑ定数 USE_ACCESSKEY を false に設定すると、accesskey は使用されません。
    398         *
    399         * @param   accesskey アクセスキー
    400         */
    401        public void setAccesskey( final String accesskey ) {
    402                if( useAccessKey ) {                            // 7.4.2.1 (2021/05/21)
    403                        set( "accesskey",getRequestParameter( accesskey ) );
    404                }
    405        }
    406
    407        /**
    408         * 【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します。
    409         *
    410         * @og.tag
    411         * JavaScript などの HTML基本タグ以外の属性を、そのまま
    412         * タグとして使用します。
    413         *
    414         * @og.rev 3.1.0.1 (2003/03/26) (')を(")に置き換え処理していたのを止める。
    415         *
    416         * @param   optionAttributes オプション属性
    417         */
    418        public void setOptionAttributes( final String optionAttributes ) {
    419                final String optAttri = getRequestParameter( optionAttributes );
    420                if( optAttri != null && optAttri.length() > 0 ) {
    421                        set( "optionAttributes",optAttri );
    422                }
    423        }
    424
    425        /**
    426         * 【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');")。
    427         *
    428         * @og.tag
    429         * onClick をセットします。
    430         * 例えば、&lt;og:column name="KBSAKU" onClick="renew('query.jsp','QUERY');" /&gt;
    431         * のように指定することで、プルダウンメニューの絞込み検索が可能になります。
    432         *
    433         * @og.rev 3.5.0.0 (2003/09/17) 新規追加
    434         * @og.rev 3.5.5.9 (2004/06/07) セパレータ付きの追加メソッドに変更
    435         *
    436         * @param       onClick onClickイベント (例:onClick="renew('query.jsp','QUERY');")
    437         */
    438        public void setOnClick( final String onClick ) {
    439                add( "onClick",getRequestParameter( onClick ),";" );
    440        }
    441
    442        /**
    443         * 【HTML】JavaScriptのイベント onChange を設定します(例:onChange="renew('query.jsp','QUERY');")。
    444         *
    445         * @og.tag
    446         * onChange をセットします。
    447         * 例えば、&lt;og:column name="KBSAKU" onChange="renew('query.jsp','QUERY');" /&gt;
    448         * のように指定することで、プルダウンメニューの絞込み検索が可能になります。
    449         *
    450         * @og.rev 3.5.0.0 (2003/09/17) 新規追加
    451         * @og.rev 3.5.5.9 (2004/06/07) セパレータ付きの追加メソッドに変更
    452         *
    453         * @param   onChange    onChangeイベント (例:onChange="renew('query.jsp','QUERY');")
    454         */
    455        public void setOnChange( final String onChange ) {
    456                add( "onChange",getRequestParameter( onChange ),";" );
    457        }
    458
    459        /**
    460         * 【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();")。
    461         *
    462         * @og.tag
    463         * onBlur は、フォーカスが離れたときに発生するイベントです。
    464         *
    465         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    466         *
    467         * @param   onBlur      onBlurイベント (例:onBlur="this.value=value.toUpperCase();")
    468         */
    469        public void setOnBlur( final String onBlur ) {
    470                add( "onBlur",getRequestParameter( onBlur ),";" );
    471        }
    472
    473        /**
    474         * 【HTML】JavaScriptのイベント onFocus を設定します。
    475         *
    476         * @og.tag
    477         * onFocus は、フォーカスされたときに発生するイベントです。
    478         *
    479         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    480         *
    481         * @param   onFocus     onFocusイベント
    482         */
    483        public void setOnFocus( final String onFocus ) {
    484                add( "onFocus",getRequestParameter( onFocus ),";" );
    485        }
    486
    487        /**
    488         * 【HTML】JavaScriptのイベント onSelect を設定します。
    489         *
    490         * @og.tag
    491         * onSelect は、テキストフィールド/テキストエリアのテキストが
    492         * 選択されたときに発生するイベントです。
    493         *
    494         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    495         *
    496         * @param   onSelect    onSelectイベント
    497         */
    498        public void setOnSelect( final String onSelect ) {
    499                add( "onSelect",getRequestParameter( onSelect ),";" );
    500        }
    501
    502        /**
    503         * 【HTML】JavaScriptのイベント ondblClick を設定します。
    504         *
    505         * @og.tag
    506         * ondblClick は、マウスでダブルクリックされたときに発生するイベントです。
    507         *
    508         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    509         *
    510         * @param   ondblClick  ondblClickイベント
    511         */
    512        public void setOndblClick( final String ondblClick ) {
    513                add( "ondblClick",getRequestParameter( ondblClick ),";" );
    514        }
    515
    516        /**
    517         * 【HTML】JavaScriptのイベント onMouseDown を設定します。
    518         *
    519         * @og.tag
    520         * onMouseDown は、マウスダウンされたときに発生するイベントです。
    521         *
    522         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    523         *
    524         * @param   onMouseDown onMouseDownイベント
    525         */
    526        public void setOnMouseDown( final String onMouseDown ) {
    527                add( "onMouseDown",getRequestParameter( onMouseDown ),";" );
    528        }
    529
    530        /**
    531         * 【HTML】JavaScriptのイベント onMouseUp を設定します。
    532         *
    533         * @og.tag
    534         * onMouseUp は、マウスアップされたときに発生するイベントです。
    535         *
    536         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    537         *
    538         * @param   onMouseUp   onMouseUpイベント
    539         */
    540        public void setOnMouseUp( final String onMouseUp ) {
    541                add( "onMouseUp",getRequestParameter( onMouseUp ),";" );
    542        }
    543
    544        /**
    545         * 【HTML】JavaScriptのイベント onMouseMove を設定します。
    546         *
    547         * @og.tag
    548         * onMouseMove は、マウスが移動されたときに発生するイベントです。
    549         *
    550         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    551         *
    552         * @param   onMouseMove onMouseMoveイベント
    553         */
    554        public void setOnMouseMove( final String onMouseMove ) {
    555                add( "onMouseMove",getRequestParameter( onMouseMove ),";" );
    556        }
    557
    558        /**
    559         * 【HTML】JavaScriptのイベント onMouseOut を設定します。
    560         *
    561         * @og.tag
    562         * onMouseOut は、マウスが離れたときに発生するイベントです。
    563         *
    564         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    565         *
    566         * @param   onMouseOut  onMouseOutイベント
    567         */
    568        public void setOnMouseOut( final String onMouseOut ) {
    569                add( "onMouseOut",getRequestParameter( onMouseOut ),";" );
    570        }
    571
    572        /**
    573         * 【HTML】JavaScriptのイベント onMouseOver を設定します。
    574         *
    575         * @og.tag
    576         * onMouseOver は、マウスが重なったときに発生するイベントです。
    577         *
    578         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    579         *
    580         * @param   onMouseOver onMouseOverイベント
    581         */
    582        public void setOnMouseOver( final String onMouseOver ) {
    583                add( "onMouseOver",getRequestParameter( onMouseOver ),";" );
    584        }
    585
    586        /**
    587         * 【HTML】JavaScriptのイベント onKeydown を設定します。
    588         *
    589         * @og.tag
    590         * onKeydown は、キーが押されたときに発生するイベントです。
    591         *
    592         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    593         *
    594         * @param   onKeydown   onKeydownイベント
    595         */
    596        public void setOnKeydown( final String onKeydown ) {
    597                add( "onKeydown",getRequestParameter( onKeydown ),";" );
    598        }
    599
    600        /**
    601         * 【HTML】JavaScriptのイベント onKeypress を設定します。
    602         *
    603         * @og.tag
    604         * onKeypress は、キーが押され続けていたときに発生するイベントです。
    605         *
    606         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    607         *
    608         * @param   onKeypress  onKeypressイベント
    609         */
    610        public void setOnKeypress( final String onKeypress ) {
    611                add( "onKeypress",getRequestParameter( onKeypress ),";" );
    612        }
    613
    614        /**
    615         * 【HTML】JavaScriptのイベント onKeyup を設定します。
    616         *
    617         * @og.tag
    618         * onKeyup は、キーが押された状態から離されたときに発生するイベントです。
    619         *
    620         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    621         *
    622         * @param   onKeyup     onKeyupイベント
    623         */
    624        public void setOnKeyup( final String onKeyup ) {
    625                add( "onKeyup",getRequestParameter( onKeyup ),";" );
    626        }
    627
    628        /**
    629         * 【HTML5】入力候補を提示して入力内容を自動補完する[on/off]（初期値はon）。
    630         *
    631         * @og.tag
    632         * HTML5から追加された新機能です。
    633         * オートコンプリートを有効にする場合は、on 、無効にする場合は、off を設定します。
    634         * 初期値は、on(有効) です。
    635         *
    636         * &lt;datalist&gt; タグを使用して、入力候補となるデータリストを定義できます。
    637         * 各データのリスト項目は、&lt;option&gt;で定義します。 &lt;datalist&gt;をサポートしたブラウザでは、
    638         * &lt;option&gt;で指定された値がユーザーに対して入力候補として提案表示されます。
    639         * &lt;input&gt;のlist属性の値と&lt;datalist&gt;のid属性の値を同じにして、入力欄と
    640         * データリストを関連付けます。
    641         *
    642         * 利用可能type:[text,search,url,tel,email,password,datetime,date,month,week,time,datetime-local,number,range,color]
    643         *
    644         * <pre>
    645         * &lt;og:input type="text" name="yourarea" autocomplete="on" list="tokyo" /&gt;
    646         *
    647         *  &lt;og:datalist id="tokyo" &gt;
    648         *      &lt;og:option value="渋谷" /&gt;
    649         *      &lt;og:option value="新宿" /&gt;
    650         *      &lt;og:option value="池袋" /&gt;
    651         *  &lt;/og:datalist&gt;&lt;
    652         * </pre>
    653         *
    654         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    655         *
    656         * @param       autocomplete 自動補完設定 [on/off]（初期値はon）
    657         * @see         <a href="http://www.htmq.com/html5/input_autocomplete.shtml">autocomplete</a>
    658         */
    659        public void setAutocomplete( final String autocomplete ) {
    660                set( "autocomplete" , getRequestParameter( autocomplete ) );
    661        }
    662
    663        /**
    664         * 【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます。
    665         *
    666         * @og.tag
    667         * HTML5から追加された新機能です。
    668         * autofocus属性を指定すると、ウェブページが表示された際に、
    669         * 指定した入力欄にカーソルが当たって自動的にフォーカスされます。
    670         *
    671         * autofocus="autofocus" , autofocus="true" が指定された場合は、有効です。
    672         * false も指定値としては、有効です。(大文字小文字の区別も不要)
    673         * それ以外の指定は、エラーとします。
    674         *
    675         * 利用可能type:[text,search,url,tel,email,password]
    676         *
    677         * ※ autofocus は、論理属性です。
    678         *
    679         * <pre>
    680         * &lt;og:input type="text" name="userid" autofocus="autofocus" /&gt;
    681         * </pre>
    682         *
    683         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    684         *
    685         * @param       atfocus オートフォーカス
    686         * @see         <a href="http://www.htmq.com/html5/input_autofocus.shtml">autofocus</a>
    687         */
    688        public void setAutofocus( final String atfocus ) {
    689                final String autofocus = nval( getRequestParameter( atfocus ),null );
    690                if( autofocus != null ) {
    691                        if( "autofocus".equalsIgnoreCase( autofocus ) ||
    692                                "true".equalsIgnoreCase( autofocus ) ) {
    693                                        set( "autofocus","autofocus" );
    694                        }
    695                        else if( ! "false".equalsIgnoreCase( autofocus ) ) {
    696                                final String errMsg = "autofocus には、[autofocus,true,false]以外の文字は指定できません。"
    697                                                                + " autofocus=[" + autofocus + "]" + CR ;
    698                                throw new HybsSystemException( errMsg );
    699                        }
    700                }
    701        }
    702
    703        /**
    704         * 【HTML5】正規表現で入力値のパターンを指定します。
    705         *
    706         * @og.tag
    707         * HTML5から追加された新機能です。
    708         * 正規表現を使って入力値のパターンを指定することができます。
    709         *
    710         * 利用可能type:[text,search,url,tel,email,password]
    711         *
    712         * <pre>
    713         * &lt;og:input type="text" name="userid" pattern="^[0-9A-Za-z]+$" /&gt; ※半角英数
    714         * </pre>
    715         *
    716         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    717         *
    718         * @param       pattern 入力値正規表現
    719         * @see         <a href="http://www.htmq.com/html5/input_pattern.shtml">pattern</a>
    720         */
    721        public void setPattern( final String pattern ) {
    722                set( "pattern",getRequestParameter( pattern ) );
    723        }
    724
    725        /**
    726         * 【HTML5】入力欄に初期表示する内容を指定します。
    727         *
    728         * @og.tag
    729         * HTML5から追加された新機能です。
    730         * placeholder属性で指定した値が、入力欄に初期値として表示されます。
    731         * 例えば、テキストフィールドに初期値として、 「検索するキーワードを入力してください」
    732         * などのヒントを示してユーザーの操作を補助することができます。
    733         *
    734         * 利用可能type:[text,search,url,tel,email,password]
    735         *
    736         * 6.1.1.0 (2015/01/17)
    737         *  ① 1.引数を、{&#064;XXXX} 処理せずに、XXXX でラベルリソースをチェックします。
    738         *     2.なければ、全体を、RequestParameter 処理します。
    739         *  ② 変換後の文字列から、"￥n" を、"&amp;#13;&amp;#10;" に変換することで、改行に対応します。
    740         *     実際は、CR か LF のどちらでも改行するようです。
    741         *  ③ title属性が、未設定なら、placeholder の設定キーと同じキーで、title を設定します。
    742         *
    743         * <pre>
    744         * &lt;og:input type="search" name="q" placeholder="キーワードを入力" /&gt;
    745         * </pre>
    746         *
    747         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    748         * @og.rev 6.1.1.0 (2015/01/17) 直接、ラベルリソースを表示できるようにする。
    749         *
    750         * @param       placeholder 初期表示文字
    751         * @see         <a href="http://www.htmq.com/html5/input_placeholder.shtml">placeholder</a>
    752         */
    753        public void setPlaceholder( final String placeholder ) {
    754
    755                if( placeholder != null ) {
    756                        String lbl = getResource().getLabel( placeholder );                                     // ①1.ラベル
    757                        // 存在しないか、引数と同じ場合(変換できなかった=存在しない)は、再検索
    758                        if( lbl == null || lbl.isEmpty() || lbl.equals( placeholder ) ) {
    759                                lbl = nval( getRequestParameter( placeholder ),null );                  // ①2.RequestParameter 処理する
    760                        }
    761
    762                        if( lbl != null ) {
    763                                // "\n" という文字列の正規表現は、"\\n" で本物の改行コードになるので、４つ \ が必要になる。
    764                                lbl = lbl.replaceAll( "\\\\n","&#13;&#10;" );                           // ②.改行に対応
    765                                set( "placeholder",lbl );
    766                        }
    767
    768                        // ③ title が設定されていない場合は、設定する。
    769                        // パラメータのアクセス順は不明だが、titleが後なら、上書きされるので、OK。
    770                        if( get( "title" ) == null ) {
    771                                setTitle( placeholder );        // title に placeholder のキーをセットする。
    772                        }
    773                }
    774        }
    775
    776        /**
    777         * 【HTML5】ユーザーに入力候補として提案するデータリストの要素のid属性の値を指定します。
    778         *
    779         * @og.tag
    780         * HTML5から追加された新機能です。
    781         * ユーザーに入力候補として提案するデータリストタグ(&lt;datalist&gt;)のid属性を
    782         * この、list 属性に設定することで、関連付けができます。
    783         *
    784         * ※
    785         * 内部事情で、list属性 に設定するキーも、datalistタグのid属性に設定するキーも、
    786         * inputタグ(columnタグ)の name属性＋".sel" を標準的に使用してください。
    787         *
    788         * 利用可能type:[text,search,url,tel,email,datetime,date,month,week,time,datetime-local,number,range,color]
    789         *
    790         * <pre>
    791         *              &lt;og:input type="search" name="keywords" autocomplete="on" list="keywords.sel" /&gt;
    792         *              &lt;og:datalist id="keywords.sel"&gt;
    793         *                      &lt;og:option value="ウィキペディア" /&gt;
    794         *                      &lt;og:option value="ウィルス対策" /&gt;
    795         *                      &lt;og:option value="ウィンドウズ" /&gt;
    796         *              &lt;/og:datalist&gt;
    797         * </pre>
    798         *
    799         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    800         *
    801         * @param       list データリストID
    802         * @see         <a href="http://www.htmq.com/html5/datalist.shtml">list</a>
    803         */
    804        public void setList( final String list ) {
    805                set( "list",getRequestParameter( list ) );
    806        }
    807
    808        /**
    809         * 【HTML5】入力欄で入力できる最小値を指定します。
    810         *
    811         * @og.tag
    812         * HTML5から追加された新機能です。
    813         *  数値型や日付型の入力欄で入力できる最小値を指定することができます。
    814         *
    815         * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
    816         *
    817         * <pre>
    818         * &lt;og:input type="number" name="ninzu" min="1" max="4" /&gt;　※1人以上4人以下
    819         * </pre>
    820         *
    821         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    822         *
    823         * @param       min 入力できる最小値
    824         * @see         <a href="http://www.htmq.com/html5/input_min.shtml">min</a>
    825         */
    826        public void setMin( final String min ) {
    827                set( "min",getRequestParameter( min ) );
    828        }
    829
    830        /**
    831         * 【HTML5】入力欄で入力できる最大値を指定します。
    832         *
    833         * @og.tag
    834         * HTML5から追加された新機能です。
    835         *  数値型や日付型の入力欄で入力できる最大値を指定することができます。
    836         *
    837         * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
    838         *
    839         * <pre>
    840         * &lt;og:input type="number" name="ninzu" min="1" max="4" /&gt;　※1人以上4人以下
    841         * </pre>
    842         *
    843         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    844         *
    845         * @param       max 入力できる最大値
    846         * @see         <a href="http://www.htmq.com/html5/input_min.shtml">max</a>
    847         */
    848        public void setMax( final String max ) {
    849                set( "max",getRequestParameter( max ) );
    850        }
    851
    852        /**
    853         * 【HTML5】入力欄で刻むステップ値を指定します。
    854         *
    855         * @og.tag
    856         * HTML5から追加された新機能です。
    857         * step属性を指定すると、 数値型や日付型の入力欄で刻むステップ値を指定することができます。
    858         *
    859         * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
    860         *
    861         * <pre>
    862         * &lt;og:input type="number" name="lot" step="0.5" /&gt;　※単位0.5
    863         * </pre>
    864         *
    865         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    866         *
    867         * @param       step 入力ステップ値
    868         * @see         <a href="http://www.htmq.com/html5/input_step.shtml">step</a>
    869         */
    870        public void setStep( final String step ) {
    871                set( "step",getRequestParameter( step ) );
    872        }
    873
    874        /**
    875         * 【HTML5】入力必須を指定します。
    876         *
    877         * @og.tag
    878         * HTML5から追加された新機能です。
    879         * 入力項目が入力必須であることをブラウザに知らせることができます。
    880         * 単独で、required 属性を使用できるようにしておきます。
    881         *
    882//       * フレームワークの入力必須は、must 属性ですが、must 属性を指定した場合にも、
    883//       * システムリソースの USE_IE7_HEADER = "false" で、USE_HTML5_HEADER = "true" で、
    884         * USE_MUST_REQUIRED = "true" の場合は、required 属性を出力します。
    885         *
    886         * 利用可能type:[text,search,url,tel,email,datetime,date,month,week,time,datetime-local,number,checkbox,radio,file]
    887         *
    888         * ※ required は、論理属性です。
    889         *
    890         * <pre>
    891         * &lt;og:input type="text" name="yourname" required="required" /&gt;
    892         * </pre>
    893         *
    894         * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    895         *
    896         * @param       req 入力必須かどうか [required/true/false]
    897         * @see         <a href="http://www.htmq.com/html5/input_required.shtml">required</a>
    898         */
    899        public void setRequired( final String req ) {
    900                final String required = nval( getRequestParameter( req ),null );
    901                if( required != null ) {
    902                        if( "required".equalsIgnoreCase( required ) ||
    903                                "true".equalsIgnoreCase( required ) ) {
    904                                        set( "required","required" );
    905                        }
    906                        else if( ! "false".equalsIgnoreCase( required ) ) {
    907                                final String errMsg = "required には、[required/true/false]以外の文字は指定できません。"
    908                                                                + " required=[" + required + "]" + CR ;
    909                                throw new HybsSystemException( errMsg );
    910                        }
    911                }
    912        }
    913
    914        /**
    915         * 【TAG】ロールをセットします。
    916         *
    917         * @og.tag
    918         * ここで指定したカラムロールを元に、ユーザー毎のアクセス許可がチェックされます。
    919         * アクセス許可されないと、表示されません。
    920         * このロールを指定しない場合は、カラムリソースのロールが使用されます。
    921         *
    922         * @og.rev 4.0.0.0 (2005/11/30) 新規追加
    923         *
    924         * @param       roles ロール
    925         */
    926        public void setRoles( final String roles ) {
    927                set( "roles",getRequestParameter( roles ) );
    928        }
    929
    930        /**
    931         * 【TAG】必須入力を表す色に変えるかどうか[true/false]を指定します(初期値:false)。
    932         *
    933         * @og.tag
    934         * 初期値は、必須でない("false") です。
    935         * useMustHidden==true(初期値) の場合は、必須の自動チェック用Hiddenを出力するため、
    936         * submit することで、必須チェックをかけることができます。
    937//       * さらに、システムリソースの USE_HTML5_HEADER が、true に指定されている場合は、
    938//       * HTML5 適用として、required 属性も、出力します。
    939//       *   ※ 6.1.0.0 (2014/12/26)
    940//       *      useMustHidden==true かつ、USE_HTML5_HEADER==true かつ USE_IE7_HEADER==false
    941//       *      の場合に、required 属性(HTML5の必須チェック)を出力します。
    942//       *      これは、#doEndTag() の中の、#makeTag() の直前でセットしますので、
    943//       *      #doEndTag() を継承する場合は、ご注意ください。
    944         *
    945         * &lt;og:input name="PN" must="true" /&gt;
    946         *
    947         * @og.rev 5.2.1.0 (2010/10/01) 新規追加
    948         * @og.rev 5.7.1.0 (2013/12/06) HTML5 対応(required属性)。
    949         * @og.rev 6.1.0.0 (2014/12/26) HTML5のrequired属性は、useMustHidden==true でも制御可能とする。
    950         * @og.rev 6.8.1.4 (2017/08/25) mustに、false 指定が出来るようにします。
    951         *
    952         * @param       flag    必須入力指定 [true:必須入力/false:必須削除/それ以外:何もしない]
    953         * @see         #setUseMustHidden( String )
    954         */
    955        public void setMust( final String flag ) {
    956                mustType = nval( getRequestParameter( flag ),null );
    957                if( "true".equalsIgnoreCase( mustType ) ) {
    958                        mustType = "must";
    959                        add( "class","must" );
    960
    961                        // 5.7.1.0 (2013/12/06) HTML5 対応(required属性)。
    962                        // 6.1.0.0 (2014/12/26) makeMustHidden( String ) 内で作成します。
    963                }
    964                // 6.8.1.4 (2017/08/25) mustに、false 指定が出来るようにします。
    965                else if( "false".equalsIgnoreCase( mustType ) ) {
    966                        mustType = "false";                                             // 特殊な指定
    967                }
    968        }
    969
    970        /**
    971         * 【TAG】選択必須入力(どれかひとつ必須)を表す色[true/mustAny/その他]を指定します(初期値:無指定)。
    972         *
    973         * @og.tag
    974         * 複数のカラムのうち、どれかひとつを必須とする選択必須入力を示す色を指定します。
    975         * true または、mustAny を設定すると、class属性に、mustAny がセットされます。
    976         * mustAny は、CSSファイルに初期設定されています。true または、mustAny 以外の値をセット
    977         * すると、その値がそのまま、class属性にセットされますので、選択必須のグループ化が
    978         * 可能です。
    979         * なお、実際の選択必須入力チェックは、ここではなく、columnCheck タグで指定が必要です。
    980         * 自動処理は、mustAny="true" 指定の場合のみ有効です。
    981         * 初期値は、無指定です。
    982         *
    983         * @og.rev 5.2.1.0 (2010/10/01) 新規追加
    984         *
    985         * @param       flag 選択必須入力指定 [true/mustAny/その他]
    986         * @see         #setUseMustHidden( String )
    987         */
    988        public void setMustAny( final String flag ) {
    989                if( mustType == null ) {        // must 属性と同時設定時には、must 属性を優先します。
    990                        mustType = nval( getRequestParameter( flag ),null );
    991                        if( "true".equalsIgnoreCase( mustType ) ) {
    992                                mustType = "mustAny";
    993                        }
    994                        add( "class",mustType );        // mustType == null の場合は、add されません。
    995                }
    996        }
    997
    998        /**
    999         * 【TAG】必須の自動チェック用Hiddenを出力するかどうか[true/false]を指定します(初期値:true)。
    1000         *
    1001         * @og.tag
    1002         * query.jsp上でmust/mustAny指定した場合に検索時の必須チェックを自動化するための
    1003         * hiddenを出力するかどうかを選択します。
    1004         * 初期値は、出力する("true") です。
    1005         * 通常は初期値で問題ありませんが、必須の切替をScriptで行う場合等に邪魔になる場合が
    1006         * あるため出力の切替を出来るようにしておきます。
    1007         *
    1008         * @og.rev 5.7.2.0 (2013/01/10) 新規作成
    1009         *
    1010         * @param       flag    必須自動チェック [true:使用する/それ以外:使用しない]
    1011         * @see         #setMust( String )
    1012         * @see         #setMustAny( String )
    1013         */
    1014        public void setUseMustHidden( final String flag ) {
    1015                useMustHidden = nval( getRequestParameter( flag ),useMustHidden );
    1016        }
    1017
    1018        /**
    1019         * 【TAG】曖昧検索可能フィールドとして、曖昧検索方法を指定します(初期値:null)。
    1020         *
    1021         * @og.tag
    1022         * 従来は、clazz="aimai" として、点線の入力フィールドのみ作成していましたが、
    1023         * AimaiPicker をCallするようにして、検索方法を指定できるようにします。
    1024         * なお、AimaiPickerは、カラムの値に、選択した条件に応じた ％を付与するため、
    1025         * result.jsp の like には、％を含めない様に記述してください。
    1026         *
    1027         * ※ 互換表示の為に、"true" 属性は残しておきます。ピッカー無しで、点線の入力フィールド
    1028         *    のみ設定します。(clazz="aimai" は、廃止の方向です)
    1029         *
    1030         *   ① class="aimai" の設定 (ほぼ、従来と同じ)
    1031         *   ② AimaiPicker となる、preタグを出力(スペースを含む固定幅文字にするため)
    1032         *   ③ aimai属性で、前方一致、後方一致、前後曖昧、完全一致 選択が可能
    1033         *   ④ aimai属性で選択した検索方法を、submit時にvalueに反映し、result.jsp に送信する。
    1034         *
    1035         * aimai属性の指定方法を以下に示します。
    1036         * 　"0" または "V"   :完全一致
    1037         * 　"1" または "V*"  :前方一致
    1038         * 　"2" または "*V"  :後方一致
    1039         * 　"3" または "*V*" :前後曖昧
    1040         * 　"true"           :従来互換(clazz="aimai")
    1041         *
    1042         * Vは、0,1,2,3 以外であれば、何でも構いません。* の位置で判定します。
    1043         *
    1044         * @og.rev 6.2.0.0 (2015/02/27) aimai 属性を追加。
    1045         *
    1046         * @param   val 曖昧検索指定 [0,V:完全一致/1,V*:前方一致/2,*V:後方一致/3,*V*:前後曖昧]
    1047         */
    1048        public void setAimai( final String val ) {
    1049                final String tmp = nval( getRequestParameter( val ),null );
    1050                if( tmp != null && !tmp.isEmpty() ) {
    1051                        add( "class","aimai" );                                         // class 設定は先に行う必要がある。
    1052
    1053                        // 曖昧タイプは、0,1,2,3,null(指定が不明時) に再設定しなおします。
    1054                        if( tmp.length() == 1 && "0,1,2,3".indexOf( tmp ) >= 0 ) {
    1055                                aimai = Integer.parseInt( tmp );                                // 0,1,2,3 を直接指定した場合。
    1056                        }
    1057                        else if( "true".equalsIgnoreCase( tmp ) ) {
    1058                                aimai = -1;                                                                             // 従来互換(clazz="aimai") 初期値なので、あえて設定の必要はない。
    1059                        }
    1060                        else {
    1061                                aimai = 0 ;                                                                                                     // * が 0個 ＝ V:完全一致 ＝ 0
    1062                                if( tmp.endsWith(   "*" ) ) { aimai  = 1; }                                     // * が 後ろ＝V*:前方一致 ＝ 1
    1063                                if( StringUtil.startsChar( tmp,'*' ) ) { aimai += 2; }          // * が 前  ＝*V:後方一致 ＝ 2
    1064                                                                                                                                // 先にV*:前方一致(typeを加算)＝*V*:前後曖昧 ＝ 3
    1065                        }
    1066                }
    1067        }
    1068
    1069        /**
    1070         * mustType 属性を取得します。
    1071         *
    1072         * must , mustAny 属性を設定する場合に、mustType 属性を設定します。
    1073         * その設定された値を取り出します。
    1074         * 何も設定されていない状態では、null を返します。
    1075         *
    1076         * @og.rev 5.2.1.0 (2010/10/01) 新規追加。
    1077         *
    1078         * @return      mustType属性
    1079         */
    1080        protected String getMustType() {
    1081                return mustType ;
    1082        }
    1083
    1084        /**
    1085         * must , mustAny 属性を自動化するためのhiddenタグを生成します。
    1086         *
    1087         * HybsSystem.MUST_KEY + mustType をキーに、指定のカラム名を値として
    1088         * hidden を作成します。この値を columnChack タグで拾って must 処理します。
    1089         * なお、must , mustAny 属性を使用していない場合は、ゼロ文字列 を返します。
    1090         *
    1091         * @og.rev 5.2.1.0 (2010/10/01) 新規追加。
    1092         * @og.rev 5.7.2.0 (2014/01/10) useMustHidden対応
    1093         * @og.rev 6.2.0.0 (2015/02/27) MustHidden は、同一 name で、カラム名を作成するので、id は、セットしない。
    1094         * @og.rev 6.8.1.4 (2017/08/25) mustに、false 指定が出来るようにします。
    1095         *
    1096         * @param       name    must指定するカラム等の名称
    1097         *
    1098         * @return      自動化するためのhiddenタグ
    1099         * @og.rtnNotNull
    1100         */
    1101        protected String makeMustHidden( final String name ) {
    1102                // 6.1.1.0 (2015/01/17) refactoring. ロジックの見直し
    1103                return mustType != null && !"false".equalsIgnoreCase( mustType ) && useMustHidden       // 6.8.1.4 (2017/08/25)
    1104                                        ? XHTMLTag.hidden( HybsSystem.MUST_KEY + mustType, name , null )                // 6.2.0.0 (2015/02/27)
    1105                                        : "" ;
    1106        }
    1107
    1108        /**
    1109         * aimai 属性を自動化するためのAimaiPicker関連タグを生成します。
    1110         *
    1111         * AIMAI_xxxのid属性をキーに、指定のカラムのvalue値の％付加を、JavaScriptで行います。
    1112         * そのための、preタグを出力します。
    1113         *
    1114         * @og.rev 6.2.0.0 (2015/02/27) aimai 属性を追加。
    1115         * @og.rev 6.2.2.0 (2015/03/27) id属性がある場合は、そちらを優先する。
    1116         *
    1117         * @param       name    aimai指定するカラム
    1118         *
    1119         * @return      自動化するためのpreタグ
    1120         * @og.rtnNotNull
    1121         */
    1122        protected String makeAimaiPicker( final String name ) {
    1123                if( aimai >= 0 ) {
    1124                        // 6.2.2.0 (2015/03/27) id属性がある場合は、そちらを優先する。
    1125                        final String id = get( "id" );
    1126                        final String aimaiId = "AIMAI_" + ( id == null || id.isEmpty() ? name : id );
    1127
    1128                        return new TagBuffer( "pre" )
    1129                                                .add(   "id"            , aimaiId )                                             // 6.2.2.0 (2015/03/27)
    1130                                                .add(   "class"         , "aimaiClm" )
    1131                                                .add(   "aimaiType"     , String.valueOf( aimai ) )
    1132                                                .add(   "title"         , AIMAI_TITL[aimai] )
    1133                                                .addBody( AIMAI_TEXT[aimai] )
    1134                                                .makeTag();
    1135                }
    1136                return "" ;
    1137        }
    1138
    1139//      /**
    1140//       * HTML5を使用するかどうか(true:使用する/false:使用しない)を取得します。
    1141//       *
    1142//       * HTML5 の機能を有効にするには、ネイティブモードで動作させる必要があります。
    1143//       *   ① USE_IE7_HEADER = "false" に設定する。
    1144//       *   ② USE_HTML5_HEADER = "true" に設定する。
    1145//       *   ③ IEのツール⇒互換表示設定で、互換表示に追加したWebサイトから削除する。
    1146//       *   ④ 同上の設定で、イントラサイトを互換表示で表示するのチェックを外す。
    1147//       * 必要があります。
    1148//       * このメソッドで返すのは、①と②の設定ができていれば true、そうでなければ、false を返します。
    1149//       *
    1150//       *      (初期値:USE_IE7_HEADER[={@og.value SystemData#USE_IE7_HEADER}])。
    1151//       *      (初期値:USE_HTML5_HEADER[={@og.value SystemData#USE_HTML5_HEADER}])。
    1152//       *
    1153//       * @og.rev 5.7.1.0 (2013/12/06) 新規追加
    1154//       * @og.rev 6.4.0.4 (2015/12/26) 他に使ってなさそうなので、protected → private にしておく。
    1155//       * @og.rev 6.9.5.0 (2018/04/23) USE_IE7_HEADER 廃止(false固定) , USE_HTML5_HEADER 廃止(true固定)
    1156//       *
    1157//       * @return      HTML5を使用するかどうか(true:使用する/false:使用しない)
    1158//       * @see         #setMust( String )
    1159//       */
    1160//      private boolean isUseHTML5() {
    1161//              // 6.1.1.0 (2015/01/17) refactoring. ロジックの見直し
    1162//              return  ! HybsSystem.sysBool( "USE_IE7_HEADER" )                // ① IE7互換モードが、false
    1163//                         && HybsSystem.sysBool( "USE_HTML5_HEADER" );         // ② HTML5 ヘッダーが true
    1164//      }
    1165}