Filtros de HubL

Los filtros afectan la salida final de tu HubL. Pueden aplicarse a varias sentencias y expresiones de HubL para alterar el marcador de plantilla que emite el servidor.

La sintaxis básica de un filtro es |filtername. El filtro se agrega directamente a continuación de la sentencia o de la expresión, dentro de sus delimitadores. Algunos filtros tienen parámetros adicionales que se pueden agregar entre paréntesis. La sintaxis básica de un filtro con una cadena, un número y un parámetro booleano es: |filtername("stringParameter", 10, true). Ten en cuenta que los parámetros de cadena deben escribirse entre comillas. También hay que tener en cuenta que los filtros de HubL tienen un alias que puede ser utilizado para servir el mismo propósito que el filtro principal.

El siguiente artículo contiene todos los filtros HubL compatibles.

Obtiene el valor absoluto de un número Puedes usar este filtro para garantizar que un número sea positivo.

En el ejemplo siguiente, hay una variable que contiene una secuencia de tipos de frutas. El filtro por lotes se aplica a un bucle que itera a través de la secuencia. El bucle anidado se ejecuta tres veces para imprimir 3 tipos de fruta por fila, antes de que el bucle exterior se ejecute de nuevo. Observa en la salida final que, como sólo hay 5 tipos de fruta, el último elemento se sustituye por un &nbsp (el segundo parámetro).

El ejemplo siguiente muestra un filtro de centrado aplicado a una variable en una etiqueta pre, de modo que no se eliminan los espacios en blanco.

Escapa el contenido de una entrada de atributo HTML. Acepta una cadena y convierte los caracteres &, <, ‘, ” y escape_jinjava en secuencias seguras para HTML. Utiliza este filtro para las variables HubL que se están agregando a los atributos HTML.

Ten en cuenta que al escapar los valores de los atributos que aceptan URL, como href, debes usar el filtro escape_url en su lugar.

Calcula la distancia 2D elipsoidal entre dos puntos de la Tierra.

El filtro groupby agrupa una secuencia de objetos por un atributo en común. El parámetro establece el atributo común en agrupar por.

El filtro de sangría utiliza espacios en blanco para sangrar el texto dentro de una longitud de campo determinada. Este filtro no es recomendable ni especialmente útil, ya que el compilador HTML de HubSpot eliminará automáticamente los espacios en blanco; sin embargo, se incluye aquí en aras de la exhaustividad. El ejemplo siguiente muestra un filtro de centrado aplicado a una variable en una etiqueta pre, de modo que no se eliminan los espacios en blanco. El primer parámetro controla la cantidad de espacios en blanco y el segundo booleano cambia la sangría de la primera línea.

Convierte el valor en un entero. Si la conversión no funciona, devolverá 0. Puedes anular este valor predeterminado utilizando el primer parámetro.

Este filtro devuelve la intersección de dos conjuntos o listas. La lista devuelta por el filtro contiene todos los elementos únicos que están contenidos en ambas listas.

Se evalúa como verdadero si el valor es una dirección IPv4 o IPv6 válida.

Devuelve una cadena que es la concatenación de las cadenas de la secuencia. El separador entre elementos es una cadena vacía por opción predeterminada, puedes definirlo con el parámetro opcional. El segundo parámetro puede utilizarse para especificar un atributo a unir.

Devuelve el último elemento de una secuencia.

Devuelve el número de elementos de una secuencia o mapeo.

Convierte los valores numéricos en una lista. Si se trata de una cadena, la lista devuelta será una lista de caracteres. Para agregar cadenas a una secuencia, basta con agregarlas a las variables de cadena a los delimitadores de la secuencia [ ].

Calcula el logaritmo natural de un número.

Convertir un valor a todas las letras minúsculas.

Aplica un filtro a una secuencia de objetos o busca un atributo. Esto es útil cuando se trata con listas de objetos, pero en realidad sólo te interesa un valor determinado de la misma.

