/*
 * Copyright (c) 2009 The openGion Project.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
 * either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */
package org.opengion.hayabusa.taglib;

import org.opengion.hayabusa.common.HybsSystem;
import org.opengion.hayabusa.common.HybsSystemException;

import org.opengion.fukurou.util.TagBuffer;						// 6.2.0.0 (2015/02/27)
import org.opengion.fukurou.util.XHTMLTag;
import org.opengion.fukurou.util.StringUtil;					// 6.4.1.1 (2016/01/16)
import static org.opengion.fukurou.util.StringUtil.nval ;

/**
 * CommonTagSupport から継承されたサブクラスです。
 *
 * HTML関連の共通属性を、設定する為のメソッドを持っています。
 * 主な、HTMLタグは、このクラスを継承して作ることで、必要な属性は、
 * Attributes オブジェクト にセットされるため、#set(String,String) 
 * get(String) メソッドで扱う事が可能になります。
 * 不要な属性は、tld ファイルに記述しなければ、使用されません。
 *
 * 以下に、このメソッド内で定義される属性を記述します。
 *
 *       roles              【TAG】ロールをセットします
 *       must               【TAG】必須入力を表す色に変えるかどうか[true/false]を指定します(初期値:false)
 *       mustAny            【TAG】選択必須入力(どれかひとつ必須)を表す色[true/mustAny/その他]を指定します(初期値:無指定)
 *       useMustHidden      【TAG】必須の自動チェック用Hiddenを出力するかどうか[true/false]を指定します(初期値:true)
 *       aimai              【TAG】曖昧検索可能フィールドとして、曖昧検索方法を指定します(初期値:null)
 *       optionAttributes   【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します
 *       id                 【HTML】要素に対して固有の名前(id)をつける場合に設定します
 *       clazz              【HTML】要素に対して class 属性を設定します
 *       lang               【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します
 *       dir                【HTML】文字表記の方向(dir)を指定します
 *       title              【HTML】要素に対する補足的情報(title)を設定します
 *       style              【HTML】この要素に対して適用させるスタイルシート(style)を設定します
 *       readonly           【TAG】その部品に対して変更が出来ないように(readonly)指定します(サーバーに送信される)
 *       disabled           【TAG】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない)
 *       tabindex           【HTML】タブの移動順(tabindex)を指定します(0 ～ 32767)
 *       accesskey          【HTML】アクセスキー(alt+キーで直接指定)を割り当てます
 *       onClick            【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');")
 *       onChange           【HTML】JavaScriptのイベント onChange を設定します(例:onChange="renew('query.jsp','QUERY');")
 *       onBlur             【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();")
 *       onFocus            【HTML】JavaScriptのイベント onFocus を設定します
 *       onSelect           【HTML】JavaScriptのイベント onSelect を設定します
 *       ondblClick         【HTML】JavaScriptのイベント ondblClick を設定します
 *       onMouseDown        【HTML】JavaScriptのイベント onMouseDown を設定します
 *       onMouseUp          【HTML】JavaScriptのイベント onMouseUp を設定します
 *       onMouseMove        【HTML】JavaScriptのイベント onMouseMove を設定します
 *       onMouseOut         【HTML】JavaScriptのイベント onMouseOut を設定します
 *       onMouseOver        【HTML】JavaScriptのイベント onMouseOver を設定します
 *       onKeydown          【HTML】JavaScriptのイベント onKeydown を設定します
 *       onKeypress         【HTML】JavaScriptのイベント onKeypress を設定します
 *       onKeyup            【HTML】JavaScriptのイベント onKeyup を設定します
 *       autocomplete       【HTML5】入力候補を提示して入力内容を自動補完する[on/off]（初期値はon）。
 *       autofocus          【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます。
 *       pattern            【HTML5】正規表現で入力値のパターンを指定します。
 *       placeholder        【HTML5】入力欄に初期表示する内容を指定します。
 *       list               【HTML5】ユーザーに入力候補として提案するデータリストの要素のid属性の値を指定します。
 *       min                【HTML5】入力欄で入力できる最小値を指定します。
 *       max                【HTML5】入力欄で入力できる最大値を指定します。
 *       step               【HTML5】入力欄で刻むステップ値を指定する。
 *       required           【HTML5】入力必須を指定します
 *
 * 各属性は、{&#064;XXXX} 変数が使用できます。
 * これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に
 * 割り当てます。つまり、このXXXXをキーにリクエストすれば、
 * この変数に値をセットすることができます。
 *
 * http://localhost/query.jsp?KEY1=VLA1&amp;KEY2=VAL2
 *
 * のようなリクエストで、{&#064;KEY1} とすれば、 VAL1 がセットされます。
 *
 * このタグは、ラベル部分と入力フィールド部分がテーブルタグの&lt;td&gt;
 * により左右に分割されます。HTML 表示時は、前後に&lt;tr&gt;タグで囲って,
 * 整形できます。
 *
 * ※ readonly , disabled , autofocus[HTML5] , required[HTML5]  は、論理属性です。
 * 通常は、キーワードのみの指定で、有効です。
 * よって、readonly="false" としても、readonly というキーワードが存在すると、有効になります。
 * 記述例  ①readonly ②readonly="" ③readonly="readonly" の３種類が推奨されます。
 *          「属性名」 「属性名=""」 「属性名="属性名"」
 * フレームワーク側の問題として、①や②の渡し方は他の属性との関係や、動的なリクエスト変数の処理の
 * 関係で、③を利用します。また、動的切替の為に、④readonly="[true/false]" も受け付けます。
 * 内部的には、readonly="true" の場合は、readonly="readonly" を作成し、readonly="false" の場合は、
 * なにも作成しないという処理を行っています。
 *
 * @og.group 画面部品
 *
 * @version  4.0
 * @author   Kazuhiko Hasegawa
 * @since    JDK5.0,
 */
abstract class HTMLTagSupport extends CommonTagSupport {
	/** このプログラムのVERSION文字列を設定します。	{@value} */
	private static final String VERSION = "6.9.5.0 (2018/04/23)" ;
	private static final long serialVersionUID = 695020180423L ;

