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
- すべての実装されたインタフェース:
- Serializable, BodyTag, IterationTag, JspTag, Tag, 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,
メソッドの概要 |
int |
doAfterBody()
Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。 |
int |
doStartTag()
Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。 |
protected String |
makeTag()
検索条件の入力用のテキストフィールドを作成します。 |
protected void |
release2()
タグリブオブジェクトをリリースします。 |
void |
setAccept(String accept)
【HTML】type が file の場合に、MIMEタイプをCSV形式で複数指定出来ます。 |
void |
setAlt(String alt)
【HTML】type が image の場合で、画像が表示できない場合の代替テキストをセットします。 |
void |
setChecked(String ch)
【HTML】type が checkbox か radio のとき、初めから選択された状態で表示します("checked"のみ指定可)。 |
void |
setColspan(String sp)
【TAG】フィールド部分の colspan を指定します。 |
void |
setIsmap(String ismap)
【HTML】type が image の場合に、サーバーサイド・イメージマップを使用する場合に指定します。 |
void |
setLbls(String lbls)
【TAG】ラベルをCSV形式で複数指定します。 |
void |
setMaxlength(String maxlength)
【HTML】最大入力文字数を指定します(typeがtextまたはpasswordの場合)。 |
void |
setName(String name)
【HTML】名前を指定します。 |
void |
setNextForm(String name)
【TAG】入力カーソルを指定されたname属性のフィールドへ自動的に移動します。 |
void |
setSize(String size)
【HTML】横幅を指定します(typeがtextまたはpasswordの場合は文字数で、それ以外はピクセル)。 |
void |
setSrc(String src)
【HTML】type が image の場合、送信ボタンとして利用する画像のURLをセットします。 |
void |
setTd(String flag)
【TAG】テーブル形式の <td> タグを使用するかどうか(yes/no/false)を指定します(初期値:yes)。 |
void |
setType(String type)
【HTML】表示形式(text/password/checkbox/radio/submit/reset/button/image/file)を指定します(初期値:text)。 |
void |
setUsemap(String usemap)
【HTML】type が image の場合、クライアントサイド・イメージマップのURLを指定します。 |
void |
setValue(String value)
【HTML】このフィールドに設定する値を指定します。 |
String |
toString()
このオブジェクトの文字列表現を返します。 |
クラス org.opengion.hayabusa.taglib.HTMLTagSupport から継承されたメソッド |
doEndTag, setAccesskey, setClazz, setDir, setDisabled, setId, setLang, 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, addEventColumnSQL, 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, getScope, getSessionAttribute, getTagName, getUser, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setMsglbl, setNoTransitionRequest, setObject, setParameterRows, setRequestAttribute, setRequestCacheData, setScope, setSessionAttribute, setUserInfo, setUseValue, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useXssCheck |
InputTag
public InputTag()
doStartTag
public int doStartTag()
- Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
- 定義:
- インタフェース
Tag
内の doStartTag
- オーバーライド:
- クラス
CommonTagSupport
内の doStartTag
- 戻り値:
- int
- 変更履歴:
4.0.0 (2007/05/30) 新規追加(BODY部の評価) |
doAfterBody
public int doAfterBody()
- Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
- 定義:
- インタフェース
IterationTag
内の doAfterBody
- オーバーライド:
- クラス
CommonTagSupport
内の doAfterBody
- 戻り値:
- int
- 変更履歴:
4.0.0 (2007/05/30) 新規追加(BODY部の評価) |
release2
protected void release2()
- タグリブオブジェクトをリリースします。
キャッシュされて再利用されるので、フィールドの初期設定を行います。
- オーバーライド:
- クラス
CommonTagSupport
内の 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 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化 |
setName
public void setName(String name)
- 【HTML】名前を指定します。
- パラメータ:
name
- String- TagLib:
setType
public void setType(String type)
- 【HTML】表示形式(text/password/checkbox/radio/submit/reset/button/image/file)を指定します(初期値:text)。
- パラメータ:
type
- String- TagLib:
<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(String value)
- 【HTML】このフィールドに設定する値を指定します。
- パラメータ:
value
- 初期値- TagLib:
type属性の値が"radio"か"checkbox"以外の場合、この属性は省略可能です。
<og:input name="PN" value="syokichi" /> |
setSize
public void setSize(String size)
- 【HTML】横幅を指定します(typeがtextまたはpasswordの場合は文字数で、それ以外はピクセル)。
- パラメータ:
size
- String- TagLib:
<og:input name="PN" size="20" /> |
setMaxlength
public void setMaxlength(String maxlength)
- 【HTML】最大入力文字数を指定します(typeがtextまたはpasswordの場合)。
- パラメータ:
maxlength
- String- TagLib:
最大文字数は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(String ch)
- 【HTML】type が checkbox か radio のとき、初めから選択された状態で表示します("checked"のみ指定可)。
- パラメータ:
ch
- "checked" 文字列を指定- TagLib:
<og:input name="PN" type="checkbox" checked="checked" /> |
setSrc
public void setSrc(String src)
- 【HTML】type が image の場合、送信ボタンとして利用する画像のURLをセットします。
- パラメータ:
src
- String- TagLib:
setAlt
public void setAlt(String alt)
- 【HTML】type が image の場合で、画像が表示できない場合の代替テキストをセットします。
- パラメータ:
alt
- String- TagLib:
setAccept
public void setAccept(String accept)
- 【HTML】type が file の場合に、MIMEタイプをCSV形式で複数指定出来ます。
- パラメータ:
accept
- String- TagLib:
setUsemap
public void setUsemap(String usemap)
- 【HTML】type が image の場合、クライアントサイド・イメージマップのURLを指定します。
- パラメータ:
usemap
- String- TagLib:
setIsmap
public void setIsmap(String ismap)
- 【HTML】type が image の場合に、サーバーサイド・イメージマップを使用する場合に指定します。
- パラメータ:
ismap
- String- TagLib:
setTd
public void setTd(String flag)
- 【TAG】テーブル形式の <td> タグを使用するかどうか(yes/no/false)を指定します(初期値:yes)。
- パラメータ:
flag
- yes:<td> タグを使用 / no:ラベルとフィールド / false:フィールドのみ- TagLib:
通常(初期値: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(String lbls)
- 【TAG】ラベルをCSV形式で複数指定します。
- パラメータ:
lbls
- 複数ラベルID(カンマ区切り)- TagLib:
シングルラベルの 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) 先に配列に分解してからリクエスト変数の値を取得 |
setColspan
public void setColspan(String sp)
- 【TAG】フィールド部分の colspan を指定します。
- パラメータ:
sp
- フィールド部分の colspan- TagLib:
通常は、ラベルとフィールドが、別のtdで囲われます。しかし、場合によっては、
フィールド部の長いカラムがある場合、上下のカラムとの位置関係がおかしくなり、
ラベルとフィールドが離れて表示されるケースがあります。
この場合、長いフィールド部を持つカラムに、colspan 属性を指定すると、
その分のカラムを割り当てることにより、上下のカラムとの位置関係を
調節することが可能になります。
通常は、3 を指定して、フィールド、ラベル、フィールドの
組み合わせ部分に、長いフィールドが適用されるように使用します。
<og:input name="PN" colspan="3" /> |
- 変更履歴:
3.0.1.4 (2003/03/17) colspan 属性を追加。 |
setNextForm
public void setNextForm(String name)
- 【TAG】入力カーソルを指定されたname属性のフィールドへ自動的に移動します。
- パラメータ:
name
- String- TagLib:
JavaScript の onKeyup イベントを利用して、最大桁数まで入力すると、
次のフィールドに、自動的に飛ぶように設定します。
引数は、次に飛ばすフィールドの name 属性です。
実行するには、JavaScript の nextForm ファンクションが必要です。(default.js で指定) |
- 変更履歴:
3.5.4.2 (2003/12/15) 新規追加 |
toString
public String toString()
- このオブジェクトの文字列表現を返します。
基本的にデバッグ目的に使用します。
- オーバーライド:
- クラス
CommonTagSupport
内の toString
- 戻り値:
- このクラスの文字列表現
Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.