Taffy: 柔軟で高性能なクロスプラットフォームUIレイアウトライブラリ
Taffy: A flexible, high-performance, cross-platform UI layout library (github.com)
要約
TaffyはRustで書かれた、柔軟で高性能なクロスプラットフォームUIレイアウトライブラリです。CSSのBlock、Flexbox、CSS Gridのレイアウトアルゴリズムを実装しており、将来的に他のパラダイムへの対応も計画されています。Servo、Blitz、Bevy、Slintなど、多くのUI/GUIライブラリで採用されています。
全文翻訳
[画像: Taffy]
[画像: GitHub CI] [画像: crates.io] [画像: docs.rs] [画像: Crates.io MSRV]
Taffyは、Rustで書かれた、柔軟で高性能なクロスプラットフォームUIレイアウトライブラリです。
現在、CSSのBlock、Flexbox、CSS Gridレイアウトアルゴリズムを実装しています。他のパラダイムへの対応も計画されています。これらやその他の将来の開発計画については、ロードマップのイシューを参照してください。
このクレートは、複数のチームによる共同プロジェクトであり、他のUIおよびGUIライブラリの依存関係として使用されるように設計されています。現在、以下のプロジェクトで利用されています。
- Servo: 代替ウェブブラウザ
- Blitz: 革新的にモジュール化されたウェブエンジン
- Bevy: 人間工学的でECSファーストなRustゲームエンジン
- Takumi: Reactコンポーネントを画像にレンダリング
- iocraft: ターミナル向けの美しいインターフェースをクラフト
- Slint: ネイティブユーザーインターフェース構築のための宣言型GUIツールキット
- Lapce テキストエディタ(Floem UIフレームワーク経由)
- Zed テキストエディタ(GPUI UIフレームワーク経由)
使用方法
use taffy::prelude::*;
// まずTaffyTreeのインスタンスを作成します
let mut tree : TaffyTree<()> = TaffyTree::new();
// `TaffyTree.new_leaf` と `TaffyTree.new_with_children` を使用してノードツリーを作成します。
// これらの関数はどちらも、そのノードを参照するために使用できるノードIDを返します。
// Style構造体はスタイリング情報を指定するために使用されます。
let header_node = tree
.new_leaf(
Style {
size: Size { width: length(800.0), height: length(100.0) },
..Default::default()
},
).unwrap();
let body_node = tree
.new_leaf(
Style {
size: Size { width: length(800.0), height: auto() },
flex_grow: 1.0,
..Default::default()
},
).unwrap();
let root_node = tree
.new_with_children(
Style {
flex_direction: FlexDirection::Column,
size: Size { width: length(800.0), height: length(600.0) },
..Default::default()
},
&[header_node, body_node],
)
.unwrap();
// ルートノードに対してcompute_layoutを呼び出し、レイアウトアルゴリズムを実行します。
tree.compute_layout(root_node, Size::MAX_CONTENT).unwrap();
// compute_layoutの結果を `TaffyTree.layout` を使用して確認します。
assert_eq!(tree.layout(root_node).unwrap().size.width, 800.0);
assert_eq!(tree.layout(root_node).unwrap().size.height, 600.0);
assert_eq!(tree.layout(header_node).unwrap().size.width, 800.0);
assert_eq!(tree.layout(header_node).unwrap().size.height, 100.0);
assert_eq!(tree.layout(body_node).unwrap().size.width, 800.0);
assert_eq!(tree.layout(body_node).unwrap().size.height, 500.0); // この値は明示的に設定されていませんが、Taffyによって計算されました。
他言語へのバインディング
- Python: stretchable 経由
- WIP Cバインディング
- WIP WASMバインディング
学習リソース
TaffyはFlexboxとCSS Gridの仕様を忠実に実装しているため、ウェブ向けに設計されたドキュメントはTaffyの実装にもそのまま適用できます。個々のスタイルプロパティのリファレンスドキュメントとしては、MDNのドキュメント(例: widthプロパティに関するこのページ)を推奨します。これらのページは通常、検索エンジンで「MDN プロパティ名」と検索することで見つけることができます。
CSSレイアウトのガイドレベルのドキュメントに興味がある場合は、以下のリソースを推奨します。
Flexbox
- Flexbox Froggy: インタラクティブなチュートリアル/ゲームで、楽しく魅力的な方法でFlexboxの必須部分を学習できます。
- A Complete Guide To Flexbox (CSS Tricks著): イラストと、さまざまなFlexboxプロパティとその動作に関する包括的な説明が記載された詳細なガイドです。
CSS Grid
- CSS Grid Garden: インタラクティブなチュートリアル/ゲームで、楽しく魅力的な方法でCSS Gridの必須部分を学習できます。
- A Complete Guide To CSS Grid (CSS Tricks著): イラストと、さまざまなCSS Gridプロパティとその動作に関する包括的な説明が記載された詳細なガイドです。
ベンチマーク(Yoga との比較)
- 2021 MacBook Pro (M1 Proプロセッサ) でcriterionを使用して実行
- ベンチマークはレイアウト計算のみを測定します。ツリー作成は測定しません。
- Yogaのベンチマークはyogaクレート(Rustバインディング)、バージョン0.5.0経由で実行しました。
- ほとんどの一般的なウェブサイトは3,000から10,000ノード(ただし、テキストレイアウトも必要ですが、YogaもTaffyも実装していません)を持つようです。
以下の表には複数の異なる単位(秒、ミリ秒、マイクロ秒)が含まれていることに注意してください。
| ベンチマーク | ノード数 | 深さ | Yoga (v3.2.1) | Taffy (e747f6e) |
|---|---|---|---|---|
| yoga 'huge nested' | 1,000 | 3 | 328.24 µs | 250.23 µs |
| yoga 'huge nested' | 10,000 | 4 | 3.2892 ms | 2.6947 ms |
| yoga 'huge nested' | 100,000 | 5 | 41.686 ms | 32.871 ms |
| big trees (wide) | 1,000 | 2 | 468.66 µs | 471.14 µs |
| big trees (wide) | 10,000 | 2 | 4.8667 ms | 4.8032 ms |
| big trees (wide) | 100,000 | 2 | 63.304 ms | 58.111 ms |
| absolutely positioned leaves | 1,000 | 2 | 408.51 µs | 259.91 µs |
| absolutely positioned leaves | 10,000 | 2 | 4.3898 ms | 2.7890 ms |
| absolutely positioned leaves | 100,000 | 2 | 56.490 ms | 41.270 ms |
| big trees (deep, random size) | 4,000 | 12 | 1.7937 ms | 1.8160 ms |
| big trees (deep, random size) | 10,000 | 14 | 4.4436 ms | 4.5843 ms |
| big trees (deep, random size) | 100,000 | 17 | 63.555 ms | 69.952 ms |
| big trees (deep, auto size) | 4,000 | 12 | 32.872 ms | 4.7357 ms |
| big trees (deep, auto size) | 10,000 | 14 | 103.19 ms | 11.894 ms |
| big trees (deep, auto size) | 100,000 | 17 | 2.3502 s | 164.24 ms |
| super deep | 150 | 50 | 61.132 ms | 179.02 µs |
| super deep | 300 | 100 | finishedせず (>9分) | 366.89 µs |
貢献
貢献を歓迎します: taffyを使いたい、改善したい、または構築したい場合は、ぜひ会話に参加し、イシューを開くか、PRを送信してください。taffyの使用方法について質問がある場合は、ディスカッションを開いてください。そうすれば、他の人が見つけられる形で質問に回答できます。