André Staltz

React could love Web Components

Recently Web Components have been punched in the face in the Twittersphere. It doesn’t need to be like that. Web Components are nice and easy-going and humble and friendly. Web Components love you. Do you love them back?

React is a very popular library/framework at the moment, and React advocates make it sound like Web Components are doomed. And that the React component model is superior. Comments like these are often raised:

The golden use case for WCs would be as primitive leaf components, like third party UI component libraries such as Material UI or Elemental UI. These are not intermediate components in your component hierarchy.

Leaf components rarely (or never) need attributes that accept objects nor functions. Even in cases where the leaf component expects an object, you could serialize it, because the object probably shouldn’t contain functions nor circular references.

Some Web Components have imperative methods like toggle(), which are obstacles to the “declarative” programming style in React, based on props. But WCs don’t need to be built with imperative methods. That was just a choice of the developer who made the component. They could also be fully declarative, controlled only through attributes. In fact, even in React Native we have components with imperative methods like TextInput.clear(), which deviates from the “fully declarative” style too. Does that make React Native doomed? No, not at all.

Are Web Components unsuitable for Flux/Redux dispatching on user events?

@csuwildcat I still have no idea how to build a WC app with top-down data flow and without stuff like Polymer. Same for many people.

— Dan Abramov (@dan_abramov) August 30, 2016

Not really. We don’t need to build the whole app with Web Components. We can use them just as leaf components, and then hook them up with a Redux-like architecture. Here is an example (runs only in Chrome, it’s just a proof of concept quickly built) of how you could use a Web Component inside a React app, and the Web Component’s flipend event would trigger a dispatch of an action:

window.addEventListener('WebComponentsReady', function () {
  class HelloMessage extends React.Component {
    handleHelloClick() {

    handleFlipend() {
      console.log('here we should do store.dispatch(action)')

    componentDidMount() {
      // hack to add user event handler for the
      // brick-flipbox 'flipend' event
      // Ideally, React would support doing this
      // as <brick-flipbox onFlipend={}> instead,
      // since it anyway has a synthetic event system.
      // Cycle.js wouldn't see any difference between
      // or'brick-flipbox').events('flipend')
      this.refs['foo'].addEventListener('flipend', ev => this.handleFlipend())

    render() {
      return (
          <div onClick={ev => this.handleHelloClick()}>
            Hello {}, click me!
          <brick-flipbox class="demo" ref="foo">

    <HelloMessage name={'world'} />,

What do we benefit by using Web Components? Framework interoperability. We could neatly use jQuery plugins in Vue.js, React components in Angular apps, Cycle.js components in React/Redux apps. If you’re satisfied with the React bubble where there’s a vast collection of ready-made React-only components, then this might not sound appealing to you. But if you’re working on an application built in another framework, you don’t want to limit your options of ready-made components to only those built in that other framework. You want the full menu of everything the open source community can provide you.

You know why Facebook won’t be built on Web Components? Because Facebook builds all their leaf components. It’s all custom. It’s the same reason why Facebook won’t have any use for Material UI components, probably ever. Same reason why Facebook won’t use your average jQuery plugin.

Does that mean you should not use Material UI nor jQuery plugins nor Web Components? No. Facebook is not a regular site. A lot of things and technologies and choices that impact Facebook are completely different to what most web developers have to face in their jobs. This is not science, but I assume that 90%+ of websites in the world have less than 1% of the amount of active users that Facebook has. The type of websites we build are different, and the way of building is also different. We need: quick reusability, ready made components, and just getting it done. Often it doesn’t need to be ultra fast, it doesn’t need to be ultra tiny. Often we just need to get it done, and neatly.

Web Components are for you and me, the mere mortal web developers. They are useful like Material UI is. Love them back and you’ll make the web a place with more exchange of reusable code. A place with more sharing.

Become a Patron!

Copyright (C) 2016 Andre 'Staltz' Medeiros, licensed under Creative Commons BY-NC 4.0, translations to other languages allowed.