Bonsai: Jane StreetのUIライブラリ
Bonsai: Janestreet's UI Library (github.com)
要約
Bonsaiは、OCamlでパフォーマンスが高くリアクティブなWebアプリケーションを構築するためのUIライブラリで、Elmに触発されています。Jane Streetのほぼ全てのWebアプリケーション(企業ディレクトリからトレーディングシステムを監視・操作するツールまで)で使用されています。Bonsaiコンポーネントは純粋関数的なステートマシンとして実装され、状態が変更されたときのみ増分的にレンダリングされるため、効率的です。
全文翻訳
Bonsaiは、OCamlでパフォーマンスが高くリアクティブなWebアプリケーションを構築するためのUIライブラリで、Elmに部分的に触発されています。これは、Jane Street社内のほぼ全てのWebアプリケーション、企業ディレクトリからトレーディングシステムを監視・操作するツールまで、あらゆるものに使用されています。少しインタラクティブ性を持つシンプルなBonsaiコンポーネントは、以下のようになります。
module Dice = struct
let faces =
[ "⚀"; "⚁"; "⚂"; "⚃"; "⚄"; "⚅" ]
;;
let component (graph @ local) =
(* コンポーネントは純粋関数的なステートマシンとして実装されます。*)
let face, set_face = Bonsai.state (List.hd_exn faces) graph in
(* コンポーネントは、状態の関連部分が変更されたときにのみ、段階的にレンダリングされます。*)
let%arr face and set_face in
{%html|
<div>
You rolled a #{face}
<button
style="" on_click=%{fun _ ->
let index = Random.int (List.length faces) in
set_face (List.nth_exn faces index)}
>
Roll the dice
</button>
</div>
|}
;;
end
[画像: Bonsaiで構築されたWebアプリ] [画像: Bonsaiで構築されたWebアプリ]
Jane Streetの内部WebアプリケーションのほとんどはBonsaiで構築されています。
コンポーネントは純粋関数的なステートマシンとして実装され、容易に合成可能です。フレームワーク内のインクリメンタライゼーションは、値が必要になるまで再計算されないことを意味します。これは、ビューだけでなく、あらゆる値に適用されます。
なぜBonsaiなのか?
他のWebフレームワークは、状態、インクリメンタリティ、レンダリングを単一の抽象化であるUIコンポーネントにまとめがちです。対照的に、Bonsaiでは状態とインクリメンタリティのプリミティブをアラカルトで合成できます。ユーザーインタラクション中にページ全体を再レンダリングしないようにするのと同じプリミティブを、ライブ更新データセット上の高コストなビジネスロジック計算をインクリメンタライズするためにも使用できます。(Reactに慣れているなら、すべてが非常に似たフックを使用し、状態がコンポーネント階層の外で管理されていると想像してください。)
状態は明示的なコンポーネントに関連付けられていないため、ユーザーがページとインタラクションする際の状態のライフサイクルとスコープを管理するための広範なAPIがあります。たとえば、状態を持つUIコンポーネントのコレクションを別のUIコンポーネント(タブインターフェイスなど)内に埋め込みたい場合、Bonsaiは内部コンポーネントのすべての状態を手動でアプリのトップレベルモデルにホイストする必要なく、状態管理を処理します。状態がどのように合成されるかのさらなる例については、Bonsaiの作成者によって書かれたこの合成比較を参照してください。
そして、BonsaiはOCamlで書かれているため、バックエンドとフロントエンドで同じ言語と型を使用することが可能になります。これが可読性に与える影響や、大規模なWebアプリのコードベースを管理可能に保つこと(特にOCamlの型システムを広範囲に使用してエラーを減らす場合)は、どれだけ強調してもしすぎることはありません。Jane Streetでは、以前はターミナルUIしか持たなかった多くの内部システムがあり、このフレームワークにより、既存の型とビジネスロジックをWebに簡単に移植できるようになりました。
Bonsaiには、強力なテンプレート言語、コンポーネント固有のスタイルシートのサポート、およびアプリ全体の自動テストシステムも付属しています。
アプリを手動でクリックすることなく、あなたを救う表現力豊かなテスト
Bonsaiの最も強力な機能の1つは、UI要素をプログラムで操作し、DOMの進化を観察する現実的なテストを簡単に記述できることです。
以下の例では、ユーザーセレクターの動作をテストしています。テキストボックスに入力した内容は、小さな「hello」メッセージに追加されます。
let%expect_test "shows hello to a specified user" =
let handle = Handle.create (Result_spec.vdom Fn.id) hello_textbox in
Handle.show handle;
[%expect
{|
<div>
<input oninput> </input>
<span> hello </span>
</div> |
}];
Handle.input_text handle ~get_vdom:Fn.id ~selector:"input" ~text:"Bob";
Handle.show_diff handle;
[%expect
{|
<div>
<input oninput> </input>
- <span> hello </span>
+ <span> hello Bob </span>
</div> |
}];
2つのexpectブロックに注意してください。(これにより、特定のシナリオ内で複数のアサーションを作成し、セットアップ/ヘルパーコードをそのシナリオに限定できます。)
最初のブロックはUIを可視化し、2番目のブロック(diffを含む)はプログラムでテキストを入力した後の動作を示します。Bonsaiは、HTML属性やクラス名がユーザー入力に応じてどのように変化するかさえ表示します。テストにはモックサーバー呼び出しを含めることができ、UIだけでなくそれを駆動する状態の変更も伴う場合があります。このようなテストにより、ブラウザを開かずにコンポーネント全体を記述できます。
ドキュメント
BonsaiクイックスタートとBonsaiでの考え方は、Bonsaiへの実践的な入門を提供しており、学習を開始するのに最適な場所です。その他にも以下があります。
- 一連のハウツー記事。
- Bonsaiの歴史に関する短い記事シリーズ。
- 「UIフレームワークの構築」に関する私たちのシグナル&スレッドポッドキャストのエピソード。「トレーダー向けツールの構築」に関する別のエピソードでは、Bonsaiを使用する利点の一部が議論されました。
- Bonsaiで構築された例示的なWebサイトのライブラリ。
- APIドキュメントは、cont.mliファイルで見つけることができます。
Bonsaiは実際にはライブラリのコレクションです
えーと、1つの注意点があります:Bonsai自体――このライブラリ――は、上記の説明よりも実際には汎用的です。汎用のインクリメンタルで合成可能なステートマシンを構築できます。Bonsai_webは、そのコアライブラリの上に構築され、インタラクティブなブラウザベースのUIに特化していますが、インタラクティブなターミナルベースのUIを構築するためのBonsai_termもあります。April Fools' Dayには、リアクティブな仮想現実UIのためのBonsai_vrのプロトタイプさえありました。
Bonsaiライブラリの全スイート:
汎用ライブラリ
Bonsaiは、インクリメンタルで合成可能なステートマシンを構築するためのライブラリです。
ブラウザベースUIライブラリ
Bonsai_webは、bonsaiを使用してインタラクティブなブラウザベースUIを構築するためのライブラリです。
ターミナルベースUIライブラリ
Bonsai_termは、bonsaiを使用してインタラクティブなターミナルベースUIを構築するためのライブラリです。
事前コンパイラ
Bonsai Webアプリケーションでは、以下の事前コンパイラがよく使用されます。