A escrita de nomes com hífens
O kebab-case é uma convenção de escrita que separa as palavras de um nome por hífens, normalmente com letras minúsculas. Em tempo-limite, o hífen ocupa o lugar do espaço entre as duas palavras, permitindo formar um nome contínuo e legível.
Essa grafia aparece em nomes de arquivos e em identificadores aceitos por diferentes ferramentas. No CSS, background-color é um exemplo de propriedade escrita dessa forma. O significado do nome e os valores aceitos dependem da linguagem ou da ferramenta que o interpreta.
Uma chave com hífen em JavaScript
O exemplo didático abaixo guarda o número 30 em uma propriedade chamada tempo-limite e lê esse valor:
const configuracao = { "tempo-limite": 30 }console.log(configuracao["tempo-limite"])A saída é 30. As aspas preservam o hífen como parte do nome da propriedade, que é acessada por colchetes. O nome da variável configuracao segue a sintaxe dos identificadores JavaScript e não contém hífen.
Escrever tempo-limite como uma expressão JavaScript faria o interpretador ler uma subtração entre tempo e limite. Por isso, você não pode declarar uma variável simples com essa grafia. A chave textual do objeto permite o hífen porque usa outra forma de nomear e acessar a propriedade.
Preservar a grafia esperada pela ferramenta
A diferença entre tempo-limite e tempo_limite está no separador: o primeiro segue o kebab-case e o segundo segue o snake_case. A troca altera a grafia do nome, portanto uma ferramenta pode reconhecer uma dessas formas e rejeitar a outra.
Ao copiar uma opção de terminal, confira a grafia completa na ajuda do comando. Uma opção escrita com hífens também pode ser convertida pela biblioteca para outro nome dentro do programa. Você precisa consultar a documentação dessa conversão para saber qual propriedade o código recebe.
Dúvidas frequentes
Perguntas frequentes sobre kebab-case
- Kebab-case e snake_case usam o mesmo separador?
- O kebab-case separa palavras com hífen, como em tempo-limite. O snake_case usa sublinhado, como em tempo_limite. A troca altera a grafia do nome.
- Uma variável JavaScript pode ter hífen no nome?
- O hífen não é aceito em um identificador de variável JavaScript. Uma propriedade de objeto pode usar uma chave entre aspas com hífen e ser acessada por colchetes.
- O hífen determina a função de uma opção?
- Não. Ele pertence à grafia do nome. O significado da opção e os valores aceitos dependem da documentação da ferramenta.
Para continuar
Recursos relacionados
Documentação
MDN: kebab case
Define a escrita com hífens e apresenta exemplos de nomes usados no desenvolvimento web.
Abrir recursoAplicação na formação
Developer Workspace
As convenções de nomes permitem interpretar opções de ferramentas e propriedades usadas no desenvolvimento web.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.