markup is printed as text" %}
| {{ column }} | {% endfor %}
| apples | oranges | pears |
| grapes | blueberries |
{% set var = "string to center" %}
before{{ var|center(80) }}after
```
```html example.html theme={null}
before string to center after```
`, de modo que los espacios en blanco no se eliminen. El primer parámetro controla la cantidad de espacios en blanco y el segundo booleano cambia la sangría de la primera línea.```html example.html theme={null} | Parámetro | Tipo | Descripción | | -------------- | -------- | --------------------------------------------------------- | | `width` | Numérico | La cantidad de espacios en blanco que se aplicarán. | | `indent-first` | Booleano | Si se establece como `true`, se indenta la primera línea. | ## int Convierte el valor en un entero. Si la conversión no funciona, devolverá `0`. Puedes anular este valor predeterminado utilizando el primer parámetro.{% set var = "string to indent" %} {{ var|indent(2, true) }}``` ```text resultados renderizados.txt theme={null} string to indent ``````text hubl.txt theme={null} {% set string="25" %} {{ string|int + 17 }} ``` ```text resultados renderizados.txt theme={null} 42 ``` | Parámetro | Tipo | Descripción | | --------- | -------- | ----------------------------------------------- | | `default` | Numérico | Entero a devolver si la conversión no funciona. | ## intersect Este filtro devuelve la intersección de dos conjuntos o listas. La lista que el filtro devuelve contiene todos los elementos únicos que están contenidos en ambas listas.```text hubl.txt theme={null} {{ [1, 2, 3]|intersect([2, 3, 4, 5]) }} ``` ```text resultados renderizados.txt theme={null} [2, 3] ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ------------------------------------------------------------------------------------------ | | `list` | Matriz | La segunda lista con la que se comparará la lista original para encontrar su intersección. | ## ipaddr Se evalúa como `true` si el valor es una dirección IPv4 o IPv6 válida.```text hubl.txt theme={null} {% set ip = "1.0.0.1" %} {% if ip|ipaddr %} The string is a valid IP address {% endif %} ``` ```text resultados renderizados.txt theme={null} The string is a valid IP address ``` ## join 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 un parámetro opcional. El segundo parámetro puede utilizarse para especificar un atributo a unir.```text hubl.txt theme={null} {% set my_list = [1, 2, 3] %} {% set sep = "---" %} {{ my_list|join }} {{ my_list|join("|") }} {{ my_list|join(sep) }} ``` ```text resultados renderizados.txt theme={null} 123 1|2|3 1---2---3 ``` | Parámetro | Tipo | Descripción | | ----------- | ---------------- | ------------------------------------------------ | | `delimiter` | Cadena | El delimitador a utilizar al concatenar cadenas. | | `attribute` | Variable de HubL | Atributo de valor para unir en un objeto. | ## last Devuelve el último elemento de una secuencia.```text hubl.txt theme={null} {% set my_sequence = ["Item 1", "Item 2", "Item 3"] %} {% my_sequence|last %} ``` ```text resultados renderizados.txt theme={null} Item 3 ``` ## length Devuelve el número de elementos de una secuencia o estructura de datos.```text hubl.txt theme={null} {% set services = ["Web design", "SEO", "Inbound Marketing", "PPC"] %} {{ services|length }} ``` ```text resultados renderizados.txt theme={null} 4 ``` ## list Convierte los valores en una lista. Las cadenas se devolverán como caracteres separados a menos que estén contenidas en delimitadores de secuencia de corchetes `[ ]`.```text hubl.txt theme={null} {% set one = 1 %} {% set two = 2 %} {% set three = "three" %} {% set four = ["four"] %} {% set list_num = one|list + two|list + three|list + four|list %} {{ list_num }} ``` ```text resultados renderizados.txt theme={null} [1, 2, t, h, r, e, e, four] ``` ## log Calcula el logaritmo natural de un número.```text hubl.txt theme={null} {{ 10|log }} {{ 65536|log(2) }} ``` ```text resultados renderizados.txt theme={null} 2.302585092994046 16.0 ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ----------------------------------------------- | | `base` | Número | La base a utilizar para el cálculo logarítmico. | ## lower Convierte todas las letras de un valor a minúsculas.```text hubl.txt theme={null} {% set text="Text to MAKE LowercaSe" %} {{ text|lower }} ``` ```text resultados renderizados.txt theme={null} text to make lowercase ``` ## map Aplica un filtro a una secuencia de objetos o busca un atributo. Este filtro es especialmente útil cuando trabajas con listas de objetos y solo necesitas obtener un valor en particular. El uso básico es la asignación 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 dicc. Como alternativa, puedes permitir que aplique un filtro pasando el nombre del filtro seguido de los argumentos.```text hubl.txt theme={null} {# Usage 1 #} Apply a filter to a sequence: {% set seq = ["item1", "item2", "item3"] %} {{ seq|map("upper") }} {# Usage 2 #} Look up an attribute: {{ content|map("currentState")}} ``` ```text resultados renderizados.txt theme={null} Apply a filter to a sequence: [ITEM1, ITEM2, ITEM3] Look up an attribute: [DRAFT] ``` | Parámetro | Tipo | Descripción | | --------- | ------------------------------------------- | ----------- | | `filter` | Filtro a aplicar a la secuencia de objetos. | | ## md5 Calcula el [hash md5](https://en.wikipedia.org/wiki/MD5) del objeto dado.```text hubl.txt theme={null} {{ content.absolute_url|md5 }} ``` ```text resultados renderizados.txt theme={null} 923adb4ce05a4c6342c04c80be88d15e ``` ## minus\_time Resta una cantidad de tiempo a un objeto de fecha y hora.```text hubl.txt theme={null} {% set date = "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %} {{ date }} {{ date|minus_time(2, "months") }} ``` ```text resultados renderizados.txt theme={null} 2018-07-14 14:31:30 2018-05-14 14:31:30 ``` | Parámetro | Tipo | Descripción | | ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `diff` | Numérico | Cantidad a restar. | | `timeunit` | Cadena | Las unidades de tiempo válidas son `nanos` , `micros` , `millis` , `seconds` , `minutes` , `hours` , `half_days` , `days` , `weeks` , `months` , `years` , `decades` , `centuries` , `millennia` y `eras` . | ## multiply Multiplica un valor por un número. Funciona igual que el [\ operador \*](/cms/reference/hubl/operators-and-expression-tests).```text hubl.txt theme={null} {% set n = 20 %} {{ n|multiply(3) }} ``` ```text resultados renderizados.txt theme={null} 60 ``` ## plus\_time Agrega una cantidad de tiempo a un objeto de fecha y hora.```text hubl.txt theme={null} {% set date = "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %} {{ date }} {{ date|plus_time(5, "days") }} ``` ```text resultados renderizados.txt theme={null} 2018-07-14 14:31:30 2018-07-19 14:31:30 ``` | Parámetro | Tipo | Descripción | | ---------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `diff` | Numérico | Cantidad a restar. | | `timeunit` | Cadena | Las unidades de tiempo válidas son `nanos` , `micros` , `millis` , `seconds` , `minutes` , `hours` , `half_days` , `days` , `weeks` , `months` , `years` , `decades` , `centuries` , `millennia` y `eras` . | ## pprint Muestra una variable con formato legible. Muestra el tipo de variable y otra información útil para la depuración.```text hubl.txt theme={null} {% set this_var ="Variable that I want to debug" %} {{ this_var|pprint }} ``` ```text resultados renderizados.txt theme={null} (String: Variable that I want to debug) ``` ## random Devuelve un elemento aleatorio de la secuencia.### Nota: Cuando uses este filtro, la página se [prerrenderizará](/cms/best-practices/testing-staging-performance/prerendering) periódicamente en lugar de cada vez que se actualice el contenido de la página. Esto significa que el contenido filtrado no se actualizará cada vez que se cargue la página de nuevo. Esto puede no ser un problema para ciertos tipos de contenido, como mostrar una lista aleatoria de publicaciones de blog. Sin embargo, si necesitas que el contenido cambie al azar cada vez que se carga una página, deberías usar JavaScript para mostrar de forma aleatoria el contenido del lado del cliente. ```text hubl.txt theme={null} {% for content in contents|random %} ## regex\_replace 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. Más información sobre [la sintaxis regex RE2](https://github.com/google/re2/wiki/Syntax).Post item markup{% endfor %} ``` ```text resultados renderizados.txt theme={null}Random post``````text hubl.txt theme={null} {{ "contact-us-2"|regex_replace("[^a-zA-Z]", "") }} ``` ```text resultados renderizados.txt theme={null} contactus ``` ## reject Filtra una secuencia de objetos aplicando una [prueba de expresión](/cms/reference/hubl/operators-and-expression-tests) al objeto y rechazando los que tienen éxito en la prueba.```text hubl.txt theme={null} {% set some_numbers = [10, 12, 13, 3, 5, 17, 22] %} {{ some_numbers|reject("even") }} ``` ```text resultados renderizados.txt theme={null} [13, 3, 5, 17] ``` | Parámetro | Tipo | Descripción | | ---------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- | | `exp_text` | Cadena | El nombre de la [prueba de expresión](/cms/reference/hubl/operators-and-expression-tests#expression-tests) que se aplicará al objeto. | ## rejectattr Filtra una secuencia de objetos aplicando una prueba a un atributo de un objeto y rechazando los que tienen éxito en la prueba.```html example.html theme={null} {% for content in contents|rejectattr("post_list_summary_featured_image") %} | Parámetro | Tipo | Descripción | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- | | `attribute_name` | Cadena | Especifica el atributo a seleccionar. Puedes acceder a los atributos anidados utilizando la notación de puntos. | | `exp_test` | Cadena | el nombre de la [prueba de expresión](/cms/reference/hubl/operators-and-expression-tests#expression-tests) que se aplicará al objeto. | ## render Procesa cadenas que contienen HubL de manera anticipada para que el resultado pueda pasarse a otros filtros.{% if content.post_list_summary_featured_image %}{% endfor %} ``` ```html example.html theme={null}{% endif %} {{ content.post_list_content|safe }}
Post with no featured imagePost with no featured imagePost with no featured image``````html example.html theme={null} {{ personalization_token("contact.lastname", "default value")|render|lower }} ``` ```html example.html theme={null} mclaren ``` ## replace Reemplaza todas las instancias de una subcadena por una nueva.```html example.html theme={null} {% if topic %} | Parámetro | Tipo | Descripción | | --------- | ------ | --------------------------------------------------------------- | | `old` | Cadena | La subcadena que se debe reemplazar. | | `new` | Cadena | La subcadena que será reemplazada. | | `count` | Número | Si se proporciona, solo se reemplazan las primeras ocurrencias. | ## reverse Revierte el objeto o devuelve un iterador que recorre el objeto en sentido inverso. Para invertir una lista utiliza [.reverse()](/cms/reference/hubl/functions#reverse)Posts about {{ page_meta.html_title|replace("Blog | ", "") }}
{% endif %} ``` ```html example.html theme={null}Posts about topic name
``````text hubl.txt theme={null} {% set nums = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] %} {% for num in nums|reverse %} {{ num }} {% endfor %} ``` ```text resultados renderizados.txt theme={null} 10 9 8 7 6 5 4 3 2 1 ``` ## root Extrae la raíz cuadrada de un valor.```text hubl.txt theme={null} {{ 16|root }} {{ 625|root(4) }} ``` ```text resultados renderizados.txt theme={null} 4 5 ``` | Parámetro | Tipo | Descripción | | ---------- | ------ | ------------------------------------------- | | `nth_root` | Número | La raíz enésima a utilizar para el cálculo. | ## round Redondea un número con la precisión especificada.```text hubl.txt theme={null} {{ 52.5|round }} {{ 52.5|round(0, "floor") }} ``` ```text resultados renderizados.txt theme={null} 53 52 ``` | Parámetro | Tipo | Descripción | | ----------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `precision` | Número | Especifica la precisión del redondeo. | | `rounding_method` | `'common'` (predeterminado) \| `'ceil'` \| `'floor'` | las opciones incluyen `common` redondea hacia arriba o hacia abajo (predeterminado); `ceil` siempre redondea hacia arriba; `floor` siempre redondea hacia abajo. | ## safe Marca el valor como seguro, lo que evita que se escape en entornos con escape automático activado.```text hubl.txt theme={null} {{ content.post_list_content|safe }} ``` ```html example.html theme={null} ## sanitize\_html 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 y que deberían permitir un HTML seguro. Puedes incluir los siguientes parámetros para permitir los específicos tipos 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 también se ejecuta mediante `escape_jinjava` para evitar la interpretación anidada.HTML post content that is not escaped.
``````text hubl.txt theme={null} {% set escape_string = "This ## select Filtra una secuencia de objetos aplicando una prueba al objeto y seleccionando solo los que tienen éxito en la prueba.
markup is" %} {{ escape_string|sanitize_html("IMAGES") }} ``` ```html example.html theme={null} This markup isprinted as text.
```text hubl.txt theme={null} {% set some_numbers = [10, 12, 13, 3, 5, 17, 22] %} {{ some_numbers|select("even") }} ``` ```html example.html theme={null} [10, 12, 22] ``` | Parámetro | Tipo | Descripción | | ---------- | ------ | ------------------------------------------------- | | `exp_text` | Cadena | La prueba de expresión que se aplicará al objeto. | ## selectattr Filtra una secuencia de objetos aplicando una prueba a un atributo de un objeto y seleccionando solo los que tienen éxito en la prueba.```html example.html theme={null} {% for content in contents|selectattr("post_list_summary_featured_image") %} | Parámetro | Tipo | Descripción | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------- | | `attribute_name` | Cadena | El atributo que debe ponerse a prueba. Puedes acceder a los atributos anidados utilizando la notación de puntos. | | `exp_test` | Cadena | el nombre de la [prueba de expresión](/cms/reference/hubl/operators-and-expression-tests#expression-tests) que se aplicará al objeto. | | `val` | Cadena | Valor a comprobar. | ## shuffle Organiza de forma aleatoria el orden de iteración a través de una secuencia. El siguiente ejemplo mezcla un bucle de blog estándar.{% if content.post_list_summary_featured_image %}{% endfor %} ``` ```html example.html theme={null}{% endif %} {{ content.post_list_content|safe }}```Post with featured image
### Nota: Cuando uses este filtro, la página se [prerrenderizará](/cms/best-practices/testing-staging-performance/prerendering) periódicamente en lugar de cada vez que se actualice el contenido de la página. Esto significa que el contenido filtrado no se actualizará cada vez que se cargue la página de nuevo. Esto puede no ser un problema para ciertos tipos de contenido, como mostrar una lista aleatoria de publicaciones de blog. Sin embargo, si necesitas que el contenido cambie al azar cada vez que se carga una página, deberías usar JavaScript para mostrar de forma aleatoria el contenido del lado del cliente. ```html example.html theme={null} {% for content in contents|shuffle %} ## slice 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.Markup of each post{% endfor %} ``` ```html example.html theme={null}Markup of each post 5Markup of each post 3Markup of each post 1Markup of each post 2Markup of each post 4``````html example.html theme={null} {% set items = ["laptops", "tablets", "smartphones", "smart watches", "TVs"] %} | Parámetro | Tipo | Descripción | | --------- | -------- | ---------------------------------------------------------- | | `slices` | Numérico | Cuántos artículos se cortarán. | | `filler` | Cadena | Especifica los caracteres para rellenar los cortes vacíos. | ## sort 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 y el segundo parámetro determina si el orden distingue entre mayúsculas y minúsculas. El último parámetro especifica un atributo por el que ordenar. En el siguiente ejemplo, las entradas de un blog se representan y se ordenan alfabéticamente por nombre.{% for column in items|slice(3," ") %}``` ```html example.html theme={null}{% for item in column %}
{% endfor %}- {{ item }}
{% endfor %}```
- laptops
- tablets
- smartphones
- smart watches
- TVs
```html example.html theme={null} {% set my_posts = blog_recent_posts("default", limit=5) %} {% for item in my_posts|sort(False, False, "name") %} {{ item.name }} | Parámetro | Tipo | Descripción | | ---------------- | -------- | --------------------------------------------------------------------------------- | | `reverse` | Booleano | Establécelo como `true` para invertir el orden de clasificación. | | `case_sensitive` | Booleano | Establécelo como `true` para que el orden distinga entre mayúsculas y minúsculas. | | `attribute` | Cadena | Atributo por el que ordenar. Puedes omitirlo al ordenar una lista. | ## split Divide la cadena de entrada en una lista usando el separador indicado. El primer parámetro especifica el separador entre el que se divide la variable y el segundo parámetro determina cuántas veces debe dividirse la variable. El resto de los artículos permanecerán en el grupo. En el siguiente ejemplo, una cadena de nombres se divide en el `;` para los primeros cuatro nombres.
{% endfor %} ``` ```html example.html theme={null} A post
B post
C post
D post
E post
``````html example.html theme={null} {% set string_to_split = "Mark; Irving; Helly; Dylan; Milchick; Harmony;" %} {% set names = string_to_split|split(";", 4) %} | Parámetro | Tipo | Descripción | | ----------------------- | ------ | --------------------------------------------------------------------------------------------------- | | `character_to_split_by` | Cadena | Especifica el separador entre el que se divide la variable. | | `number_of_splits` | Número | Determina cuántas veces debe dividirse la variable. Los elementos restantes permanecerán agrupados. | ## string Convierte un tipo de variable diferente en una cadena. En el siguiente ejemplo, un número entero se convierte en una cadena (se utiliza `pprint` para confirmar el cambio de tipo de la variable).{% for name in names %}
``` ```html example.html theme={null}- {{ name }}
{% endfor %}```
- Mark
- Irving
- Helly
- Dylan; Milchick; Harmony;
```text hubl.txt theme={null} {% set number_to_string = 45 %} {{ number_to_string|string|pprint }} ``` ```text resultados renderizados.txt theme={null} (String: 45) ``` ## striptags Elimina las etiquetas SGML y XML, y reemplaza los espacios en blanco adyacentes por un espacio. Este filtro puede utilizarse para eliminar cualquier etiqueta HTML de una variable.```html example.html theme={null} {% set some_html = " ## strtodate Convierte una cadena y un formato de fecha en un objeto de fecha.Some text" %} {{ some_html|striptags }} ``` ```html example.html theme={null} some text ``````text hubl.txt theme={null} {{ '3/3/21'|strtodate('M/d/yy') }} ``` ```text resultados renderizados.txt theme={null} 2021-03-03 00:00:00 ``` | Parámetro | Tipo | Descripción | | ------------ | ------ | ------------------------------------------------------------------------------------------------------------ | | `dateFormat` | Cadena | El [formato de fecha](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html) a utilizar. | ## strtotime Convierte una cadena de fecha y hora y un formato datetime en un objeto de fecha y hora.```text hubl.txt theme={null} {{ "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ")|unixtimestamp }} ``` ```text resultados renderizados.txt theme={null} 1531558890000 ``` | Parámetro | Tipo | Descripción | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------- | | `datetimeFormat` | Cadena | El [formato de fecha y hora](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html) a utilizar. | ## sum 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.```text hubl.txt theme={null} // Simple sum {% set sum_this = [1, 2, 3, 4, 5] %} {{ sum_this|sum }} // Sum of attribute {% set items = [15, 10] %} {% set dict_var = [{"name": "Item1", "price": "20"}, {"name": "Item2", "price": "10"}] %} Total: {{ dict_var|sum(attribute="price") }} ``` ```text resultados renderizados.txt theme={null} 15 Total: 30 ``` | Parámetro | Tipo | Descripción | | ------------------- | ------ | ------------------------------------------------------- | | `attribute` | Cadena | Atributo a sumar. | | `return_if_nothing` | Cadena | Valor a devolver si no hay nada en la variable a sumar. | ## symmetric\_difference Este filtro devuelve la diferencia simétrica de dos conjuntos o listas. La lista que el filtro devuelve 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.```text hubl.txt theme={null} {{ [1, 2, 3]|symmetric_difference([2, 3, 4, 5]) }} ``` ```text resultados renderizados.txt theme={null} [1, 4, 5] ``` | Parámetro | Tipo | Descripción | | --------- | ------ | -------------------------------------------------------------------------------------------------- | | `list` | Matriz | La segunda lista con la que comparar para encontrar la diferencia simétrica con la lista original. | ## title Devuelve una versión del valor en formato de título (es decir, las palabras comenzarán con letras mayúsculas y el resto de los caracteres estarán en minúsculas).```text hubl.txt theme={null} {% set my_title="my title should be title case" %} {{ my_title|title }} ``` ```text resultados renderizados.txt theme={null} My Title Should Be Title Case ``` ## tojson Escribe un objeto como una cadena JSON.```text hubl.txt theme={null} {% for content in contents %} {{ content.blog_post_author|tojson }} {% endfor %} ``` ```json example.json theme={null} { "portalId": 1234567, "id": 12312253109, "created": 1566413741989, "updated": 1566414012799, "deletedAt": 0, "fullName": "Sample User", "email": "sampleUser@example.com", "userId": null, "username": null, "slug": "sample-user", "jsonBody": { "avatar": "https://app.hubspot.com/settings/avatar/109d6874a0cb066c1c7263ac5df6ce7a", "bio": "Sample Bio", "facebook": "", "linkedin": "", "twitter": "", "website": "https://www.hubspot.com" }, "bio": "Sample Bio", "facebook": "", "linkedin": "", "avatar": "https://app.hubspot.com/settings/avatar/109d6874a0cb066c1c7263ac5df6ce7a", "gravatarUrl": "https://app.hubspot.com/settings/avatar/108bb5ac667ded34796271437dfe8d58", "twitterUsername": "", "hasSocialProfiles": false, "website": "https://www.hubspot.com", "twitter": "", "displayName": "Sample User" } ``` ## trim 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.```text hubl.txt theme={null} {{ " remove whitespace " }} {{ " remove whitespace "|trim }} ``` ```text resultados renderizados.txt theme={null} remove whitespace remove whitespace ``` ## truncate Corta el texto después de un determinado número de caracteres. El valor predeterminado es 255. Los caracteres HTML se incluyen en este conteo.**Nota:** ya que este filtro depende de los espacios entre palabras para acortar las cadenas, es posible que no funcione correctamente en idiomas que no los utilizan, como el japonés. ```text hubl.txt theme={null} {{ "I only want to show the first sentence. Not the second."|truncate(40) }} {{ "I only want to show the first sentence. Not the second."|truncate(35, true, "..........") }} ``` ```text resultados renderizados.txt theme={null} I only want to show the first sente.......... ``` | Parámetro | Tipo | Descripción | | ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------- | | `number_of_characters` | Número | Número de caracteres permitidos antes de cortar el texto. Por opción predeterminada es 255. | | `breakword` | Booleano | Si es `true`, el filtro cortará el texto a lo largo. En el caso contrario, si es `false`, se descartará la última palabra. | | `end` | Cadena | Anula los caracteres finales '...' predeterminados después del corte. | ## truncatehtml Corta una cadena, respetando el marcado HTML (es decir, cerrará correctamente todas las etiquetas anidadas). Esto evitará que una etiqueta permanezca abierta después del corte. Los caracteres HTML no cuentan en el total de caracteres.**Nota:** ya que este filtro depende de los espacios entre palabras para acortar las cadenas, es posible que no funcione correctamente en idiomas que no los utilizan, como el japonés. ```html example.html theme={null} {% set html_text = " | Parámetro | Tipo | Descripción | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `number_of_characters` | Número | Número de caracteres permitidos antes de cortar el texto. Por opción predeterminada es 255. | | `end` | Cadena | Anula los caracteres finales '...' predeterminados después del corte. | | `breakword` | Booleano | Valor booleano. Si es `true`, el filtro cortará el texto a lo largo. Si es `false` (predeterminado), se descartará la última palabra. Si solo utilizas uno de los parámetros opcionales, utiliza argumentos de palabra clave, como`truncatehtml(70, breakwords = false)`. | ## unescape\_html Convierte texto con entidades codificadas en HTML a sus equivalentes en Unicode.I want to truncate this text without breaking my HTML
" %} {{ html_text|truncatehtml(28, "..." , false) }} ``` ```html example.html theme={null}
I want to truncate this..
``````text hubl.txt theme={null} {% set escape_string = "me & you" %} {{ escape_string|unescape_html }} ``` ```text resultados renderizados.txt theme={null} me & you ``` ## union Este filtro devuelve la unión de dos conjuntos o listas. La lista que el filtro devuelve contiene todos los elementos únicos que están en cualquiera de las dos listas.```text hubl.txt theme={null} {{ [1, 2, 3]|union([2, 3, 4, 5]) }} ``` ```text resultados renderizados.txt theme={null} [1, 2, 3, 4, 5] ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ---------------------------------------------- | | `list` | Matriz | La segunda lista a unir con la lista original. | ## unique Este filtro extrae un conjunto único de una secuencia o dicc. de objetos. Al filtrar un dicc., como una lista de mensajes devueltos por una función, puedes especificar qué atributo se utiliza para desduplicar los elementos en el dicc.```text hubl.txt theme={null} {% set my_sequence = ["one", "one", "two", "three" ] %} {{ my_sequence|unique }} ``` ```text resultados renderizados.txt theme={null} [one, two, three] ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ----------------------------------------------------------------------- | | `attr` | Cadena | Especifica el atributo que debe utilizarse al filtrar un valor de dicc. | ## unixtimestamp Este filtro convierte un objeto de fecha y hora en una marca de tiempo Unix.### Nota: Este filtro debe usarse únicamente con variables que devuelvan una fecha. A partir del 30 de septiembre de 2024, este filtro ya no devolverá la fecha actual cuando se pase un valor nulo. Después de esa fecha, un valor nulo en el filtro devolverá el `September 30, 2024`. ```text hubl.txt theme={null} {{ local_dt }} {{ local_dt|unixtimestamp }} ``` ```text resultados renderizados.txt theme={null} 2017-01-30 17:11:44 1485814304000 ``` ## upper Convierte todas las letras de un valor a mayúsculas.```text hubl.txt theme={null} {% set text="text to make uppercase" %} {{ text|upper }} ``` ```text resultados renderizados.txt theme={null} TEXT TO MAKE UPPERCASE ``` ## urlencode Escapa y codifica la URL de una cadena usando el formato UTF-8. Acepta tanto diccionarios como cadenas regulares, así como iterables por pares.```text hubl.txt theme={null} {% set encode_value="Escape & URL encode this string" %} {{ encode_value|urlencode }} ``` ```text resultados renderizados.txt theme={null} Escape+%26+URL+encode+this+string ``` ## urldecode Decodifica las cadenas de URL codificadas de vuelta a la URL original. Acepta tanto diccionarios como cadenas regulares, así como iterables por pares.```text hubl.txt theme={null} {% set decode_value="Escape+%26+URL+decode+this+string" %} {{ decode_value|urldecode }} ``` ```text resultados renderizados.txt theme={null} Escape & URL decode this string ``` ## urlize Convierte direcciones URL en texto sin formato a 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. | Parámetro | Tipo | Descripción | | ----------------- | -------- | ------------------------------------------------------------------ | | `shorten_text` | Número | Número entero que acortará las URL al número deseado. | | `no_follow` | Booleano | Si se establece como `true`, el enlace incluirá `rel="no follow"`. | | `target="_blank"` | Cadena | Especifica si el enlace se abrirá en una pestaña nueva. |```text hubl.txt theme={null} {{ "http://hubspot.com/"|urlize }} {{ "http://hubspot.com/"|urlize(10,true) }} {{ "http://hubspot.com/"|urlize("",true) }} {{ "http://hubspot.com/"|urlize("",false,target="_blank") }} ``` ```html example.html theme={null} http://hubspot.com/ http://... http://hubspot.com/ http://hubspot.com/ ``` ## wordcount Cuenta el número de palabras de una cadena.Si la cadena contiene HTML, utiliza el filtro `striptags` para obtener un recuento preciso. ```text hubl.txt theme={null} {% set count_words = "Count the number of words in this variable" %} {{ count_words|wordcount }} ``` ```text resultados renderizados.txt theme={null} 8 ``` ## wordwrap Hace que las palabras se cierren al llegar a un número determinado de caracteres. Esto funciona mejor en una etiqueta `` porque HubSpot elimina los espacios en blanco de manera predeterminada.```text hubl.txt theme={null} {% set wrap_text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam efficitur, ipsum non sagittis euismod, ex risus rhoncus lectus, vel maximus leo enim sit amet dui. Ut laoreet ultricies quam at fermentum." %} {{ wrap_text|wordwrap(10) }} ``` ```text resultados renderizados.txt theme={null} Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam efficitur, ipsum non sagittis euismod, ex risus rhoncus lectus, vel maximus leo enim sit amet dui. Ut laoreet ultricies quam at fermentum. ``` | Parámetro | Descripción | | ----------------- | --------------------------------------------- | | `character_count` | Número de caracteres para cerar el contenido. | ## xmlattr Crea una cadena de atributos HTML y XML, basada en los elementos de un dicc. Todos los valores que no sean nulos ni indefinidos se escapan automáticamente. Antepone un espacio al elemento si el filtro devuelve algún valor, a menos que el primer parámetro sea falso.```html example.html theme={null} {% set html_attributes = {"class": "bold", "id": "sidebar"} %} ``` ```html example.html theme={null} ``` | Parámetro | Tipo | Descripción | | ----------- | -------- | -------------------------------------------------------------------- | | `autospace` | Booleano | Establécelo como `true` para añadir un espacio delante del elemento. |
