Docs: add explanation for how to import components with default props.

[johnridesabike]

This question comes up regularly on Discord.

[woeps]

LGTM

Just shadowing the makeProps function feels more lightweight to me. Having the original bindings around can be usefull if someone wanted to have several different derivations of the bound component.

[johnridesabike]

Shadowing makeProps is an interesting technique. The compiled JS does look like it may be more lightweight too since it only adds a new function to the props, and doesn’t call React.createElement an extra time.

It feels a bit hacky to me though, so I was hesitant to put it in the PR. But I don’t mind adding it if we all think it’s worth mentioning.

module Greeting = {
   [@bs.module "./MyJavascriptFile.js"] [@react.component]
   external make: (~name: string) => React.element = "default";
   let makeProps = (~name="Peter", unit) => makeProps(~name, unit);
 };

let f = () => <Greeting  />

https://nit.sketch.sh/?code=LYewJgrgNgpgBAcQE4xgFwJYDsDmcC8cA3gFBzkDaAAgEYDOAdKJLHAEQMD0AsgJ4BSAQwBugugGMkGAA5oAYhlgMAVnTYBdONRSDxaBuJDBpILDCxp1ZcjAAeaGEiyCocYIIDWMAFxwAFAB+zsA+cHRoUrgAlAQAfHAASjC6+jCwIRYE7GAwAGaC0GhsANzWcLBobp4wAApIINJ0WYHBMPhsNeiObAA0cBBYGGgx+PHuXnUNdC2CIX0DQ1GlcAC+pSQVcLnNI-EAPMiomLjknLFAA

[peterpme]

Hey thanks so much, just a few nits 😄

[peterpme]

Thank you!