Biblioteca de integração dos Web Components GovBR-DS com o Vue
Bibiloteca de componentes vue que encapsulam os Web Components GovBR-DS.
Instale os pacotes abaixo:
``bash`
npm install --save-dev @govbr-ds/core @govbr-ds-testing/webcomponents @govbr-ds-testing/webcomponents-vue
Inclua no main.ts (ou arquivo equivalente) da sua aplicação:
`typescript
import { ComponentLibrary } from '@govbr-ds-testing/webcomponents-vue'
import '@govbr-ds/core/dist/core.min.css'
`
O core.min.css é quem define os valores dos tokens de CSS usados.
`markdown`
- vue
- lib
- stencil-generated
- index.ts
- plugin.ts
Ao gerar um build da biblioteca te Web Components os arquivos da pasta lib/stencil-generated são deletados e recriados. Todas as alterações nesses arquivos vão ser perdidas ao gerar um novo build dos Web Components.
O Arquivo plugin.ts registra os componentes como custom elements.
O Arquivo index.ts é o entry point da biblioteca e exporta os componentes.
Rode o comando npm run build.
Para utilizar a biblioteca em Stencil criada para o GovBR-DS, é necessário que se tenha um novo projeto Vue previamente configurado. Se ainda não o tiver instalado, siga estes passos para criar um projeto Vue e configurá-lo para utilizar os componentes:
- Criar um Projeto Vue: Primeiramente, crie um novo projeto Vue utilizando o Vue CLI ou outro método de sua preferência. Por exemplo:
`terminal`
vue create meu-projeto
- Baixar Pacotes Necessários: Após criar o projeto, instale os pacotes necessários, incluindo os componentes do Padrão Digital de Governo.
`terminal`
npm install @govbr-ds-testing/webcomponents-vue @govbr-ds/core
- Configurar o Arquivo main.js: No arquivo main.js do seu projeto Vue, configure o uso dos componentes e do roteador, se necessário. Exemplo de arquivo main.js:
`terminal
import { ComponentLibrary } from '@govbr-ds-testing/webcomponents-vue';
import '@govbr-ds/core/dist/core.min.css';
import { createApp } from 'vue';
import App from './App.vue';
import router from './router';
const app = createApp(App);
app.use(router); // Se estiver utilizando roteador
app.use(ComponentLibrary);
app.mount('#app');
`
Com esses passos, seu projeto Vue estará configurado para utilizar os componentes do Padrão Digital de Governo.
É importante notar que as dependências estão sendo gerenciadas através do sistema de módulos do JavaScript. Se ainda estiver com dificuldade para aplicar os estilos, incluía no arquivo index.html algumas referências a bibliotecas externas e estilos adicionais, que incluem o GovBR-DS, o Google Fonts e o Font Awesome, verificando sempre se ocorre redundâncias e conflitos entre as importações no arquivo main.js e os scripts e folhas de estilo incluídos no index.html:
`html`
Para gerar um componente no seu projeto Vue, vamos utilizar como exemplo o componente Input do GovBR-DS, seguindo o mesmo entendimento nos demais componentes.
Você pode usar as tags do componente diretamente no template. Por exemplo:
`html`
Cada componente possui várias propriedades que podem ser utilizadas para personalizar sua aparência e comportamento. A documentação de cada componente deve ser consultada para obtenção de maiores informações. É importante destacar que as propriedades padrão do HTML podem ser utilizadas da mesma forma que em um input HTML comum. Por exemplo, as propriedades id, name, value, disabled, required, entre outras, podem ser aplicadas diretamente à tag do componente br-input. Veja um exemplo:
`html`
Neste exemplo, além das propriedades HTML comum, foi definido as propriedades density (densidade do input, podendo ser "small" ou "large") e label(geração automática do label para o input).
Utilizando : (sintaxe de bind), você pode passar dinamicamente o valor de uma variável para a propriedade do componente e uma variável no seu componente Vue. Por exemplo:
`html`
No componente Vue:
`javascript`
data() {
return {
textLabel: "Texto do label"
};
}
Você pode ouvir eventos customizados emitidos pelo componente br-input usando a diretiva @, seguida pelo nome do evento. Por exemplo, você está ouvindo o evento input no exemplo fornecido:
`html`
No componente Vue:
`javascript``
methods: {
handleInputChange(newValue) {
this.inputValue = newValue.target.value;
},
}
É importante observar que os componentes utilizam Shadow DOM para encapsular seu estilo e comportamento. Isso significa que os estilos não podem ser facilmente modificados diretamente a partir do componente pai.
No entanto, você ainda pode personalizar alguns aspectos do estilo utilizando CSS personalizado dentro do escopo do componente pai. Isso pode ser feito definindo classes personalizadas ou utilizando estilos embutidos diretamente no componente pai.
Você pode usar as issues para nos informar os problemas que tem enfrentado ao usar nossa biblioteca ou mesmo o que gostaria que fizesse parte do projeto. Por favor use o modelo que mais se encaixa na sua necessidade e preencha com o máximo de detalhes possível.
Nos comprometemos a responder a todas as issues.
Nesse projeto usamos um padrão para branches e commits. Por favor observe a documentação na nossa wiki para aprender sobre os nossos padrões.
Por favor não crie issues para fazer perguntas.
Use nossos canais abaixo para obter tirar suas dúvidas:
- Site do GovBR-DS http://gov.br/ds
- Web Components https://gov.br/ds/webcomponents
- Usando nosso canal no discord https://discord.gg/U5GwPfqhUP
Os Web Components do GovBR-DS são criados pelo SERPRO juntamente com a comunidade.
Nesse projeto usamos a licença MIT.