Operadores y pruebas de expresiones

Para ampliar la lógica y la funcionalidad de tus plantillas, HubL admite varios operadores clave y pruebas de expresión. Los operadores permiten ejecutar funciones matemáticas, realizar comparaciones, generar lógica más compleja en las plantillas y modificar la representación del marcado. Además, este artículo contiene una lista completa de pruebas de expresión que se pueden utilizar en HubL.

Operadores

Los operadores son símbolos que indican al compilador de HubL que ejecute diversas operaciones que dan lugar al output final del marcador. Los operadores se colocan entre los operadores para relacionar ambos valores, ya sea para ejecutar funciones matemáticas, realizar comparaciones o implementar expresiones booleanas.

A continuación están los operadores que puedes utilizar en HubL, organizados por el tipo.

Matemáticas

Los operadores matemáticos estándar pueden utilizarse para calcular valores en el contexto de una plantilla.

{% set my_num = 11 %}
{% set my_number = 2 %}

{{ my_num + my_number }}
<!-- 11 + 2 = 13 -->

{{ my_num - my_number }}
<!-- 11 - 2 = 9 -->

{{ my_num / my_number }}
<!-- 11 / 2 = 5.5 -->

{{ my_num % my_number }}
<!-- 11 % 2 = 1 -->

{{ my_num // my_number }}
<!-- 11 // 2 = 5 -->

{{ my_num * my_number }}
<!-- 11 * 2 = 22 -->

{{ my_num ** my_number }}
<!-- 11 ** 2 = 121 -->

Símbolo	Descripción
`+`	Suma dos objetos, generalmente valores numéricos. Para concatenar cadenas o listas, debes utilizar el operador `~`.
`-`	Resta un número de otro.
`/`	Divide números
`%`	Devuelve el resto de la división de números
`//`	Divide dos números y devuelve el resultado entero truncado. Por ejemplo, `{{ 20 // 7 }}` es `2`.
`*`	Multiplica números
`**`	Eleva el operador izquierdo a la potencia del operador derecho

Comparación

Los operadores de comparación se pueden utilizar para evaluar valores para la lógica de la plantilla. Puedes ver algunos ejemplos de operadores de comparación en las sentencias if.

{% set my_num = 11 %}
{% set my_number = 2 %}

{{ my_num == my_number }}
<!-- Evaluates to false -->

{{ my_num != my_number }}
<!-- Evaluates to true -->

{{ my_num > my_number }}
<!-- Evaluates to true -->

{{ my_num >= my_number }}
<!-- Evaluates to true -->

{{ my_num < my_number }}
<!-- Evaluates to false -->

{{ my_num <= my_number }}
<!-- Evaluates to false -->

Símbolo	Abreviación	Descripción
`==`	eq	Igual a. Evalúa como verdadero si los dos objetos tienen valores iguales.
`!=`	ne	No es igual a. Se evalúa como verdadero si dos objetos no son iguales.
`>`	gt	Mayor que. Evalúa como verdadero si el valor del operador izquierdo es mayor que el del operador derecho.
`>=`	gte	Mayor que o igual a. Evalúa como verdadero si el operador izquierdo es mayor o igual que el operador derecho.
`<`	lt	Menor que. Evalúa como verdadero si el operador izquierdo es menor que el operador derecho.
`<=`	lte	Menor que o igual a. Evalúa como verdadero si el operador izquierdo es menor o igual que el operador derecho.

La versión abreviada de los operadores de comparación se puede utilizar en filtros que implican la comprobación de una expresión como |selectattr().

Lógica

Los operadores lógicos te permiten implementar expresiones booleanas, así como combinar varias expresiones en una sola instrucción.

Two non-empty strings:
{{ "a" and "b" }}
<!-- Evaluates to true -->

Empty string and non-empty string:
{{ "" and "b" }}
<!-- Evaluates to false -->

Two non-zero numbers:
{{ 1 and 2 }}
<!-- Evaluates to true -->

Zero and non-zero number:
{{ 0 and 1 }}
<!-- Evaluates to false -->

Two non-empty lists:
{{ [1] and [2] }}
<!-- Evaluates to true -->

Empty list and non-empty list:
{{ [] and [2] }}
<!-- Evaluates to false -->

Two non-empty dicts:
{{ {a: 1} and {b: 2} }}
<!-- Evaluates to true -->

Empty dict and non-empty dict:
{{ {} and {b: 2} }}
<!-- Evaluates to false -->

Two non-empty strings:
{{ "a" or "b" }}
<!-- Evaluates to "a" -->

Empty string and non-empty string:
{{ "" or "b" }}
<!-- Evaluates to "b" -->

Two non-zero numbers:
{{ 1 or 2 }}
<!-- Evaluates to 1 -->

Zero and non-zero number:
{{ 0 or 1 }}
<!-- Evaluates to 0 -->

Two non-empty lists:
{{ [1] or [2] }}
<!-- Evaluates to [1] -->

Empty list and non-empty list:
{{ [] or [2] }}
<!-- Evaluates to [2] -->

Two non-empty dicts:
{{ {a: 1} or {b: 2} }}
<!-- Evaluates to {a=1} -->

Empty dict and non-empty dict:
{{ {} or {b: 2} }}
<!-- Evaluates to {b=2} -->

Conditional using `is` operator:
{% set string = "strings are a cat's best friend" %}
{% if string is string_containing "cat" %}
Meow
{% else %}
Woof
{% endif %}
<!-- Evaluates to Meow -->

Conditional using `not` operator:
{% set string = "strings are a cat's best friend" %}
{% if string is not string_containing "cat" %}
Meow
{% else %}
Woof
{% endif %}
<!-- Evaluates to Woof -->

{% set my_num = 10 %}
{% set my_variable = 5 %}

{{ (my_num + 2) * my_variable }}
<!-- Evaluates to 60 -->

{% set date = local_dt %}
{{ date ? date : 'No date'}}
<!-- Evaluates to the date variable value -->

{{ todays_date ? todays_date : 'No date'}}
<!-- Evaluates to 'No date' since no value is set for todays_date -->

Símbolo	Descripción
`and`	Devuelve `true` si tanto el operador izquierdo como el derecho son verdaderos. En caso contrario, devuelve `false`. Este operador no se comporta como el operador `and` en Python o el operador `&&` en JavaScript. Más información sobre el uso de los operadores `and` a continuación.
`or`	Devuelve el primer operador si es verdadero. En caso contrario, devuelve el segundo operador. Este operador es equivalente a `or` en Python y `\|\|` en JavaScript Más información sobre el uso de los operadores `or` a continuación.
`is`	Une dos operadores para una declaración afirmativa.
`not`	Niega una afirmación, junto con `is`.
`(expr)`	Agrupa una expresión para el orden de las operaciones. Por ejemplo, `(10 - 2) * variable`.
`?`	El operador ternario puede utilizarse para escribir rápidamente la lógica condicional. Acepta 3 argumentos: expresión, condición verdadera, condición falsa. Evalúa una expresión y devuelve la condición correspondiente.

Utilizar operadores “and” y “or” En HubL, el operador or se comporta como el operador or en Python y como el operador || en JavaScript. Devolverá el primer operador si la expresión se evalúa como verdadera, en caso contrario devolverá el segundo operador. Un caso de uso habitual del operador or es el ajuste de un valor alternativo cuando no está definido el valor de una variable.

Two non-empty strings:
{{ "a" or "b" }}
<!-- Evaluates to "a" -->

Empty string and non-empty string:
{{ "" or "b" }}
<!-- Evaluates to "b" -->

Defining a fallback value:
{{ some_variable or "default value" }}
<!-- If some_variable is defined, print its value,
otherwise print "default value" -->

Sin embargo, el operador and se comporta de forma diferente al operador and en Python y al operador && en JavaScript. En HubL, and siempre devolverá un valor booleano: cuando la expresión se evalúe como verdadera, se devolverá true, de lo contrario devolverá false. Por otra parte, los operadores de Python y JavaScript devolverán un valor de operando dependiendo si la instrucción se evalúa como verdadera o falsa.

Two non-empty strings:
{{ "a" and "b" }}
<!-- Evaluates to true -->

Empty string and non-empty string:
{{ "" and "b" }}
<!-- Evaluates to false -->

En HubL, las listas vacías ([]) y los dicc. vacíos ({}) se consideran falsos. Esto es equivalente al comportamiento en Python, pero diferente de JavaScript, donde [] y {} son veraces.

Empty list and non-empty list:
{{ [] or [2] }}
<!-- Evaluates to [2] -->

Empty dict and non-empty dict:
{{ {} and {b: 2} }}
<!-- Evaluates to false -->

Otros operadores de HubL

A continuación se encuentran otros operadores importantes de HubL que pueden utilizarse para realizar diversas tareas.

Símbolo	Descripción
`in`	Comprueba si un valor está en una secuencia.
`is`	Realiza una prueba de expresión.
`\|`	Aplica un filtro.
`~`	Concatena los valores.

Pruebas de expresión

Las pruebas de expresión son varias condiciones booleanas que pueden evaluarse utilizando operadores lógicos.

boolean

Verifica si el objeto es booleano (en un sentido estricto, no solo si puede evaluarse como una expresión verdadera).

{% set isActive = false %}

{% if isActive is boolean %}
isActive is a boolean
{% endif %}

isActive is a boolean

containing

La prueba de expresión comprueba si una variable de lista tiene un valor en ella.

{% set numbers = [1, 2, 3] %}

{% if numbers is containing 2 %}
Set contains 2!
{% endif %}

Set contains 2!

containingall

La prueba de expresión comprueba si una variable de lista contiene todos los valores de otra lista.

{% set numbers = [1, 2, 3] %}

{% if numbers is containingall [2, 3] %}
Set contains 2 and 3!
{% endif %}

{% if numbers is containingall [2, 4] %}
Set contains 2 and 4!
{% endif %}

Set contains 2 and 3!

defined

La prueba de expresión comprueba si una variable está definida en el contexto de la plantilla. Aunque puedes utilizar esta prueba de expresión, al escribir una sentencia if sin ningún operador se comprobará por opción predeterminada si la variable está definida o no. En el siguiente ejemplo, se comprueba el parámetro de color de un módulo de color. Si el parámetro de color no tuviera ningún valor, la plantilla, por opción predeterminada, mostraría un color de fondo negro. Si se define, muestra el color de fondo establecido por el usuario.

{% color "my_color" color="#930101", export_to_template_context=True %}
<style>
{% if widget_data.my_color.color is defined %}
body{
background: {{ widget_data.my_color.color }};
}
{% else %}
body{
background: #000;
}
{% endif %}
</style>

<style>
body {
background: #930101;
}
</style>

divisibleby

Comprueba si un objeto es divisible por otro número. Por ejemplo, a continuación se crea un bucle for que itera a través de una lista de tipos de animales. Cada tipo de animal se imprime en un div, y al quinto div tiene aplicado un estilo en línea diferente (width:100%). Este concepto podría aplicarse a un blog en el que se renderiza un marcador diferente para un determinado patrón de entradas. Para saber más sobre los bucles for y loop.index, consulta este artículo.

{% set animals = ["lions", "tigers", "bears", "dogs", "sharks"] %}
{% for animal in animals %}
{% if loop.index is divisibleby 5 %}
<div style="width:100%">{{animal}}</div>
{% else %}
<div style="width:25%">{{animal}}</div>
{% endif %}
{% endfor %}

<div style="width:25%">lions</div>
<div style="width:25%">tigers</div>
<div style="width:25%">bears</div>
<div style="width:25%">dogs</div>
<div style="width:100%">sharks</div>

equalto

Comprueba si el valor de una variable es igual a una constante o a otra variable. También puedes utilizar el operador == para realizar la misma prueba. En el siguiente ejemplo, el ancho de loas publicaciones del blog se ajusta en función del número total de entradas en el bucle. La salida del ejemplo supone que hay 4 publicaciones en el blog.

{% for content in contents %}
{% if loop.length is equalto 2 %}
<div style="width:50%;">Post content</div>
{% elif loop.length is equalto 3 %}
<div style="width:33.333332%;">Post content</div>
{% elif loop.length is equalto 4 %}
<div style="width:25%;">Post content</div>
{% else %}
<div style="width:100%;>Post content</div>
{% endif %}
{% endfor %}

<div style="width:25%;">Post content</div>
<div style="width:25%;">Post content</div>
<div style="width:25%;">Post content</div>
<div style="width:25%;">Post content</div>

even

Comprueba si una variable numérica es un número par. El siguiente ejemplo muestra un bucle simplificado de listado de blogs, en el que si la iteración actual del bucle es par, se asigna una clase de even-post al div del elemento de la entrada. De lo contrario, se asigna una clase de odd-post.

{% for content in contents %}
{% if loop.index is even %}
<div class="post-item even-post">Post content</div>
{% else %}
<div class="post-item odd-post">Post content</div>
{% endif %}
{% endfor %}

<div class="post-item odd-post">Post content</div>
<div class="post-item even-post">Post content</div>
<div class="post-item odd-post">Post content</div>
<div class="post-item even-post">Post content</div>

float

Comprueba si una variable numérica es un número de punto flotante.

{% set quantity = 1.20 %}
{% if quantity is float %}
quantity is a floating point number
{% endif %}

quantity is a floating-point number

integer

Comprueba si una variable es un entero.

{% set quantity = 120 %}
{% if quantity is integer %}
Quantity is an integer
{% endif %}

Quantity is an integer

iterable

Comprueba si una variable se puede recorrer en bucle. Este ejemplo comprueba una variable llamada jobs para ver si puede ser iterada. Como la variable contiene una lista de trabajos, la sentencia if se evaluaría como true y el bucle se ejecutaría. Si la variable contuviera un solo valor, la sentencia if imprimiría ese valor con un marcador diferente. Más información sobre los bucles for.

{% set jobs = ["Accountant", "Developer", "Manager", "Marketing", "Support"] %}

{% if jobs is iterable %}
<h3>Available positions</h3>
<ul>
{% for job in jobs %}
<li>{{ job }}</li>
{% endfor %}
</ul>
{% else %}
<h3>Available position</h3>
<div class="single-position">{{ jobs }}</div>
{% endif %}

<h3>Available positions</h3>
<ul>
<li>Accountant</li>
<li>Developer</li>
<li>Manager</li>
<li>Marketing</li>
<li>Support</li>
</ul>

lower

Comprueba si una cadena está en minúsculas. El siguiente ejemplo utiliza una instrucción unless y un filtro lower para asegurar que una cadena de texto introducida en un módulo de texto esté siempre en minúsculas.

{% module "my_text" path="@hubspot/text" label="Enter text", value="Some TEXT that should be Lowercase", export_to_template_context=True %}

{% unless widget_data.my_text.value is lower %}
{{ widget_data.my_text.value|lower }}
{% endunless %}

some text that should be lowercase

mapping

Comprueba si un objeto es un dicc. (diccionario). El siguiente ejemplo comprueba si el objeto de contacto es un diccionario.

{% if contact is mapping %}
This object is a dictionary.
{% else %}
This object is not a dictionary.
{% endif %}

This object is a dictionary.

none

Comprueba si una variable tiene un valor null.

{% module "user_email" path="@hubspot/text" label="Enter user email", value="example@hubspot.com", export_to_template_context=True %}
{% unless widget_data.user_email.value is none %}
{{ widget_data.user_email.value }}
{% endunless %}

example@hubspot.com

number

Comprueba si el valor de una variable es un número. El siguiente ejemplo comprueba si una variable es o no una variable, y si es así la convierte en millones.

{% set my_var = 40 %}
{% if my_var is number %}
{{ my_var * 1000000 }}
{% else %}
my_var is not a number.
{% endif %}

40000000

odd

Comprueba si una variable numérica es un número impar. A continuación se muestra el mismo ejemplo que la prueba de expresión par inversa descrita anteriormente.

{% for content in contents %}
{% if loop.index is odd %}
<div class="post-item odd-post">Post content</div>
{% else %}
<div class="post-item even-post">Post content</div>
{% endif %}
{% endfor %}

<div class="post-item odd-post">Post content</div>
<div class="post-item even-post">Post content</div>
<div class="post-item odd-post">Post content</div>
<div class="post-item even-post">Post content</div>

sameas

Comprueba si dos variables tienen o no el mismo valor. El siguiente ejemplo establece dos variables y luego comprueba si son iguales o no.

{% set var_one = True %}
{% set var_two = True %}
{% if var_one is sameas var_two  %}
The variables values are the same.
{% else %}
The variables values are different.
{% endif %}

The variables values are the same.

sequence

Similar a la prueba iterable, esta prueba de expresión comprueba si una variable es una secuencia. El siguiente ejemplo comprueba si una variable es una secuencia y luego itera a través de esa secuencia de géneros musicales.

{% set genres = ["Pop", "Rock", "Disco", "Funk", "Folk", "Metal", "Jazz", "Country", "Hip-Hop", "Classical", "Soul", "Electronica" ] %}
{% if genres is sequence %}
<h3>Favorite genres</h3>
<ul>
{% for genre in genres %}
<li>{{ genre }}</li>
{% endfor %}
</ul>
{% else %}
<h3>Favorite genre:</h3>
<div class="single-genre">{{ genres }}</div>
{% endif %}

<ul>
<li>Pop</li>
<li>Rock</li>
<li>Disco</li>
<li>Funk</li>
<li>Folk</li>
<li>Metal</li>
<li>Jazz</li>
<li>Country</li>
<li>Hip-Hop</li>
<li>Classical</li>
<li>Soul</li>
<li>Electronica</li>
</ul>

string

Comprueba si el valor almacenado en una variable es texto. El siguiente ejemplo comprueba si una variable es o no una cadena, y si es así, aplica un filtro de título para cambiar las mayúsculas.

{% set my_var = "title of section" %}
{% if my_var is string %}
{{ my_var|title }}
{% else %}
my_var is not a string
{% endif %}

Title Of Section

string_containing

Comprueba si una subcadena está contenida dentro de otra cadena. Esta prueba de expresión se utiliza junto con el operador is.

{% if content.domain is string_containing ".es" %}
Markup that will only render on content hosted on .es domains
{% elif content.domain is string_containing ".jp" %}
Markup that will only render on content hosted on .jp domains
{% else %}
Markup that will render on all other domains
{% endif %}

Markup that will render on all other domains

string_startingwith

Comprueba si una cadena empieza por una cadena determinada. Se utiliza junto con el operador is.

{% if content.slug is string_startingwith "es/" %}
Markup that will only render on content hosted in a /es/ subdirectory
{% elif content.slug is string_startingwith "jp/" %}
Markup that will only render on content hosted in a /jp/ subdirectory
{% else %}
Markup that will render on all subdirectories
{% endif %}

Markup that will render on all subdirectories

truthy

Comprueba si una expresión se evalúa como True. El siguiente ejemplo utiliza un módulo de casilla de verificación booleana para mostrar un mensaje de alerta.

{% boolean "check_box" label="Show alert", value=True, export_to_template_context=True %}

{% if widget_data.check_box.value is truthy %}
<div class="alert">Danger!</div>
{% endif %}

<div class="alert">Danger!</div>

undefined

Comprueba si una variable está indefinida en el contexto de la plantilla. Esta prueba es diferente de la de none, ya que undefined será true cuando la variable esté presente pero no tenga ningún valor; mientras que none será true cuando la variable tenga un valor nulo. El siguiente ejemplo comprueba la existencia de la variable “my_var” en una plantilla.

{% if my_var is undefined %}
A variable named "my_var" does not exist on this template.
{% else %}
{{ my_var }}
{% endif %}

A variable named "my_var" does not exist on this template.

upper

Comprueba si una cadena está toda en mayúsculas. A continuación se muestra un ejemplo inverso de la prueba de expresión lower anterior.

{% module "my_text" path="@hubspot/text" label="Enter text", value="Some TEXT that should be Uppercase", export_to_template_context=True %}

{% unless widget_data.my_text.value is upper %}
{{ widget_data.my_text.value|upper }}
{% endunless %}

SOME TEXT THAT SHOULD BE UPPERCASE

within

Comprueba si una variable está presente en una lista.

{% set numbers = [1, 2, 3] %}

{% if 2 is within numbers %}
2 is in the list!
{% endif %}

{% if 4 is within numbers %}
4 is in the list!
{% endif %}

2 is in the list!

Start Building

Reference

Best Practices

Marketplace

Versions & Deprecations

Operadores y pruebas de expresiones

Operadores

Matemáticas

Comparación

Lógica

Otros operadores de HubL

Pruebas de expresión

boolean

containing

containingall

defined

divisibleby

equalto

even

float

integer

iterable

lower

mapping

none

number

odd

sameas

sequence

string

string_containing

string_startingwith

truthy

undefined

upper

within

​Operadores

​Matemáticas

​Comparación

​Lógica

​Otros operadores de HubL

​Pruebas de expresión

​boolean

​containing

​containingall

​defined

​divisibleby

​equalto

​even

​float

​integer

​iterable

​lower

​mapping

​none

​number

​odd

​sameas

​sequence

​string

​string_containing

​string_startingwith

​truthy

​undefined

​upper

​within

Operadores

Matemáticas

Comparación

Lógica

Otros operadores de HubL

Pruebas de expresión

boolean

containing

containingall

defined

divisibleby

equalto

even

float

integer

iterable

lower

mapping

none

number

odd

sameas

sequence

string

string_containing

string_startingwith

truthy

undefined

upper

within