SWCore / Componentes / Textlimit

Textlimit Componentes

Contador de caracteres restantes, com aviso visual perto do limite e ao estourar.

O que é

Mostra quantos caracteres faltam (ou passaram) do limite — bio de perfil, campo de comentário, SMS.

Como funciona

Injeta um contador logo depois do campo e atualiza a cada tecla. Aplica maxlength real no campo (bloqueia digitar além do limite) e classes de aviso quando restam poucos caracteres ou o limite estourou (só relevante se o texto foi colado, já que maxlength impede digitar além).

Exemplos

1. Demo — digite nos campos Ao vivo

O contador — inserido automaticamente logo abaixo — fica laranja ao atingir 80% e vermelho ao limite (100%).

Título do post

Nome de usuário

Bio

Post social

<!-- Input com limite -->
<input type="text" sw-textlimit sw-textlimit-max="80" placeholder="Máximo 80 caracteres">

<!-- Textarea com limite -->
<textarea sw-textlimit sw-textlimit-max="280" placeholder="Máximo 280 caracteres"></textarea>
2. Formatos do contador — sw-textlimit-txt Ao vivo

Padrão: {count}/{max}

Restante: {remaining} restantes

Completo: {count} de {max} chars

Só contagem: {count}

<!-- Padrão: "42/100" -->
<textarea sw-textlimit sw-textlimit-max="100"></textarea>

<!-- Restante: "58 restantes" -->
<textarea sw-textlimit sw-textlimit-max="100" sw-textlimit-txt="{remaining} restantes"></textarea>

<!-- Completo: "42 de 100 chars" -->
<textarea sw-textlimit sw-textlimit-max="100" sw-textlimit-txt="{count} de {max} chars"></textarea>

<!-- Só contagem: "42" -->
<textarea sw-textlimit sw-textlimit-max="100" sw-textlimit-txt="{count}"></textarea>
3. Expansão centralizada Ao vivo

Contador centralizado: sw-textlimit-align="center"

Campo e contador centralizados: sw-textlimit-center

<!-- Contador expandindo a partir do centro -->
<textarea sw-textlimit sw-textlimit-max="100" sw-textlimit-align="center" sw-textlimit-txt="{count} de {max} caracteres"></textarea>

<!-- Campo e contador centralizados -->
<input type="text" sw-textlimit sw-textlimit-max="50" sw-textlimit-center sw-textlimit-txt="{remaining} restantes">

Atributos

sw-textlimit-max
limite de caracteres (padrão 150, ou usa o maxlength nativo se já existir) — define o maxlength real no campo
sw-textlimit-txt
template do texto do contador — padrão "{count}/{max}", aceita {count}, {max} e {remaining}
sw-textlimit-align
"right" (padrão), "center" (expande das duas pontas) ou "left"
sw-textlimit-center
centraliza o texto dentro do próprio campo, além do contador

Variantes

Nenhum.

Eventos

Nenhum.

API (JavaScript)

Nenhum.

Requisitos

Nenhuma.

Limitações — o que ele não faz

Nenhuma.