	// 6.4.0.4 (2015/12/26) HTML5使用時の must="true" での required属性の出力制御
	private static final boolean USE_MUST_REQUIRED = HybsSystem.sysBool( "USE_MUST_REQUIRED" );

	// 6.2.0.0 (2015/02/27) AimaiPicker のタイプに対応したキーワード
	private static final String[] AIMAI_TEXT = { " V ", " V*", "*V ", "*V*" };
	private static final String[] AIMAI_TITL = { "完全一致", "前方一致", "後方一致", "前後曖昧" };

	// 5.2.1.0 (2010/10/01) must , mustAny 属性を自動化します。
	private String	mustType	;			// 5.2.1.0 (2010/10/01)
	// 5.7.2.0 (2014/01/10) 自動化の制御をできるようにします。(初期は自動)
	private boolean useMustHidden = true;	// 5.7.2.0 (2014/01/10)
	// 6.2.0.0 (2015/02/27) aimai 属性を追加。
	private int		aimai		= -1;		// 6.2.0.0 (2015/02/27)

	/**
	 * デフォルトコンストラクター
	 *
	 * @og.rev 6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.
	 */
	public HTMLTagSupport() { super(); }		// これも、自動的に呼ばれるが、空のメソッドを作成すると警告されるので、明示的にしておきます。

	/**
	 * Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
	 *
	 * @og.rev 3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
	 * @og.rev 4.0.0.0 (2005/11/30) ロール を考慮します。
	 * @og.rev 4.3.0.0 (2008/07/04) ロールモードマルチ対応
	 * @og.rev 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
	 * @og.rev 6.1.0.0 (2014/12/26) HTML5のrequired属性は、useMustHidden==true でも制御可能とする。
	 * @og.rev 6.4.0.4 (2015/12/26) USE_MUST_REQUIRED で、HTML5使用時の must="true" での required属性の出力制御
	 * @og.rev 6.9.5.0 (2018/04/23) isUseHTML5() 廃止(true固定)
	 *
	 * @return	後続処理
	 */
	@Override
	public int doEndTag() {
		debugPrint();		// 4.0.0 (2005/02/28)
		// 5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応
		if( useTag() && getUser().isAccess( get( "roles" ) ) ) {			// 4.3.0.0 (2008/07/04) ロールモードマルチ対応
			// 6.1.0.0 (2014/12/26) HTML5のrequired属性は、useMustHidden==true でも制御可能とする。
//			if( "must".equals( mustType ) && useMustHidden && isUseHTML5() && USE_MUST_REQUIRED ) {
			if( "must".equals( mustType ) && useMustHidden && USE_MUST_REQUIRED ) {		// 6.9.5.0 (2018/04/23) isUseHTML5() 廃止(true固定)
				set( "required","required" );
			}
			jspPrint( makeTag() );
		}
		return EVAL_PAGE ;
	}

	/**
	 * タグリブオブジェクトをリリースします。
	 * キャッシュされて再利用されるので、フィールドの初期設定を行います。
	 *
	 * @og.rev 5.2.1.0 (2010/10/01) mustType 属性を追加。
	 * @og.rev 5.7.2.0 (2014/01/10) useMustHidden追加
	 * @og.rev 6.2.0.0 (2015/02/27) aimai 属性を追加
	 */
	@Override
	protected void release2() {
		super.release2();
		mustType		= null;		// 5.2.1.0 (2010/10/01)
		useMustHidden	= true;		// 5.7.2.0 (2013/12/10)
		aimai			= -1;		// 6.2.0.0 (2015/02/27) aimai 属性を追加。
	}

	/**
	 * タグ文字列を作成します。
	 *
	 * ここでは、#doEndTag() で、jspPrint の出力として書き出されます。
	 * 各サブクラスで、実装してください。
	 *
	 * @return  タグ文字列
	 */
	protected abstract String makeTag() ;

	/**
	 * 【HTML】要素に対して固有の名前(id)をつける場合に設定します。
	 *
	 * @og.tag
	 * 特別な使用方法として、id="FOCUS" とすることで、フィールド系要素に
	 * フォーカスを移動させます。これは、そのページ内で唯一の id 属性として使用ください。
	 *
	 * ※ HTML5 より、autofocus属性の使用が可能になりました。
	 *
	 * @param   id 固有の名前
	 */
	@Override
	public void setId( final String id ) {
		set( "id",getRequestParameter( id ) );
	}

	/**
	 * 【HTML】要素に対して class 属性を設定します。
	 *
	 * @og.tag
	 * Javaの言語使用上、class で作成できないため、代用として
	 * clazz を使用しています。
	 * html で作成される属性は、 class で作成されます。
	 *
	 * @og.rev 3.5.0.0 (2003/09/17) set ではなく、add を利用します。
	 *
	 * @param   cls class属性
	 */
	public void setClazz( final String cls ) {
		add( "class",getRequestParameter( cls ) );	// 3.5.5.9 (2004/06/07) セパレータ引数付きのメソッドに変更
	}

	/**
	 * 【HTML】要素の内容と他の属性値の言語(lang,xml:lang)を指定します。
	 *
	 * @og.tag
	 * HTMLの言語属性に使われます。指定する値は、ISO 639で規定されている「言語コード」です。
	 * [ja/en/zh/…]などのほかに、en-US:アメリカ英語、en-cockney:コックニー英語 など、
	 * 副言語を指定する方法も定められています。
	 * ここでは、lang と xml:lang の両方に同じ値がセットされます。
	 * タグの language 属性とは使用用途が異なります。
	 *
	 * @og.tag lang セット
	 *
	 * @param   lang 言語 [ja/en/zh/…]
	 */
	public void setLang( final String lang ) {
		final String lng = getRequestParameter( lang );
		if( lng != null ) {
			set( "lang",lng );
			set( "xml:lang",lng );
		}
	}

	/**
	 * 【HTML】文字表記の方向(dir)を指定します。
	 *
	 * @og.tag
	 * 当該要素の書字方向を指定する属性です。
	 * ltr で、左から右に、rtl で、右から左に並べます。
	 *
	 * @param   dir 文字表記方向 [ltr:左から右、rtl:右から左]
	 */
	public void setDir( final String dir ) {
		set( "dir",getRequestParameter( dir ) );
	}

