openGionopenGion
5.3.4.0

org.opengion.hayabusa.taglib
クラス InputTag

java.lang.Object
  上位を拡張 javax.servlet.jsp.tagext.TagSupport
      上位を拡張 javax.servlet.jsp.tagext.BodyTagSupport
          上位を拡張 org.opengion.hayabusa.taglib.CommonTagSupport
              上位を拡張 org.opengion.hayabusa.taglib.HTMLTagSupport
                  上位を拡張 org.opengion.hayabusa.taglib.InputTag
すべての実装されたインタフェース:
java.io.Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag, javax.servlet.jsp.tagext.TryCatchFinally

public class InputTag
extends HTMLTagSupport

入力フィールドやボタンなどを作成するHTML拡張タグです。 簡易的な入力用タグとして、columnタグがありますので、通常は、columnタグをお使い下さい。 name 属性に ラベルリソース のキーを与えることで、ロケールにあわせたリソースを 使用して、画面に表示します。 ロケールは、session 登録項目の HybsSystem#LANG_KEY を初期値で使用し、 language 属性で定義されている場合は、そちらを優先します。

関連項目:
直列化された形式
形式サンプル:
 ●形式:<og:input name=… value=… />
 ●body:あり

 ●使用例
    <og:input name="OYA" />                             lbl属性が指定されていない場合は、name属性をキーにしてLabelResourceを読み取ります。
    <og:input name="PN" lbl="KO" />                     lbl属性を指定することで、ラベルだけを付替えることができます。
    <og:input name="PN" size="13" maxlength="11" />     強制的にサイズの変更をするときは、size属性、maxlength属性を使用できます。
    <og:input name="OYA" td="false" />                  自動作成されるtdタグやラベルを外すときはtd属性を使います。
    <og:input name="OYA" td="no" />                     自動作成されるtdタグを外し、ラベルとフィールドは残します。
    <og:input name="PN" optionAttributes="onBlur='blr()'
                            onFocus='fcs()'" />
                                                               JavaScriptのイベントをコーディングするときは、optionAttributes属性を使います。
    <og:input type="radio" name="OYA" />                ラベル部分と入力フィールド部分がテーブルタグの<td>により左右に分割されます。

    <table>
        <tr><og:input name="PN" value="{@PN}" /></tr>
        <tr><og:input name="CD" value="{@CD}" /></tr>
    </table>

    <table>
        <tr><og:input name="PN" value="{@PN}" >部品入力フィールド</og:input></tr>
        <tr><og:input name="CD" value="{@CD}" >コードフィールド</og:input></tr>
    </table>
                                                               HTML 表示時は、前後に<tr>タグで囲って,整形できます。

    <og:input name="A"  nextForm="B" />                最大桁数入力後、フォーム B にフォーカスが移動します。
    <og:input name="B" />

    BODY 部分に記述した値は、入力フィールドの直後にセットされます。
    <og:input name="PN" >
      <button type="button" onclick="popup(・・・);return false;">
          <og:message lbl="POPUP" comment="▼" />
      </button>
    </og:input>
機能階層
画面部品
バージョン
4.0
作成者
Kazuhiko Hasegawa
導入されたバージョン:
JDK5.0,

フィールドの概要
 
クラス javax.servlet.jsp.tagext.BodyTagSupport から継承されたフィールド
bodyContent
 
クラス javax.servlet.jsp.tagext.TagSupport から継承されたフィールド
id, pageContext
 
インタフェース javax.servlet.jsp.tagext.BodyTag から継承されたフィールド
EVAL_BODY_BUFFERED, EVAL_BODY_TAG
 
インタフェース javax.servlet.jsp.tagext.IterationTag から継承されたフィールド
EVAL_BODY_AGAIN
 
インタフェース javax.servlet.jsp.tagext.Tag から継承されたフィールド
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
コンストラクタの概要
InputTag()
           
 
メソッドの概要
 int doAfterBody()
          Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
 int doStartTag()
          Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
protected  java.lang.String makeTag()
          検索条件の入力用のテキストフィールドを作成します。
