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```
`, para que o espaço em branco não seja removido. O primeiro parâmetro controla a quantidade de espaços em branco e o segundo booleano alterna se a primeira linha deve ser recuada.```html example.html theme={null} | Parâmetro | Tipo | Descrição | | -------------- | -------- | ----------------------------------------------------------- | | `width` | Número | A quantidade de espaço em branco a ser aplicada. | | `indent-first` | Booleano | Quando definido para `true`, a primeira linha será recuada. | ## int Converte o valor em um inteiro. Se a conversão não funcionar, ela retornará `0`. Você pode substituir esse padrão usando o primeiro parâmetro.{% set var = "string to indent" %} {{ var|indent(2, true) }}``` ```text saída renderizada.txt theme={null} string to indent ``````text hubl.txt theme={null} {% set string="25" %} {{ string|int + 17 }} ``` ```text saída renderizada.txt theme={null} 42 ``` | Parâmetro | Tipo | Descrição | | --------- | ------ | ----------------------------------------------------- | | `default` | Número | Inteiro a ser retornado se a conversão não funcionar. | ## intersect Retorna a interseção de dois conjuntos ou listas. A lista retornada pelo filtro contém todos os elementos únicos que estão contidos em ambas as listas.```text hubl.txt theme={null} {{ [1, 2, 3]|intersect([2, 3, 4, 5]) }} ``` ```text saída renderizada.txt theme={null} [2, 3] ``` | Parâmetro | Tipo | Descrição | | --------- | --------- | ----------------------------------------------------------------------------------------------------- | | `list` | Variedade | A segunda lista a ser comparada para uso na descoberta de onde a lista se cruza com a lista original. | ## ipaddr Avalia para `true` se o valor for um endereço IPv4 ou IPv6 válido.```text hubl.txt theme={null} {% set ip = "1.0.0.1" %} {% if ip|ipaddr %} The string is a valid IP address {% endif %} ``` ```text saída renderizada.txt theme={null} The string is a valid IP address ``` ## join Retorna uma string que é a concatenação das strings na sequência. O separador entre os elementos é uma string vazia por padrão. Você pode defini-la com o parâmetro opcional. O segundo parâmetro pode ser usado para especificar um atributo para 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 saída renderizada.txt theme={null} 123 1|2|3 1---2---3 ``` | Parâmetro | Tipo | Descrição | | ----------- | ------------- | ------------------------------------------------ | | `delimiter` | String | O delimitador a ser usado ao concatenar strings. | | `attribute` | Variável HubL | Atributo de valor a ser unido em um objeto. | ## last Retorna o último item de uma sequência.```text hubl.txt theme={null} {% set my_sequence = ["Item 1", "Item 2", "Item 3"] %} {% my_sequence|last %} ``` ```text saída renderizada.txt theme={null} Item 3 ``` ## length Retorna o número de itens de uma sequência ou mapeamento.```text hubl.txt theme={null} {% set services = ["Web design", "SEO", "Inbound Marketing", "PPC"] %} {{ services|length }} ``` ```text saída renderizada.txt theme={null} 4 ``` ## list Converte valores em uma lista. As strings serão retornadas como caracteres separados, a menos que estejam contidas em delimitadores de sequência de colchetes `[ ]`.```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 saída renderizada.txt theme={null} [1, 2, t, h, r, e, e, four] ``` ## log Calcula o logaritmo natural de um número.```text hubl.txt theme={null} {{ 10|log }} {{ 65536|log(2) }} ``` ```text saída renderizada.txt theme={null} 2.302585092994046 16.0 ``` | Parâmetro | Tipo | Descrição | | --------- | ------ | ----------------------------------------------- | | `base` | Número | A base a ser usada para o cálculo do logaritmo. | ## lower Converte todas as letras de um valor em minúsculas.```text hubl.txt theme={null} {% set text="Text to MAKE LowercaSe" %} {{ text|lower }} ``` ```text saída renderizada.txt theme={null} text to make lowercase ``` ## map Aplica um filtro em uma sequência de objetos ou procura um atributo. Isso é útil ao lidar com uma lista de objetos em que você está interessado apenas em um determinado valor. Geralmente, é usado para mapear um atributo. Por exemplo, se você quiser usar a lógica condicional para verificar se um valor está presente em um determinado atributo de um dicionário. Como alternativa, você pode deixá-lo invocar um filtro, passando o nome do filtro e os argumentos depois.```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 saída renderizada.txt theme={null} Apply a filter to a sequence: [ITEM1, ITEM2, ITEM3] Look up an attribute: [DRAFT] ``` | Parâmetro | Tipo | Descrição | | --------- | ------ | --------------------------------------------- | | `filter` | String | Filtro a ser aplicado à sequência de objetos. | ## md5 Calcula o [hash md5](https://en.wikipedia.org/wiki/MD5) do objeto fornecido.```text hubl.txt theme={null} {{ content.absolute_url|md5 }} ``` ```text saída renderizada.txt theme={null} 923adb4ce05a4c6342c04c80be88d15e ``` ## minus\_time Subtrai uma quantidade de tempo de um objeto datetime.```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 saída renderizada.txt theme={null} 2018-07-14 14:31:30 2018-05-14 14:31:30 ``` | Parâmetro | Tipo | Descrição | | ---------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `diff` | Número | Quantidade a subtrair. | | `timeunit` | String | As unidades de tempo válidas são `nanos`, `micros`, `millis`, `seconds`, `minutes`, `hours`, `half_days`, `days`, `weeks`, `months`, `years`, `decades`, `centuries`, `millennia`, e `eras`. | ## multiply Multiplica um valor por um número. Funciona da mesma forma que o [operador \*](/cms/reference/hubl/operators-and-expression-tests).```text hubl.txt theme={null} {% set n = 20 %} {{ n|multiply(3) }} ``` ```text saída renderizada.txt theme={null} 60 ``` ## plus\_time Adiciona uma quantidade de tempo a um objeto de data/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 saída renderizada.txt theme={null} 2018-07-14 14:31:30 2018-07-19 14:31:30 ``` | Parâmetro | Tipo | Descrição | | ---------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `diff` | Número | Quantidade a subtrair. | | `timeunit` | String | As unidades de tempo válidas são `nanos`, `micros`, `millis`, `seconds`, `minutes`, `hours`, `half_days`, `days`, `weeks`, `months`, `years`, `decades`, `centuries`, `millennia`, e `eras`. | ## pprint Imprime uma variável. Imprime o tipo de variável e outras informações úteis para a depuração.```text hubl.txt theme={null} {% set this_var ="Variable that I want to debug" %} {{ this_var|pprint }} ``` ```text saída renderizada.txt theme={null} (String: Variable that I want to debug) ``` ## random Retorna um item aleatório da sequência.### Observação: Ao usar este filtro, a página será [pré-renderizada](/cms/best-practices/testing-staging-performance/prerendering) periodicamente, em vez de sempre que o conteúdo da página for atualizado. Isso significa que o conteúdo filtrado não será atualizado em cada recarga de página. Isso pode não ser um problema para certos tipos de conteúdo, como exibir uma lista aleatória de posts de blog. No entanto, se você precisar que o conteúdo seja alterado aleatoriamente em cada carregamento de página, use o JavaScript para randomizar o conteúdo do lado do cliente. ```text hubl.txt theme={null} {% for content in contents|random %} ## regex\_replace Procura um padrão regex e o substitui por uma sequência de caracteres. O primeiro argumento é um padrão regex no estilo RE2; o segundo é a string de substituição. Saiba mais sobre [Sintaxe regex RE2](https://github.com/google/re2/wiki/Syntax).Post item markup{% endfor %} ``` ```text saída renderizada.txt theme={null}Random post``````text hubl.txt theme={null} {{ "contact-us-2"|regex_replace("[^a-zA-Z]", "") }} ``` ```text saída renderizada.txt theme={null} contactus ``` ## reject Filtra uma sequência de objetos aplicando um [teste de expressão](/cms/reference/hubl/operators-and-expression-tests) ao objeto e rejeitando aqueles que passaram com sucesso no teste.```text hubl.txt theme={null} {% set some_numbers = [10, 12, 13, 3, 5, 17, 22] %} {{ some_numbers|reject("even") }} ``` ```text saída renderizada.txt theme={null} [13, 3, 5, 17] ``` | Parâmetro | Tipo | Descrição | | ---------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | `exp_text` | String | O nome do [teste de expressão](/cms/reference/hubl/operators-and-expression-tests#expression-tests) para aplicar ao objeto. | ## rejectattr Filtra uma sequência de objetos aplicando um teste a um atributo de um objeto e rejeitando aqueles que passaram com sucesso no teste.```html example.html theme={null} {% for content in contents|rejectattr("post_list_summary_featured_image") %} | Parâmetro | Tipo | Descrição | | ---------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- | | `attribute_name` | String | Especifica o atributo a ser selecionado. Você pode acessar os atributos aninhados usando a notação de pontos. | | `exp_test` | String | O nome do [teste de expressão](/cms/reference/hubl/operators-and-expression-tests#expression-tests) para aplicar ao objeto. | ## render Renderiza rapidamente as strings que contêm HubL para que a saída possa ser passada para outros 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 Substitui todas as instâncias de uma substring por uma nova.```html example.html theme={null} {% if topic %} | Parâmetro | Tipo | Descrição | | --------- | ------ | ------------------------------------------------------------------ | | `old` | String | A substring que deve ser substituída. | | `new` | String | Corda de substituição. | | `count` | Número | Se fornecido, apenas as ocorrências firstcount serão substituídas. | ## reverse Inverte o objeto ou retorna um iterador que itera sobre ele no sentido inverso. Para reverter uma lista, use [.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 saída renderizada.txt theme={null} 10 9 8 7 6 5 4 3 2 1 ``` ## root Calcula a raiz quadrada de um valor.```text hubl.txt theme={null} {{ 16|root }} {{ 625|root(4) }} ``` ```text saída renderizada.txt theme={null} 4 5 ``` | Parâmetro | Tipo | Descrição | | ---------- | ------ | ------------------------------------ | | `nth_root` | Número | A raiz n a ser usada para o cálculo. | ## round Arredonda um número para uma precisão fornecida.```text hubl.txt theme={null} {{ 52.5|round }} {{ 52.5|round(0, "floor") }} ``` ```text saída renderizada.txt theme={null} 53 52 ``` | Parâmetro | Tipo | Descrição | | ----------------- | -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | | `precision` | Número | Especifica a precisão do arredondamento. | | `rounding_method` | `'common'` (padrão) \| `'ceil'` \| `'floor'` | As opções incluem `common` arredondar para cima ou para baixo (padrão); `ceil` sempre arredonda para cima; `floor` sempre arredonda para baixo. | ## safe Marque um valor como seguro, o que significa que, em um ambiente com escape automático habilitado, esta variável não sofrerá escape.```text hubl.txt theme={null} {{ content.post_list_content|safe }} ``` ```html example.html theme={null} ## sanitize\_html Limpa o conteúdo de uma entrada HTML para a saída de conteúdo de rich text. Aceita uma string e, em seguida, remove as tags HTML que não são permitidas. Use esse filtro para variáveis HubL usadas em HTML que devem permitir HTML seguro. Você pode incluir os seguintes parâmetros para permitir tipos específicos de tags HTML: `FORMATTING`, `BLOCKS`, `STYLES`, `LINKS`, `TABLES`, `IMAGES`. Por exemplo, `sanitize_html(IMAGES)`. Usar `sanitize_html` incluirá todos os parâmetros no filtro. Você também pode incluir um parâmetro `STRIP` para remover todo o HTML. Todo o conteúdo também é executado por `escape_jinjava` para evitar interpretações aninhadas.HTML post content that is not escaped.
``````text hubl.txt theme={null} {% set escape_string = "This ## select Filtra uma sequência de objetos, aplicando um teste aos objetos e selecionando apenas aqueles que passaram com sucesso no teste.
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 | Descrição | | ---------- | ------ | ---------------------------------------------- | | `exp_text` | String | O teste de expressão a ser aplicado ao objeto. | ## selectattr Filtra uma sequência de objetos aplicando um teste a um atributo dos objetos e selecionando apenas aqueles cujo teste foi bem-sucedido.```html example.html theme={null} {% for content in contents|selectattr("post_list_summary_featured_image") %} | Parâmetro | Tipo | Descrição | | ---------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------- | | `attribute_name` | obrigatório | O atributo a ser testado. Você pode acessar os atributos aninhados usando a notação de pontos. | | `exp_test` | String | O nome do [teste de expressão](/cms/reference/hubl/operators-and-expression-tests#expression-tests) para aplicar ao objeto. | | `val` | String | Valor para testar. | ## shuffle Randomiza a ordem de iteração por uma sequência. O exemplo abaixo randomiza um loop padrão do blog.{% if content.post_list_summary_featured_image %}{% endfor %} ``` ```html example.html theme={null}{% endif %} {{ content.post_list_content|safe }}```Post with featured image
### Observação: Ao usar este filtro, a página será [pré-renderizada](/cms/best-practices/testing-staging-performance/prerendering) periodicamente, em vez de sempre que o conteúdo da página for atualizado. Isso significa que o conteúdo filtrado não será atualizado em cada recarga de página. Isso pode não ser um problema para certos tipos de conteúdo, como exibir uma lista aleatória de posts de blog. No entanto, se você precisar que o conteúdo seja alterado aleatoriamente em cada carregamento de página, use o JavaScript para randomizar o conteúdo do lado do cliente. ```html example.html theme={null} {% for content in contents|shuffle %} ## slice Divide um iterador e retorna uma lista de listas que contêm esses itens. O primeiro parâmetro especifica quantos itens serão divididos, e o segundo parâmetro especifica os caracteres para preencher as divisões vazias.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 | Descrição | | --------- | ------ | --------------------------------------------------- | | `slices` | Número | Quantos itens serão fatiados. | | `filler` | Corda | Especifica caracteres para preencher fatias vazias. | ## sort Classifica um iterável. Este filtro requer todos os parâmetros para classificar por um atributo no HubSpot. O primeiro parâmetro é um booleano para inverter a ordem de classificação. O segundo parâmetro determina se a classificação diferencia ou não maiúsculas de minúsculas. E o parâmetro final especifica por qual atributo classificar. No exemplo abaixo, os posts de um blog foram renderizados e classificados em ordem alfabética por nome.{% 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 | Descrição | | ---------------- | -------- | ----------------------------------------------------------------------------------- | | `reverse` | Booleano | Definir para `true` para inverter a ordem de classificação. | | `case_sensitive` | Booleano | Definir para `true` para tornar a classificação sensível a maiúsculas e minúsculas. | | `attribute` | String | Atributo para classificar. Omita ao classificar uma lista. | ## split Divide a string de entrada em uma lista em um determinado separador. O primeiro parâmetro especifica o separador pelo qual a variável deve ser dividida. O segundo parâmetro determina quantas vezes a variável deve ser dividida. Qualquer item restante permanece agrupado. No exemplo abaixo, uma string de nomes é dividida no `;` para os quatro primeiros nomes.
{% 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 | Descrição | | ----------------------- | ------ | ------------------------------------------------------------------------------------------------ | | `character_to_split_by` | String | Especifica o separador para dividir a variável. | | `number_of_splits` | Número | Determina quantas vezes a variável deve ser dividida. Qualquer item restante permanece agrupado. | ## string Converte um tipo de variável diferente em uma string. No exemplo abaixo, um número inteiro é convertido em uma string (`pprint` é usado para confirmar a mudança no tipo de variável).{% 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 saída renderizada.txt theme={null} (String: 45) ``` ## striptags Remove tags SGML/XML e substitui espaços em branco adjacentes por um espaço. Este filtro pode ser usado para remover quaisquer tags HTML de uma variável.```html example.html theme={null} {% set some_html = " ## strtodate Converte uma sequência de data e um formato de data em um objeto de data.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 saída renderizada.txt theme={null} 2021-03-03 00:00:00 ``` | Parâmetro | Tipo | Descrição | | ------------ | ------ | --------------------------------------------------------------------------------------------------------- | | `dateFormat` | String | O [formato de data](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html) para usar. | ## strtotime Converte uma string e um formato de data/hora em um objeto de data/hora.```text hubl.txt theme={null} {{ "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ")|unixtimestamp }} ``` ```text saída renderizada.txt theme={null} 1531558890000 ``` | Parâmetro | Tipo | Descrição | | ---------------- | ------ | ---------------------------------------------------------------------------------------------------------------- | | `datetimeFormat` | String | O [Formato de data e hora](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html) para usar. | ## sum Soma valores numéricos em uma sequência. O primeiro parâmetro pode especificar um atributo opcional e o segundo parâmetro define o valor a retornar se não houver nada na variável a somar.```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 saída renderizada.txt theme={null} 15 Total: 30 ``` | Parâmetro | Tipo | Descrição | | ------------------- | ------ | ---------------------------------------------------------------- | | `attribute` | Strin | Atributo para soma. | | `return_if_nothing` | String | Valor a ser retornado se não houver nada na variável para somar. | ## symmetric\_difference Retorna a diferença simétrica de dois conjuntos ou listas. A lista retornada pelo filtro contém todos os elementos únicos que estão na primeira lista, mas não na segunda, ou que estão na segunda lista, mas não na primeira```text hubl.txt theme={null} {{ [1, 2, 3]|symmetric_difference([2, 3, 4, 5]) }} ``` ```text saída renderizada.txt theme={null} [1, 4, 5] ``` | Parâmetro | Tipo | Descrição | | --------- | --------- | ------------------------------------------------------------------------------------------- | | `list` | Variedade | A segunda lista para comparação e uso na busca da diferença simétrica com a lista original. | ## title Retorna uma versão do valor em caixa alta (ou seja, as palavras começarão com letras maiúsculas, mas todos os caracteres restantes serão minúsculos).```text hubl.txt theme={null} {% set my_title="my title should be title case" %} {{ my_title|title }} ``` ```text saída renderizada.txt theme={null} My Title Should Be Title Case ``` ## tojson Escreve um objeto como uma string 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 Remove espaços em branco antes e depois. O HubSpot já remove os espaços em branco da marcação, mas este filtro está documentado por uma questão de abrangência.```text hubl.txt theme={null} {{ " remove whitespace " }} {{ " remove whitespace "|trim }} ``` ```text saída renderizada.txt theme={null} remove whitespace remove whitespace ``` ## truncate Corta o texto após um certo número de caracteres. O padrão é 255. Os caracteres HTML estão incluídos nesta contagem.**Observação:** como esse filtro depende dos espaços entre as palavras para encurtar as strings, ele pode não funcionar como esperado para idiomas sem espaços entre caracteres, como 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 saída renderizada.txt theme={null} I only want to show the first sente.......... ``` | Parâmetro | Tipo | Descrição | | ---------------------- | ----------- | ------------------------------------------------------------------------------------------------ | | `number_of_characters` | obrigatório | Número de caracteres permitido antes de truncar o texto. O padrão é 255. | | `breakword` | Booleano | Se `true`, o filtro cortará o texto no comprimento. Se `false`, ele descartará a última palavra. | | `end` | String | Substituir os caracteres finais padrão '...' após o truncamento. | ## truncatehtml Trunca uma determinada string, respeitando a marcação html (ou seja, fecha adequadamente todas as tags aninhadas). Isso evita que uma tag permaneça aberta após o truncamento. Os caracteres HTML não são contabilizados no total de caracteres.**Observação:** como esse filtro depende dos espaços entre as palavras para encurtar as strings, ele pode não funcionar como esperado para idiomas sem espaços entre caracteres, como japonês. ```html example.html theme={null} {% set html_text = " | Parâmetro | Tipo | Descrição | | ---------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `number_of_characters` | obrigatório | Número de caracteres permitido antes de truncar o texto. O padrão é 255. | | `end` | String | Substituir os caracteres finais padrão '...' após o truncamento. | | `breakword` | Booleano | Valor booleano. Se `true`, o filtro cortará o texto no comprimento. Se `false` (padrão), descartará a última palavra. Se estiver usando apenas um dos parâmetros opcionais, use argumentos de palavra-chave, como `truncatehtml(70, breakwords = false)`. | ## unescape\_html Converte texto com entidades codificadas em HTML para seus equivalentes em 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 saída renderizada.txt theme={null} me & you ``` ## union Retorna a união de dois conjuntos ou listas. A lista retornada do filtro contém todos os elementos exclusivos que estão em qualquer uma das listas.```text hubl.txt theme={null} {{ [1, 2, 3]|union([2, 3, 4, 5]) }} ``` ```text saída renderizada.txt theme={null} [1, 2, 3, 4, 5] ``` | Parâmetro | Tipo | Descrição | | --------- | --------- | ------------------------------------------- | | `list` | Variedade | A segunda lista a se unir à lista original. | ## unique Extrai um conjunto exclusivo de uma sequência ou dicionário de objetos. Ao filtrar um dicionário, como uma lista de postagens retornadas por uma função, você pode especificar qual atributo é usado para desduplicar itens no dicionário.```text hubl.txt theme={null} {% set my_sequence = ["one", "one", "two", "three" ] %} {{ my_sequence|unique }} ``` ```text saída renderizada.txt theme={null} [one, two, three] ``` | Parâmetro | Tipo | Descrição | | --------- | ------ | --------------------------------------------------------------------------- | | `attr` | String | Especifica o atributo que deve ser usado ao filtrar um valor de dicionário. | ## unixtimestamp Converte um objeto datetime em um registro de data e hora Unix.### Observação: Você deve usar este filtro somente com variáveis que retornam uma data. A partir de 30 de setembro de 2024, este filtro não retornará mais a data atual quando um valor nulo for passado. Após essa data, um valor nulo no filtro retornará `September 30, 2024`. ```text hubl.txt theme={null} {{ local_dt }} {{ local_dt|unixtimestamp }} ``` ```text saída renderizada.txt theme={null} 2017-01-30 17:11:44 1485814304000 ``` ## upper Converte todas as letras de um valor em maiúsculas.```text hubl.txt theme={null} {% set text="text to make uppercase" %} {{ text|upper }} ``` ```text saída renderizada.txt theme={null} TEXT TO MAKE UPPERCASE ``` ## urlencode Escapes e URL codificam uma string usando a formatação UTF-8. Aceita dicionários e strings regulares, bem como iteráveis em pares.```text hubl.txt theme={null} {% set encode_value="Escape & URL encode this string" %} {{ encode_value|urlencode }} ``` ```text saída renderizada.txt theme={null} Escape+%26+URL+encode+this+string ``` ## urldecode Decodifica as strings de URL codificadas para a URL original. Aceita dicionários e strings regulares, bem como iteráveis em pares.```text hubl.txt theme={null} {% set decode_value="Escape+%26+URL+decode+this+string" %} {{ decode_value|urldecode }} ``` ```text saída renderizada.txt theme={null} Escape & URL decode this string ``` ## urlize Converte URLs de texto simples em links clicáveis. Se você passar um número inteiro adicional para o filtro, ele encurtará as urls para esse número. O segundo parâmetro é um booleano que determina se o link é rel="no follow". O parâmetro final permite especificar se o link será aberto em uma nova aba. | Parâmetro | Tipo | Descrição | | ----------------- | -------- | --------------------------------------------------------------- | | `shorten_text` | Número | Inteiro que encurtará as URLs para o número desejado. | | `no_follow` | Booleano | Quando definido para `true`, o link incluirá `rel="no follow"`. | | `target="_blank"` | String | Especifica se o link será aberto em uma nova aba. |```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 Conta o número de palavras em uma string.Se a string contiver HTML, use o `striptags` filtre para obter uma contagem precisa. ```text hubl.txt theme={null} {% set count_words = "Count the number of words in this variable" %} {{ count_words|wordcount }} ``` ```text saída renderizada.txt theme={null} 8 ``` ## wordwrap Insere uma quebra nas palavras após um determinado número de caracteres. Funciona melhor em um `` porque o HubSpot remove os espaços em branco por padrão.```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 saída renderizada.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. ``` | Descrição | Parâmetro | | ----------------- | ------------------------------------------------ | | `character_count` | Número de caracteres para encapsular o conteúdo. | ## xmlattr Cria uma string de atributo HTML/XML, com base nos itens em um dicionário. Todos os valores que não são none nem undefined são escapados automaticamente. Se o filtro retornar algo, adiciona automaticamente um espaço na frente do item, a menos que o primeiro parâmetro seja falso.```html example.html theme={null} {% set html_attributes = {"class": "bold", "id": "sidebar"} %} ``` ```html example.html theme={null} ``` | Parâmetro | Tipo | Descrição | | ----------- | -------- | --------------------------------------------------------------- | | `autospace` | Booleano | Definir para `true` para adicionar um espaço na frente do item. |
