クラス TabLinkTag

  • すべての実装されたインタフェース:
    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 TabLinkTag
    extends CommonTagSupport
    タブ形式のリンクを表示するタグです。 このタグ形式の実態は、リンクのリストであるため、実の画面の表示はターゲットを指定して 別フレームで行う必要があります。 タブの指定方法については、listType属性の指定により、クエリ発行(DB)により動的に生成する パターンと、タグ指定(TAG)により、静的に生成するパターンがあります。 listType属性に何も指定されていない場合は、Body部分に記述された内容により、自動判定されます。 ("SELECT"で始まっている場合はDB、それ以外はTAGとして処理) ①listType属性が"DB"の場合 検索された各カラムは、その順番により次の意味を持ちます。 [第1カラム] タブの名前 : リンク時のキー情報、後述のopenTabName属性のキーとしても使用 ※必須 [第2カラム] タブの表示名称 : タブの表示名称 指定がない場合は、第1カラムが表示名称となります。 [第3カラム] タブのリンク先URL : タブのリンク先URL 指定がない場合は、href属性の値が適用されます。 [第4カラム] タブのクラス属性 : 個別のタブに付加されるクラス属性 指定がない場合は、unselClass属性の値が適用されます。 [第5カラム] タブのロールズ : タブのロールズを指定します。ユーザーロールズと一致しない指定した場合は、タブが表示されなくなります。 [第6カラム] タブの選択可否 : タブの選択可否を'true'or'false'で指定します。falseを指定した場合は、タブが表示されなくなります。 (ロールズで選択不可になっている場合は、この値は無視されます) 各カラムの値は[カラム名]=[値]の形で、リンク先のJSPに引数として渡されます。 また、リンク先のJSPについては、href属性で指定します。 ②listType属性が"TAG"の場合 tabListタグを記述し、個別にタブを定義します。 制御可能な項目は、①DBの場合と同等です。 タブの名前を定義するname属性は、tabListタグで必ず定義する必要があります。 lbl属性が指定されていない場合は、name属性のラベル名称を取得します。 タブのリンク先JSP及び、クラス属性については、tabListタグで指定がない場合、tabListタグの値が適用されます。 [共通設定] 初期設定では、第1番目の"有効な"タブが自動的に開かれます。(="true") 各タブの表示方法で、選択不可能なタブが存在している場合は、それらを読み飛ばした上で、"有効な"タブを 検索します。 また、自動で開くタブは、openTabName属性で指定可能であり、これに変数を定義することで、 画面リロード時も、開いていたタブを再度選択された状態で表示することが可能です。 7.4.1.0 (2021/04/23) openTab = false を指定すると、自動でオープンしません。 選択したタブ及び非選択のタブの枠線や、背景色等を変更する場合は、custom.cssでクラスを定義し、 変更して下さい。 タブの表示方向(水平方向 or 垂直方向)については、orientation属性で変更することが可能です。 (初期値は、水平方向) 水平方向にした場合は、listCount属性により強制的に一定数のタブを表示する毎に、改行を挿入することができます。 このタグを使用する場合は、headタグで必ずuseTabLink="true"を指定してJavaScriptをロードして下さい。 各属性は、{@XXXX} 変数が使用できます。 これは、ServletRequest から、XXXX をキーに値を取り出し,この変数に割り当てます。 つまり、このXXXXをキーにリクエストすれば、この変数に値をセットすることができます。
    関連項目:
    直列化された形式
    導入されたバージョン:
    JDK1.4,
    • コンストラクタの詳細

      • TabLinkTag

        public TabLinkTag()
        デフォルトコンストラクター
    • メソッドの詳細

      • doStartTag

        public int doStartTag()
        Taglibの開始タグが見つかったときに処理する doStartTag() を オーバーライドします。
        定義:
        doStartTag インタフェース内 javax.servlet.jsp.tagext.Tag
        オーバーライド:
        doStartTag クラス内 CommonTagSupport
        戻り値:
        後続処理の指示( EVAL_BODY_BUFFERED )
      • doAfterBody

        public int doAfterBody()
        Taglibのタグ本体を処理する doAfterBody() を オーバーライドします。
        定義:
        doAfterBody インタフェース内 javax.servlet.jsp.tagext.IterationTag
        オーバーライド:
        doAfterBody クラス内 CommonTagSupport
        戻り値:
        後続処理の指示(SKIP_BODY)
      • doEndTag

        public int doEndTag()
        Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
        定義:
        doEndTag インタフェース内 javax.servlet.jsp.tagext.Tag
        オーバーライド:
        doEndTag クラス内 CommonTagSupport
        戻り値:
        後続処理の指示
      • release2

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

        protected void addTag​(String hr,
                              String name,
                              String label,
                              String clz,
                              boolean visible,
                              String[] keys,
                              String[] vals)
        子タグであるタブリストタグからタブ情報をセットします。
        パラメータ:
        hr - 画面URL
        name - タブの名前
        label - タブの表示名称
        clz - 非選択状態のタブに付加するclass名
        visible - タブが選択可能 [true:可能/false:不可能]
        keys - リンク先のJSPに渡すキー一覧
        vals - リンク先のJSPに渡す値一覧
      • setListType

        public void setListType​(String tp)
        【TAG】タブの一覧をどこから取得するか[AUTO/DB/TAG]を指定します(初期値:AUTO)。
        パラメータ:
        tp - 取得方法 [AUTO/DB/TAG]
      • setHref

        public void setHref​(String hr)
        【TAG】リンク先のJSPを指定します(初期値:result.jsp)。
        パラメータ:
        hr - リンク先のJSP
      • setTarget

        public void setTarget​(String tgt)
        【TAG】リンクのターゲットを指定します(初期値:RESULT)。
        パラメータ:
        tgt - リンクターゲット
      • setOpenTab

        public void setOpenTab​(String flag)
        【TAG】リンク表示にタブリンクを自動で開くかどうか[true/false]を指定します(初期値:true[=開く])。
        パラメータ:
        flag - 自動タブオープン [true:自動で開く/false:開かない]
      • setOpenTabName

        public void setOpenTabName​(String name)
        【TAG】最初に開くタブリンクの名前を指定します。
        パラメータ:
        name - 初期表示タブ名前
      • setConstKeys

        public void setConstKeys​(String keys)
        【TAG】次画面に渡す定数パラメーターのキーを指定します。
        パラメータ:
        keys - 定数キー (CSV形式)
        関連項目:
        setConstVals( String )
      • setConstVals

        public void setConstVals​(String vals)
        【TAG】次画面に渡す定数パラメーターの値を指定します。
        パラメータ:
        vals - 定数値 (CSV形式)
        関連項目:
        setConstKeys( String )
      • setListCount

        public void setListCount​(String cnt)
        【TAG】1行辺りに表示するタブの数を指定します(初期値:10)。
        パラメータ:
        cnt - 1行タブ数
      • setSelClass

        public void setSelClass​(String cls)
        【TAG】選択タブのクラスを指定します(初期値:selTab)。
        パラメータ:
        cls - 選択タブのクラス名
      • setUnselClass

        public void setUnselClass​(String cls)
        【TAG】非選択タブのクラスを指定します(初期値:unselTab)。
        パラメータ:
        cls - 選択タブのクラス名
      • setOrientation

        public void setOrientation​(String ori)
        【TAG】タブの方向[Horizontal(or H):横型/Vertical(or V):縦型]を指定します(初期値:Horizontal:横型)。
        パラメータ:
        ori - タブの方向 [Horizontal(or H):横型/Vertical(or V):縦型]
      • setWidth

        public void setWidth​(String wh)
        【TAG】タブリンクの幅を % 、px 、または "auto" で指定します(初期値:auto)。
        パラメータ:
        wh - 幅 (% 、px 、または "auto" )
      • setHeight

        public void setHeight​(String ht)
        【TAG】タブの高さを、% 、px 、または "auto" で指定します(初期値:auto)。
        パラメータ:
        ht - 高さ (% 、px 、または "auto" )
      • setOnClick

        public void setOnClick​(String scrpt)
        【HTML】JavaScriptのイベント onClick を設定します(初期値::onClick="changeTab( this, 'selTab' );")。
        パラメータ:
        scrpt - onClickイベント
      • toString

        public String toString()
        このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。
        オーバーライド:
        toString クラス内 CommonTagSupport
        戻り値:
        このクラスの文字列表現