El uso básico es el mapeo en un atributo. Por ejemplo, si deseas utilizar la lógica condicional para comprobar si un valor está presente en un atributo particular de un dict. Alternativamente, puedes dejar que invoque un filtro pasando el nombre del filtro y los argumentos a continuación.

Calcula el hash md5 del objeto dado

Resta una cantidad de tiempo a un objeto datetime.

Multiplica un valor por un número. Funciona igual que el operador *.

Agrega una cantidad de tiempo a un objeto datetime.

Imprimir una variable. Esto imprime el tipo de variable y otra información útil para la depuración.

Devuelve un elemento aleatorio de la secuencia.

Busca un patrón de expresión regular y lo sustituye por una secuencia de caracteres. El primer argumento es un patrón de expresión regular estilo RE2, el segundo es la cadena de sustitución.

Puedes encontrar información sobre la sintaxis de expresiones regulares RE2 aquí.

Filtra una secuencia de objetos aplicando una prueba de expresión al objeto y rechazando los que tienen éxito en la prueba.

Filtra una secuencia de objetos aplicando una prueba a un atributo de un objeto y rechazando los que tienen éxito en la prueba. 

Renderiza cadenas que contienen HubL antes de tiempo para que la salida pueda ser pasada a otros filtros.

Reemplaza todas las instancias de una subcadena por una nueva. 

Invierte el objeto o devuelve un iterador que itera sobre él al revés. Para invertir una lista utiliza .reverse()

Extraer la raíz cuadrada de un valor

Redondea el número a una precisión determinada.

Marca el valor como seguro, lo que significa que en un entorno con el escape automático activado esta variable no será escapada.

Depura el contenido de una entrada HTML para la salida de contenido de texto enriquecido. Acepta una cadena y luego elimina las etiquetas HTML que no están permitidas. Utiliza este filtro para las variables HubL que se usan en HTML que deberían permitir HTML seguro.

Al utilizar este filtro, puedes incluir los siguientes parámetros para permitir tipos específicos de etiquetas HTML: FORMATTING, BLOCKS, STYLES, LINKS, TABLES, IMAGES. Por ejemplo, sanitize_html(IMAGES).

El uso de sanitize_html incluirá todos los parámetros en el filtro.

También puedes incluir un parámetro STRIP para eliminar todo el HTML. Todo el contenido se ejecuta a través de escape_jinjava también para evitar la interpretación anidada.

Filtra una secuencia de objetos aplicando una prueba al objeto y seleccionando sólo los que tienen éxito en la prueba.

Filtra una secuencia de objetos aplicando una prueba a un atributo de un objeto y seleccionando sólo los que tienen éxito en la prueba.

Aleatoriza el orden de iteración a través de una secuencia. El ejemplo siguiente mezcla un bucle de blog estándar.

Corta un iterador y devuelve una lista de listas que contienen esos elementos. El primer parámetro especifica cuántos elementos serán cortados, y el segundo parámetro especifica los caracteres para rellenar los cortes vacíos.

Ordena un iterable. Este filtro requiere que todos los parámetros se ordenen por un atributo en HubSpot. El primer parámetro es un booleano para invertir el orden de clasificación. El segundo parámetro determina si la ordenación distingue entre mayúsculas y minúsculas. Y el último parámetro especifica un atributo por el que ordenar. En el ejemplo siguiente, las entradas de un blog se representan y se ordenan alfabéticamente por nombre.

Divide la cadena de entrada en una lista en el separador dado. El primer parámetro especifica el separador entre el que se divide la variable. El segundo parámetro determina cuántas veces debe dividirse la variable. El resto de los artículos permanecerían en el grupo. En el ejemplo siguiente, una cadena de nombres se divide en el ";" para los 4 primeros nombres.

