Komponenty sieciowe
These docs are old and won’t be updated. Go to react.dev for the new React docs.
See Custom HTML elements in the new docs.
React i komponenty sieciowe (ang. Web Components) zostały stworzone do rozwiązywania różnych problemów. Komponenty sieciowe zapewniają silną enkapsulację w celu wielokrotnego użytku, a React jest deklaratywną biblioteką stworzoną do synchronizacji danych z modelem DOM. Te dwa cele się dopełniają. Jako deweloper możesz wykorzystywać Reacta w swoich komponentach sieciowych lub wykorzystywać komponenty sieciowe w Reakcie.
Większość osób korzystających z Reacta nie używa komponentów sieciowych, ale ty możesz chcieć to zrobić, zwłaszcza jeśli używasz zewnętrznych komponentów UI napisanych z wykorzystaniem komponentów sieciowych.
Używanie komponentów sieciowych w Reakcie
class HelloMessage extends React.Component {
render() {
return <div>Witaj, <x-search>{this.props.name}</x-search>!</div>;
}
}
Uwaga:
Komponenty sieciowe często udostępniają imperatywne API. Na przykład: komponent sieciowy
video
może udostępniać funkcjeplay()
ipause()
. Aby skorzystać z imperatywnego API komponentu sieciowego, możesz potrzebować użyć referencji (ref
), aby nawiązać bezpośredni kontakt z węzłem drzewa DOM. Jeśli korzystasz z komponentów sieciowych innych osób, najlepszym rozwiązaniem będzie utworzenie reactowego komponentu służącego jako nakładka dla komponentu sieciowego.Zdarzenia emitowane przez komponent sieciowy mogą niewłaściwie propagować się przez reactowe drzewo renderowania. Aby obsłużyć te zdarzenia w komponencie reactowym, konieczne może być ręczne dodanie procedur obsługi zdarzeń.
Często mylonym aspektem komponentów sieciowych jest to, że korzystają z atrybutu “class”, a nie “className”.
function BrickFlipbox() {
return (
<brick-flipbox class="demo">
<div>front</div>
<div>back</div>
</brick-flipbox>
);
}
Używanie Reacta w komponentach sieciowych
class XSearch extends HTMLElement {
connectedCallback() {
const mountPoint = document.createElement('span');
this.attachShadow({ mode: 'open' }).appendChild(mountPoint);
const name = this.getAttribute('name');
const url = 'https://www.google.com/search?q=' + encodeURIComponent(name);
const root = ReactDOM.createRoot(mountPoint);
root.render(<a href={url}>{name}</a>);
}
}
customElements.define('x-search', XSearch);
Uwaga:
Ten kod nie zadziała, jeśli dokonujesz transformacji klas używając narzędzia Babel. Zobacz dyskusję na ten temat, aby dowiedzieć się więcej. Aby rozwiązać ten problem, użyj custom-elements-es5-adapter przed załadowaniem komponentów sieciowych.