Dash コアコンポーネント

Dash のコアコンポーネントはアプリケーションを構築するための基盤であり、ユーザーインターフェースを作成してデータとやり取りすることを可能にします。

Dash はdash.htmlとdash.dccモジュールにより、ユーザーインターフェースを簡単に作成し、データと対話できます。

Dash 2.0 以降、dash_html_components と dash_core_components は dash メインパッケージに統合されました。

現在は、古い dash_html_components や dash_core_components を使用するのではなく、直接 dash から html と dcc をインポートすることが推奨されます。


Dash コアコンポーネント概要

Dash のコアコンポーネントは大きく2つのカテゴリに分けられます:dash.htmlとdash.dcc。dash.htmlHTML タグの Python ラッパーを提供し、dash.dcc一方、スライダー、ドロップダウンメニュー、グラフなどのより高機能なインタラクティブコンポーネントを提供します。

1. dash.htmlコンポーネント

dash.htmlモジュールは HTML タグに対応する Python クラスを提供します。これらのクラスを使用すると、Python の方法で HTML コードを記述できます。例えば、dash.html.Divは HTML の<div>タグに、dash.html.H1は<h1>タグに対応します。

例

import dash
import dash.html as html

app = dash.Dash(__name__)

app.layout = html.Div([
    html.H1('欢迎来到 Dash 世界'),
    html.P(これは簡単な段落です。),
    html.Div([
        html.Span(これは Span 1 です),
        html.Span(これは Span 2 です)
    ])
])

if __name__ == '__main__':
    app.run_server(debug=True)

dash.htmlコンポーネントにより、HTML 構造の記述が非常に簡単かつ直感的になります。

上記のコードでは、見出し、段落、および2つのSpan要素を含むDivコンテナを作成しました。

2. dash.dccコンポーネント

dash.dccモジュールは、データ可視化やユーザー入力に通常使用される、より高機能なインタラクティブコンポーネントを提供します。一般的なdash.dccコンポーネントにはGraph、Dropdown、Sliderなどがあります。

サンプルコード

例

import dash
import dash.html as html
import dash.dcc as dcc

app = dash.Dash(__name__)

app.layout = html.Div([
    dcc.Graph(
        id='example-graph',
        figure={
            'data': [
                {'x': [1, 2, 3], 'y': [4, 1, 2], 'type': 'bar', 'name': 'サンプル'},
                {'x': [1, 2, 3], 'y': [2, 4, 5], 'type': 'bar', 'name': 'GOOGLE'},
            ],
            'layout': {
                'title': 'Dash 数据可视化'
            }
        }
    ),
    dcc.Dropdown(
        id='example-dropdown',
        options=[
            {'label': '选项 1', 'value': '1'},
            {'label': '选项 2', 'value': '2'},
            {'label': '选项 3', 'value': '3'}
        ],
        value='1'
    )
])

if __name__ == '__main__':
    app.run_server(debug=True)

この例では、棒グラフとドロップダウンメニューを含むレイアウトを作成しました。dcc.Graphコンポーネントはデータ可視化グラフの表示に使用され、dcc.Dropdown一方、コンポーネントはユーザーがドロップダウンメニューからオプションを選択できるようにします。

コアコンポーネントの属性

すべての Dash コンポーネントには、外観と動作を制御するための属性がいくつかあります。例えば、dash.html.Divのchildren属性はその子要素を指定するために使用され、dash.dcc.Graphのfigure属性はグラフのデータとレイアウトを指定するために使用されます。

よく使われる属性

  • children: コンポーネントの子要素を指定するために使用します。ほとんどのコンポーネントがこの属性を持っています。
  • id: コンポーネントを一意に識別するために使用し、通常はコールバック関数で使用します。
  • style: コンポーネントの CSS スタイルを設定するために使用します。
  • className: コンポーネントの CSS クラス名を指定するために使用します。

サンプルコード

例

import dash
import dash.html as html

app = dash.Dash(__name__)

app.layout = html.Div(
    children=[
        html.H1('これは見出しです', style={'color': 'blue', 'fontSize': 40}),
        html.P('これは段落です', className='my-class')
    ],
    style={'backgroundColor': '#f0f0f0'}
)

if __name__ == '__main__':
    app.run_server(debug=True)

上記のコードでは、私たちはstyle属性を使用してタイトルの色とフォントサイズを設定し、className属性を使用して段落に CSS クラス名を指定しました。

その他の拡張