Common components
All of the built-in browser components support some props and events.
This includes React-specific props likeref anddangerouslySetInnerHTML.
Form components
These built-in browser components accept user input:
They are special in React because passing thevalue prop to them makes themcontrolled.
Resource and Metadata Components
These built-in browser components let you load external resources or annotate the document with metadata:
They are special in React because React can render them into the document head, suspend while resources are loading, and enact other behaviors that are described on the reference page for each specific component.
All HTML components
React supports all built-in browser HTML components. This includes:
<aside><audio><b><base><bdi><bdo><blockquote><body><br><button><canvas><caption><cite><code><col><colgroup><data><datalist><dd><del><details><dfn><dialog><div><dl><dt><em><embed><fieldset><figcaption><figure><footer><form><h1><head><header><hgroup><hr><html><i><iframe><img><input><ins><kbd><label><legend><li><link><main><map><mark><menu><meta><meter><nav><noscript><object><ol><optgroup><option><output><p><picture><pre><progress><q><rp><rt><ruby><s><samp><script><section><select><slot><small><source><span><strong><style><sub><summary><sup><table><tbody><td><template><textarea><tfoot><th><thead><time><title><tr><track><u><ul><var><video><wbr>
Note
Similar to theDOM standard, React uses acamelCase convention for prop names. For example, you’ll writetabIndex instead oftabindex. You can convert existing HTML to JSX with anonline converter.
Custom HTML elements
If you render a tag with a dash, like<my-element>, React will assume you want to render acustom HTML element.
If you render a built-in browser HTML element with anis attribute, it will also be treated as a custom element.
Setting values on custom elements
Custom elements have two methods of passing data into them:
- Attributes: Which are displayed in markup and can only be set to string values
- Properties: Which are not displayed in markup and can be set to arbitrary JavaScript values
By default, React will pass values bound in JSX as attributes:
<my-elementvalue="Hello, world!"></my-element>Non-string JavaScript values passed to custom elements will be serialized by default:
// Will be passed as `"1,2,3"` as the output of `[1,2,3].toString()`
<my-elementvalue={[1,2,3]}></my-element>React will, however, recognize an custom element’s property as one that it may pass arbitrary values to if the property name shows up on the class during construction:
exportclass MyElementextendsHTMLElement{constructor(){super();// The value here will be overwritten by React// when initialized as an elementthis.value =undefined;}connectedCallback(){this.innerHTML =this.value.join(", ");}}
Listening for events on custom elements
A common pattern when using custom elements is that they may dispatchCustomEvents rather than accept a function to call when an event occur. You can listen for these events using anon prefix when binding to the event via JSX.
exportfunctionApp(){return(<my-elementonspeak={e=>console.log(e.detail.message)}></my-element>)}
Note
Events are case-sensitive and support dashes (-). Preserve the casing of the event and include all dashes when listening for custom element’s events:
// Listens for `say-hi` events
<my-elementonsay-hi={console.log}></my-element>
// Listens for `sayHi` events
<my-elementonsayHi={console.log}></my-element>All SVG components
React supports all built-in browser SVG components. This includes:
<a><animate><animateMotion><animateTransform><circle><clipPath><defs><desc><discard><ellipse><feBlend><feColorMatrix><feComponentTransfer><feComposite><feConvolveMatrix><feDiffuseLighting><feDisplacementMap><feDistantLight><feDropShadow><feFlood><feFuncA><feFuncB><feFuncG><feFuncR><feGaussianBlur><feImage><feMerge><feMergeNode><feMorphology><feOffset><fePointLight><feSpecularLighting><feSpotLight><feTile><feTurbulence><filter><foreignObject><g><hatch><hatchpath><image><line><linearGradient><marker><mask><metadata><mpath><path><pattern><polygon><polyline><radialGradient><rect><script><set><stop><style><svg><switch><symbol><text><textPath><title><tspan><use><view>
Note
Similar to theDOM standard, React uses acamelCase convention for prop names. For example, you’ll writetabIndex instead oftabindex. You can convert existing SVG to JSX with anonline converter.
Namespaced attributes also have to be written without the colon:
xlink:actuatebecomesxlinkActuate.xlink:arcrolebecomesxlinkArcrole.xlink:hrefbecomesxlinkHref.xlink:rolebecomesxlinkRole.xlink:showbecomesxlinkShow.xlink:titlebecomesxlinkTitle.xlink:typebecomesxlinkType.xml:basebecomesxmlBase.xml:langbecomesxmlLang.xml:spacebecomesxmlSpace.xmlns:xlinkbecomesxmlnsXlink.