Getting Started | Examples | Discord
A Yoga powered layout library for PixiJS.
Features
-
📐 Yoga-Powered Flexbox Layout: Built on top of Facebook’s Yoga engine, enabling powerful and predictable flexbox layouting for 2D interfaces.
-
📦 Supports all PixiJS Objects: Such as Container, Sprite, Graphics, Text, etc. to deliver responsive, visually rich UI components.
-
🧠 Simple and Intuitive API: Designed with usability in mind, declare your layouts using familiar properties with minimal boilerplate.
-
🎯 Advanced Styling Support: Includes support for styling properties like objectFit, objectPosition, overflow, backgroundColor, and borderRadius, bringing web-style flexibility to canvas UIs.
-
🤝 Compatible with PixiJS React: Easily integrates with PixiJS React, allowing you to combine layout and interactivity in React environments.
It's easy to get started with PixiJS Layout! Just install the package with your package manager of choice
# with pnpm
pnpm add @pixi/layout
# with yarn
yarn add @pixi/layout
# with npm
npm install @pixi/layout// import the library before creating your pixi application to ensure all mixins are applied
import "@pixi/layout";
import { Application, Assets, Container, Sprite } from "pixi.js";
(async () =>
{
// Create a new application
const app = new Application();
await app.init({ background: '#1099bb', resizeTo: window });
document.body.appendChild(app.canvas);
const texture = await Assets.load('https://pixijs.com/assets/bunny.png');
// Create a new layout for the stage that will fill the entire screen
// and center the content
app.stage.layout = {
width: app.screen.width,
height: app.screen.height,
justifyContent: 'center',
alignItems: 'center',
}
// Create and add a container to the stage that will be used to hold the bunnies
// The container will be centered in the stage and will have a gap of 10 pixels
// between the bunnies
// The container will also wrap the bunnies if there are too many to fit in a single row
const container = new Container({layout: {
width: '80%',
height: '80%',
gap: 4,
flexWrap: 'wrap',
justifyContent: 'center',
alignContent: 'center',
}});
app.stage.addChild(container);
// Create a grid of bunny sprites
for (let i = 0; i < 10; i++)
{
// Create a bunny Sprite and enable layout
// The width/height of the bunny will be the size of the texture by default
const bunny = new Sprite({ texture, layout: true });
// Add the bunny to the container
container.addChild(bunny);
}
// Listen for animate update
app.ticker.add((time) =>
{
// Rotating a container that is in layout will not cause the layout to be recalculated
container.rotation += 0.1 * time.deltaTime;
});
})();Want to be part of the PixiJS Layout project? Great! All are welcome! We will get there quicker together :) Whether you find a bug, have a great feature request, or you fancy owning a task from the road map above, feel free to get in touch.
Make sure to read the Contributing Guide before submitting changes.
This content is released under the MIT License.
We're passionate about making PixiJS the best graphics library possible. Our dedication comes from our love for the project and community. If you'd like to support our efforts, please consider contributing to our open collective.