protected  void release2()
          タグリブオブジェクトをリリースします。
 void setAccept(java.lang.String accept)
          【HTML】type が file の場合に、MIMEタイプをCSV形式で複数指定出来ます。
 void setAlt(java.lang.String alt)
          【HTML】type が image の場合で、画像が表示できない場合の代替テキストをセットします。
 void setChecked(java.lang.String ch)
          【HTML】type が checkbox か radio のとき、初めから選択された状態で表示します("checked"のみ指定可)。
 void setColspan(java.lang.String sp)
          【TAG】フィールド部分の colspan を指定します。
 void setIsmap(java.lang.String ismap)
          【HTML】type が image の場合に、サーバーサイド・イメージマップを使用する場合に指定します。
 void setLbls(java.lang.String lbls)
          【TAG】ラベルをCSV形式で複数指定します。
 void setMaxlength(java.lang.String maxlength)
          【HTML】最大入力文字数を指定します(typeがtextまたはpasswordの場合)。
 void setName(java.lang.String name)
          【HTML】名前を指定します。
 void setNextForm(java.lang.String name)
          【TAG】入力カーソルを指定されたname属性のフィールドへ自動的に移動します。
 void setSize(java.lang.String size)
          【HTML】横幅を指定します(typeがtextまたはpasswordの場合は文字数で、それ以外はピクセル)。
 void setSrc(java.lang.String src)
          【HTML】type が image の場合、送信ボタンとして利用する画像のURLをセットします。
 void setTd(java.lang.String flag)
          【TAG】テーブル形式の <td> タグを使用するかどうか(yes/no/false)を指定します(初期値:yes)。
 void setType(java.lang.String type)
          【HTML】表示形式(text/password/checkbox/radio/submit/reset/button/image/file)を指定します(初期値:text)。
 void setUsemap(java.lang.String usemap)
          【HTML】type が image の場合、クライアントサイド・イメージマップのURLを指定します。
 void setValue(java.lang.String value)
          【HTML】このフィールドに設定する値を指定します。
 java.lang.String toString()
          このオブジェクトの文字列表現を返します。
 
クラス org.opengion.hayabusa.taglib.HTMLTagSupport から継承されたメソッド
doEndTag, getMustType, makeMustHidden, setAccesskey, setClazz, setDir, setDisabled, setId, setLang, setMust, setMustAny, setOnBlur, setOnChange, setOnClick, setOndblClick, setOnFocus, setOnKeydown, setOnKeypress, setOnKeyup, setOnMouseDown, setOnMouseMove, setOnMouseOut, setOnMouseOver, setOnMouseUp, setOnSelect, setOptionAttributes, setReadonly, setRoles, setStyle, setTabindex, setTitle
 
クラス org.opengion.hayabusa.taglib.CommonTagSupport から継承されたメソッド
add, add, addEventColumn, addEventColumn, check, check, commitTableObject, debugPrint, doCatch, doFinally, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getLabel, getLabelInterface, getLanguage, getLongLabel, getMsglbl, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getTagName, getUser, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseKey, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheck
 
クラス javax.servlet.jsp.tagext.BodyTagSupport から継承されたメソッド
doInitBody, getBodyContent, getPreviousOut, release, setBodyContent
 
クラス javax.servlet.jsp.tagext.TagSupport から継承されたメソッド
findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setPageContext, setParent, setValue
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
インタフェース javax.servlet.jsp.tagext.Tag から継承されたメソッド
getParent, setPageContext, setParent
 

コンストラクタの詳細

InputTag

public InputTag()
メソッドの詳細

doStartTag

public int doStartTag()
Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。

定義:
インタフェース javax.servlet.jsp.tagext.Tag 内の doStartTag
オーバーライド:
クラス CommonTagSupport 内の doStartTag
戻り値:
int 後続処理の指示( EVAL_BODY_BUFFERED )
変更履歴:
4.0.0 (2007/05/30) 新規追加(BODY部の評価)
5.2.2.0 (2010/11/01) caseKey 、caseVal 属性対応

doAfterBody

public int doAfterBody()
Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。

定義:
インタフェース javax.servlet.jsp.tagext.IterationTag 内の doAfterBody
オーバーライド:
クラス CommonTagSupport 内の doAfterBody
戻り値:
int 後続処理の指示(SKIP_BODY)
変更履歴:
4.0.0 (2007/05/30) 新規追加(BODY部の評価)

release2

protected void release2()
タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。

