#layout #facebook #yoga #flexbox #engine #node #prelude

lento-yoga

Rust bindings for Facebook's Yoga, a Flexbox layout engine

1 unstable release

new 0.4.0 Jan 18, 2025

#1 in #yoga

Download history 51/week @ 2025-01-13

51 downloads per month

MIT license

6MB
121K SLoC

C++ 44K SLoC // 0.0% comments TypeScript 36K SLoC // 0.0% comments Java 35K SLoC // 0.0% comments JavaScript 3K SLoC // 0.0% comments Rust 1.5K SLoC // 0.0% comments TSX 438 SLoC // 0.1% comments Python 252 SLoC // 0.1% comments C 145 SLoC // 0.0% comments Kotlin 114 SLoC // 0.1% comments Batch 93 SLoC Ruby 37 SLoC Swift 21 SLoC // 0.3% comments Prolog 9 SLoC

Contains (JAR file, 63KB) gradle-wrapper.jar, (Zip file, 59KB) src/yoga/lib/soloader/soloader-0.5.1.aar, (JAR file, 32KB) src/yoga/lib/jsr-305/jsr305.jar

Yoga-rs

Build Status

A Rust wrapper for Facebook's Yoga layout library.

You may also want to check out taffy (a revived fork of the abandoned stretch) as it is a pure Rust implementation.

Dependencies

  • cargo
  • rustc
  • libc++-dev (LLVM’s libc++)

Build

$ cargo build --release

Run Example

$ cargo run --release --example layout

Format Code

$ cargo +nightly fmt

Example Code

#[macro_use]
extern crate yoga;

use yoga::prelude::*;
use yoga::Node;
use yoga::StyleUnit::{Auto, UndefinedValue};

fn main() {
	let mut node = Node::new();

	let mut child = Node::new();
	let mut other_child = Node::new();

	node.insert_child(&mut child, 0);
	node.insert_child(&mut other_child, 1);

	style!(node,
		Margin(10 pt),
		MarginLeft(Auto),
		PaddingHorizontal(4 pt),
		Left(16 %),
		Bottom(UndefinedValue)
	);

	let child_styles = make_styles!(
		Width(32 pt),
		Height(32 pt),
		FlexGrow(1.0),
		Margin(Auto)
	);

	child.apply_styles(&child_styles);
	other_child.apply_styles(&child_styles);

	node.calculate_layout(512.0, 512.0, yoga::Direction::LTR);

	println!("Layout is {:#?}", child.get_layout());
}

Testing

The unit tests are automatically generated based on upstream fixtures and should not be edited manually.

$ cargo test

To generate the test cases: Download the ChromeDriver binary and put it somewhere in your $PATH. Linux/MacOS example:

$ cp chromedriver /usr/local/bin

Then run the following

$ cd gentest
$ bundle install # Install the required ruby gems
$ ruby gentest/gentest.rb # Generate the tests
$ cargo +nightly fmt # Format the tests for consistency

Dependencies