Bokeh-adding-widgets
ボケ-ウィジェットの追加
bokeh.models.widgetsモジュールには、ボタン、スライダー、チェックボックス、ラジオボタンなど、HTMLフォーム要素に類似したGUIオブジェクトの定義が含まれています。 これらのコントロールは、プロットへのインタラクティブなインターフェースを提供します。 プロットデータの変更、プロットパラメータの変更などの処理の呼び出しは、対応するイベントで実行されるカスタムJavaScript関数によって実行できます。
ボケはコールバック機能が2つの方法で定義されることを可能にします-
- * CustomJSコールバック*を使用して、インタラクティブ機能がスタンドアロンのHTMLドキュメントで機能するようにします。
- * Bokehサーバー*を使用して、イベントハンドラーをセットアップします。
このセクションでは、Bokehウィジェットを追加し、JavaScriptコールバックを割り当てる方法について説明します。
ボタン
このウィジェットは、ユーザー定義のコールバックハンドラーを呼び出すために通常使用されるクリック可能なボタンです。 コンストラクタは次のパラメータを取ります-
labelパラメータはボタンのキャプションとして使用される文字列であり、コールバックはクリックされたときに呼び出されるカスタムJavaScript関数です。
次の例では、プロットとボタンウィジェットが列レイアウトで表示されます。 プロット自体は、xデータ系列とyデータ系列の間に線グリフを描画します。
「callback」という名前のカスタムJavaScript関数は、* CutomJS()関数*を使用して定義されています。 フォーム変数cb_objでコールバックをトリガーしたオブジェクト(この場合はボタン)への参照を受け取ります。
この関数は、ソースのColumnDataSourceデータを変更し、最終的にこの更新をソースデータで発行します。
出力(初期)
プロットの上にあるボタンをクリックして、次のような更新されたプロット図を確認してください-
出力(クリック後)
スライダー
スライダーコントロールを使用して、割り当てられた開始プロパティと終了プロパティの間の数を選択できます。
次の例では、スライダーのon_changeイベントにコールバック関数を登録します。 スライダーの瞬間的な数値は、ColumnDatasourceデータの変更に使用されるcb_obj.valueの形式でハンドラーに使用できます。 位置をスライドさせると、プロット図は継続的に更新されます。
出力
RadioGroup
このウィジェットは、キャプションの左側に円形のボタンを示す相互に排他的なトグルボタンのコレクションを提供します。
ここで、labelsはキャプションのリストであり、activeは選択されたオプションのインデックスです。
選択する
このウィジェットは、文字列アイテムの単純なドロップダウンリストで、そのうちの1つを選択できます。 選択した文字列が上部のウィンドウに表示されます。これは値パラメーターです。
ドロップダウンの文字列要素のリストは、オプションリストオブジェクトの形式で提供されます。
以下は、ラジオボタンと選択ウィジェットの組み合わせ例で、どちらもxとyのデータシリーズ間に3つの異なる関係を提供します。 RadioGroup および* Selectウィジェット*は、on_change()メソッドを介してそれぞれのハンドラーに登録されます。
出力
タブウィジェット
ブラウザーと同様に、各タブは異なるWebページを表示できます。タブウィジェットは、各図に異なるビューを提供するボケモデルです。 次の例では、正弦曲線と余弦曲線の2つのプロット図が2つの異なるタブに表示されます-