HubL-Filterliste und Beispiele für HubSpot CMS-Entwickler.
Letzte Änderung: 7. Oktober 2025
Filter beeinflussen die endgültige Ausgabe Ihres HubL-Codes. Sie können auf verschiedene HubL-Anweisungen und -Ausdrücke angewendet werden, um das vom Server ausgegebene Template-Markup zu ändern.Die grundlegende Syntax eines Filters ist |filtername. Der Filter wird direkt nach der Anweisung oder dem Ausdruck innerhalb seiner Trennzeichen eingefügt. Einige Filter haben zusätzliche Parameter, die in Klammern hinzugefügt werden können. Die grundlegende Syntax eines Filters mit einem String, einer Zahl und einem booleschen Parameter lautet: |filtername("stringParameter", 10, true). Beachten Sie, dass String-Parameter in Anführungszeichen geschrieben werden sollten. Beachten Sie auch, dass HubL-Filter einen Alias haben, der für denselben Zweck wie der primäre Filter verwendet werden kann.Der folgende Artikel enthält alle unterstützten HubL-Filter.
Sie können HubL-Filter auf Personalisierungstoken wie Kontakt- und Unternehmens-Token auf HubSpot CMS- und Blog-Seiten anwenden, jedoch nicht in E-Mails.
Addiert einen numerischen Wert zu einem anderen numerischen Wert. Dieser Filter funktioniert genauso wie der Operator +. Der Parameter in Klammern ist der Summand, den Sie mit Ihrem numerischen Ausgangswert kombinieren.
Gibt das Attribut eines Dictionarys wieder; Dieser Filter entspricht dem Ausgeben einer Variablen, die in einem Wörterbuch vorhanden ist, z. B. content.absolute_url.
Gruppiert Elemente innerhalb einer Sequenz.Im folgenden Beispiel gibt es eine Variable, die eine Sequenz von Obstsorten enthält. Der batch-Filter wird auf eine Schleife angewendet, die die Sequenz durchläuft. Die geschachtelte Schleife wird dreimal durchlaufen, um 3 Obstsorten pro Zeile auszugeben, bevor die äußere Schleife erneut läuft. Beachten Sie in der endgültigen Ausgabe, dass, da es nur 5 Obstsorten gibt, das letzte Element durch ein (den zweiten Parameter) ersetzt wird.
Report incorrect code
Copy
Ask AI
{% set rows = ["apples", "oranges", "pears", "grapes", "blueberries"] %}<table>{% for row in rows|batch(3, " ") %}<tr>{% for column in row %}<td>{{ column }}</td>{% endfor %}</tr>{% endfor %}</table>
Parameter
Typ
Beschreibung
linecount
Zahl
Anzahl der in den Batch aufzunehmenden Elemente
fill_with
Zeichenfolge
Gibt an, was eingeschlossen werden soll, um fehlende Elemente zu ergänzen
Sie sollten diesen Filter nur für Variablen verwenden, die ein Datum zurückgeben. Ab dem 30. September 2024 gibt dieser Filter nicht mehr das aktuelle Datum zurück, wenn ein Nullwert übergeben wird. Nach diesem Datum wird bei einem Nullwert im Filter „30. September 2024“ zurückgegeben.
Report incorrect code
Copy
Ask AI
{% set begin = "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %}{% set end = "2018-07-20T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %}{{ begin|between_times(end, "days") }}
Parameter
Typ
Beschreibung
end
datetime-Objekt
Das End-datetime-Objekt
timeunit
Zeichenfolge
Gültige Zeiteinheiten sind nanos, micros, millis, seconds, minutes, hours, half_days, days, weeks, months, years, decades, centuries, millennia und eras.
Großschreibung des ersten Buchstabens eines Variablenwerts; Das erste Zeichen wird großgeschrieben, alle anderen Buchstaben werden kleingeschrieben. Bei nachfolgenden Wörtern, die durch Leerzeichen oder Bindestriche getrennt sind, wird der erste Buchstabe nicht großgeschrieben.
Report incorrect code
Copy
Ask AI
{% set sentence = "the first letter of a sentence should always be capitalized." %}{{ sentence|capitalize }}
Zentriert Text innerhalb einer bestimmten Feldlänge unter Verwendung von Leerzeichen; Dieser Filter wird nicht empfohlen und ist auch nicht besonders nützlich, da der HTML-Compiler von HubSpot die Leerzeichen automatisch entfernt; er ist hier jedoch der Vollständigkeit halber aufgeführt.Das folgende Beispiel zeigt, wie dieser Filter auf eine Variable in einem pre-Tag angewendet wird, sodass die Leerzeichen nicht entfernt werden.
Report incorrect code
Copy
Ask AI
<pre>{% set var = "string to center" %}before{{ var|center(80) }}after</pre>
Parameter
Typ
Beschreibung
width
Zahl
Gibt die Länge des Leerraums an, in dem der Text zentriert werden soll
Konvertiert einen HEX-Wert in einen RGB-String. Dies ist nützlich, wenn Sie Farbvariablen in RGB konvertieren müssen, um sie mit einer RGBA-CSS-Deklaration zu verwenden. Im folgenden Beispiel wird der von einem Farbmodul festgelegte Wert in einen RGB-Wert umgewandelt und in einer RGBA-CSS-Deklaration verwendet.
Report incorrect code
Copy
Ask AI
{% set my_color = "#FFFFFF" %}{{ my_color|convert_rgb }}{% set my_color2="#000000" %}<div style="background: rgba({{ my_color2|convert_rgb }}, .5)"></div>
Entfernt einen String aus einem Wert. Dieser Filter kann verwendet werden, um einen bestimmten Teil eines Strings abzugleichen und auszuschneiden. Der Parameter gibt den Teil des Strings an, der entfernt werden soll. Im folgenden Beispiel werden das Leerzeichen und das Wort „world“ aus dem ursprünglichen Variablenwert entfernt.
Report incorrect code
Copy
Ask AI
{% set my_string = "Hello world." %}{{ my_string|cut(" world") }}
Bitte beachten: Dieser Filter ist mittlerweile veraltet. Verwenden Sie stattdessen den format_datetime-Filter, der eine stärker standardisierte Syntax verwendet.
Wenn der Wert undefiniert ist, wird der erste Parameter zurückgegeben, andernfalls wird der Wert der Variablen gedruckt. Wenn Sie default mit Variablen verwenden wollen, die als false ausgewertet werden, müssen Sie den zweiten Parameter auf true festlegen.Das erste Beispiel unten würde die Meldung drucken, wenn die Variable nicht definiert ist. Das zweite Beispiel wendet den Filter auf eine leeren Zeichenfolge an, die nicht undefiniert ist, gibt aber aufgrund des zweiten Parameters eine Meldung aus.
Report incorrect code
Copy
Ask AI
{{ my_variable|default("my_variable is not defined") }}{{ ""|default("the string was empty", true) }}
Parameter
Typ
Beschreibung
default_value
Zeichenfolge
Wert, der zurückgegeben wird, wenn die Variable undefiniert ist. Wenn die Variable definiert ist, wird stattdessen der Wert der Variable zurückgegeben.
truthy
Boolesch
Wert auf true zur Verwendung mit Variablen, die als false ausgewertet werden
Sortiert ein Dict und ergibt (Schlüssel, Wert) Paare. Dictionaries sind standardmäßig unsortiert. Sie können ein Dictionary jedoch nach Schlüssel oder Wert sortiert ausgeben. Der erste Parameter ist ein boolescher Wert, der angibt, ob bei der Sortierung zwischen Groß- und Kleinschreibung unterschieden wird oder nicht. Der zweite Parameter bestimmt, ob das Dict nach Schlüssel oder Wert sortiert werden soll. Das folgende Beispiel druckt ein sortiertes Kontaktverzeichnis mit allen bekannten Details zum Kontakt.
Report incorrect code
Copy
Ask AI
{% for item in contact|dictsort(false, "value") %}{{item}}{% endfor %}
Parameter
Typ
Beschreibung
case_sensitive
Boolesch
Legt fest, ob bei der Sortierung zwischen Groß- und Kleinschreibung unterschieden wird
sort_by
"key" | "value"
Bestimmt, ob nach key oder value sortiert werden soll
Gibt die Differenz von zwei Mengen oder Listen zurück. Die vom Filter zurückgegebene Liste enthält alle eindeutigen Elemente, die in der ersten Liste, aber nicht in der zweiten Liste enthalten sind.
Report incorrect code
Copy
Ask AI
{{ [1, 2, 3]|difference([2, 3, 4, 5]) }}
Parameter
Typ
Beschreibung
list
Array
Die zweite Liste, die zum Vergleich herangezogen wird, um Unterschiede zur ursprünglichen Liste zu finden
Versieht den Inhalt mit Escape-Zeichen einer HTML-Eingabe. Akzeptiert einen String und konvertiert die Zeichen &, <, >, ‘, ” und escape_jinjava in HTML-sichere Sequenzen. Verwenden Sie diesen Filter für HubL-Variablen, die in HTML-Codes verwendet werden, aber kein HTML zulassen dürfen.
Report incorrect code
Copy
Ask AI
{% set escape_string = "<div>This markup is printed as text</div>" %}{{ escape_string|escape_html }}
Versieht den Inhalt mit Escape-Zeichen einer HTML-Attributeingabe. Akzeptiert einen String und konvertiert die Zeichen &, <, ‘, ” und escape_jinjava in HTML-sichere Sequenzen. Verwenden Sie diesen Filter für HubL-Variablen, die HTML-Attributen hinzugefügt werden.Beachten Sie, dass Sie beim Escaping von Werten von Attributen, die URLs akzeptieren, wie z. B. href, stattdessen den Filter escape_url verwenden müssen.
Report incorrect code
Copy
Ask AI
{% set escape_string = "This <br> markup is printed as text" %}<img src="test.com/imageurl" alt="{{escape_string|escape_attr}}">
Konvertiert die Zeichen { und } in Strings in Jinjava-sichere Sequenzen. Verwenden Sie diesen Filter, wenn Sie Text anzeigen müssen, der solche Zeichen in Jinjava enthalten könnte.
Report incorrect code
Copy
Ask AI
{% set escape_string = "{{This markup is printed as text}}" %}{{ escape_string|escape_jinjava }}
Versieht Strings mit Escape-Zeichen, einschließlich escape_jinjava, sodass sie sicher in eine JavaScript-Variablendeklaration eingefügt werden können. Verwenden Sie diesen Filter für HubL-Variablen, die in HTML-Skriptelementen verwendet werden.
Report incorrect code
Copy
Ask AI
{% set escape_string = "\tThey said 'This string can safely be inserted into JavaScript.'" %}{{ escape_string|escape_js }}
Versieht den Inhalt einer URL-Eingabe mit Escape-Zeichen, erzwingt festgelegte Protokolle, entfernt ungültige und gefährliche Zeichen und kodiert HTML-Entitäten. Gibt eine leere Antwort zurück, wenn eine URL gültig ist. Verwenden Sie diesen Filter für HubL-Variablen, die in HTML-Attributen verwendet werden. Es müssen gültige URLs sein.
Report incorrect code
Copy
Ask AI
{% set escape_string = "http://example.com/with space/<html>" %}<a href="https://developers.hubspot.de/docs{{ escape_string|escape_url }}"></a>
Formatiert einen Zahlenwert in eine für Menschen lesbare Dateigröße (z. B. 13 kB, 4,1 MB, 102 Bytes usw.). Standardmäßig werden Dezimalpräfixe verwendet (z. B. MB und GB), aber Sie können den binary-Parameter auf true festlegen, um binäre Präfixe wie Mebi (MiB) und Gibi (GiB) zu verwenden.
Report incorrect code
Copy
Ask AI
{% set bytes = 10000 %}{{ bytes|filesizeformat(binary=true) }}
Parameter
Typ
Beschreibung
binary
Boolesch
Bei Festlegung auf true werden binäre Präfixe verwendet, z. B. Mebi (MiB) und Gibi (GiB).
Wandelt den Wert in eine Fließkommazahl um; Wenn die Konvertierung nicht funktioniert, wird 0.0 zurückgegeben. Sie können diese Vorgabe mit dem ersten Parameter außer Kraft setzen.
Report incorrect code
Copy
Ask AI
{% set my_text="25" %}{{ my_text|float + 17 }}
Parameter
Typ
Beschreibung
default
Zahl
Integer, der zurückgegeben wird, wenn die Konvertierung nicht funktioniert
Strenge Durchsetzung von HTML-Escaping; In der HubSpot-Umgebung gibt es keinen echten Anwendungsfall für doppeltes Escaping, daher verhält sich dieser Filter im Allgemeinen genauso wie der escape-Filter.
Report incorrect code
Copy
Ask AI
{% set escape_string = "<div>This markup is printed as text</div>" %}{{ escape_string|forceescape }}
Formatiert eine gegebene Zahl als Währung basierend auf der Standardwährung des Portals und dem als Parameter übergebenen Gebietsschema. Ersetzt den veralteten format_currency-Filter.
Das Sprach-Tag des Java-Gebietsschemas. Der Standard ist das locale.Format : ISO639LanguageCodeInLowercase-ISO3166CountryCodeInUppercase-Format der Seite.
currency
Zeichenfolge
Der alphabetische ISO 4217-Code der Währung; Standard ist die Standardwährung des Portals. Numerische Codes werden nicht akzeptiert.
minDecimalDigits
Zahl
Die Mindestanzahl an Dezimalstellen, die die Ausgabe umfassen darf. Standardmäßig wird die Standardanzahl der Dezimalstellen der Währung verwendet.
maxDecimalDigits
Zahl
Die maximale Anzahl an Dezimalstellen, die die Ausgabe umfassen darf. Standardmäßig wird die Standardanzahl der Dezimalstellen der Währung verwendet.
Sie sollten diesen Filter nur für Variablen verwenden, die ein Datum zurückgeben. Ab dem 30. September 2024 gibt dieser Filter nicht mehr das aktuelle Datum zurück, wenn ein Nullwert übergeben wird. Nach diesem Datum wird bei einem Nullwert im Filter „30. September 2024“ zurückgegeben.
Formatiert sowohl die date- als auch die time-Komponente eines date-Objekts. Dieser Filter ersetzt den veralteten datetimeformat-Filter. Standardmäßig wird eine Datetime in der Zeitzone UTC-00:00 zurückgegeben.
Sie sollten diesen Filter nur für Variablen verwenden, die ein Datum zurückgeben. Ab dem 30. September 2024 gibt dieser Filter nicht mehr das aktuelle Datum zurück, wenn ein Nullwert übergeben wird. Nach diesem Datum wird bei einem Nullwert im Filter „30. September 2024“ zurückgegeben.
Das zu verwendende Format; Kann ein benutzerdefiniertes Muster gemäß Unicode LDML sein. Wenn long oder full verwendet werden, enthält der Zeitstempel ein Z, um die Nullpunktverschiebung zur UTC-Zeit (z. B. 2:23:00 PM Z) zu kennzeichnen. Um den Z-Bezeichner zu entfernen, geben Sie eine timeZone an.
timeZone
Zeichenfolge
Die Zeitzone des Ausgabedatums im IANA-TZDB-Format; Standardmäßig wird die UTC-Zeit zurückgegeben.
Sie sollten diesen Filter nur für Variablen verwenden, die ein Datum zurückgeben. Ab dem 30. September 2024 gibt dieser Filter nicht mehr das aktuelle Datum zurück, wenn ein Nullwert übergeben wird. Nach diesem Datum wird bei einem Nullwert im Filter „30. September 2024“ zurückgegeben.
Das zu verwendende Format; Kann ein benutzerdefiniertes Muster gemäß Unicode LDML sein. Wenn long oder full verwendet werden, enthält der Zeitstempel ein Z, um die Nullpunktverschiebung zur UTC-Zeit (z. B. 2:23:00 PM Z) zu kennzeichnen. Um den Z-Bezeichner zu entfernen, geben Sie eine timeZone an.
timeZone
Zeichenfolge
Die Zeitzone des Ausgabedatums im IANA-TZDB-Format; Standardmäßig wird die UTC-Zeit zurückgegeben.
Berechnet den ellipsoiden 2D-Abstand zwischen zwei Punkten auf der Erde.
Report incorrect code
Copy
Ask AI
<!-- in the example belowthe HubDB Location =42.3667, -71.1060 (Cambridge, MA) |Chicago, IL = 37.3435, -122.0344 -->{{ row.location | geo_distance(37.3435, -122.0344, "mi") }} MI
Gruppiert eine Sequenz von Objekten nach einem gemeinsamen Attribut; Der Parameter legt das gemeinsame Attribut fest, nach dem gruppiert werden soll.
Report incorrect code
Copy
Ask AI
<ul>{% for group in contents|groupby("blog_post_author") %}<li>{{ group.grouper }}<ul>{% for content in group.list %}<li>{{ content.name }}</li>{% endfor %}</ul></li>{% endfor %}</ul>
Zieht Text innerhalb einer bestimmten Feldlänge unter Verwendung von Leerzeichen ein; Dieser Filter wird nicht empfohlen und ist auch nicht besonders nützlich, da der HTML-Compiler von HubSpot die Leerzeichen automatisch entfernt. Der Vollständigkeit halber ist er hier jedoch aufgeführt. Das folgende Beispiel zeigt, wie ein indent-Filter auf eine Variable in einem <pre>-Tag angewendet wird, sodass die Leerzeichen nicht entfernt werden. Der erste Parameter steuert die Menge an Leerzeichen, und der zweite boolesche Parameter bestimmt, ob die erste Zeile eingerückt werden soll.
Report incorrect code
Copy
Ask AI
<pre>{% set var = "string to indent" %}{{ var|indent(2, true) }}</pre>
Parameter
Typ
Beschreibung
width
Zahl
Die Menge an Leerzeichen, die angewendet werden soll
indent-first
Boolesch
Bei Festlegung auf true wird die erste Zeile eingerückt.
Konvertiert den Wert in eine Ganzzahl; Wenn die Konvertierung nicht funktioniert, wird 0 zurückgegeben. Sie können diese Vorgabe mit dem ersten Parameter außer Kraft setzen.
Report incorrect code
Copy
Ask AI
{% set string="25" %}{{ string|int + 17 }}
Parameter
Typ
Beschreibung
default
Zahl
Integer, der zurückgegeben wird, wenn die Konvertierung nicht funktioniert
Dieser Filter gibt die Schnittmenge von zwei Mengen oder Listen zurück. Die vom Filter zurückgegebene Liste enthält alle eindeutigen Elemente, die in beiden Listen enthalten sind.
Report incorrect code
Copy
Ask AI
{{ [1, 2, 3]|intersect([2, 3, 4, 5]) }}
Parameter
Typ
Beschreibung
list
Array
Die zweite Liste, mit der verglichen werden soll, um herauszufinden, wo sich die Liste mit der ursprünglichen Liste überschneidet
Gibt einen String zurück, die die Verkettung der Strings in der Sequenz ist; Das Trennzeichen zwischen den Elementen ist standardmäßig ein leerer String, Sie können es mit dem optionalen Parameter definieren. Der zweite Parameter kann verwendet werden, um ein zu verbindendes Attribut anzugeben.
Report incorrect code
Copy
Ask AI
{% set my_list = [1, 2, 3] %}{% set sep = "---" %}{{ my_list|join }}{{ my_list|join("|") }}{{ my_list|join(sep) }}
Parameter
Typ
Beschreibung
delimiter
Zeichenfolge
Das Trennzeichen, das bei der Verkettung von Strings verwendet wird
attribute
HubL-Variable
Attribut des Werts, der zu einem Objekt hinzugefügt werden soll
Konvertiert Werte in eine Liste um; Zeichenfolgen werden als separate Zeichen zurückgegeben, es sei denn, sie sind in eckigen Klammern [ ] enthalten.
Report incorrect code
Copy
Ask AI
{% 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 }}
Wendet einen Filter auf eine Sequenz von Objekten an oder sucht nach einem Attribut. Dies ist nützlich, wenn man mit Listen von Objekten arbeitet, aber eigentlich nur an einem bestimmten Wert interessiert ist.Die grundlegende Verwendung ist das Mapping auf ein Attribut. Wenn Sie z. B. mithilfe von bedingter Logik prüfen wollen, ob ein Wert in einem bestimmten Attribut eines Dict vorhanden ist. Alternativ können Sie auch einen Filter aufrufen lassen, indem Sie den Namen des Filters und die Argumente übergeben.
Report incorrect code
Copy
Ask AI
{# 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")}}
Parameter
Typ
Beschreibung
filter
Zeichenfolge
Filter, der auf die Sequenz von Objekten angewendet werden soll
Bei Verwendung dieses Filters wird die Seite nicht jedes Mal, wenn der Seiteninhalt aktualisiert wird, sondern in regelmäßigen Abständen vorgerendert. Dies bedeutet, dass der gefilterte Inhalt nicht bei jedem erneuten Laden der Seite aktualisiert wird.Dies ist möglicherweise kein Problem für bestimmte Arten von Inhalten, z. B. die Anzeige einer zufälligen Liste von Blog-Beiträgen. Wenn Inhalte jedoch bei jedem Laden der Seite zufällig geändert werden müssen, sollten Sie stattdessen JavaScript verwenden, um den Inhalt client-seitig zu randomisieren.
Report incorrect code
Copy
Ask AI
{% for content in contents|random %}<div class="post-item">Post item markup</div>{% endfor %}
Sucht nach einem Regex-Muster und ersetzt es durch eine Sequenz von Zeichen. Das erste Argument ist ein Regex-Muster im RE2-Stil, das zweite ist der Ersatz-String.Erfahren Sie mehr über die RE2-Regex-Syntax.
Filtert eine Sequenz von Objekten, indem ein Ausdruckstest auf das Objekt angewendet wird und die Objekte, bei denen der Test erfolgreich war, zurückgewiesen werden.
Filtert eine Sequenz von Objekten, indem ein Test auf ein Attribut eines Objekts angewendet wird und die Objekte abgelehnt werden, bei denen der Test erfolgreich war.
Report incorrect code
Copy
Ask AI
{% for content in contents|rejectattr("post_list_summary_featured_image") %}<div class="post-item">{% if content.post_list_summary_featured_image %}<div class="hs-featured-image-wrapper"><a href="https://developers.hubspot.de/docs{{content.absolute_url}}" title="" class="hs-featured-image-link"><img src="{{ content.post_list_summary_featured_image }}" class="hs-featured-image"></a></div>{% endif %}{{ content.post_list_content|safe }}</div>{% endfor %}
Parameter
Typ
Beschreibung
attribute_name
Zeichenfolge
Gibt das auszuwählende Attribut an; Mithilfe der Punktnotation können Sie auf verschachtelte Attribute zugreifen.
exp_test
Zeichenfolge
Der Name des Ausdruckstests, der auf das Objekt angewendet werden soll
Kehrt das Objekt um oder gibt einen Iterator zurück, der das Objekt in umgekehrter Reihenfolge durchläuft; Um eine Liste umzukehren, verwenden Sie .reverse()
Report incorrect code
Copy
Ask AI
{% set nums = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] %}{% for num in nums|reverse %}{{ num }}{% endfor %}
Markieren Sie einen Wert als sicher, was bedeutet, dass diese Variable in einer Umgebung, in der automatisches Escaping aktiviert ist, nicht mit Escape-Zeichen versehen wird.
Bereinigt den Inhalt einer HTML-Eingabe für die Ausgabe von Rich-Text-Inhalten. Akzeptiert einen String und entfernt dann HTML-Tags, die nicht zulässig sind. Verwenden Sie diesen Filter für HubL-Variablen, die in HTML-Codes verwendet werden und sicheres HTML ermöglichen sollen.Sie können die folgenden Parameter einschließen, um bestimmte Typen von HTML-Tags zuzulassen: FORMATTING, BLOCKS, STYLES, LINKS, TABLES, IMAGES. Zum Beispiel: sanitize_html(IMAGES).Mit sanitize_html werden alle Parameter in den Filter aufgenommen.Sie können auch einen STRIP-Parameter einfügen, um alle HTML-Codes zu entfernen. Alle Inhalte werden auch über escape_jinjava ausgeführt, um eine verschachtelte Interpretation zu verhindern.
Report incorrect code
Copy
Ask AI
{% set escape_string = "This <br> <div>markup is <img src='test.com/image'> <span>printed</span> as text.</div>" %}{{ escape_string|sanitize_html("IMAGES") }}
Filtert eine Sequenz von Objekten, indem ein Test auf die Objekte angewendet wird und nur die Objekte ausgewählt werden, bei denen der Test erfolgreich war.
Filtert eine Sequenz von Objekten, indem er einen Test auf ein Attribut der Objekte anwendet und nur die Objekte auswählt, bei denen der Test erfolgreich war.
Report incorrect code
Copy
Ask AI
{% for content in contents|selectattr("post_list_summary_featured_image") %}<div class="post-item">{% if content.post_list_summary_featured_image %}<div class="hs-featured-image-wrapper"><a href="https://developers.hubspot.de/docs{{content.absolute_url}}" title="" class="hs-featured-image-link"><img src="{{ content.post_list_summary_featured_image }}" class="hs-featured-image"></a></div>{% endif %}{{ content.post_list_content|safe }}</div>{% endfor %}
Parameter
Typ
Beschreibung
attribute_name
Zeichenfolge
Das Attribut, auf das getestet werden soll. Mithilfe der Punktnotation können Sie auf verschachtelte Attribute zugreifen.
exp_test
Zeichenfolge
Der Name des Ausdruckstests, der auf das Objekt angewendet werden soll
Bei Verwendung dieses Filters wird die Seite nicht jedes Mal, wenn der Seiteninhalt aktualisiert wird, sondern in regelmäßigen Abständen vorgerendert. Dies bedeutet, dass der gefilterte Inhalt nicht bei jedem erneuten Laden der Seite aktualisiert wird.Dies ist möglicherweise kein Problem für bestimmte Arten von Inhalten, z. B. die Anzeige einer zufälligen Liste von Blogbeiträgen. Wenn Inhalte jedoch bei jedem Laden der Seite zufällig geändert werden müssen, sollten Sie stattdessen JavaScript verwenden, um den Inhalt client-seitig zu randomisieren.
Report incorrect code
Copy
Ask AI
{% for content in contents|shuffle %}<div class="post-item">Markup of each post</div>{% endfor %}
Zerschneiden eines Iterators und Rückgabe einer Liste von Listen, die diese Elemente enthalten; Der erste Parameter gibt an, wie viele Elemente in Scheiben geschnitten werden sollen, und der zweite Parameter gibt an, mit welchen Zeichen leere Scheiben gefüllt werden sollen.
Report incorrect code
Copy
Ask AI
{% set items = ["laptops", "tablets", "smartphones", "smart watches", "TVs"] %}<div class="columwrapper">{% for column in items|slice(3," ") %}<ul class="column-{{ loop.index }}">{% for item in column %}<li>{{ item }}</li>{% endfor %}</ul>{% endfor %}</div>
Parameter
Typ
Beschreibung
slices
Zahl
Wie viele Elemente werden geschnitten
filler
Zeichenfolge
Gibt Zeichen an, mit denen leere Slices aufgefüllt werden
Sortiert eine Iterable. Bei diesem Filter müssen alle Parameter nach einem Attribut in HubSpot sortiert werden. Der erste Parameter ist ein boolescher Wert, der die Sortierreihenfolge umkehrt. Der zweite Parameter bestimmt, ob bei der Sortierung zwischen Groß- und Kleinschreibung unterschieden wird. Und der letzte Parameter gibt ein Attribut an, nach dem sortiert werden soll. Im folgenden Beispiel werden Beiträge aus einem Blog gerendert und nach Namen alphabetisch geordnet.
Report incorrect code
Copy
Ask AI
{% set my_posts = blog_recent_posts("default", limit=5) %}{% for item in my_posts|sort(False, False, "name") %}{{ item.name }}<br>{% endfor %}
Parameter
Typ
Beschreibung
reverse
Boolesch
Wert auf true, um die Sortierreihenfolge umzukehren
case_sensitive
Boolesch
Wert auf true, damit bei der Sortierung zwischen Groß- und Kleinschreibung unterschieden wird
attribute
Zeichenfolge
Attribut, nach dem sortiert werden soll; Beim Sortieren einer Liste auslassen
Teilt den Eingabe-String in eine Liste mit dem angegebenen Separator auf. Der erste Parameter gibt den Separator an, mit dem die Variable geteilt werden soll. Der zweite Parameter bestimmt, wie oft die Variable aufgeteilt werden soll. Alle übrigen Elemente verbleiben dann in der Gruppe. Im folgenden Beispiel wird ein String von Namen am ; für die ersten vier Namen geteilt.
Report incorrect code
Copy
Ask AI
{% set string_to_split = "Mark; Irving; Helly; Dylan; Milchick; Harmony;" %}{% set names = string_to_split|split(";", 4) %}<ul>{% for name in names %}<li>{{ name }}</li>{% endfor %}</ul>
Parameter
Typ
Beschreibung
character_to_split_by
Zeichenfolge
Gibt den Separator an, durch den die Variable geteilt werden soll
number_of_splits
Zahl
Bestimmt, wie oft die Variable geteilt werden soll; Alle übrigen Elemente bleiben gruppiert.
Konvertiert einen anderen Variablentyp in einen String. Im folgenden Beispiel wird eine Ganzzahl in einen String umgewandelt (pprint wird verwendet, um die Änderung des Variablentyps zu bestätigen).
Report incorrect code
Copy
Ask AI
{% set number_to_string = 45 %}{{ number_to_string|string|pprint }}
Entfernt SGML/XML-Tags und ersetzt angrenzende Leerzeichen durch ein einziges Leerzeichen. Dieser Filter kann verwendet werden, um alle HTML-Tags aus einer Variablen zu entfernen.
Report incorrect code
Copy
Ask AI
{% set some_html = "<div><strong>Some text</strong></div>" %}{{ some_html|striptags }}
Addiert numerische Werte in einer Sequenz. Der erste Parameter kann ein optionales Attribut angeben und der zweite Parameter legt einen Wert fest, der zurückgegeben wird, wenn die zu summierende Variable nichts enthält.
Report incorrect code
Copy
Ask AI
// 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") }}
Parameter
Typ
Beschreibung
attribute
Zeichenfolge
Zu summierendes Attribut
return_if_nothing
Zeichenfolge
Wert, der zurückgegeben wird, wenn die zu summierende Variable nichts enthält
Dieser Filter gibt die symmetrische Differenz von zwei Mengen oder Listen zurück. Die vom Filter zurückgegebene Liste enthält alle eindeutigen Elemente, die in der ersten Liste enthalten sind, aber nicht in der zweiten, oder die in der zweiten Liste enthalten sind, aber nicht in der ersten.
Entfernt vor- und nachgestellte Leerzeichen. HubSpot schneidet bereits Leerzeichen aus dem Markup ab, aber dieser Filter ist der Vollständigkeit halber dokumentiert.
Schneidet den Text nach einer bestimmten Anzahl von Zeichen ab. Der Standardwert ist 255. HTML-Zeichen sind in dieser Zahl enthalten.
Hinweis: Da dieser Filter auf die Leerzeichen zwischen den Wörtern angewiesen ist, um Zeichenfolgen zu kürzen, funktioniert er für Sprachen ohne Leerzeichen zwischen Zeichen, wie z. B. Japanisch, möglicherweise nicht wie erwartet.
Report incorrect code
Copy
Ask AI
{{ "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, "..........") }}
Parameter
Typ
Beschreibung
number_of_characters
Zahl
Erlaubte Anzahl der Zeichen, bevor der Text gekürzt wird. Der Standardwert ist 255.
breakword
Boleesch
Bei true schneidet der Filter den Text auf die angegebene Länge ab. Bei false wird das letzte Wort verworfen.
end
Zeichenfolge
Überschreiben Sie die standardmäßigen „…“ Zeichen nach dem Abschneiden
Kürzt einen vorgegebenen String unter Berücksichtigung des HTML-Markups (d. h., alle verschachtelten Tags werden korrekt geschlossen); Dadurch wird verhindert, dass ein Tag nach dem Abschneiden offen bleibt. HTML-Zeichen werden nicht auf die Gesamtzahl der Zeichen angerechnet.
Hinweis: Da dieser Filter auf die Leerzeichen zwischen den Wörtern angewiesen ist, um Zeichenfolgen zu kürzen, funktioniert er für Sprachen ohne Leerzeichen zwischen Zeichen, wie z. B. Japanisch, möglicherweise nicht wie erwartet.
Report incorrect code
Copy
Ask AI
{% set html_text = "<p>I want to truncate this text without breaking my HTML<p>" %}{{ html_text|truncatehtml(28, "..." , false) }}
Parameter
Typ
Beschreibung
number_of_characters
Zahl
Erlaubte Anzahl der Zeichen, bevor der Text gekürzt wird. Der Standardwert ist 255.
end
Zeichenfolge
Überschreiben Sie die standardmäßigen „…“ Zeichen nach dem Abschneiden
breakword
Boolesch
Boolescher Wert; Bei true schneidet der Filter den Text auf die angegebene Länge ab. Bei false (Standard) wird das letzte Wort verworfen. Wenn Sie nur einen der optionalen Parameter verwenden, benutzen Sie Schlüsselwortargumente wie truncatehtml(70, breakwords = false).
Dieser Filter gibt die Vereinigung von zwei Mengen oder Listen zurück. Die vom Filter zurückgegebene Liste enthält alle eindeutigen Elemente, die in beiden Listen enthalten sind.
Report incorrect code
Copy
Ask AI
{{ [1, 2, 3]|union([2, 3, 4, 5]) }}
Parameter
Typ
Beschreibung
list
Array
Die zweite Liste zur Vereinigung mit der ursprünglichen Liste
Dieser Filter extrahiert eine eindeutige Menge aus einer Sequenz oder einem Dict von Objekten. Wenn Sie ein Dict filtern, z. B. eine Liste von Beiträgen, die von einer Funktion zurückgegeben wird, können Sie angeben, welches Attribut verwendet wird, um Elemente im Dict zu deduplizieren.
Sie sollten diesen Filter nur für Variablen verwenden, die ein Datum zurückgeben. Ab dem 30. September 2024 gibt dieser Filter nicht mehr das aktuelle Datum zurück, wenn ein Nullwert übergeben wird. Nach diesem Datum wird bei einem Nullwert im Filter September 30, 2024 zurückgegeben.
Versieht einen String mit Escape-Zeichen und URL-codiert ihn mit UTF-8-Formatierung. Akzeptiert sowohl Dictionaries und reguläre Strings als auch paarweise Iterablen.
Report incorrect code
Copy
Ask AI
{% set encode_value="Escape & URL encode this string" %}{{ encode_value|urlencode }}
Konvertiert URLs im Klartext in klickbare Links um. Wenn Sie dem Filter eine zusätzliche ganze Zahl übergeben, werden die URLs auf diese Zahl gekürzt. Der zweite Parameter ist ein boolescher Wert, der an festlegt, ob der Link rel=“no follow” ist. Mit dem letzten Parameter können Sie angeben, ob der Link in einer neuen Registerkarte geöffnet werden soll.
Parameter
Typ
Beschreibung
shorten_text
Zahl
Ganzzahl, die die URLs auf die gewünschte Anzahl kürzt
no_follow
Boolesch
Bei Festlegung auf true enthält der Link rel="no follow"
target="_blank"
Zeichenfolge
Gibt an, ob der Link in einem neuen Tab geöffnet wird
Bewirkt den Umbruch von Wörtern bei einer bestimmten Zeichenanzahl. Dies funktioniert am besten in einem <pre>, da HubSpot standardmäßig Leerzeichen entfernt.
Report incorrect code
Copy
Ask AI
{% 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) }}
Parameter
Beschreibung
character_count
Anzahl der Zeichen, mit denen der Inhalt umgebrochen werden soll.
Erstellt einen HTML/XML-Attribut-String, der auf den Elementen in einem Dict basiert; Alle Werte, die weder keines noch undefiniert sind, werden automatisch mit Escape-Zeichen versehen. Es wird automatisch ein Leerzeichen vor das Element gesetzt, wenn der Filter etwas zurückgegeben hat, es sei denn, der erste Parameter ist falsch.