Skip to content

Commit

Permalink
docs: ponsto do porque usar os decoratos
Browse files Browse the repository at this point in the history
  • Loading branch information
deMGoncalves committed Aug 13, 2024
1 parent a6eeebd commit 331e3a5
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 6 deletions.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -53,5 +53,5 @@
},
"type": "module",
"types": "types.d.ts",
"version": "0.0.4"
"version": "0.0.5"
}
22 changes: 17 additions & 5 deletions src/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -174,12 +174,24 @@ Para transformar um elemento personalizado em um controle associado a um formul

Implemente os callbacks `formAssociatedCallback`, `formDisabledCallback`, `formResetCallback`, e `formStateRestoreCallback` para gerenciar como o componente interage com o formulário em diferentes momentos do ciclo de vida.

## Por Que Usar Decorators?
## Por Que Usar Decorators ao Invés de Métodos Nativos?

Os decorators são uma poderosa ferramenta para simplificar a escrita e evitar um código excessivamente verboso. Aqui estão algumas das principais vantagens:
Usar decorators em vez de métodos nativos do ciclo de vida dos Web Components traz várias vantagens:

- **Código Mais Limpo e Menos Verboso:** Ao usar decorators, você pode evitar a criação de métodos extensivos e complexos. Decorators permitem que você anote métodos com funcionalidades específicas de maneira clara e concisa.
- **Modularidade e Reusabilidade:** Decorators permitem encapsular funcionalidades específicas de forma modular, promovendo a reusabilidade e evitando a duplicação de código.

- **Múltiplos Decorators no Mesmo Método:** Você pode aplicar o mesmo decorator várias vezes a um mesmo método, permitindo que diversas ações sejam executadas em momentos diferentes do ciclo de vida do componente. Isso evita a necessidade de chamar métodos um dentro do outro, facilitando a manutenção e a leitura do código.
- **Separação de Preocupações:** Com decorators, você separa a lógica de ciclo de vida e funcionalidades do formulário da lógica principal do componente, tornando o código mais organizado.

Essas características tornam o desenvolvimento de Web Components mais ágil e menos propenso a erros, proporcionando uma maneira mais eficiente de gerenciar os ciclos de vida e interações dos componentes.
- **Consistência e Padrões:** Decorators asseguram que funcionalidades sejam aplicadas de maneira consistente, reduzindo a probabilidade de erros.

- **Facilidade de Testes:** Decorators facilitam a escrita de testes ao permitir que métodos específicos sejam testados em isolamento.

- **Redução de Código Boilerplate:** Decorators reduzem a quantidade de código boilerplate necessário, simplificando a implementação de funcionalidades comuns.

- **Integração e Extensibilidade:** Decorators permitem a adição de novas funcionalidades e extensões de forma modular e integrada, sem modificar a estrutura existente.

### Conclusão

O **-O-id** transforma a maneira como você cria Web Components, oferecendo uma abordagem mais eficiente e modular através do uso de decorators. Diga adeus ao código verboso e complexo, e diga olá a uma nova era de desenvolvimento de Web Components mais claro e poderoso.

Experimente o **-O-id** e veja como ele pode simplificar e aprimorar seu desenvolvimento de Web Components!

0 comments on commit 331e3a5

Please sign in to comment.