HubL-Filterliste und Beispiele für HubSpot CMS-Entwickler.
|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.
content.absolute_url
.
Parameter | Beschreibung |
---|---|
attribute_name | Gibt an, welches Attribut gedruckt werden soll. |
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.
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 |
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 . |
Parameter | Typ | Beschreibung |
---|---|---|
width | Zahl | Gibt die Länge des Leerraums an, in dem der Text zentriert werden soll |
Parameter | Typ | Beschreibung |
---|---|---|
characters_to_cut | Zeichenfolge | Der Teil des Strings, der entfernt werden soll. |
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.
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 |
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 |
Parameter | Typ | Beschreibung |
---|---|---|
list | Array | Die zweite Liste, die zum Vergleich herangezogen wird, um Unterschiede zur ursprünglichen Liste zu finden |
Parameter | Typ | Beschreibung |
---|---|---|
divisor | Zahl | Die Zahl, durch die die Variable geteilt werden soll |
divisibleby
wird dieser Filter zu „true“ ausgewertet, wenn der Wert durch die angegebene Zahl teilbar ist.
Parameter | Typ | Beschreibung |
---|---|---|
divisor | Zahl | Die Zahl, die verwendet werden soll, wenn geprüft wird, ob der Wert teilbar ist |
&
, <
, >
, ‘
, ”
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.
&
, <
, ‘
, ”
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.
{
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.
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.
binary
-Parameter auf true
festlegen, um binäre Präfixe wie Mebi (MiB) und Gibi (GiB) zu verwenden.
Parameter | Typ | Beschreibung |
---|---|---|
binary | Boolesch | Bei Festlegung auf true werden binäre Präfixe verwendet, z. B. Mebi (MiB) und Gibi (GiB). |
0.0
zurückgegeben. Sie können diese Vorgabe mit dem ersten Parameter außer Kraft setzen.
Parameter | Typ | Beschreibung |
---|---|---|
default | Zahl | Integer, der zurückgegeben wird, wenn die Konvertierung nicht funktioniert |
%s
kann durch eine andere Variable ersetzt werden.
Parameter | Typ | Beschreibung |
---|---|---|
locale | Zeichenfolge | 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. |
Parameter | Typ | Beschreibung |
---|---|---|
format | 'short' | 'medium' | 'long' | 'full' | benutzerdefiniertes Muster | Das zu verwendende Format; Kann ein benutzerdefiniertes Muster gemäß Unicode LDML sein. |
timeZone | Zeichenfolge | Die Zeitzone des Ausgabedatums im IANA-TZDB-Format |
locale | Zeichenfolge | Das Gebietsschema, das für Formate verwendet werden soll, die das Gebietsschema berücksichtigen Siehe Liste der unterstützten Gebietsschemata. |
Parameter | Typ | Beschreibung |
---|---|---|
format | 'short' | 'medium' | 'long' | 'full' | benutzerdefiniertes Muster | 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. |
locale | Zeichenfolge | Das Gebietsschema, das für Formate verwendet werden soll, die das Gebietsschema berücksichtigen Siehe Liste der unterstützten Gebietsschemata. |
Parameter | Typ | Beschreibung |
---|---|---|
locale | Zeichenfolge | Das Gebietsschema, das für Formate verwendet werden soll. Siehe Liste der unterstützten Gebietsschemata. |
maxDecimalDigits | Zahl | Die maximale Anzahl an Dezimalstellen, die die Ausgabe umfassen darf. Standardmäßig wird die Anzahl der Dezimalstellen vom Eingabewert verwendet. |
Parameter | Typ | Beschreibung |
---|---|---|
format | 'short' | 'medium' | 'long' | 'full' | benutzerdefiniertes Muster | 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. |
locale | Zeichenfolge | Das Gebietsschema, das für Formate verwendet werden soll, die das Gebietsschema berücksichtigen Siehe Liste der unterstützten Gebietsschemata. |
Parameter | Beschreibung |
---|---|
attribute | Das Attribut, nach dem gruppiert werden soll. |
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.
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. |
0
zurückgegeben. Sie können diese Vorgabe mit dem ersten Parameter außer Kraft setzen.
Parameter | Typ | Beschreibung |
---|---|---|
default | Zahl | Integer, der zurückgegeben wird, wenn die Konvertierung nicht funktioniert |
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 |
true
ausgewertet, wenn der Wert eine gültige IPv4- oder IPv6-Adresse ist.
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 |
[ ]
enthalten.
Parameter | Typ | Beschreibung |
---|---|---|
base | Zahl | Die Basis, die für die Protokollberechnung verwendet werden soll |
Parameter | Typ | Beschreibung |
---|---|---|
filter | Zeichenfolge | Filter, der auf die Sequenz von Objekten angewendet werden soll |
Parameter | Typ | Beschreibung |
---|---|---|
diff | Zahl | Betrag, der abgezogen werden soll |
timeunit | Zeichenfolge | Gültige Zeiteinheiten sind nanos , micros , millis , seconds , minutes , hours , half_days , days , weeks , months , years , decades , centuries , millennia und eras . |
Parameter | Typ | Beschreibung |
---|---|---|
diff | Zahl | Betrag, der abgezogen werden soll |
timeunit | Zeichenfolge | Gültige Zeiteinheiten sind nanos , micros , millis , seconds , minutes , hours , half_days , days , weeks , months , years , decades , centuries , millennia und eras . |
Parameter | Typ | Beschreibung |
---|---|---|
exp_text | Zeichenfolge | Der Name des Ausdruckstests, der auf das Objekt angewendet werden soll |
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 |
Parameter | Typ | Beschreibung |
---|---|---|
old | Zeichenfolge | Der Substring, der ersetzt werden soll |
new | Zeichenfolge | Ersatz-String |
count | Zahl | Falls angegeben, werden nur die Vorkommen der ersten Anzahl ersetzt |
Parameter | Typ | Beschreibung |
---|---|---|
nth_root | Zahl | Die n-te Wurzel, die für die Berechnung verwendet werden soll |
Parameter | Typ | Beschreibung |
---|---|---|
precision | Zahl | Gibt die Genauigkeit der Rundung an |
rounding_method | 'common' (Standard) | 'ceil' | 'floor' | Optionen umfassen common auf- oder abrunden (Standard); ceil immer aufrunden; floor immer abrunden |
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.
Parameter | Typ | Beschreibung |
---|---|---|
exp_text | Zeichenfolge | Der Ausdruckstest, der auf das Objekt angewendet werden soll |
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 |
val | Zeichenfolge | Wert, auf den getestet werden soll |
Parameter | Typ | Beschreibung |
---|---|---|
slices | Zahl | Wie viele Elemente werden geschnitten |
filler | Zeichenfolge | Gibt Zeichen an, mit denen leere Slices aufgefüllt werden |
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 |
;
für die ersten vier Namen geteilt.
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. |
pprint
wird verwendet, um die Änderung des Variablentyps zu bestätigen).
Parameter | Typ | Beschreibung |
---|---|---|
dateFormat | Zeichenfolge | Das zu verwendende Datumsformat |
Parameter | Typ | Beschreibung |
---|---|---|
datetimeFormat | Zeichenfolge | Das zu verwendende Datums- und Zeitformat |
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 |
Parameter | Typ | Beschreibung |
---|---|---|
list | Array | Die zweite Liste, mit der die symmetrische Differenz zur ursprünglichen Liste ermittelt wird |
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 |
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) . |
Parameter | Typ | Beschreibung |
---|---|---|
list | Array | Die zweite Liste zur Vereinigung mit der ursprünglichen Liste |
Parameter | Typ | Beschreibung |
---|---|---|
attr | Zeichenfolge | Gibt das Attribut an, das beim Filtern eines dict-Wertes verwendet werden soll |
September 30, 2024
zurückgegeben.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 |
striptags
, um eine genaue Zählung zu erhalten.<pre>
, da HubSpot standardmäßig Leerzeichen entfernt.
Parameter | Beschreibung |
---|---|
character_count | Anzahl der Zeichen, mit denen der Inhalt umgebrochen werden soll. |
Parameter | Typ | Beschreibung |
---|---|---|
autospace | Boolesch | Wert auf true , um ein Leerzeichen vor dem Element hinzuzufügen |