We want to hear from you!Take our 2021 Community Survey!
Este sitio ya no se actualiza.Vaya a react.dev

Web Components

Estos documentos son antiguos y no se actualizarán. Vaya a react.dev para ver los nuevos documentos de React.

Consulte [Elementos HTML personalizados] (https://es.react.dev/reference/react-dom/components#custom-html-elements) en los nuevos documentos.

React y Web Components están construidos para resolver diferentes problemas. Los Web Components proporciona una fuerte encapsulación para componentes reutilizables, mientras que React proporciona una biblioteca declarativa que mantiene el DOM sincronizado con tus datos. Los dos objetivos se complementan. Como desarrollador, eres libre de usar React en tus Web Components, utilizar Web Components en React, o ambos.

La mayoría de las personas que usan React no utilizan Web Components, pero es posible que desees hacerlo, especialmente si estás utilizando componentes de interfaz de usuario de terceros que se escriben utilizando Web Components.

Usando Web Components en React

class HelloMessage extends React.Component {
  render() {
    return <div>Hello <x-search>{this.props.name}</x-search>!</div>;
  }
}

Nota:

Los Web Components a menudo exponen una API imperativa. Por ejemplo, un Web Component video podría exponer las funciones play() y pause(). Para acceder a un API imperativa de un Web Component, necesitarás utilizar una referencia para interactuar con el DOM directamente. Si estás utilizando Web Components de terceros, lo mejor sería escribir un componente React que sirva como un contenedor para tu Web Component`.

Los eventos emitidos por un Web Component pueden no distribuirse correctamente a través de un árbol de renderizado React. Deberás agregar manualmente los controladores de eventos para manejarlos dentro de tus componentes React.

Una cosa que puede confundirte, es que los Web Components usan “class” en vez de “className”

function BrickFlipbox() {
  return (
    <brick-flipbox class="demo">
      <div>front</div>
      <div>back</div>
    </brick-flipbox>
  );
}

Usando React en tus Web Components

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);

Nota:

Este código NO funcionará si transformas clases con Babel. Ver Este caso para la discusión. Incluye el custom-elements-es5-adapter antes de cargar tus Web Components para que puedas solucionar este problema.

¿Es útil esta página?Edita esta página