Terra Core
- Pacotes
- Versão
- Status
- Descontinuado
- Navegadores suportados
- Internacionalização (I18n)
- Contribuindo
- Desenvolvimento local
- Desenvolvimento local usando Docker (recipientes de dev)
- LICENÇA
Pacotes
Versão
Quando um componente atinge v1.0.0., Ele é considerado estável e seguirá Semver para versões.
- As principais versões representam mudanças de ruptura
- As versões menores representam funcionalidade adicional de maneira compatível com as costas
- As versões de patch representam correções de bug compatíveis com as costas
Consulte os Changelogs do componente, questões relacionadas e PRs para obter mais informações.
Vemos a API React.JS Props de nossos componentes como nossa principal API pública. Usamos isso para nos guiar ao versionar componentes.
Antes dos componentes que atingem a v1.0.0, um componente é considerado em um estágio beta. Os componentes no estágio beta podem incluir alterações de quebra, novos recursos e correções de bugs nas versões v0.xx.
Status
| Pacote de terra | Versão | Status | Dependências |
|---|
| Terra-ação-Footer | | | |
| Terra-ação-cabeçalho | | | |
| Terra-Alert | | | |
| terra-arrange | | | |
| Terra-Avatar | | | |
| Terra-Badge | | | |
| terra-base | | | |
| Terra-breakpoints | | | |
| Terra-Button | | | |
| Terra-Button-Group | | | |
| terra-card | | | |
| Terra-Content-container | | | |
| Terra-Demographics-Banner | | | |
| Terra-Dialog | | | |
| terra-dividedor | | | |
| Terra-Dropdown-Button | | | |
| Terra-Dinâmico-grade | | | |
| Terra-form-forma-checkbox | | | |
| Terra-Form Field | | | |
| Terra-form-Fieldset | | | |
| Terra-forma-entrada | | | |
| Terra-forma-radio | | | |
| terra-seleção de terra | | | |
| Terra-form-textarea | | | |
| terra-grid | | | |
| terra-cabeçalho | | | |
| Terra-hyperlink | | | |
| Terra-i18n | | | |
| Terra-icon | | | |
| terra-imagem | | | |
| Terra-List | | | |
| terra-mixins | | | |
| Terra-overlay | | | |
| terra-paginator | | | |
| Terra-Profile-Image | | | |
| terra-progresso-bar | | | |
| elemento de terra responsivo | | | |
| terra-roll | | | |
| Campo de Pesquisa de Terra | | | |
| Terra-seção-cabeçalho | | | |
| Terra-show-hide | | | |
| sinalização de terra | | | |
| terra-spacer | | | |
| terra-status | | | |
| Terra-status-View | | | |
| terra-mesa | | | |
| terra-tag | | | |
| Terra-texto | | | |
| Terra-Toggle | | | |
| Terra-Toggle-Button | | | |
| Terra-toggle-Seção-cabeçalho | | | |
| Texto terratualmente oculto | | | |
Descontinuado
| Pacote de terra | Versão | Status | Dependências |
|---|
| Terra-form | | | |
| Terra-i18n-plugin | | | |
| Terra-Legacy-Theme | | | |
| terra-modal | | | |
Navegadores suportados
| Navegador | Versão |
|---|
| Chrome & Chrome para Android | Atual |
| Borda | Atual |
| Firefox | Atual |
| Internet Explorer | 10 e 11 |
| Safari e Mobile Safari | Atual |
Internacionalização (I18n)
Revise a documentação de internacionalização da Terra para obter mais informações. Estão incluídas instruções sobre o consumo e como a internacionalização é configurada.
Pacotes que exigem i18n
- Terra-ação-cabeçalho
- Terra-Alert
- Terra-Demographics-Banner
- Terra-Dialog
- Terra-form-forma-checkbox
- Terra-Form Field
- Terra-forma-radio
- terra-seleção de terra
- Terra-i18n
- Terra-overlay
- Campo de Pesquisa de Terra
- Terra-show-hide
- Terra-status-View
Contribuindo
Por favor, leia nossas diretrizes contribuintes. Estão incluídas instruções para relatórios de problemas e solicitações de puxar.
Desenvolvimento local
- Instale o Node Version Manager (NVM) e o nó. O diretório raiz contém um arquivo
.nvmrc que especifica a versão do nó do Terra-Corore. Depois que o NVM estiver instalado e você estiver dentro do diretório raiz, sua versão do nó mudará para esta versão. - Instale o docker https://www.docker.com/ para executar testes do navegador.
- Instale dependências e execute testes.
Desenvolvimento local usando Docker (recipientes de dev)
- Instale o fazendeiro ou o docker.
- O Rancher é gratuito e de código aberto e é altamente recomendado, enquanto o Docker pode exigir uma licença para uso.
- Instale o Código Microsoft vs.
- Instale a extensão do contêiner de dev.
- Navegue para visualizar-> Extensão-> Pesquise e instale os contêineres de dev (ou "ms-vscode-remote.remote-containers")
- Mais informações sobre contêineres de dev
- Construa o contêiner de dev:
- (Opção 1) - Abrindo espaço de trabalho local em contêiner de dev
- Clone o repositório (ou garfo) localmente e abra o projeto no Código do Visual Studio
- Navegue para visualizar -> Paleta de comando e executar contêineres de dev: Open Workspace no contêiner
- (Opção 2) - Recomendado para o Windows para que a carga quente funcione durante o desenvolvimento e o desempenho aprimorado: Criando o contêiner de dev usando volumes de dev (para obter mais informações e orientações, consulte o guia oficial)
- Se você tiver configuração Git e possui arquivo de configuração global ~/.gitconfig localmente, essas configurações devem ser automaticamente transferidas para o contêiner dev
- Navegue para visualizar -> Paleta de comando e executar contêineres de dev: repositório de clone no volume de contêineres
- Cole o URL do GitHub deste repositório (ou garfo)
- O código VS agora recarregará o espaço de trabalho e criará/iniciará o contêiner e o volume de dev
- Observação: as alterações feitas usando esta opção atualizarão apenas os arquivos no volume do Docker. Recomenda -se cometer alterações frequentemente, caso o volume seja excluído ou o recipiente de dev seja removido.
- Agora você está executando em um contêiner de dev. Use o terminal do contêiner Dev no código do Visual Studio para emitir quaisquer comandos NPM ou BASH.
- Antes de executar todos os testes do WDIO, execute as seguintes etapas:
- Abra um novo terminal (fora do recipiente de dev) e navegue para ".DevContainer/" Caminho em seu repositório.
- Execute o comando
"docker compose -f docker-compose-wdio.yml up" . O centro de selênio deve girar. Deixe isso funcionando em segundo plano. Se você vir erros dizendo "o nome do contêiner já existe", execute "docker container prune" seguido de pressionando "y" para limpar qualquer contêiner não utilizado e tente executar o comando anterior novamente. - Agora você pode executar
npm run test:docker ou npm run wdio:docker Comandos para executar testes WDIO de dentro do contêiner dev. - NOTA: Opcionalmente, se você deseja executar outros comandos do WDIO no contêiner dev, também poderá editar o arquivo root package.json scripts WDIO para incluir
--disableSeleniumService=true sinalizador. Isso desativará o serviço de selênio de girar novamente. Por exemplo: " scripts " : {
" wdio:lowlight " : " terra wdio --disableSeleniumService=true --themes clinical-lowlight-theme "
} - Se algum dos arquivos de composição for alterado, você deverá atualizar o contêiner do Docker, excluindo as imagens do Docker existente correspondentes e executando o seguinte comando:
docker compose -f < changed compose file name > .yml up
- Para encerrar um contêiner de dev:
- Use linha de comando ou desktop de fazendeiro/docker ou
- Usando o código do Visual Studio
- Selecione o ícone do Explorer remoto na barra de atividades ou visualização -> Paleta de comando e execute o Remote Explorer: Concentre -se na exibição de contêineres
- Localize o Terra-core_DevContainer ou atualmente executando o contêiner de dev em "Dev contêineres"
- Clique com o botão direito do mouse e selecione Stop Container e feche o espaço de trabalho
- Você também pode selecionar o contêiner de reconstrução para reiniciar o contêiner de dev
- Para reabrir um recipiente de dev:
- Espaço de trabalho local existente (para a opção 1)
- Abra o projeto no Código do Visual Studio
- Verifique se o espaço de trabalho contém a pasta .DevContainer
- Navegue para visualizar -> Paleta de comando e executar contêineres de dev: Open Workspace no contêiner
- Volume de contêiner de dev isolado (para a opção 2)
- Código do Visual Studio aberto
- Use o ícone Remote Explorer na barra de atividades ou visualização -> Paleta de comando e execute o Explorer remoto: foco na exibição de contêineres para visualizar contêineres
- Localize o Terra-core_DevContainer em "Dev Recainers"
- Passe o mouse sobre o contêiner de dev e clique no ícone da pasta rotulada pela pasta aberta no contêiner ou clicando com o botão direito do lado e selecionando a pasta aberta no contêiner
LICENÇA
Copyright 2017 - 2024 Cerner Innovation, Inc.
Licenciado sob a licença Apache, versão 2.0 (a "licença"); Você não pode usar esse arquivo, exceto em conformidade com a licença. Você pode obter uma cópia da licença em
http://www.apache.org/license/license-2.0
A menos que exigido pela lei aplicável ou acordada por escrito, o software distribuído sob a licença é distribuído "como está", sem garantias ou condições de qualquer tipo, expressa ou implícita. Consulte a licença para o idioma específico que rege as permissões e limitações sob a licença.
