Resumo em 1 Minuto
O str_limit()
é um helper do Laravel para truncar strings • Sintaxe: str_limit($string, $limit, $end)
• Útil para previews de texto, títulos e descrições • Substituído pelo Str::limit()
nas versões mais recentes • Essencial para controle de layout e UX
O que é o Helper str_limit()
O str_limit() é um helper do Laravel projetado para truncar strings de forma elegante, mantendo a legibilidade do texto. Este helper é especialmente útil quando você precisa exibir apenas uma parte de um texto longo, como títulos, descrições ou previews de conteúdo.
Por que Usar o str_limit()?
- ✅ Controle de Layout: Mantém designs consistentes
- ✅ Melhor UX: Evita textos excessivamente longos
- ✅ Performance: Reduz o tamanho do DOM
- ✅ Responsividade: Adapta conteúdo a diferentes telas
Sintaxe e Parâmetros
str_limit($string, $limit = 100, $end = '...')
Parâmetros Detalhados
Parâmetro | Tipo | Descrição | Padrão |
$string | string | Texto a ser limitado | Obrigatório |
$limit | int | Texto a ser limitado | 100 |
$end | string | Texto a ser limitado | ‘…’ |
Exemplos Práticos de Uso
Exemplo Básico
$titulo = "Este é um título muito longo que precisa ser truncado para melhor visualização";
echo str_limit($titulo, 50);
// Resultado: "Este é um título muito longo que precisa ser tru..."
Personalizando o Sufixo
$descricao = "Laravel é um framework PHP elegante e expressivo";
echo str_limit($descricao, 25, ' [Leia mais]');
// Resultado: "Laravel é um framework [Leia mais]"
Em Views Blade
<h2>{{ str_limit($post->title, 60) }}</h2>
<p>{{ str_limit($post->excerpt, 150) }}</p>
Boas Práticas
✅ Faça:
- Use limites apropriados para cada contexto (títulos: 50-70, descrições: 150-200)
- Considere o espaço disponível no design
- Teste em diferentes tamanhos de tela Mantenha consistência nos limites
❌ Evite:
- Limites muito baixos que cortam palavras importantes
- Sufixos muito longos que ocupam espaço desnecessário
- Aplicar em textos já curtos Ignorar caracteres especiais e emojis
Erros Comuns
1. Não Considerar Palavras Completas
// ❌ Problemático
str_limit("Laravel Framework", 10); // "Laravel Fr..."
// ✅ Melhor abordagem
Str::words("Laravel Framework", 1); // "Laravel..."
2. Limites Inadequados
// ❌ Muito restritivo
str_limit($titulo, 15); // Pode cortar informações importantes
// ✅ Equilibrado
str_limit($titulo, 50); // Mantém contexto adequado
3. Não Validar Entrada
// ✅ Com validação
echo $muni->title ? str_limit($muni->title, 50) : 'Título não disponível';
Helper Personalizado para Compatibilidade
if (!function_exists('str_limit')) {
function str_limit($value, $limit = 100, $end = '...') {
return Str::limit($value, $limit, $end);
}
}
Conclusão
O helper str_limit()
do Laravel é uma ferramenta fundamental para controle de texto em aplicações web. Embora tenha sido substituído pelo Str::limit()
nas versões mais recentes, seu conceito permanece essencial para criar interfaces limpas e organizadas.