Reason bindings for material-ui-icons.
🚧 This is a WIP, not everything is supported yet but we're getting close. 🚧
Feel free to create an issue or PR if you find anything missing.
yarn add @mscharley/bs-material-ui-icons
yarn add @material-ui/core
yarn add @material-ui/icons
Then add @mscharley/bs-material-ui-icons
to bs-dependencies
in your bsconfig.json
:
{
// ...
"bs-dependencies": ["@mscharley/bs-material-ui-icons"]
}
let component = ReasonReact.statelessComponent("Example");
let make = (_children) => {
...component,
render: (_self) => <MscharleyBsMaterialUiIcons.Delete.Filled />
};
You can find a list of available icons here. The icons are exposed as <IconName.Theme />
from this library, which is slightly different to ReactJS which uses <IconNameTheme />
or <IconName />
for the filled theme.
Maybe this library hasn't been updated yet to include the new icon. No problems! Just open an issue and let us know we're msising something. We'll get things updated as soon as possible.
There are an awful lot of icons available in @material-ui/icons
; as of writing, around 5000 of them. Initially, this project exported all of these icons from one module file. This was very fast to build! However due to interactions with the way the bsb
builds files and the way it writes imports this led to very big deployment packages, even with tree shaking. Using a single icon caused builds to increase in size by 3MB (~7x in my small project!) because all the icons were always being included.
This module now exports each group of icons into it's own file. This leads to a slightly different usage pattern to ReactJS, namely <Delete.Filled />
instead of <Delete />
or <Delete.Outlined />
instead of <DeleteOutlined />
. This isn't that big a deal, really. It also lets packagers only include the icons you're using. Unfortunately, it means that the BSB build is a little bit longer.
MscharleyBsMaterialUiIcons.js is compiled in script mode while its dependent is not
Related to the build question above, this package uses the namespace
option in BuckleScript. This means that MscharleyBsMaterialUiIcons
is purely synthetic and there isn't actually a script to include and re-export. Even if this did work it would be discouraged because you would end up at square one with code elimination as highlighted in the design decision above.
The current recommended way to alias this library is as follows:
/* Icons.re */
open MscharleyBsMaterialUiIcons;
module PowerSettingsNew = PowerSettingsNew.Filled;
module ReportProblem = ReportProblem.Filled;
module Help = Help.Outlined;