HubL-Filter

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.

Ruft den Absolutwert einer Zahl ab. Sie können diesen Filter verwenden, um sicherzustellen, dass eine Zahl positiv ist.

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 &nbsp (den zweiten Parameter) ersetzt wird.

Das folgende Beispiel zeigt, wie ein center-Filter auf eine Variable in einem pre-Tag angewendet wird, sodass die Leerzeichen nicht entfernt werden.

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.

Berechnet den ellipsoiden 2D-Abstand zwischen zwei Punkten auf der Erde.

Der groupby-Filter gruppiert eine Sequenz von Objekten nach einem gemeinsamen Attribut. Der Parameter legt das gemeinsame Attribut fest, nach dem gruppiert werden soll.

Der indent-Filter verwendet Leerzeichen, um Text innerhalb einer bestimmten Feldlänge einzurücken. 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 ein center-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.

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.

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.

Wird zu true ausgewertet, wenn der Wert eine gültige IPv4- oder IPv6-Adresse ist.

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.

Gibt das letzte Element einer Sequenz zurück.

Gibt die Anzahl der Elemente einer Sequenz oder einer Zuordnung zurück.

Konvertieren Sie die Zahlenwerte in eine Liste. Wenn es sich um einen String handelt, ist die zurückgegebene Liste eine Liste von Zeichen. Um Strings zu einer Sequenz hinzuzufügen, fügen Sie sie einfach den String-Variablen an den Sequenztennzeichen [ ] hinzu.

Berechnet den natürlichen Logarithmus einer Zahl.

Konvertiert einen Wert in Kleinbuchstaben.

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.

Berechnet den md5-Hash des angegebenen Objekts

Zieht eine Zeitdauer von einem datetime-Objekt ab.

Multipliziert einen Wert mit einer Zahl. Funktioniert genauso wie der Operator *.

Addiert eine Zeitdauer zu einem datetime-Objekt hinzu.

Gibt eine Variable als pretty print aus. Dies druckt den Typ der Variablen und andere Informationen, die für das Debugging nützlich sind.

Gibt ein zufälliges Element aus der Sequenz zurück.

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.

Informationen über die RE2-Regex-Syntax finden Sie hier.

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. 

Rendering von Strings, die HubL enthalten, damit die Ausgabe an andere Filter weitergegeben werden kann.

Ersetzt alle Instanzen eines Substrings durch eine neue. 

Kehren Sie das Objekt um oder geben Sie einen Iterator zurück, der das Objekt in umgekehrter Reihenfolge durchläuft. Um eine Liste umzukehren, verwenden Sie .reverse()

Berechnet die Quadratwurzel eines Wertes.

Rundet die Zahl auf eine bestimmte Genauigkeit.

Markieren Sie den 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.

Wenn Sie diesen Filter verwenden, können Sie die folgenden Parameter einfügen, um bestimmte Arten 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.

Filtert eine Sequenz von Objekten, indem ein Test auf das Objekt 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 eines Objekts anwendet und nur die Objekte auswählt, bei denen der Test erfolgreich war.

Legt die Reihenfolge der Iteration durch eine Sequenz wird zufällig fest. Im folgenden Beispiel wird eine Standard-Blogschleife gemischt.

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.

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.

Teilt den Eingabez-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 einen String von Namen am „;“ für die ersten 4 Namen geteilt.

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).

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.

Konvertiert einen datetime-String und ein datetime-Format in ein datetime-Objekt.

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.

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.

Gibt eine Title-Case-Version des Wertes zurück. D.h., Wörter beginnen mit Großbuchstaben, alle anderen Zeichen sind in Kleinbuchstaben geschrieben.

Schreibt ein Objekt als JSON-String.

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. Bitte beachten Sie, dass HTML-Zeichen in dieser Zahl enthalten sind. Die Länge wird mit dem ersten Parameter angegeben, der standardmäßig 255 beträgt. Wenn der zweite Parameter true ist, schneidet der Filter den Text den Text auf die angegebene Länge ab. Andernfalls wird das letzte Wort verworfen. Wenn der Text tatsächlich abgeschnitten wurde, wird ein Auslassungszeichen („…“) angehängt. Wenn Sie ein anderes Auslassungszeichen als „…“ wünschen, können Sie es mit dem dritten Parameter angeben.

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. Dieser Filter hat einen Parameter für die Länge und einen Parameter für Abschneiden-Symbol. Es gibt einen dritten booleschen Parameter, der angibt, ob die Wörter bei der angegebenen Länge umgebrochen werden sollen. Dieser Parameter ist standardmäßig false, damit die Länge der Wörter erhalten bleibt. 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.

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.

Dieser Filter wandelt ein datetime-Objekt in einen Unix-Zeitstempel um.

Konvertiert einen Wert in Großbuchstaben.

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.

Decodiert codierte URL-Strings zurück zur die ursprünglichen URL. Akzeptiert sowohl Dictionaries und reguläre Strings als auch paarweise Iterablen.

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 angibt, 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.

Zählt die Anzahl der Wörter in einem String.

Bewirkt den Umbruch von Wörtern bei einer bestimmten Zeichenanzahl. Dies funktioniert am besten in einem <pre>, da HubSpot standardmäßig Leerzeichen entfernt.

Erstellen Sie einen HTML/XML-Attribut-String, der auf den Elementen in einem Dict basiert. Alle Werte, die weder „keine“
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.