オーバーライド:
クラス HTMLTagSupport 内の release2
変更履歴:
2.0.0.4 (2002/09/27) カスタムタグの release() メソッドを、追加
2.0.0.8 (2002/10/09) yes/no/false で指定するように変更
3.0.1.4 (2003/03/17) colspan 属性を追加。
3.1.1.2 (2003/04/04) Tomcat4.1 対応。release2() を doEndTag()で呼ぶ。
3.5.4.2 (2003/12/15) nextForm 属性を追加。

makeTag

protected java.lang.String makeTag()
検索条件の入力用のテキストフィールドを作成します。 テーブルタグによりフィールドは分割されます。 使用時は、テーブルタグを前後に使用して下さい。

定義:
クラス HTMLTagSupport 内の makeTag
戻り値:
入力用のテキストフィールドタグ
変更履歴:
2.0.0.8 (2002/10/09) yes/no/false で指定するように変更
2.0.1.0 (2002/10/10) ラベルとフィールドのセパレーターとして、コロン(:)を使用するかどうかを指定できる
3.0.1.2 (2003/03/07) forward.jsp の代替用 CommonForwardTag を新規作成
3.1.0.1 (2003/03/26) キャッシュエントリーは、type="submit" の場合のみ、登録する。
3.1.1.0 (2003/03/28) forward.jsp 関係の処理を削除する。
3.1.1.0 (2003/03/28) radio ボタン等で、ラベルをクリックしても値をセットできるようにする。
3.5.4.2 (2003/12/15) 入力カーソルを自動的に次のフィールドへ移動する機能を追加する。
4.0.0 (2007/05/30) BODY 部分に記述した値は、入力フィールドの直後にセットされます。
4.3.7.1 (2009/06/08) id=labelのclass化
5.2.1.0 (2010/10/01) must , mustAny 属性を自動化します。

setName

public void setName(java.lang.String name)
【HTML】名前を指定します。

パラメータ:
name - String
説明:
 <og:input name="PN" />

setType

public void setType(java.lang.String type)
【HTML】表示形式(text/password/checkbox/radio/submit/reset/button/image/file)を指定します(初期値:text)。

パラメータ:
type - String
説明:
 <og:input type="text"     /> テキストボックスを表示
 <og:input type="password" /> パスワード専用テキストボックスを表示
 <og:input type="checkbox" /> チェックボックスを表示
 <og:input type="radio"    /> ラジオボタンを表示
 <og:input type="submit"   /> 送信実行ボタンを表示
 <og:input type="reset"    /> 入力したフィールド内容を全てリセット
 <og:input type="button"   /> ボタンを表示
 <og:input type="image"    /> イメージを表示してクリックした座標を返す
 <og:input type="file"     /> ファイル名入力ボックスを表示
 <og:input type="hidden"   /> 表示させずにサーバーに送信するデータ

setValue

public void setValue(java.lang.String value)
【HTML】このフィールドに設定する値を指定します。

パラメータ:
value - 初期値
説明:
 type属性の値が"radio"か"checkbox"以外の場合、この属性は省略可能です。
<og:input name="PN" value="syokichi" />

setSize

public void setSize(java.lang.String size)
【HTML】横幅を指定します(typeがtextまたはpasswordの場合は文字数で、それ以外はピクセル)。

パラメータ:
size - String
説明:
 <og:input name="PN" size="20" />

setMaxlength

public void setMaxlength(java.lang.String maxlength)
【HTML】最大入力文字数を指定します(typeがtextまたはpasswordの場合)。

パラメータ:
maxlength - String
説明:
 最大文字数はsize指定を超え得るが、超えた場合ユーザエージェントはスクロール機構を提供する必要があります。
この属性の初期値は「無制限」です。
<og:input name="PN" maxlength="20" />
変更履歴:
3.5.4.2 (2003/12/15) 最大入力制限数に応じたサイズ自動生成を入れます。
3.5.4.5 (2004/01/23) CSSで処理する場合のクラス属性は、maxlength が 5 以下の場合とする。
4.0.0 (2005/01/31) getFieldSize メソッドを XHTMLTag から DBColumn へ移動

setChecked

public void setChecked(java.lang.String ch)
【HTML】type が checkbox か radio のとき、初めから選択された状態で表示します("checked"のみ指定可)。

パラメータ:
ch - "checked" 文字列を指定
説明:
 <og:input name="PN" type="checkbox" checked="checked" />

setSrc

