[SPIP] PUBLIE : |identifiant_slug

SPIP

Article validé

L’article « |identifiant_slug » vient d’être publié par Ricardo Porto.


|identifiant_slug

quinta-feira 6 de Março de 2025, por Ricardo Porto

Esta função permite transformar um texto claro em nome curto que pode ser usado como identificador, classe CSS, id HTML ou URL.

Para isso, remove os acentos, conservando apenas os caracteres alfanuméricos, remove os outros caracteres e os substitui por um separador ’_’ por padrão, excepto no início e no fim.

Exemplo:

[(#VAL{Olá! O verão está a chegar!}|identifiant_slug)]` devolve  `olal_o_verao_esta_a_chegar

O filtro aceita dois argumentos opcionais:

um tipo: se o tipo for ’id’, ’class’ ou ’anchor’, a string é pré-fixada para o caso em que começa por um número, para gerar uma string válida para ser usada nesse atributo HTML.

uma matriz de opções que aceita três chaves possíveis:

  • separateur: o caracter separador
  • longueur_maxi: o comprimento máximo da string devolvida
  • longueur_mini: o comprimento mínimo da string devolvida. Se for demasiado curta, a string é completada até o comprimento mínimo por caracteres do md5 da string recebida. O objetivo é que a string devolvida seja única.

Exemplo:

<div [id="(#TITRE|identifiant_slug{id,#ARRAY{longueur_maxi,10}})"]>
  #TEXTE
</div>

— Enviado por SPIP