クラス JsChartDataTag

  • すべての実装されたインタフェース:
    java.io.Serializable, BodyTag, IterationTag, JspTag, Tag, TryCatchFinally

    public class JsChartDataTag
    extends CommonTagSupport
    設定された値をJsChartDataに設定し、 JsChartTagのJsChartDataリストに追加するタグです。
    関連項目:
    直列化された形式
    機能分類
    画面表示
    形式サンプル:
    ●形式:<og:jsChartData chartColumn="…" … /> ●body:なし ●Tag定義: <og:jsChartData =================== data:datasets: の 要素の属性です。 chartColumn ○【TAG】チャートのカラム名を指定します(必須)。 label 【TAG】凡例の値を指定します。 type 【TAG】複合チャートの種類を指定します[line/bar] // 7.0.1.1 (2018/10/22) fill 【TAG】線下を塗りつぶすかどうか[true/false]を指定します(初期値:false)。 tension 【TAG】線の伸張を指定します。0で直線になります(初期値:0.4)。 backgroundColor 【TAG】データの背景色を指定します(色,色番号,VIVID,PASTEL,V0~,P0~)。 borderColor 【TAG】線の色を指定します(色,色番号,VIVID,PASTEL,V0~,P0~)。 X colorNo 【廃止】線の色(borderColor)をColorMapの色番号で指定します。 borderWidth 【TAG】線の幅を指定します。 borderDash 【TAG】点線のスタイルを配列で指定します。 pointStyle 【TAG】点のスタイル(circle,triangle,rect,rectRot,cross,crossRot,star,line,dash)を指定します。 // 6.8.5.0 (2018/01/09) pointRadius 【TAG】点の大きさを指定します。 // 6.8.5.0 (2018/01/09) showLine 【TAG】ラインを表示するかどうか[true/false]を指定します(初期値:null)。 // 6.8.5.0 (2018/01/09) spanGaps 【TAG】spanGaps属性を行うかどうか[true/false]を指定します(初期値:null)。 // 7.0.1.2 (2018/11/04) pointBGColor 【TAG】pointBackgroundColor属性を指定します(色,色番号,VIVID,PASTEL,V0~,P0~)。 // 7.0.1.2 (2018/11/04) =================== options:scales:yAxes の 要素の属性です。 useAxis 【TAG】y軸表示を行うかどうか[true/false]を指定します(初期値:null)。 // 7.0.1.1 (2018/10/22) id 【TAG】y軸のid(自動採番 'y'+連番) // 7.0.1.1 (2018/10/22) position 【TAG】y軸の表示位置[left,right]を指定します(初期値:null)。 // 7.0.1.1 (2018/10/22) scaleType 【TAG】y軸のスケールタイプ[linear/category/realtime]を指定します(初期値:linear) // 7.0.1.1 (2018/10/22) categoryList 【TAG】y軸のメモリリストをCSV形式で指定します(scaleTypeがcategoryの場合に有効) // 7.0.1.1 (2018/10/22) ylabel 【TAG】scaleLabel:y軸に表示するラベル文字 // 7.0.1.1 (2018/10/22) beginAtZero 【TAG】ticks:y軸を0から書き始まるかどうか[true/false]を指定(初期値:true)(円形の場合もこの値) // 7.0.1.1 (2018/10/22) fontColor 【TAG】ticks:y軸のフォントの色(色,色番号,VIVID,PASTEL,V0~,P0~) // 7.0.1.1 (2018/10/22) scaleCallback 【TAG】ticks:y軸コールバックを指定します。 // 7.0.1.1 (2018/10/22) max 【TAG】ticks:y軸の最大値を指定します(scaleTypeがlinearの場合に有効) // 7.0.1.1 (2018/10/22) min 【TAG】ticks:y軸の最小値を指定します(scaleTypeがlinearの場合に有効) // 7.0.1.1 (2018/10/22) stepSize 【TAG】ticks:y軸のメモリ幅を指定します(scaleTypeがlinearの場合に有効) // 7.0.1.1 (2018/10/22) ticks 【TAG】ticks属性(他のticks属性とは、同時に使用できません) // 7.0.1.1 (2018/10/22) gridColor 【TAG】gridLines:color属性( gridLines:{ color:'red', } を生成) // 7.0.1.1 (2018/10/22) gridLines 【TAG】gridLines属性(gridColorは、同時に使用できません) // 7.0.1.1 (2018/10/22) =================== optDataset 【TAG】その他data:datasetのオプションを指定します。 // 7.0.1.2 (2018/11/04) optAxis 【TAG】その他options:scales:yAxesのオプションを指定します。 // 7.0.1.2 (2018/11/04) optTicks 【TAG】その他options:scales:yAxes:ticksのオプションを指定します。 // 7.0.1.2 (2018/11/04) optScaleLabel 【TAG】その他options:scales:yAxes:scaleLabelのオプションを指定します。 // 7.0.1.2 (2018/11/04) optGridLines 【TAG】その他options:scales:yAxes:gridLinesのオプションを指定します。 // 7.0.1.2 (2018/11/04) =================== caseKey 【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) caseVal 【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) caseNN 【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) caseNull 【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) caseIf 【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない) debug 【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false) // 7.0.1.1 (2018/10/22) /> ●使用例 <og:jsChart...> <og:jsChartData chartColumn ="CLM1" label ="ラベル" fill ="true" tension ="0" borderColor ="rbga(150,150,150,0.7)" borderWidth ="2" /> </og:jsChart>
    変更履歴:
    5.9.17.2 (2017/02/08) 新規作成, 7.0.1.1 (2018/10/22) 大幅見直し
    バージョン
    5.9.17.2 2017/02/08
    作成者
    T.OTA
    導入されたバージョン:
    JDK7.0
    • コンストラクタの詳細

      • JsChartDataTag

        public JsChartDataTag()
        デフォルトコンストラクター
        変更履歴:
        6.9.7.0 (2018/05/14) PMD Each class should declare at least one constructor
    • メソッドの詳細

      • doEndTag

        public int doEndTag()
        Taglibの終了タグが見つかった時に処理する doEndTag() を オーバーライドします。
        定義:
        doEndTag インタフェース内 Tag
        オーバーライド:
        doEndTag クラス内 CommonTagSupport
        戻り値:
        後続処理の指示
        変更履歴:
        6.7.6.0 (2017/03/17) タグの使用を決める共通属性の追加, 6.7.7.0 (2017/03/31) backgroundColor が未設定の場合は、borderColor を使用します。, 6.8.5.0 (2018/01/09) pointStyle , pointRadius , showLine 属性の追加。, 7.0.1.1 (2018/10/22) rightAxis 属性の追加。
      • release2

        protected void release2()
        タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。
        オーバーライド:
        release2 クラス内 CommonTagSupport
        変更履歴:
        6.7.7.0 (2017/03/31) jsDataのローカル変数化。, 6.8.5.0 (2018/01/09) pointStyle , pointRadius , showLine 属性の追加。, 7.0.1.1 (2018/10/22) rightAxis 属性の追加。, 7.0.1.1 (2018/10/22) 初期値は、デフォルト(出力しない)に変更。
      • setChartColumn

        public void setChartColumn​(java.lang.String clm)
        【TAG】チャートのカラム名を指定します(必須)。
        パラメータ:
        clm - チャートのカラム名
        説明:
      • setLabel

        public void setLabel​(java.lang.String lbl)
        【TAG】凡例の値を指定します。
        パラメータ:
        lbl - 凡例
        説明:
      • setType

        public void setType​(java.lang.String type)
        【TAG】複合チャートの種類を指定します[line/bar]。 通常は、JsChartTagタグのchartTypeで指定しますが、複合グラフの場合は、個々のJsChartDataTag でタイプを指定します。 なお、複合グラフ時には、JsChartTagタグのchartTypeを、"bar" にしておかないと、きちんと表示しないようです。
        パラメータ:
        type - 種類 [line/bar]
        説明:
      • setFill

        public void setFill​(java.lang.String fill)
        【TAG】線下を塗りつぶすかどうか[true/false]を指定します(初期値:false)。
        パラメータ:
        fill - 塗りつぶすかどうか [true/false]
        説明:
        フィル(線より下の塗りつぶし) を設定します。
      • setTension

        public void setTension​(java.lang.String tension)
        【TAG】線の伸張を指定します。0で直線になります(初期値:0.4)。
        パラメータ:
        tension - 線の伸張
        説明:
        伸張 を設定します。
        変更履歴:
        7.0.1.1 (2018/10/22) 初期値は、デフォルト(出力しない)に変更。
      • setBackgroundColor

        public void setBackgroundColor​(java.lang.String bgColor)
        【TAG】データの背景色を指定します。
        パラメータ:
        bgColor - 背景色
        関連項目:
        setBorderColor(String)
        説明:
        backgroundColor = "BLUE" とすると、すべての背景色を指定できます。 配列で指定すると、データの順番に適用されます。 例:backgroundColor = "['#ffaaaa','#ffffaa','#aaffaa','#aaaaff','#aaaaff']" 特殊キーワードとして、PASTELとVIVID を指定することで、パステルカラーやビビッドカラーの色コードを指定できます。 背景色を指定しない場合、線の色(borderColor)を使用します。
        変更履歴:
        6.9.9.2 (2018/09/18) パステルカラーの色文字列のCSV形式文字列
      • setBorderColor

        public void setBorderColor​(java.lang.String color)
        【TAG】線の色を指定します。
        パラメータ:
        color - 線の色 // * @see #setColorNo(String)
        説明:
        borderColor = "BLUE" とすると、すべての線の色を指定できます。 配列で指定すると、データの順番に適用されます。 例:borderColor = "['#ffaaaa','#ffffaa','#aaffaa','#aaaaff','#aaaaff']" 色の代わりに、ColorMapの色番号を指定したい場合は、colorNo を指定します。 両方指定した場合は、borderColor が優先されます。 どちらも指定しない場合は、JsChartTagに登録した順番に色コードで指定されます。 特殊キーワードとして、PASTELとVIVID を指定することで、パステルカラーやビビッドカラーの 色コード配列を指定できます。
      • setBorderWidth

        public void setBorderWidth​(java.lang.String width)
        【TAG】線の幅を指定します。
        パラメータ:
        width - 線の幅
        説明:
      • setBorderDash

        public void setBorderDash​(java.lang.String dash)
        【TAG】点線のスタイルを配列で指定します。 ダッシュ線のスタイルは、配列で指定します。 borderDash="[5,2]" とすれば、線の長さが5px , 線と線の間が2px になります。
        パラメータ:
        dash - 点線のスタイル
        説明:
        変更履歴:
        7.0.1.3 (2018/11/12) 点線のスタイル追加
      • setPointStyle

        public void setPointStyle​(java.lang.String ptStyle)
        【TAG】点のスタイル[circle,triangle,rect,rectRot,cross,crossRot,star,line,dash]を指定します。
        パラメータ:
        ptStyle - 点のスタイル [circle,triangle,rect,rectRot,cross,crossRot,star,line,dash]
        説明:
        jsChartTag で、usePointStyle = "true" をセットした場合に有効になります。 点のスタイルは、circle,triangle,rect,rectRot,cross,crossRot,star,line,dash が、
        変更履歴:
        6.8.5.0 (2018/01/09) 新規登録
      • setPointRadius

        public void setPointRadius​(java.lang.String ptRadius)
        【TAG】点の大きさを指定します。
        パラメータ:
        ptRadius - 点の大きさを指定します。
        説明:
        jsChartTag で、usePointStyle = "true" をセットした場合に有効になります。
        変更履歴:
        6.8.5.0 (2018/01/09) 新規登録
      • setShowLine

        public void setShowLine​(java.lang.String show)
        【TAG】ラインを表示するかどうか[true/false]を指定します(初期値:null)。
        パラメータ:
        show - ラインを表示するかどうか [true:表示する/false:表示しない]
        説明:
        jsChartTag で、usePointStyle = "true" をセットした場合に有効になります。 初期値(null)は、showLine 属性を設定しませんが、chartJS 自体の初期値が true なので、表示されます。
        変更履歴:
        6.8.5.0 (2018/01/09) 新規登録
      • setSpanGaps

        public void setSpanGaps​(java.lang.String flag)
        【TAG】spanGaps属性を行うかどうか[true/false]を指定します(初期値:null)。
        パラメータ:
        flag - spanGaps属性を行うかどうか [true/false]
        説明:
        trueの場合、データがない点またはヌルの点との間に線が描画されます。 falseの場合、 NaN データ点では線が途切れます。
        変更履歴:
        7.0.1.2 (2018/11/04) 新規登録
      • setPointBGColor

        public void setPointBGColor​(java.lang.String cols)
        【TAG】pointBackgroundColor属性を指定します(初期値:null)。
        パラメータ:
        cols - 点の塗りつぶしの色(単独、配列)
        説明:
        点の塗りつぶしの色を指定します。属性名が長いので、短縮しています。 単独文字列の場合は、すべての点を同じ色で塗ります。配列([]で囲う)の場合は、 点の並び順に応じて、色付けを行います。 配列([]で囲う)か、var定義変数を想定していますので、前後にクオートを付けません。 単独文字列を指定する場合は、"'red'" のように、クオートを付けてください。 通常は、backgroundColorが使用されますので、単独文字で色指定は行わないと思います。 ポイントの色指定に、ColorMapの色コードは使えません。
        変更履歴:
        6.8.5.0 (2018/01/09) 新規登録
      • setUseAxis

        public void setUseAxis​(java.lang.String use)
        【TAG】このデータのy軸を表示するかどうか[true/false]を指定します(初期値:false)。
        パラメータ:
        use - 右側のy軸表示するかどうか [true:表示する/false:表示しない]
        説明:
        true にセットした場合、jsChartTag で、yAxis に対して、一連の設定を行います。 初期値(false)ですが、1つのデータセットは必ず表示されるようです。
        変更履歴:
        7.0.1.1 (2018/10/22) useAxis 属性の追加。
      • setId

        public void setId​(java.lang.String id)
        【TAG】データチャートのIDを指定します。
        オーバーライド:
        setId クラス内 TagSupport
        パラメータ:
        id - 固有の名前
        説明:
        指定しない場合は、y軸のid(自動採番 'y'+連番) になります。 options:scales:yAxes の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setPosition

        public void setPosition​(java.lang.String pos)
        【TAG】y軸の表示位置[left,right]を指定します(初期値:null)。
        パラメータ:
        pos - y軸の表示位置 [left,right]
        説明:
        複合グラフ表示で、指定のデータのy軸を、右に表示したい場合は、right を指定します。 初期値(null)は、左に表示されます。 options:scales:yAxes の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setScaleType

        public void setScaleType​(java.lang.String type)
        【TAG】y軸のスケールタイプ[linear/category]を指定します(初期値:null)。
        パラメータ:
        type - y軸のスケールタイプ [linear/category]
        説明:
        未指定(null)の場合は、linear になります。 options:scales:yAxes の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setCategoryList

        public void setCategoryList​(java.lang.String categoryList)
        【TAG】y軸のメモリリストをCSV形式で指定します(scaleTypeがcategoryの場合に有効)。
        パラメータ:
        categoryList - y軸のメモリリスト
        説明:
        ※ 通常のCSVで指定します。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setYlabel

        public void setYlabel​(java.lang.String label)
        【TAG】scaleLabel:y軸に表示するラベル文字を指定します(初期値:null)。
        パラメータ:
        label - y軸に表示するラベル文字
        説明:
        横軸に表示する文字を指定します。 options:scales:yAxes:scaleLabel の 要素の属性です。 scaleLabel: { display: true, labelString: 'ラベル文字', } がセットされます。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setBeginAtZero

        public void setBeginAtZero​(java.lang.String atZero)
        【TAG】y軸を0から書き始まるかどうか[true/false]を指定します(初期値:null)。
        パラメータ:
        atZero - y軸を0から書き始まるかどうか [true/false]
        説明:
        ticks と同時には使用できません。 初期値(null)は、0から書き始めます。 options:scales:yAxes:ticks の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setFontColor

        public void setFontColor​(java.lang.String fontColor)
        【TAG】y軸のフォントの色を指定(初期値:null)。
        パラメータ:
        fontColor - y軸のフォントの色
        説明:
        ticks と同時には使用できません。 options:scales:yAxes:ticks の 要素の属性です。 ColorMapの色コード(色,色番号,VIVID,PASTEL,V0~,P0~)が使えます。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。, 7.0.1.3 (2018/11/12) 色情報を返すメソッドを集約します。
      • setScaleCallback

        public void setScaleCallback​(java.lang.String callback)
        【TAG】y軸コールバックを指定します。
        パラメータ:
        callback - y軸コールバック
        説明:
        y軸のメモリ編集用スケールバックを設定します。 options:scales:yAxes:ticks の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setMax

        public void setMax​(java.lang.String max)
        【TAG】y軸の最大値を指定します(scaleTypeがlinearの場合に有効)。
        パラメータ:
        max - メモリの最大値
        説明:
        options:scales:yAxes:ticks の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setMin

        public void setMin​(java.lang.String min)
        【TAG】y軸の最小値を指定します(scaleTypeがlinearの場合に有効)。
        パラメータ:
        min - メモリの最小値
        説明:
        options:scales:yAxes:ticks の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setStepSize

        public void setStepSize​(java.lang.String stepSize)
        【TAG】y軸のメモリ幅を指定します(scaleTypeがlinearの場合に有効)。
        パラメータ:
        stepSize - y軸のメモリ幅
        説明:
        options:scales:yAxes:ticks の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setTicks

        public void setTicks​(java.lang.String ticks)
        【TAG】y軸のticks属性を指定(初期値:null)。
        パラメータ:
        ticks - y軸のticks属性
        説明:
        ticks に登録する内容をそのまま書き込みます。 tics = "{ beginAtZero:true,fontColor:'blue' }" という感じに、{} なども含めて書きます。 この設定と、beginAtZero、fontColor を同時に設定した場合の動作は、不定です。 options:scales:yAxes:ticks の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setGridColor

        public void setGridColor​(java.lang.String gridColor)
        【TAG】gridLinesのcolor属性( gridLines:{ color:'red', } を生成)(初期値:null)。
        パラメータ:
        gridColor - y軸のフォントの色
        説明:
        gridLines と同時には使用できません。 options:scales:yAxes:gridLines の 要素の属性です。 ColorMapの色コード(色,色番号,VIVID,PASTEL,V0~,P0~)が使えます。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。, 7.0.1.3 (2018/11/12) 色情報を返すメソッドを集約します。
      • setGridLines

        public void setGridLines​(java.lang.String gridLines)
        【TAG】gridLines属性(gridColorを同時に設定した場合は、不定です)(初期値:null)。
        パラメータ:
        gridLines - y軸のgridLines属性
        説明:
        gridLines に登録する内容をそのまま書き込みます。 gridLines = "{ color:'rgba(256,0,0,0.2)' }" という感じに、{} なども含めて書きます。 この設定と、gridColor を同時に設定した場合の動作は、不定です。 options:scales:yAxes:gridLines の 要素の属性です。
        変更履歴:
        7.0.1.1 (2018/10/22) 属性の追加。
      • setOptDataset

        public void setOptDataset​(java.lang.String attri)
        【TAG】その他data:datasetのオプションを指定します。
        パラメータ:
        attri - その他data:datasetのオプション
        説明:
        変更履歴:
        7.0.1.2 (2018/11/04) 属性の追加。
      • setOptAxis

        public void setOptAxis​(java.lang.String attri)
        【TAG】その他options:scales:yAxesのオプションを指定します。
        パラメータ:
        attri - その他options:scales:yAxesのオプション
        説明:
        options:scales:yAxes の 要素の属性です。 ※ chartJS上は、Axes(axisの複数形)と、Axis を使い分けていますが、属性は、axis で統一します。
        変更履歴:
        7.0.1.2 (2018/11/04) 属性の追加。
      • setOptTicks

        public void setOptTicks​(java.lang.String attri)
        【TAG】その他options:scales:yAxes:ticksのオプションを指定します。
        パラメータ:
        attri - その他options:scales:yAxes:ticksのオプション
        説明:
        options:scales:yAxes:ticks の 要素の属性です。
        変更履歴:
        7.0.1.2 (2018/11/04) 属性の追加。
      • setOptScaleLabel

        public void setOptScaleLabel​(java.lang.String attri)
        【TAG】その他options:scales:yAxes:scaleLabelのオプションを指定します。
        パラメータ:
        attri - その他options:scales:yAxes:scaleLabelのオプション
        説明:
        options:scales:yAxes:scaleLabel の 要素の属性です。
        変更履歴:
        7.0.1.2 (2018/11/04) 属性の追加。
      • setOptGridLines

        public void setOptGridLines​(java.lang.String attri)
        【TAG】その他options:scales:yAxes:gridLinesのオプションを指定します。
        パラメータ:
        attri - その他options:scales:yAxes:gridLinesのオプション
        説明:
        options:scales:yAxes:gridLines の 要素の属性です。
        変更履歴:
        7.0.1.2 (2018/11/04) 属性の追加。
      • toString

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