public void setSrc(java.lang.String src)
【HTML】type が image の場合、送信ボタンとして利用する画像のURLをセットします。

パラメータ:
src - String
説明:
 src セット

setAlt

public void setAlt(java.lang.String alt)
【HTML】type が image の場合で、画像が表示できない場合の代替テキストをセットします。

パラメータ:
alt - String
説明:
 alt セット

setAccept

public void setAccept(java.lang.String accept)
【HTML】type が file の場合に、MIMEタイプをCSV形式で複数指定出来ます。

パラメータ:
accept - String
説明:
 accept セット

setUsemap

public void setUsemap(java.lang.String usemap)
【HTML】type が image の場合、クライアントサイド・イメージマップのURLを指定します。

パラメータ:
usemap - String
説明:
 usemap セット

setIsmap

public void setIsmap(java.lang.String ismap)
【HTML】type が image の場合に、サーバーサイド・イメージマップを使用する場合に指定します。

パラメータ:
ismap - String
説明:
 ismap セット

setTd

public void setTd(java.lang.String flag)
【TAG】テーブル形式の <td> タグを使用するかどうか(yes/no/false)を指定します(初期値:yes)。

パラメータ:
flag - yes:<td> タグを使用 / no:ラベルとフィールド / false:フィールドのみ
説明:
 通常(初期値:yes)は、テーブル形式の<td> タグを使用して、ラベルとフィールドを整列させます。
 no の場合は、tdタグを使用せず、ラベルとフィールドを連続して出力します。
 false は、ラベルを出力せず、フィールドのみ出力します。
  <og:input name="PN" td="false" />
変更履歴:
2.0.0.8 (2002/10/09) yes/no/false で指定するように変更

setLbls

public void setLbls(java.lang.String lbls)
【TAG】ラベルをCSV形式で複数指定します。

パラメータ:
lbls - 複数ラベルID(カンマ区切り)
説明:
 シングルラベルの lbl 属性との違いは,ここではラベルを複数 カンマ区切りで
 渡すことが可能であることです。これにより、"A,B,C" という値に対して、
 "Aのラベル表示,Bのラベル表示,Cのラベル表示" という具合に文字列を
 再合成します。
 これは、SQL文のOrder By 句で、ソート順を指定する場合などに便利です。

  <og:orderBy columns="MKNMJP,MKCD,MKNMEN" lbls="MKNMJP,MKCD,MKNMEN" />
変更履歴:
3.5.6.2 (2004/07/05) 先に配列に分解してからリクエスト変数の値を取得
5.2.2.0 (2010/11/01) setMsglbl 廃止 ⇒ setLbl に置換え

setColspan

public void setColspan(java.lang.String sp)
【TAG】フィールド部分の colspan を指定します。

パラメータ:
sp - フィールド部分の colspan
説明:
 通常は、ラベルとフィールドが、別のtdで囲われます。しかし、場合によっては、
 フィールド部の長いカラムがある場合、上下のカラムとの位置関係がおかしくなり、
 ラベルとフィールドが離れて表示されるケースがあります。
 この場合、長いフィールド部を持つカラムに、colspan 属性を指定すると、
 その分のカラムを割り当てることにより、上下のカラムとの位置関係を
 調節することが可能になります。
 通常は、3 を指定して、フィールド、ラベル、フィールドの
 組み合わせ部分に、長いフィールドが適用されるように使用します。

  <og:input name="PN" colspan="3" />
変更履歴:
3.0.1.4 (2003/03/17) colspan 属性を追加。

setNextForm

public void setNextForm(java.lang.String name)
【TAG】入力カーソルを指定されたname属性のフィールドへ自動的に移動します。

パラメータ:
name - String
説明:
 JavaScript の onKeyup イベントを利用して、最大桁数まで入力すると、
 次のフィールドに、自動的に飛ぶように設定します。
 引数は、次に飛ばすフィールドの name 属性です。
 実行するには、JavaScript の nextForm ファンクションが必要です。(default.js で指定)
変更履歴:
3.5.4.2 (2003/12/15) 新規追加

toString

public java.lang.String toString()
このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。

オーバーライド:
クラス CommonTagSupport 内の toString
戻り値:
このクラスの文字列表現

openGion 5.3.4.0

Webアプリケーションフレームワーク openGion
SourceForge.JPCopyright (c) 2009 The openGion Project.