{"componentChunkName":"component---src-templates-docs-js","path":"/docs/composition-vs-inheritance.html","result":{"data":{"markdownRemark":{"html":"

O React tem um poderoso modelo de composição, e por isso recomendamos o uso de composição ao invés de herança para reutilizar código entre componentes.

\n

Nesta página, iremos demonstrar alguns problemas encontrados pelos desenvolvedores que estão iniciando com o React e esbarram em situações com herança, e mostraremos como podemos resolver utilizando composição.

\n

Contenção

\n

Alguns componentes não tem como saber quem serão seus elementos filhos. Isso é muito comum para componentes como o SideBar ou Dialog que representam “caixas” genéricas.

\n

Recomendamos que esses componentes utilizem a prop especial children para passar os elementos filhos diretos para sua respectiva saída:

\n
function FancyBorder(props) {\n  return (\n    <div className={'FancyBorder FancyBorder-' + props.color}>\n      {props.children}    </div>\n  );\n}
\n

Isso permite outros componentes passar elementos filhos no próprio JSX:

\n
function WelcomeDialog() {\n  return (\n    <FancyBorder color=\"blue\">\n      <h1 className=\"Dialog-title\">        Bem-vindo      </h1>      <p className=\"Dialog-message\">        Obrigado por visitar a nossa espaçonave!      </p>    </FancyBorder>\n  );\n}
\n

Experimente no CodePen

\n

Qualquer conteúdo dentro da tag JSX do componente <FancyBorder> vai ser passado ao componente FancyBorder como prop children. Desde que FancyBorder renderize a {props.children} dentro de uma <div>, os elementos serão renderizados no resultado final.

\n

Mesmo que seja incomum, as vezes pode ser que você precise de diversos “buracos” no componente. Em alguns casos você pode criar sua própria convenção e não utilizar a prop children:

\n
function SplitPane(props) {\n  return (\n    <div className=\"SplitPane\">\n      <div className=\"SplitPane-left\">\n        {props.left}      </div>\n      <div className=\"SplitPane-right\">\n        {props.right}      </div>\n    </div>\n  );\n}\n\nfunction App() {\n  return (\n    <SplitPane\n      left={\n        <Contacts />      }\n      right={\n        <Chat />      } />\n  );\n}
\n

Experimente no CodePen

\n

Os elementos React como <Contacts/> e <Chat/> são apenas objetos, e você pode passá-los como props assim como faz com outros tipos de dados. Esta abordagem pode soar familiar como “slots” em outras bibliotecas, mas no React não existe limitações sobre o que pode ser passado como props.

\n

Especialização

\n

Algumas vezes acabamos pensando em componentes como “casos especiais” de outros componentes, por exemplo, podemos dizer que o componente WelcomeDialog é um caso especial de Dialog.

\n

No React, isto também pode ser obtido através do uso de composição, um componente específico renderiza um componente mais “genérico” e o configura com as suas respectivas props:

\n
function Dialog(props) {\n  return (\n    <FancyBorder color=\"blue\">\n      <h1 className=\"Dialog-title\">\n        {props.title}      </h1>\n      <p className=\"Dialog-message\">\n        {props.message}      </p>\n    </FancyBorder>\n  );\n}\n\nfunction WelcomeDialog() {\n  return (\n    <Dialog      title=\"Bem-vindo\"      message=\"Obrigado por visitar a nossa espaçonave!\" />  );\n}
\n

Experimente no CodePen

\n

A composição também irá funcionar para componentes escritos utilizando classe:

\n
function Dialog(props) {\n  return (\n    <FancyBorder color=\"blue\">\n      <h1 className=\"Dialog-title\">\n        {props.title}\n      </h1>\n      <p className=\"Dialog-message\">\n        {props.message}\n      </p>\n      {props.children}    </FancyBorder>\n  );\n}\n\nclass SignUpDialog extends React.Component {\n  constructor(props) {\n    super(props);\n    this.handleChange = this.handleChange.bind(this);\n    this.handleSignUp = this.handleSignUp.bind(this);\n    this.state = {login: ''};\n  }\n\n  render() {\n    return (\n      <Dialog title=\"Programa de Exploração de Marte\"\n              message=\"Como gostaria de ser chamado?\">\n        <input value={this.state.login}               onChange={this.handleChange} />        <button onClick={this.handleSignUp}>          Cadastre-se!        </button>      </Dialog>\n    );\n  }\n\n  handleChange(e) {\n    this.setState({login: e.target.value});\n  }\n\n  handleSignUp() {\n    alert(`Bem-vindo a bordo, ${this.state.login}!`);\n  }\n}
\n

Experimente no CodePen

\n

E sobre a herança?

\n

No Facebook, nós usamos o React em milhares de componentes, e não encontramos nenhum caso que recomendaríamos criar componentes utilizando hierarquia de herança.

\n

O uso de props e composição irá te dar toda flexibilidade que você precisa para customizar o comportamento e aparência dos componentes, de uma maneira explícita e segura. Lembre-se de que os componentes podem aceitar um número variável de props, incluindo valores primitivos, como int, array, boolean; assim como elementos Reacts e funções.

\n

E se você desejar reutilizar funcionalidades (não gráficas) entre componentes, sugerimos que você a extraia em módulos JavaScript. Os componentes podem importar essa função, objeto ou classe sem precisar estender.

","frontmatter":{"title":"Composição vs Herança","next":"thinking-in-react.html","prev":"lifting-state-up.html"},"fields":{"path":"content/docs/composition-vs-inheritance.md","slug":"docs/composition-vs-inheritance.html"}}},"pageContext":{"slug":"docs/composition-vs-inheritance.html"}},"staticQueryHashes":[]}