Um die Logik und Funktionalität Ihrer Vorlagen zu erweitern, unterstützt HubL mehrere wichtige Operatoren und Ausdruckstests. Operatoren ermöglichen es Ihnen, mathematische Funktionen auszuführen, Vergleiche durchzuführen, die Logik von Vorlagen komplexer zu machen und die Darstellung durch Markup zu ändern. Darüber hinaus enthält dieser Artikel eine umfassende Liste von Ausdruckstests, die in HubL verwendet werden können.
Letzte Änderung: 8. Oktober 2025
Um die Logik und Funktionalität Ihrer Vorlagen zu erweitern, unterstützt HubL mehrere wichtige Operatoren und Ausdruckstests. Operatoren ermöglichen es Ihnen, mathematische Funktionen auszuführen, Vergleiche durchzuführen, die Logik von Vorlagen komplexer zu machen und die Darstellung durch Markup zu ändern. Darüber hinaus enthält dieser Artikel eine umfassende Liste von Ausdruckstests, die in HubL verwendet werden können.
Operatoren sind Symbole, die den HubL-Compiler anweisen, verschiedene Operationen auszuführen, die zur endgültigen Ausgabe führen. Operatoren werden zwischen Operanden platziert, um die beiden Werte zueinander in Beziehung zu setzen, sei es zur Ausführung mathematischer Funktionen, zum Erstellen von Vergleichen oder zum Implementieren von booleschen Ausdrücken.
Nachfolgend finden Sie die Operatoren, die Sie in HubL verwenden können, nach Typ geordnet.
Vergleichsoperatoren können verwendet werden, um Werte für Vorlagenlogik auszuwerten. Einige Beispiele für die Verwendung von Vergleichsoperatoren finden Sie in if-Anweisungen.
Report incorrect code
Copy
Ask AI
{% 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 -->
Symbol
Kurzschreibweise
Beschreibung
==
==eq
Gleich. Wird als true ausgewertet, wenn die beiden Objekte gleiche Werte haben.
!=
ne
Ungleich. Wird als true ausgewertet, wenn die beiden Objekte nicht gleich sind.
>
gt
Größer als. Wird als true ausgewertet, wenn der Wert des linken Operanden größer als der rechte Operand ist.
>=
gte
Größer als oder gleich. Wird als true ausgewertet, wenn der linke Operand größer oder gleich dem rechten Operanden ist.
<
lt
Kleiner als. Wird als true ausgewertet, wenn der linke Operand kleiner als der rechte Operand ist.
<=
lte
Kleiner als oder gleich. Wird als true ausgewertet, wenn der linke Operand kleiner oder gleich dem rechten Operanden ist.
Die Kurzschreibweise der Vergleichsoperatoren kann in HubL-Filtern verwendet werden, bei denen ein Ausdruck getestet wird, z. B. |selectattr().
Mit logischen Operatoren können Sie boolesche Ausdrücke implementieren sowie mehrere Ausdrücke in einzelnen Anweisungen kombinieren.
Report incorrect code
Copy
Ask AI
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 -->
Symbol
Beschreibung
and
Gibt true zurück, wenn sowohl der linke als auch der rechte Operand truthy sind. Andernfalls wird false zurückgegeben.
Dieser Operator verhält sich nicht wie der and-Operator in Python oder der &&-Operator in JavaScript. Im Folgenden erfahren Sie mehr über die Verwendung von and-Operatoren.
or
Gibt den ersten Operanden zurück, wenn er truthy ist. Andernfalls wird der zweite Operand zurückgegeben.
Dieser Operator ist äquivalent zu or in Python und|| JavaScript. Im Folgenden erfahren Sie mehr über die Verwendung von or-Operatoren.
is
Verbindet zwei Operanden für eine positive Anweisung.
not
Negiert eine Anweisung in Verbindung mit is.
(expr)
Gruppieren Sie einen Ausdruck für die Reihenfolge der Operationen. Zum Beispiel: (10 - 2) * variable.
?
Der ternäre Operator kann verwendet werden, um schnell bedingte Logik zu schreiben. Akzeptiert drei Argumente (Ausdruck, „true“-Bedingung, „false“-Bedingung). Wertet einen Ausdruck aus und gibt die entsprechende Bedingung zurück.
Verwenden von und/oder-OperatorenIn HubL verhält sich der or-Operator wie der or-Operator in Python und der ||-Operator in JavaScript. Der erste Operand wird zurückgegeben, wenn der Ausdruck als true ausgewertet wird, andernfalls wird der zweite Operand zurückgegeben. Ein häufiger Anwendungsfall für diesen or Operator ist das Festlegen eines Fallback-Werts, wenn kein Variablenwert definiert ist.
Report incorrect code
Copy
Ask AI
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" -->
Der and-Operator verhält sich jedoch anders als der and-Operator in Python und der &&-Operator in JavaScript. In HubL gibt and immer einen booleschen Wert zurück: Wenn der Ausdruck als true ausgewertet wird, wird true zurückgegeben, andernfalls wird false zurückgegeben. Die Python- und JavaScript-Operatoren hingegen geben einen Operandenwert zurück, der darauf basiert, ob die Anweisung als true oder false ausgewertet wird.
Report incorrect code
Copy
Ask AI
Two non-empty strings:{{ "a" and "b" }}<!-- Evaluates to true -->Empty string and non-empty string:{{ "" and "b" }}<!-- Evaluates to false -->
In HubL werden leere Listen ([]) und leere Dicts ({}) als falsch betrachtet. Dies entspricht dem Verhalten in Python, unterscheidet sich jedoch von JavaScript, wo [] und {} truthy sind.
Report incorrect code
Copy
Ask AI
Empty list and non-empty list:{{ [] or [2] }}<!-- Evaluates to [2] -->Empty dict and non-empty dict:{{ {} and {b: 2} }}<!-- Evaluates to false -->
Überprüft, ob eine Listenvariable alle Werte einer anderen Liste enthält.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob eine Variable im Kontext der Vorlage definiert ist. Sie können diesen Ausdruckstest zwar verwenden, aber beim Schreiben einer if-Anweisung ohne Operatoren wird standardmäßig geprüft, ob die Variable definiert ist.In dem folgenden Beispiel wird der color-Parameter eines Farbmoduls getestet. Hätte der color-Parameter keinen Wert, würde die Vorlage standardmäßig eine schwarze Hintergrundfarbe darstellen. Wenn er angegeben ist, wird die vom Benutzer festgelegte Hintergrundfarbe dargestellt.
Report incorrect code
Copy
Ask AI
{% 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>
Überprüft, ob ein Objekt durch eine andere Zahl teilbar ist.Im Folgenden wird zum Beispiel eine for-Schleife erstellt, die eine Liste von Tierarten durchläuft. Jede Tierart wird in einem div gedruckt, und jedes 5. div hat ein anderes Inline-Styling (Breite:100 %). Dieses Konzept könnte auf einen Blog angewendet werden, in dem für ein bestimmtes Muster von Beiträgen ein anderes Markup gerendert wird. Weitere Informationen zu for-Schleifen und loop.index finden Sie in diesem Artikel.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob der Wert einer Variablen gleich einer Konstanten oder einer anderen Variablen ist. Sie können auch den Operator == verwenden, um denselben Test durchzuführen.Im folgenden Beispiel wird die Breite der Blogbeiträge auf der Grundlage der Gesamtzahl der Beiträge in der Schleife angepasst. In der Beispielausgabe wird davon ausgegangen, dass der Blog 4 Beiträge enthält.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob eine numerische Variable eine gerade Zahl ist.Das folgende Beispiel zeigt eine vereinfachte Blog-Listing-Schleife. Wenn die aktuelle Iteration der Schleife gerade ist, wird dem post item-div die even-post-Klasse zugewiesen. Andernfalls wird die odd-post-Klasse zugewiesen.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob eine Variable in einer Schleife durchlaufen werden kann.In diesem Beispiel wird eine Variable namens jobs daraufhin überprüft, ob sie durchlaufen werden kann. Da die Variable eine Liste von Jobs enthält, würde die if-Anweisung als true ausgewertet werden, und die Schleife würde ausgeführt werden. Hätte die Variable einen einzelnen Wert enthalten, würde die if-Anweisung diesen Wert stattdessen mit anderem Markup ausgeben. Erfahren Sie mehr über for-Schleifen.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob eine Zeichenfolge kleingeschrieben ist.Im folgenden Beispiel wird mithilfe einer unless-Anweisung und eines lower-Filter sichergestellt, dass eine in einen Textbaustein eingegebene Textzeichenfolge immer kleingeschrieben wird.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob der Wert einer Variablen eine Zahl ist.Im folgenden Beispiel wird überprüft, ob es sich bei einer Variablen um eine Variable handelt, und wenn ja, wird sie in Millionen umgewandelt.
Report incorrect code
Copy
Ask AI
{% set my_var = 40 %}{% if my_var is number %}{{ my_var * 1000000 }}{% else %}my_var is not a number.{% endif %}
Überprüft, ob eine numerische Variable eine ungerade Zahl ist.Im Folgenden wird dasselbe Beispiel wie der zuvor beschriebene inverse-even-Ausdruckstest verwendet.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob zwei Variablen den gleichen Wert haben.Im folgenden Beispiel werden zwei Variablen festgelegt und dann wird überprüft, ob sie gleich sind.
Report incorrect code
Copy
Ask AI
{% 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 %}
Ähnlich wie der iterable-Test wird mit diesem Ausdruckstest überprüft, ob eine Variable eine Sequenz ist.Im folgenden Beispiel wird überprüft, ob eine Variable eine Sequenz ist, und dann wird diese Sequenz von Musikgenres durchlaufen.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob der in einer Variablen gespeicherte Wert ein Text ist.Im folgenden Beispiel wird überprüft, ob eine Variable eine Zeichenkette ist, und wenn ja, wird ein title-Filter angewendet, um die Großschreibung zu ändern.
Report incorrect code
Copy
Ask AI
{% set my_var = "title of section" %}{% if my_var is string %}{{ my_var|title }}{% else %}my_var is not a string{% endif %}
Überprüft, ob ein bereitgestellter Substring in einer anderen Zeichenfolge enthalten ist. Dieser Ausdruckstest wird in Verbindung mit dem Operator is verwendet.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob eine Zeichenkette mit einer bestimmten Zeichenkette beginnt. Er wird in Verbindung mit dem Operator is verwendet.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob ein Ausdruck als True ausgewertet wird.Im folgenden Beispiel wird ein boolesches Kontrollkästchenmodul verwendet, um eine Warnmeldung anzuzeigen.
Report incorrect code
Copy
Ask AI
{% 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 %}
Überprüft, ob eine Variable im Kontext der Vorlage undefiniert ist. Dieser Test unterscheidet sich vom none-Ausdruckstest dadurch, dass undefined true ist, wenn die Variable vorhanden ist, aber keinen Wert hat; none hingegen ist true, wenn die Variable einen Nullwert hat.Im folgenden Beispiel wird eine Vorlage auf das Vorhandensein der Variablen “my_var” überprüft.
Report incorrect code
Copy
Ask AI
{% if my_var is undefined %}A variable named "my_var" does not exist on this template.{% else %}{{ my_var }}{% endif %}
Überprüft, ob eine Zeichenkette durchgehend in Großbuchstaben geschrieben ist. Nachfolgend finden Sie ein umgekehrtes Beispiel für den obigen Test des lower-Ausdrucks.
Report incorrect code
Copy
Ask AI
{% 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 %}