Convierte un tipo de variable diferente en una cadena. En el ejemplo siguiente, un número entero se convierte en una cadena (se utiliza pprint para confirmar el cambio de tipo de la variable).

Elimina las etiquetas SGML/XML y sustituye los espacios en blanco adyacentes por un espacio. Este filtro puede utilizarse para eliminar cualquier etiqueta HTML de una variable.

Convierte una cadena datetime y un formato datetime en un objeto datetime.

Agrega valores numéricos en una secuencia. El primer parámetro puede especificar un atributo opcional y el segundo parámetro establece un valor a devolver si no hay nada en la variable a sumar.

Este filtro devuelve la diferencia simétrica de dos conjuntos o listas. La lista devuelta por el filtro contiene todos los elementos únicos que están en la primera lista pero no en la segunda, o están en la segunda lista pero no en la primera

Devuelve una versión con título del valor. Es decir, las palabras comenzarán con letras mayúsculas, el resto de los caracteres son minúsculas.

Escribe un objeto como una cadena JSON.

Elimina los espacios en blanco iniciales y finales. HubSpot ya recorta los espacios en blanco del marcado, pero este filtro está documentado para que sea más completo.

Corta el texto después de un determinado número de caracteres. El valor predeterminado es 255. Ten en cuenta que los caracteres HTML se incluyen en este recuento. La longitud se especifica con el primer parámetro, que por opción predeterminada es 255. Si el segundo parámetro es verdadero, el filtro cortará el texto a lo largo. En caso contrario, descartará la última palabra. Si el texto se truncó, se agregará un signo de puntos suspensivos ("..."). Si quieres un signo de elipsis diferente a "..." puedes especificarlo usando el tercer parámetro.

Trunca una cadena dada, respetando el marcado html (es decir, cerrará correctamente todas las etiquetas anidadas). Esto evitará que una etiqueta permanezca abierta después del truncamiento. Los caracteres HTML no cuentan para el total de caracteres. Este filtro tiene un parámetro de longitud y un parámetro de símbolo de truncamiento. Hay un tercer parámetro booleano que especifica si las palabras se romperán a lo largo. Este parámetro es falso por opción predeterminada para preservar la longitud de las palabras. Si sólo utilizas uno de los parámetros opcionales, utiliza argumentos de palabra clave, como truncatehtml(70, breakwords = false).

Este filtro devuelve la unión de dos conjuntos o listas. La lista devuelta por el filtro contiene todos los elementos únicos que están en cualquiera de las dos listas.

Este filtro extrae un conjunto único de una secuencia o dictado de objetos. Al filtrar un dict, como una lista de mensajes devueltos por una función, puedes especificar qué atributo se utiliza para desduplicar los elementos en el dict.

Este filtro convierte un objeto datetime en una marca de tiempo de unix.

Convertir un valor a todas las letras mayúsculas.

Sal y codifica la URL de una cadena usando el formato UTF-8. Acepta tanto diccionarios como cadenas regulares, así como iterables por pares.

Decodifica las cadenas de URL codificadas de vuelta a la URL original. Acepta tanto diccionarios como cadenas regulares, así como iterables por pares.

Convierte direcciones URL en texto sin formato en enlaces en los que se puede hacer clic. Si le pasas al filtro un número entero adicional, acortará las URL a ese número. El segundo parámetro es un booleano que dicta si el enlace es rel="no follow". El último parámetro permite especificar si el enlace se abrirá en una nueva pestaña.

Cuenta el número de palabras de una cadena.

Ocasiona que las palabras se cierren con un número determinado de caracteres. Esto funciona mejor en un <pre> porque HubSpot elimina los espacios en blanco por opción predeterminada.

Crea una cadena de atributos HTML/XML, basada en los elementos de un dict. Todos los valores que no son ninguno
ni indefinidos se escapan automáticamente. Automáticamente antepone un espacio delante del elemento si el filtro devuelve algo, a menos que el primer parámetro sea falso.