An extension of [Roblox's Roact](https://github.com/Roblox/roact)
- Copy the
srcdirectory into your codebase - Rename the folder to
Roact - Use a plugin like Rojo to sync the files into a place
- Add Wally to your project
- Add
firere/roactto yourdependenciesinwally.toml
- Whenever a prop is passed into a host component which is not a valid property of the target Roblox class, it does not error and simply skips over trying to apply it
- Whenever children are passed in both the
Roact.Childrenkey ofpropsand in thechildrenarguments ofcreateElement, it will automatically merge them both- If 2 keys with the same name are found in both arguments, the
childrenargument will replace the one inprops; this can be configured
- If 2 keys with the same name are found in both arguments, the
For a detailed guide and examples, check out the documentation.
local LocalPlayer = game:GetService("Players").LocalPlayer
local Roact = require(Roact)
-- Create our virtual tree describing a full-screen text label.
local tree = Roact.createElement("ScreenGui", {
[Roact.Children] = {
Image = Roact.createElement("ImageLabel", {
InvalidProp = "InvalidProp is not a valid property on the ImageLabel class" -- This does not produce an error.
})
}
}, {
Label = Roact.createElement("TextLabel", { -- Both Image and Label will be children of tree.
Text = "Hello, world!",
Size = UDim2.new(1, 0, 1, 0),
}),
})
-- Turn our virtual tree into real instances and put them in PlayerGui
Roact.mount(tree, LocalPlayer.PlayerGui, "HelloWorld")Roact is available under the Apache 2.0 license. See LICENSE.txt for details.