	/**
	 * 【HTML】要素に対する補足的情報(title)を設定します。
	 *
	 * @og.tag
	 * title セットは、ボタンなどに適用すると、マウスオーバーによりこのメッセージが
	 * チップスのように表示されます。これを利用して、説明文を登録することが可能です。
	 * ここに指定した文字列が、ラベルリソースに存在する場合は、そのラベルを表示し、
	 * 存在しない場合は、そのままの値を表示します。
	 *
	 * 6.1.1.0 (2015/01/17)
	 *  ① 1.引数を、{&#064;XXXX} 処理せずに、XXXX でラベルリソースの概要をチェックします。
	 *     2.存在しなければ、ラベルをチェックします。
	 *     3.そこにもなければ、全体を、RequestParameter 処理します。
	 *  ② 変換後の文字列から、"￥n" を、"&amp;#13;&amp;#10;" に変換することで、改行に対応します。
	 *     実際は、CR か LF のどちらでも改行するようです。
	 *
	 * @og.rev 3.5.5.8 (2004/05/20) メッセージリソースから読み込んだ文字を使用します。
	 * @og.rev 4.0.0.0 (2007/10/18) メッセージリソース統合( getResource().getMessage ⇒ getResource().getLabel )
	 * @og.rev 6.1.1.0 (2015/01/17) 直接、ラベルリソースを表示できるようにする。
	 *
	 * @param   title タイトル情報
	 */
	public void setTitle( final String title ) {
		// 6.1.1.0 (2015/01/17)
		if( title != null ) {
			String lbl = getResource().getDescription( title );			// ①1.まずは概要
			// 存在しないか、引数と同じ場合(変換できなかった=存在しない)は、再検索
			if( lbl == null || lbl.isEmpty() || lbl.equals( title ) ) {
				lbl = getResource().getLabel( title );					// ①2.なければ、ラベル
				if( lbl == null || lbl.isEmpty() || lbl.equals( title ) ) {
					lbl = nval( getRequestParameter( title ),null );	// ①3.RequestParameter 処理する
				}
			}

			if( lbl != null ) {
				// "\n" という文字列の正規表現は、"\\n" で本物の改行コードになるので、４つ \ が必要になる。
				lbl = lbl.replaceAll( "\\\\n","&#13;&#10;" );				// ②.改行に対応
				set( "title",lbl );
			}
		}

	}

	/**
	 * 【HTML】この要素に対して適用させるスタイルシート(style)を設定します。
	 *
	 * @og.tag
	 * タグにstyle属性を設定します。これは、キー:値; のセットを複数記述できます。
	 * 通常は、class属性や、id属性で登録しておき、&lt;style type="text/css"&gt; で
	 * 外部から指定する方がソースは読みやすくなります。
	 *
	 * @param   style スタイルシート (例 style="color:red; font-size:24pt;" など)
	 */
	public void setStyle( final String style ) {
		set( "style",getRequestParameter( style ) );
	}

	/**
	 * 【TAG】その部品に対して変更が出来ないように(readonly)指定します(サーバーに送信される)。
	 *
	 * @og.tag
	 * INPUT/TEXTAREA 系に対して、指定可能です。
	 * readonly="readonly" , readonly="true" が指定された場合は、有効です。
	 * false も指定値としては、有効です。(大文字小文字の区別も不要)
	 * それ以外の指定は、エラーとします。
	 *
	 * ※ readonly は、論理属性です。
	 *
	 * @og.rev 3.7.1.0 (2005/04/26) readonly,true,false が指定できるように変更。
	 *
	 * @param   ronly 読取専用 [readonly/true/false]
	 */
	public void setReadonly( final String ronly ) {
		final String readonly = nval( getRequestParameter( ronly ),null );
		if( readonly != null ) {
			if( "readonly".equalsIgnoreCase( readonly ) ||
				"true".equalsIgnoreCase( readonly ) ) {
					set( "readonly","readonly" );
			}
			else if( ! "false".equalsIgnoreCase( readonly ) ) {
				final String errMsg = "readonly には、[readonly,true,false]以外の文字は指定できません。"
								+ " readonly=[" + readonly + "]" + CR ;
				throw new HybsSystemException( errMsg );
			}
		}
	}

	/**
	 * 【TAG】その部品に対して、選択や変更が出来ないように(disabled)指定します(サーバーに送信されない)。
	 *
	 * @og.tag
	 * BUTTON/INPUT/OPTGROUP/OPTION/SELECT/TEXTAREA 系に対して、指定可能です。
	 * disabled="disabled" , disabled="true" が指定された場合は、有効です。
	 * false も指定値としては、有効です。(大文字小文字の区別も不要)
	 * それ以外の指定は、エラーとします。
	 *
	 * ※ disabled は、論理属性です。
	 *
	 * @og.rev 3.7.1.0 (2005/04/26) disabled,true,false が指定できるように変更。
	 *
	 * @param   dis disabled指定 [disabled,true:disabled/false:設定なし]
	 */
	public void setDisabled( final String dis ) {
		final String disabled = nval( getRequestParameter( dis ),null );
		if( disabled != null ) {
			if( "disabled".equalsIgnoreCase( disabled ) ||
				"true".equalsIgnoreCase( disabled ) ) {
					set( "disabled","disabled" );
			}
			else if( ! "false".equalsIgnoreCase( disabled ) ) {
				final String errMsg = "disabled には、[disabled/true/false]以外の文字は指定できません。"
								+ " disabled=[" + disabled + "]" + CR ;
				throw new HybsSystemException( errMsg );
			}
		}
	}

	/**
	 * 【HTML】タブの移動順(tabindex)を指定します(0 ～ 32767)。
	 *
	 * @og.tag
	 * Tabキーを押したときに要素が選択される順番を指定します。
	 * 値には、選択させたい順番を数値で記述します。
	 *
	 * @param	tabindex	タブ移動順 (0～32767)
	 */
	public void setTabindex( final String tabindex ) {
		set( "tabindex",getRequestParameter( tabindex ) );
	}

	/**
	 * 【HTML】アクセスキー(alt+キーで直接指定)を割り当てます。
	 *
	 * @og.tag
	 * アクセスキーは、マウスの使えない環境でも、リンクにジャンプする、ボタンを押す、入力フォームに
	 * フォーカスを移すなどの操作を簡単に行うことができるように考慮されたものです。
	 * Windows の「ファイル(F)」メニューについている、F と同じような働きをします。
	 *
	 * @param   accesskey アクセスキー
	 */
	public void setAccesskey( final String accesskey ) {
		set( "accesskey",getRequestParameter( accesskey ) );
	}

	/**
	 * 【TAG】JavaScript などの HTML基本タグ以外の属性を、そのままタグとして使用します。
	 *
	 * @og.tag
	 * JavaScript などの HTML基本タグ以外の属性を、そのまま
	 * タグとして使用します。
	 *
	 * @og.rev 3.1.0.1 (2003/03/26) (')を(")に置き換え処理していたのを止める。
	 *
	 * @param   optionAttributes オプション属性
	 */
	public void setOptionAttributes( final String optionAttributes ) {
		final String optAttri = getRequestParameter( optionAttributes );
		if( optAttri != null && optAttri.length() > 0 ) {
			set( "optionAttributes",optAttri );
		}
	}

	/**
	 * 【HTML】JavaScriptのイベント onClick を設定します(例:onClick="renew('query.jsp','QUERY');")。
	 *
	 * @og.tag
	 * onClick をセットします。
	 * 例えば、&lt;og:column name="KBSAKU" onClick="renew('query.jsp','QUERY');" /&gt;
	 * のように指定することで、プルダウンメニューの絞込み検索が可能になります。
	 *
	 * @og.rev 3.5.0.0 (2003/09/17) 新規追加
	 * @og.rev 3.5.5.9 (2004/06/07) セパレータ付きの追加メソッドに変更
	 *
	 * @param	onClick	onClickイベント (例:onClick="renew('query.jsp','QUERY');")
	 */
	public void setOnClick( final String onClick ) {
		add( "onClick",getRequestParameter( onClick ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onChange を設定します(例:onChange="renew('query.jsp','QUERY');")。
	 *
	 * @og.tag
	 * onChange をセットします。
	 * 例えば、&lt;og:column name="KBSAKU" onChange="renew('query.jsp','QUERY');" /&gt;
	 * のように指定することで、プルダウンメニューの絞込み検索が可能になります。
	 *
	 * @og.rev 3.5.0.0 (2003/09/17) 新規追加
	 * @og.rev 3.5.5.9 (2004/06/07) セパレータ付きの追加メソッドに変更
	 *
	 * @param   onChange	onChangeイベント (例:onChange="renew('query.jsp','QUERY');")
	 */
	public void setOnChange( final String onChange ) {
		add( "onChange",getRequestParameter( onChange ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onBlur を設定します(例:onBlur="this.value=value.toUpperCase();")。
	 *
	 * @og.tag
	 * onBlur は、フォーカスが離れたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onBlur	onBlurイベント (例:onBlur="this.value=value.toUpperCase();")
	 */
	public void setOnBlur( final String onBlur ) {
		add( "onBlur",getRequestParameter( onBlur ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onFocus を設定します。
	 *
	 * @og.tag
	 * onFocus は、フォーカスされたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onFocus	onFocusイベント
	 */
	public void setOnFocus( final String onFocus ) {
		add( "onFocus",getRequestParameter( onFocus ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onSelect を設定します。
	 *
	 * @og.tag
	 * onSelect は、テキストフィールド/テキストエリアのテキストが
	 * 選択されたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onSelect	onSelectイベント
	 */
	public void setOnSelect( final String onSelect ) {
		add( "onSelect",getRequestParameter( onSelect ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント ondblClick を設定します。
	 *
	 * @og.tag
	 * ondblClick は、マウスでダブルクリックされたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   ondblClick	ondblClickイベント
	 */
	public void setOndblClick( final String ondblClick ) {
		add( "ondblClick",getRequestParameter( ondblClick ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onMouseDown を設定します。
	 *
	 * @og.tag
	 * onMouseDown は、マウスダウンされたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onMouseDown	onMouseDownイベント
	 */
	public void setOnMouseDown( final String onMouseDown ) {
		add( "onMouseDown",getRequestParameter( onMouseDown ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onMouseUp を設定します。
	 *
	 * @og.tag
	 * onMouseUp は、マウスアップされたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onMouseUp	onMouseUpイベント
	 */
	public void setOnMouseUp( final String onMouseUp ) {
		add( "onMouseUp",getRequestParameter( onMouseUp ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onMouseMove を設定します。
	 *
	 * @og.tag
	 * onMouseMove は、マウスが移動されたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onMouseMove	onMouseMoveイベント
	 */
	public void setOnMouseMove( final String onMouseMove ) {
		add( "onMouseMove",getRequestParameter( onMouseMove ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onMouseOut を設定します。
	 *
	 * @og.tag
	 * onMouseOut は、マウスが離れたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onMouseOut	onMouseOutイベント
	 */
	public void setOnMouseOut( final String onMouseOut ) {
		add( "onMouseOut",getRequestParameter( onMouseOut ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onMouseOver を設定します。
	 *
	 * @og.tag
	 * onMouseOver は、マウスが重なったときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onMouseOver	onMouseOverイベント
	 */
	public void setOnMouseOver( final String onMouseOver ) {
		add( "onMouseOver",getRequestParameter( onMouseOver ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onKeydown を設定します。
	 *
	 * @og.tag
	 * onKeydown は、キーが押されたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onKeydown	onKeydownイベント
	 */
	public void setOnKeydown( final String onKeydown ) {
		add( "onKeydown",getRequestParameter( onKeydown ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onKeypress を設定します。
	 *
	 * @og.tag
	 * onKeypress は、キーが押され続けていたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onKeypress	onKeypressイベント
	 */
	public void setOnKeypress( final String onKeypress ) {
		add( "onKeypress",getRequestParameter( onKeypress ),";" );
	}

	/**
	 * 【HTML】JavaScriptのイベント onKeyup を設定します。
	 *
	 * @og.tag
	 * onKeyup は、キーが押された状態から離されたときに発生するイベントです。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param   onKeyup	onKeyupイベント
	 */
	public void setOnKeyup( final String onKeyup ) {
		add( "onKeyup",getRequestParameter( onKeyup ),";" );
	}

	/**
	 * 【HTML5】入力候補を提示して入力内容を自動補完する[on/off]（初期値はon）。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 * オートコンプリートを有効にする場合は、on 、無効にする場合は、off を設定します。
	 * 初期値は、on(有効) です。
	 * 
	 * &lt;datalist&gt; タグを使用して、入力候補となるデータリストを定義できます。 
	 * 各データのリスト項目は、&lt;option&gt;で定義します。 &lt;datalist&gt;をサポートしたブラウザでは、
	 * &lt;option&gt;で指定された値がユーザーに対して入力候補として提案表示されます。 
	 * &lt;input&gt;のlist属性の値と&lt;datalist&gt;のid属性の値を同じにして、入力欄と
	 * データリストを関連付けます。 
	 *
	 * 利用可能type:[text,search,url,tel,email,password,datetime,date,month,week,time,datetime-local,number,range,color]
	 *
	 * <pre>
	 * &lt;og:input type="text" name="yourarea" autocomplete="on" list="tokyo" /&gt;
	 *
	 *  &lt;og:datalist id="tokyo" &gt;
	 *      &lt;og:option value="渋谷" /&gt;
	 *      &lt;og:option value="新宿" /&gt;
	 *      &lt;og:option value="池袋" /&gt;
	 *  &lt;/og:datalist&gt;&lt;
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	autocomplete 自動補完設定 [on/off]（初期値はon）
	 * @see		<a href="http://www.htmq.com/html5/input_autocomplete.shtml">autocomplete</a>
	 */
	public void setAutocomplete( final String autocomplete ) {
		set( "autocomplete" , getRequestParameter( autocomplete ) );
	}

	/**
	 * 【HTML5】指定した入力欄にカーソルが当たって自動的にフォーカスされます。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 * autofocus属性を指定すると、ウェブページが表示された際に、
	 * 指定した入力欄にカーソルが当たって自動的にフォーカスされます。
	 *
	 * autofocus="autofocus" , autofocus="true" が指定された場合は、有効です。
	 * false も指定値としては、有効です。(大文字小文字の区別も不要)
	 * それ以外の指定は、エラーとします。
	 *
	 * 利用可能type:[text,search,url,tel,email,password]
	 *
	 * ※ autofocus は、論理属性です。
	 *
	 * <pre>
	 * &lt;og:input type="text" name="userid" autofocus="autofocus" /&gt;
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	atfocus オートフォーカス
	 * @see		<a href="http://www.htmq.com/html5/input_autofocus.shtml">autofocus</a>
	 */
	public void setAutofocus( final String atfocus ) {
		final String autofocus = nval( getRequestParameter( atfocus ),null );
		if( autofocus != null ) {
			if( "autofocus".equalsIgnoreCase( autofocus ) ||
				"true".equalsIgnoreCase( autofocus ) ) {
					set( "autofocus","autofocus" );
			}
			else if( ! "false".equalsIgnoreCase( autofocus ) ) {
				final String errMsg = "autofocus には、[autofocus,true,false]以外の文字は指定できません。"
								+ " autofocus=[" + autofocus + "]" + CR ;
				throw new HybsSystemException( errMsg );
			}
		}
	}

	/**
	 * 【HTML5】正規表現で入力値のパターンを指定します。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 * 正規表現を使って入力値のパターンを指定することができます。
	 *
	 * 利用可能type:[text,search,url,tel,email,password]
	 *
	 * <pre>
	 * &lt;og:input type="text" name="userid" pattern="^[0-9A-Za-z]+$" /&gt; ※半角英数
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	pattern 入力値正規表現
	 * @see		<a href="http://www.htmq.com/html5/input_pattern.shtml">pattern</a>
	 */
	public void setPattern( final String pattern ) {
		set( "pattern",getRequestParameter( pattern ) );
	}

	/**
	 * 【HTML5】入力欄に初期表示する内容を指定します。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 * placeholder属性で指定した値が、入力欄に初期値として表示されます。
	 * 例えば、テキストフィールドに初期値として、 「検索するキーワードを入力してください」
	 * などのヒントを示してユーザーの操作を補助することができます。 
	 *
	 * 利用可能type:[text,search,url,tel,email,password]
	 *
	 * 6.1.1.0 (2015/01/17)
	 *  ① 1.引数を、{&#064;XXXX} 処理せずに、XXXX でラベルリソースをチェックします。
	 *     2.なければ、全体を、RequestParameter 処理します。
	 *  ② 変換後の文字列から、"￥n" を、"&amp;#13;&amp;#10;" に変換することで、改行に対応します。
	 *     実際は、CR か LF のどちらでも改行するようです。
	 *  ③ title属性が、未設定なら、placeholder の設定キーと同じキーで、title を設定します。
	 *
	 * <pre>
	 * &lt;og:input type="search" name="q" placeholder="キーワードを入力" /&gt;
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 * @og.rev 6.1.1.0 (2015/01/17) 直接、ラベルリソースを表示できるようにする。
	 *
	 * @param	placeholder 初期表示文字
	 * @see		<a href="http://www.htmq.com/html5/input_placeholder.shtml">placeholder</a>
	 */
	public void setPlaceholder( final String placeholder ) {

		if( placeholder != null ) {
			String lbl = getResource().getLabel( placeholder );					// ①1.ラベル
			// 存在しないか、引数と同じ場合(変換できなかった=存在しない)は、再検索
			if( lbl == null || lbl.isEmpty() || lbl.equals( placeholder ) ) {
				lbl = nval( getRequestParameter( placeholder ),null );			// ①2.RequestParameter 処理する
			}

			if( lbl != null ) {
				// "\n" という文字列の正規表現は、"\\n" で本物の改行コードになるので、４つ \ が必要になる。
				lbl = lbl.replaceAll( "\\\\n","&#13;&#10;" );				// ②.改行に対応
				set( "placeholder",lbl );
			}

			// ③ title が設定されていない場合は、設定する。
			// パラメータのアクセス順は不明だが、titleが後なら、上書きされるので、OK。
			if( get( "title" ) == null ) {
				setTitle( placeholder );	// title に placeholder のキーをセットする。
			}
		}
	}

	/**
	 * 【HTML5】ユーザーに入力候補として提案するデータリストの要素のid属性の値を指定します。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 * ユーザーに入力候補として提案するデータリストタグ(&lt;datalist&gt;)のid属性を
	 * この、list 属性に設定することで、関連付けができます。
	 * 
	 * ※
	 * 内部事情で、list属性 に設定するキーも、datalistタグのid属性に設定するキーも、
	 * inputタグ(columnタグ)の name属性＋".sel" を標準的に使用してください。
	 *
	 * 利用可能type:[text,search,url,tel,email,datetime,date,month,week,time,datetime-local,number,range,color]
	 *
	 * <pre>
	 * 		&lt;og:input type="search" name="keywords" autocomplete="on" list="keywords.sel" /&gt;
	 * 		&lt;og:datalist id="keywords.sel"&gt;
	 * 			&lt;og:option value="ウィキペディア" /&gt;
	 * 			&lt;og:option value="ウィルス対策" /&gt;
	 * 			&lt;og:option value="ウィンドウズ" /&gt;
	 * 		&lt;/og:datalist&gt;
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	list データリストID
	 * @see		<a href="http://www.htmq.com/html5/datalist.shtml">list</a>
	 */
	public void setList( final String list ) {
		set( "list",getRequestParameter( list ) );
	}

	/**
	 * 【HTML5】入力欄で入力できる最小値を指定します。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 *  数値型や日付型の入力欄で入力できる最小値を指定することができます。
	 *
	 * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
	 *
	 * <pre>
	 * &lt;og:input type="number" name="ninzu" min="1" max="4" /&gt;　※1人以上4人以下
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	min 入力できる最小値
	 * @see		<a href="http://www.htmq.com/html5/input_min.shtml">min</a>
	 */
	public void setMin( final String min ) {
		set( "min",getRequestParameter( min ) );
	}

	/**
	 * 【HTML5】入力欄で入力できる最大値を指定します。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 *  数値型や日付型の入力欄で入力できる最大値を指定することができます。
	 *
	 * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
	 *
	 * <pre>
	 * &lt;og:input type="number" name="ninzu" min="1" max="4" /&gt;　※1人以上4人以下
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	max 入力できる最大値
	 * @see		<a href="http://www.htmq.com/html5/input_min.shtml">max</a>
	 */
	public void setMax( final String max ) {
		set( "max",getRequestParameter( max ) );
	}

	/**
	 * 【HTML5】入力欄で刻むステップ値を指定します。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 * step属性を指定すると、 数値型や日付型の入力欄で刻むステップ値を指定することができます。
	 *
	 * 利用可能type:[datetime,date,month,week,time,datetime-local,number,range]
	 *
	 * <pre>
	 * &lt;og:input type="number" name="lot" step="0.5" /&gt;　※単位0.5
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	step 入力ステップ値
	 * @see		<a href="http://www.htmq.com/html5/input_step.shtml">step</a>
	 */
	public void setStep( final String step ) {
		set( "step",getRequestParameter( step ) );
	}

	/**
	 * 【HTML5】入力必須を指定します。
	 *
	 * @og.tag
	 * HTML5から追加された新機能です。
	 * 入力項目が入力必須であることをブラウザに知らせることができます。
	 * 単独で、required 属性を使用できるようにしておきます。
	 *
//	 * フレームワークの入力必須は、must 属性ですが、must 属性を指定した場合にも、
//	 * システムリソースの USE_IE7_HEADER = "false" で、USE_HTML5_HEADER = "true" で、
	 * USE_MUST_REQUIRED = "true" の場合は、required 属性を出力します。
	 *
	 * 利用可能type:[text,search,url,tel,email,datetime,date,month,week,time,datetime-local,number,checkbox,radio,file]
	 *
	 * ※ required は、論理属性です。
	 *
	 * <pre>
	 * &lt;og:input type="text" name="yourname" required="required" /&gt;
	 * </pre>
	 *
	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
	 *
	 * @param	req 入力必須かどうか [required/true/false]
	 * @see		<a href="http://www.htmq.com/html5/input_required.shtml">required</a>
	 */
	public void setRequired( final String req ) {
		final String required = nval( getRequestParameter( req ),null );
		if( required != null ) {
			if( "required".equalsIgnoreCase( required ) ||
				"true".equalsIgnoreCase( required ) ) {
					set( "required","required" );
			}
			else if( ! "false".equalsIgnoreCase( required ) ) {
				final String errMsg = "required には、[required/true/false]以外の文字は指定できません。"
								+ " required=[" + required + "]" + CR ;
				throw new HybsSystemException( errMsg );
			}
		}
	}

	/**
	 * 【TAG】ロールをセットします。
	 *
	 * @og.tag
	 * ここで指定したカラムロールを元に、ユーザー毎のアクセス許可がチェックされます。
	 * アクセス許可されないと、表示されません。
	 * このロールを指定しない場合は、カラムリソースのロールが使用されます。
	 *
	 * @og.rev 4.0.0.0 (2005/11/30) 新規追加
	 *
	 * @param	roles ロール
	 */
	public void setRoles( final String roles ) {
		set( "roles",getRequestParameter( roles ) );
	}

	/**
	 * 【TAG】必須入力を表す色に変えるかどうか[true/false]を指定します(初期値:false)。
	 *
	 * @og.tag
	 * 初期値は、必須でない("false") です。
	 * useMustHidden==true(初期値) の場合は、必須の自動チェック用Hiddenを出力するため、
	 * submit することで、必須チェックをかけることができます。
//	 * さらに、システムリソースの USE_HTML5_HEADER が、true に指定されている場合は、
//	 * HTML5 適用として、required 属性も、出力します。
//	 *   ※ 6.1.0.0 (2014/12/26)
//	 *      useMustHidden==true かつ、USE_HTML5_HEADER==true かつ USE_IE7_HEADER==false
//	 *      の場合に、required 属性(HTML5の必須チェック)を出力します。
//	 *      これは、#doEndTag() の中の、#makeTag() の直前でセットしますので、
//	 *      #doEndTag() を継承する場合は、ご注意ください。
	 *
	 * &lt;og:input name="PN" must="true" /&gt;
	 *
	 * @og.rev 5.2.1.0 (2010/10/01) 新規追加
	 * @og.rev 5.7.1.0 (2013/12/06) HTML5 対応(required属性)。
	 * @og.rev 6.1.0.0 (2014/12/26) HTML5のrequired属性は、useMustHidden==true でも制御可能とする。
	 * @og.rev 6.8.1.4 (2017/08/25) mustに、false 指定が出来るようにします。
	 *
	 * @param	flag	必須入力指定 [true:必須入力/false:必須削除/それ以外:何もしない]
	 * @see		#setUseMustHidden( String )
	 */
	public void setMust( final String flag ) {
		mustType = nval( getRequestParameter( flag ),null );
		if( "true".equalsIgnoreCase( mustType ) ) {
			mustType = "must";
			add( "class","must" );

			// 5.7.1.0 (2013/12/06) HTML5 対応(required属性)。
			// 6.1.0.0 (2014/12/26) makeMustHidden( String ) 内で作成します。
		}
		// 6.8.1.4 (2017/08/25) mustに、false 指定が出来るようにします。
		else if( "false".equalsIgnoreCase( mustType ) ) {
			mustType = "false";						// 特殊な指定
		}
	}

	/**
	 * 【TAG】選択必須入力(どれかひとつ必須)を表す色[true/mustAny/その他]を指定します(初期値:無指定)。
	 *
	 * @og.tag
	 * 複数のカラムのうち、どれかひとつを必須とする選択必須入力を示す色を指定します。
	 * true または、mustAny を設定すると、class属性に、mustAny がセットされます。
	 * mustAny は、CSSファイルに初期設定されています。true または、mustAny 以外の値をセット
	 * すると、その値がそのまま、class属性にセットされますので、選択必須のグループ化が
	 * 可能です。
	 * なお、実際の選択必須入力チェックは、ここではなく、columnCheck タグで指定が必要です。
	 * 自動処理は、mustAny="true" 指定の場合のみ有効です。
	 * 初期値は、無指定です。
	 *
	 * @og.rev 5.2.1.0 (2010/10/01) 新規追加
	 *
	 * @param	flag 選択必須入力指定 [true/mustAny/その他]
	 * @see		#setUseMustHidden( String )
	 */
	public void setMustAny( final String flag ) {
		if( mustType == null ) {	// must 属性と同時設定時には、must 属性を優先します。
			mustType = nval( getRequestParameter( flag ),null );
			if( "true".equalsIgnoreCase( mustType ) ) {
				mustType = "mustAny";
			}
			add( "class",mustType );	// mustType == null の場合は、add されません。
		}
	}

	/**
	 * 【TAG】必須の自動チェック用Hiddenを出力するかどうか[true/false]を指定します(初期値:true)。
	 *
	 * @og.tag
	 * query.jsp上でmust/mustAny指定した場合に検索時の必須チェックを自動化するための
	 * hiddenを出力するかどうかを選択します。
	 * 初期値は、出力する("true") です。
	 * 通常は初期値で問題ありませんが、必須の切替をScriptで行う場合等に邪魔になる場合が
	 * あるため出力の切替を出来るようにしておきます。
	 *
	 * @og.rev 5.7.2.0 (2013/01/10) 新規作成
	 *
	 * @param	flag	必須自動チェック [true:使用する/それ以外:使用しない]
	 * @see		#setMust( String )
	 * @see		#setMustAny( String )
	 */
	public void setUseMustHidden( final String flag ) {
		useMustHidden = nval( getRequestParameter( flag ),useMustHidden );
	}

	/**
	 * 【TAG】曖昧検索可能フィールドとして、曖昧検索方法を指定します(初期値:null)。
	 *
	 * @og.tag
	 * 従来は、clazz="aimai" として、点線の入力フィールドのみ作成していましたが、
	 * AimaiPicker をCallするようにして、検索方法を指定できるようにします。
	 * なお、AimaiPickerは、カラムの値に、選択した条件に応じた ％を付与するため、
	 * result.jsp の like には、％を含めない様に記述してください。
	 *
	 * ※ 互換表示の為に、"true" 属性は残しておきます。ピッカー無しで、点線の入力フィールド
	 *    のみ設定します。(clazz="aimai" は、廃止の方向です)
	 *
	 *   ① class="aimai" の設定 (ほぼ、従来と同じ)
	 *   ② AimaiPicker となる、preタグを出力(スペースを含む固定幅文字にするため)
	 *   ③ aimai属性で、前方一致、後方一致、前後曖昧、完全一致 選択が可能
	 *   ④ aimai属性で選択した検索方法を、submit時にvalueに反映し、result.jsp に送信する。
	 *
	 * aimai属性の指定方法を以下に示します。
	 * 　"0" または "V"   :完全一致
	 * 　"1" または "V*"  :前方一致
	 * 　"2" または "*V"  :後方一致
	 * 　"3" または "*V*" :前後曖昧
	 * 　"true"           :従来互換(clazz="aimai")
	 *
	 * Vは、0,1,2,3 以外であれば、何でも構いません。* の位置で判定します。
	 *
	 * @og.rev 6.2.0.0 (2015/02/27) aimai 属性を追加。
	 *
	 * @param   val 曖昧検索指定 [0,V:完全一致/1,V*:前方一致/2,*V:後方一致/3,*V*:前後曖昧]
	 */
	public void setAimai( final String val ) {
		final String tmp = nval( getRequestParameter( val ),null );
		if( tmp != null && !tmp.isEmpty() ) {
			add( "class","aimai" );						// class 設定は先に行う必要がある。

			// 曖昧タイプは、0,1,2,3,null(指定が不明時) に再設定しなおします。
			if( tmp.length() == 1 && "0,1,2,3".indexOf( tmp ) >= 0 ) {
				aimai = Integer.parseInt( tmp );				// 0,1,2,3 を直接指定した場合。
			}
			else if( "true".equalsIgnoreCase( tmp ) ) {
				aimai = -1;										// 従来互換(clazz="aimai") 初期値なので、あえて設定の必要はない。
			}
			else {
				aimai = 0 ;													// * が 0個 ＝ V:完全一致 ＝ 0
				if( tmp.endsWith(   "*" ) ) { aimai  = 1; }					// * が 後ろ＝V*:前方一致 ＝ 1
				if( StringUtil.startsChar( tmp,'*' ) ) { aimai += 2; }		// * が 前  ＝*V:後方一致 ＝ 2
																// 先にV*:前方一致(typeを加算)＝*V*:前後曖昧 ＝ 3
			}
		}
	}

	/**
	 * mustType 属性を取得します。
	 *
	 * must , mustAny 属性を設定する場合に、mustType 属性を設定します。
	 * その設定された値を取り出します。
	 * 何も設定されていない状態では、null を返します。
	 *
	 * @og.rev 5.2.1.0 (2010/10/01) 新規追加。
	 *
	 * @return	mustType属性
	 */
	protected String getMustType() {
		return mustType ;
	}

	/**
	 * must , mustAny 属性を自動化するためのhiddenタグを生成します。
	 *
	 * HybsSystem.MUST_KEY + mustType をキーに、指定のカラム名を値として
	 * hidden を作成します。この値を columnChack タグで拾って must 処理します。
	 * なお、must , mustAny 属性を使用していない場合は、ゼロ文字列 を返します。
	 *
	 * @og.rev 5.2.1.0 (2010/10/01) 新規追加。
	 * @og.rev 5.7.2.0 (2014/01/10) useMustHidden対応
	 * @og.rev 6.2.0.0 (2015/02/27) MustHidden は、同一 name で、カラム名を作成するので、id は、セットしない。
	 * @og.rev 6.8.1.4 (2017/08/25) mustに、false 指定が出来るようにします。
	 *
	 * @param	name	must指定するカラム等の名称
	 *
	 * @return	自動化するためのhiddenタグ
	 * @og.rtnNotNull
	 */
	protected String makeMustHidden( final String name ) {
		// 6.1.1.0 (2015/01/17) refactoring. ロジックの見直し
		return mustType != null && !"false".equalsIgnoreCase( mustType ) && useMustHidden	// 6.8.1.4 (2017/08/25)
					? XHTMLTag.hidden( HybsSystem.MUST_KEY + mustType, name , null )		// 6.2.0.0 (2015/02/27)
					: "" ;
	}

	/**
	 * aimai 属性を自動化するためのAimaiPicker関連タグを生成します。
	 *
	 * AIMAI_xxxのid属性をキーに、指定のカラムのvalue値の％付加を、JavaScriptで行います。
	 * そのための、preタグを出力します。
	 *
	 * @og.rev 6.2.0.0 (2015/02/27) aimai 属性を追加。
	 * @og.rev 6.2.2.0 (2015/03/27) id属性がある場合は、そちらを優先する。
	 *
	 * @param	name	aimai指定するカラム
	 *
	 * @return	自動化するためのpreタグ
	 * @og.rtnNotNull
	 */
	protected String makeAimaiPicker( final String name ) {
		if( aimai >= 0 ) {
			// 6.2.2.0 (2015/03/27) id属性がある場合は、そちらを優先する。
			final String id = get( "id" );
			final String aimaiId = "AIMAI_" + ( id == null || id.isEmpty() ? name : id );

			return new TagBuffer( "pre" )
						.add(	"id"		, aimaiId )						// 6.2.2.0 (2015/03/27)
						.add(	"class"		, "aimaiClm" )
						.add(	"aimaiType"	, String.valueOf( aimai ) )
						.add(	"title"		, AIMAI_TITL[aimai] )
						.addBody( AIMAI_TEXT[aimai] )
						.makeTag();
		}
		return "" ;
	}

//	/**
//	 * HTML5を使用するかどうか(true:使用する/false:使用しない)を取得します。
//	 *
//	 * HTML5 の機能を有効にするには、ネイティブモードで動作させる必要があります。
//	 *   ① USE_IE7_HEADER = "false" に設定する。
//	 *   ② USE_HTML5_HEADER = "true" に設定する。
//	 *   ③ IEのツール⇒互換表示設定で、互換表示に追加したWebサイトから削除する。
//	 *   ④ 同上の設定で、イントラサイトを互換表示で表示するのチェックを外す。
//	 * 必要があります。
//	 * このメソッドで返すのは、①と②の設定ができていれば true、そうでなければ、false を返します。
//	 * 
//	 *	(初期値:USE_IE7_HEADER[={@og.value SystemData#USE_IE7_HEADER}])。
//	 *	(初期値:USE_HTML5_HEADER[={@og.value SystemData#USE_HTML5_HEADER}])。
//	 *
//	 * @og.rev 5.7.1.0 (2013/12/06) 新規追加
//	 * @og.rev 6.4.0.4 (2015/12/26) 他に使ってなさそうなので、protected → private にしておく。
//	 * @og.rev 6.9.5.0 (2018/04/23) USE_IE7_HEADER 廃止(false固定) , USE_HTML5_HEADER 廃止(true固定)
//	 *
//	 * @return	HTML5を使用するかどうか(true:使用する/false:使用しない)
//	 * @see		#setMust( String )
//	 */
//	private boolean isUseHTML5() {
//		// 6.1.1.0 (2015/01/17) refactoring. ロジックの見直し
//		return  ! HybsSystem.sysBool( "USE_IE7_HEADER" )		// ① IE7互換モードが、false
//			   && HybsSystem.sysBool( "USE_HTML5_HEADER" );		// ② HTML5 ヘッダーが true
//	}
}
