markup is printed as text" %}
| {{ column }} | {% endfor %}
| apples | oranges | pears |
| grapes | blueberries |
{% set var = "string to center" %}
before{{ var|center(80) }}after
```
```html example.html theme={null}
before string to center after```
`タグ内の変数に`indent`フィルターを適用しています。最初のパラメーターは空白の幅を制御し、2番目のブール値は最初の行をインデントするかどうかを切り替えます。```html example.html theme={null} | パラメーター | タイプ | 説明 | | -------------- | ---- | ---------------------------- | | `width` | 数値 | 適用される空白の幅。 | | `indent-first` | ブール値 | `true`に設定すると、最初の行がインデントされます。 | ## int 値を整数に変換します。正常に変換できない場合は`0`を返します。このデフォルトの動作は、最初のパラメーターを使用することで変更できます。{% set var = "string to indent" %} {{ var|indent(2, true) }}``` ```text 出力のレンダリング.txt theme={null} string to indent ``````text hubl.txt theme={null} {% set string="25" %} {{ string|int + 17 }} ``` ```text 出力のレンダリング.txt theme={null} 42 ``` | パラメーター | タイプ | 説明 | | --------- | --- | ------------------- | | `default` | 数値 | 正常に変換できない場合に返される整数。 | ## intersect 2つのセットまたはリストの共通部分を返します。フィルターから返されるリストには、両方のリストに含まれる一意の要素が全て格納されます。```text hubl.txt theme={null} {{ [1, 2, 3]|intersect([2, 3, 4, 5]) }} ``` ```text 出力のレンダリング.txt theme={null} [2, 3] ``` | パラメーター | タイプ | 説明 | | ------ | --- | --------------------------------- | | `list` | 整列 | 最初のリストとの共通部分を見つけるために比較される2番目のリスト。 | ## ipaddr 値が有効なIPv4またはIPv6アドレスの場合には、`true`と評価されます。```text hubl.txt theme={null} {% set ip = "1.0.0.1" %} {% if ip|ipaddr %} The string is a valid IP address {% endif %} ``` ```text 出力のレンダリング.txt theme={null} The string is a valid IP address ``` ## join シーケンスの文字列を連結した1つの文字列を返します。要素間はデフォルトでは空文字列で区切られますが、任意指定のパラメーターを使って区切り文字を定義できます。2番目のパラメーターを使用すると、結合する属性を指定できます。```text hubl.txt theme={null} {% set my_list = [1, 2, 3] %} {% set sep = "---" %} {{ my_list|join }} {{ my_list|join("|") }} {{ my_list|join(sep) }} ``` ```text 出力のレンダリング.txt theme={null} 123 1|2|3 1---2---3 ``` | パラメーター | タイプ | 説明 | | ----------- | ------ | ----------------- | | `delimiter` | 文字列 | 文字列の連結に使用する区切り文字。 | | `attribute` | HubL変数 | オブジェクト内で結合する値の属性。 | ## last シーケンスの最後の項目を返します。```text hubl.txt theme={null} {% set my_sequence = ["Item 1", "Item 2", "Item 3"] %} {% my_sequence|last %} ``` ```text 出力のレンダリング.txt theme={null} Item 3 ``` ## length シーケンスまたはマッピング内の項目数を返します。```text hubl.txt theme={null} {% set services = ["Web design", "SEO", "Inbound Marketing", "PPC"] %} {{ services|length }} ``` ```text 出力のレンダリング.txt theme={null} 4 ``` ## list 値を変換して1つのリストにします。文字列は、角括弧シーケンスの区切り文字`[ ]`で囲まれていない限り、別々の文字として返されます。```text hubl.txt theme={null} {% 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 }} ``` ```text 出力のレンダリング.txt theme={null} [1, 2, t, h, r, e, e, four] ``` ## log 数値の自然対数を計算します。```text hubl.txt theme={null} {{ 10|log }} {{ 65536|log(2) }} ``` ```text 出力のレンダリング.txt theme={null} 2.302585092994046 16.0 ``` | パラメーター | タイプ | 説明 | | ------ | --- | ------------ | | `base` | 数値 | 対数計算に使用する基数。 | ## lower 値に含まれる全ての文字を小文字に変換します。```text hubl.txt theme={null} {% set text="Text to MAKE LowercaSe" %} {{ text|lower }} ``` ```text 出力のレンダリング.txt theme={null} text to make lowercase ``` ## map オブジェクトのシーケンスにフィルターを適用するか、属性を検索します。オブジェクトリストを扱うとき、その中の特定の値だけに対象を絞り込むには、これが便利です。 基本的な使用法は、属性に対するマッピングです。例えば、ディクショナリーの特定の属性に特定の値が存在するかどうかを検査する条件付きロジックを使用する場合です。または、フィルター名と引数を渡してフィルターを起動することもできます。```text hubl.txt theme={null} {# 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")}} ``` ```text 出力のレンダリング.txt theme={null} Apply a filter to a sequence: [ITEM1, ITEM2, ITEM3] Look up an attribute: [DRAFT] ``` | パラメーター | タイプ | 説明 | | -------- | --- | ----------------------- | | `filter` | 文字列 | オブジェクトのシーケンスに適用するフィルター。 | ## md5 特定のオブジェクトの[md5ハッシュ](https://ja.wikipedia.org/wiki/MD5)を計算します。```text hubl.txt theme={null} {{ content.absolute_url|md5 }} ``` ```text 出力のレンダリング.txt theme={null} 923adb4ce05a4c6342c04c80be88d15e ``` ## minus\_time 日時オブジェクトで一定の時間を差し引きます。```text hubl.txt theme={null} {% set date = "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %} {{ date }} {{ date|minus_time(2, "months") }} ``` ```text 出力のレンダリング.txt theme={null} 2018-07-14 14:31:30 2018-05-14 14:31:30 ``` | パラメーター | タイプ | 説明 | | ---------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `diff` | 数値 | 差し引く数量。 | | `timeunit` | 文字列 | 有効な時間単位は、`nanos`、`micros`、`millis`、`seconds`、`minutes`、`hours`、`half_days`、`days`、`weeks`、`months`、`years`、`decades`、`centuries`、`millennia`、`eras`です。 | ## multiply 1つの値を数値で乗算します。[\*演算子](/cms/reference/hubl/operators-and-expression-tests)と同じ機能です。```text hubl.txt theme={null} {% set n = 20 %} {{ n|multiply(3) }} ``` ```text 出力のレンダリング.txt theme={null} 60 ``` ## plus\_time 日時オブジェクトに一定の時間を加えます。```text hubl.txt theme={null} {% set date = "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ") %} {{ date }} {{ date|plus_time(5, "days") }} ``` ```text 出力のレンダリング.txt theme={null} 2018-07-14 14:31:30 2018-07-19 14:31:30 ``` | パラメーター | タイプ | 説明 | | ---------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `diff` | 数値 | 差し引く数量。 | | `timeunit` | 文字列 | 有効な時間単位は、`nanos`、`micros`、`millis`、`seconds`、`minutes`、`hours`、`half_days`、`days`、`weeks`、`months`、`years`、`decades`、`centuries`、`millennia`、`eras`です。 | ## pprint 変数をpprintします。変数の型など、デバッグに役立つ情報を出力します。```text hubl.txt theme={null} {% set this_var ="Variable that I want to debug" %} {{ this_var|pprint }} ``` ```text 出力のレンダリング.txt theme={null} (String: Variable that I want to debug) ``` ## random シーケンスからランダムな1つの項目を返します。### 注: このフィルターを使用すると、ページコンテンツの更新時ではなく、定期的にページの[プリレンダリング](/cms/best-practices/testing-staging-performance/prerendering)が実行されます。つまり、フィルタリングされたコンテンツは、ページの再読み込みのたびに更新されるわけではありません。 これは、ブログ記事のランダムなリストの表示など、特定のタイプのコンテンツでは特に問題ではありません。ただし、ページを読み込むたびにコンテンツをランダムに変更する必要がある場合には、代わりにJavaScriptを使用してコンテンツをクライアント側でランダム化する必要があります。 ```text hubl.txt theme={null} {% for content in contents|random %} ## regex\_replace 正規表現パターンを検索して、文字シーケンスで置換します。最初の引数はRE2形式の正規表現パターン、2つ目は置換文字列です。 詳しくは[RE2正規表現の構文](https://github.com/google/re2/wiki/Syntax)（英語）をご確認ください。Post item markup{% endfor %} ``` ```text 出力のレンダリング.txt theme={null}Random post``````text hubl.txt theme={null} {{ "contact-us-2"|regex_replace("[^a-zA-Z]", "") }} ``` ```text 出力のレンダリング.txt theme={null} contactus ``` ## reject オブジェクトに[式による検証](/cms/reference/hubl/operators-and-expression-tests)を適用して、該当する要素を拒否することにより、オブジェクトのシーケンスをフィルタリングします。```text hubl.txt theme={null} {% set some_numbers = [10, 12, 13, 3, 5, 17, 22] %} {{ some_numbers|reject("even") }} ``` ```text 出力のレンダリング.txt theme={null} [13, 3, 5, 17] ``` | パラメーター | タイプ | 説明 | | ---------- | --- | ----------------------------------------------------------------------------------------- | | `exp_text` | 文字列 | オブジェクトに適用する[式評価](/cms/reference/hubl/operators-and-expression-tests#expression-tests)の名前。 | ## rejectattr オブジェクトの属性を検証して該当する要素を拒否することにより、オブジェクトのシーケンスをフィルタリングします。```html example.html theme={null} {% for content in contents|rejectattr("post_list_summary_featured_image") %} | パラメーター | タイプ | 説明 | | ---------------- | --- | ----------------------------------------------------------------------------------------- | | `attribute_name` | 文字列 | 選択する属性を指定します。ドット表記を使用すると、ネストされた属性にアクセスできます。 | | `exp_test` | 文字列 | オブジェクトに適用する[式評価](/cms/reference/hubl/operators-and-expression-tests#expression-tests)の名前。 | ## render HubLを含む文字列を早期にレンダリングして、出力を他のフィルターに渡すことができるようにします。{% if content.post_list_summary_featured_image %}{% endfor %} ``` ```html example.html theme={null}{% endif %} {{ content.post_list_content|safe }}
Post with no featured imagePost with no featured imagePost with no featured image``````html example.html theme={null} {{ personalization_token("contact.lastname", "default value")|render|lower }} ``` ```html example.html theme={null} mclaren ``` ## replace 部分文字列の全てのインスタンスを、新しいものに置換します。```html example.html theme={null} {% if topic %} | パラメーター | タイプ | 説明 | | ------- | --- | ------------------------ | | `old` | 文字列 | 置換の対象にする部分文字列。 | | `new` | 文字列 | 置換する文字列。 | | `count` | 数値 | 指定した場合、最初の出現数分のみが置換されます。 | ## reverse オブジェクトを反転します。または、オブジェクトを逆順に反復処理するイテレーターを返します。リストを反転するには[.reverse()](/cms/reference/hubl/functions#reverse)を使用しますPosts about {{ page_meta.html_title|replace("Blog | ", "") }}
{% endif %} ``` ```html example.html theme={null}Posts about topic name
``````text hubl.txt theme={null} {% set nums = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] %} {% for num in nums|reverse %} {{ num }} {% endfor %} ``` ```text 出力のレンダリング.txt theme={null} 10 9 8 7 6 5 4 3 2 1 ``` ## root 値の平方根を計算します。```text hubl.txt theme={null} {{ 16|root }} {{ 625|root(4) }} ``` ```text 出力のレンダリング.txt theme={null} 4 5 ``` | パラメーター | タイプ | 説明 | | ---------- | --- | ----------- | | `nth_root` | 数値 | 計算に使用するn乗根。 | ## round 数値を指定された精度で四捨五入します。```text hubl.txt theme={null} {{ 52.5|round }} {{ 52.5|round(0, "floor") }} ``` ```text 出力のレンダリング.txt theme={null} 53 52 ``` | パラメーター | タイプ | 説明 | | ----------------- | ------------------------------------------ | ----------------------------------------------------------------- | | `precision` | 数値 | 端数処理の精度を指定します。 | | `rounding_method` | `'common'`（デフォルト） \| `'ceil'` \| `'floor'` | オプションには、`common`（四捨五入：デフォルト）、`ceil`（常に切り上げ）、`floor`（常に切り下げ）があります。 | ## safe 値に「safe」のマークを付けます。つまり、自動エスケープが有効になっている環境で、この変数はエスケープされません。```text hubl.txt theme={null} {{ content.post_list_content|safe }} ``` ```html example.html theme={null} ## sanitize\_html リッチ テキスト コンテンツの出力用にHTML入力のコンテンツをサニタイズ処理します。文字列を受け入れ、許可されていないHTMLタグを削除します。HTMLで使用されており、安全なHTMLを許可するHubL変数に、このフィルターを使用します。 特定のタイプのHTMLタグを許可するパラメーターとして、`FORMATTING`、`BLOCKS`、`STYLES`、`LINKS`、`TABLES`、`IMAGES`を含めることができます。例えば、`sanitize_html(IMAGES)`です。 `sanitize_html`を使用すると、全てのパラメーターがフィルターに含められます。 さらに`STRIP`パラメーターを含めると、全てのHTMLを削除できます。また、ネストされた解釈を防ぐ目的で、全てのコンテンツが`escape_jinjava`を介して実行されます。HTML post content that is not escaped.
``````text hubl.txt theme={null} {% set escape_string = "This ## select オブジェクトを検証して該当する要素だけを選ぶことにより、オブジェクトのシーケンスをフィルタリングします。
markup is" %} {{ escape_string|sanitize_html("IMAGES") }} ``` ```html example.html theme={null} This markup isprinted as text.
```text hubl.txt theme={null} {% set some_numbers = [10, 12, 13, 3, 5, 17, 22] %} {{ some_numbers|select("even") }} ``` ```html example.html theme={null} [10, 12, 22] ``` | パラメーター | タイプ | 説明 | | ---------- | --- | ------------- | | `exp_text` | 文字列 | オブジェクトを検証する式。 | ## selectattr オブジェクトの属性を検証して該当する要素だけを選ぶことにより、オブジェクトのシーケンスをフィルタリングします。```html example.html theme={null} {% for content in contents|selectattr("post_list_summary_featured_image") %} | パラメーター | タイプ | 説明 | | ---------------- | --- | ----------------------------------------------------------------------------------------- | | `attribute_name` | 文字列 | テストする属性。ドット表記を使用すると、ネストされた属性にアクセスできます。 | | `exp_test` | 文字列 | オブジェクトに適用する[式評価](/cms/reference/hubl/operators-and-expression-tests#expression-tests)の名前。 | | `val` | 文字列 | テストの対象となる値。 | ## shuffle シーケンス内の反復の順序をランダムにします。以下の例は、標準的なブログのループをシャッフルします。{% if content.post_list_summary_featured_image %}{% endfor %} ``` ```html example.html theme={null}{% endif %} {{ content.post_list_content|safe }}```Post with featured image
### 注: このフィルターを使用すると、ページコンテンツの更新時ではなく、定期的にページの[プリレンダリング](/cms/best-practices/testing-staging-performance/prerendering)が実行されます。つまり、フィルタリングされたコンテンツは、ページの再読み込みのたびに更新されるわけではありません。 これは、ブログ記事のランダムなリストの表示など、特定のタイプのコンテンツでは特に問題ではありません。ただし、ページを読み込むたびにコンテンツをランダムに変更する必要がある場合には、代わりにJavaScriptを使用してコンテンツをクライアント側でランダム化する必要があります。 ```html example.html theme={null} {% for content in contents|shuffle %} ## slice イテレーターをスライスして、これらの項目を含むリストの一覧を返します。最初のパラメーターにはスライスされる項目数を指定し、2番目のパラメーターには空白のスライスに埋める文字を指定します。Markup of each post{% endfor %} ``` ```html example.html theme={null}Markup of each post 5Markup of each post 3Markup of each post 1Markup of each post 2Markup of each post 4``````html example.html theme={null} {% set items = ["laptops", "tablets", "smartphones", "smart watches", "TVs"] %} | パラメーター | タイプ | 説明 | | -------- | --- | -------------------- | | `slices` | 数値 | スライスされる項目の数。 | | `filler` | 文字列 | 空白のスライスに埋める文字を指定します。 | ## sort 反復可能データを並べ替えます。このフィルターを使ってHubSpotで属性を基準に並べ替える際には、全てのパラメーターが必須です。最初のパラメーターは、並べ替え順序を逆にするブール値です。2番目のパラメーターは、並べ替えで大文字と小文字を区別するかどうかを決定します。最後のパラメーターは、並べ替え基準となる属性を指定します。以下の例ではブログ内の記事が、名前のアルファベット順でレンダリングされます。{% for column in items|slice(3," ") %}``` ```html example.html theme={null}{% for item in column %}
{% endfor %}- {{ item }}
{% endfor %}```
- laptops
- tablets
- smartphones
- smart watches
- TVs
```html example.html theme={null} {% set my_posts = blog_recent_posts("default", limit=5) %} {% for item in my_posts|sort(False, False, "name") %} {{ item.name }} | パラメーター | タイプ | 説明 | | ---------------- | ---- | -------------------------------- | | `reverse` | ブール値 | 並べ替え順序を逆にするには、`true`に設定します。 | | `case_sensitive` | ブール値 | `true`に設定すると、並べ替えで大文字と小文字が区別されま。 | | `attribute` | 文字列 | 並べ替えの基準となる属性。リストを並べ替えるときには省略します。 | ## split 入力文字列を特定の区切り文字で分割して、リストにします。最初のパラメーターは、変数を分割する基準となる区切り文字を指定します。2番目のパラメーターは、変数の分割回数を決定します。残りの項目が存在する場合、それらはグループ化されたままになります。以下の例では、複数の名前からなる1つの文字列が`;`を基準に最初の4回だけ分割されます。
{% endfor %} ``` ```html example.html theme={null} A post
B post
C post
D post
E post
``````html example.html theme={null} {% set string_to_split = "Mark; Irving; Helly; Dylan; Milchick; Harmony;" %} {% set names = string_to_split|split(";", 4) %} | パラメーター | タイプ | 説明 | | ----------------------- | --- | ----------------------------------------------- | | `character_to_split_by` | 文字列 | 変数を分割する区切り文字を指定します。 | | `number_of_splits` | 数値 | 変数を分割する回数を指定します。残りの項目（存在する場合）は、グループ化されたままになります。 | ## string 他の型の変数を文字列に変換します。以下の例では、整数が文字列に変換されます（変数の型の変化を確認するために`pprint`を使用しています）。{% for name in names %}
``` ```html example.html theme={null}- {{ name }}
{% endfor %}```
- Mark
- Irving
- Helly
- Dylan; Milchick; Harmony;
```text hubl.txt theme={null} {% set number_to_string = 45 %} {{ number_to_string|string|pprint }} ``` ```text 出力のレンダリング.txt theme={null} (String: 45) ``` ## striptags SGML/XMLタグを除去して、隣接する空白を1つのスペースで置換します。このフィルターは、変数内のHTMLタグを除去する際に使用できます。```html example.html theme={null} {% set some_html = " ## strtodate 日付文字列と日付形式を日付オブジェクトに変換します。Some text" %} {{ some_html|striptags }} ``` ```html example.html theme={null} some text ``````text hubl.txt theme={null} {{ '3/3/21'|strtodate('M/d/yy') }} ``` ```text 出力のレンダリング.txt theme={null} 2021-03-03 00:00:00 ``` | パラメーター | タイプ | 説明 | | ------------ | --- | ------------------------------------------------------------------------------------------ | | `dateFormat` | 文字列 | 使用する[日付形式](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html)（英語）。 | ## strtotime 日時文字列と日時書式を変換して、日時オブジェクトにします。```text hubl.txt theme={null} {{ "2018-07-14T14:31:30+0530"|strtotime("yyyy-MM-dd'T'HH:mm:ssZ")|unixtimestamp }} ``` ```text 出力のレンダリング.txt theme={null} 1531558890000 ``` | パラメーター | タイプ | 説明 | | ---------------- | --- | ---------------------------------------------------------------------------------------------- | | `datetimeFormat` | 文字列 | 使用する[日付と時刻の形式](https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html)（英語）。 | ## sum シーケンス内の数値を全て合算します。最初のパラメーターには任意の属性を指定し、2番目のパラメーターには、変数内に加算するものがない場合に返す値を設定します。```text hubl.txt theme={null} // 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") }} ``` ```text 出力のレンダリング.txt theme={null} 15 Total: 30 ``` | パラメーター | タイプ | 説明 | | ------------------- | --- | -------------------- | | `attribute` | 文字列 | 合計する属性。 | | `return_if_nothing` | 文字列 | 変数内に加算するものがない場合に返す値。 | ## symmetric\_difference 2つのセットまたはリストの対称差を返します。フィルターから返されるリストには、1つ目のリストに含まれ、2つ目には含まれない一意の要素、または2つ目のリストに含まれ、1つ目には含まれない一意の要素が全て格納されます。```text hubl.txt theme={null} {{ [1, 2, 3]|symmetric_difference([2, 3, 4, 5]) }} ``` ```text 出力のレンダリング.txt theme={null} [1, 4, 5] ``` | パラメーター | タイプ | 説明 | | ------ | --- | -------------------------------- | | `list` | 整列 | 1つ目のリストとの対称差を見つけるために比較する2つ目のリスト。 | ## title 見出し表記の値を返します。つまり、英単語の先頭が大文字に、残りの文字は全て小文字になります。```text hubl.txt theme={null} {% set my_title="my title should be title case" %} {{ my_title|title }} ``` ```text 出力のレンダリング.txt theme={null} My Title Should Be Title Case ``` ## tojson オブジェクトをJSON文字列として書き出します。```text hubl.txt theme={null} {% for content in contents %} {{ content.blog_post_author|tojson }} {% endfor %} ``` ```json example.json theme={null} { "portalId": 1234567, "id": 12312253109, "created": 1566413741989, "updated": 1566414012799, "deletedAt": 0, "fullName": "Sample User", "email": "sampleUser@example.com", "userId": null, "username": null, "slug": "sample-user", "jsonBody": { "avatar": "https://app.hubspot.com/settings/avatar/109d6874a0cb066c1c7263ac5df6ce7a", "bio": "Sample Bio", "facebook": "", "linkedin": "", "twitter": "", "website": "https://www.hubspot.com" }, "bio": "Sample Bio", "facebook": "", "linkedin": "", "avatar": "https://app.hubspot.com/settings/avatar/109d6874a0cb066c1c7263ac5df6ce7a", "gravatarUrl": "https://app.hubspot.com/settings/avatar/108bb5ac667ded34796271437dfe8d58", "twitterUsername": "", "hasSocialProfiles": false, "website": "https://www.hubspot.com", "twitter": "", "displayName": "Sample User" } ``` ## trim 先頭および末尾にある空白を除去します。包括的な説明のためにここで説明していますが、HubSpotでは標準でマークアップから前後の空白が削除されます。```text hubl.txt theme={null} {{ " remove whitespace " }} {{ " remove whitespace "|trim }} ``` ```text 出力のレンダリング.txt theme={null} remove whitespace remove whitespace ``` ## truncate 特定の文字数よりも後ろにあるテキストを切り捨てます。デフォルトは255文字です。このカウントにはHTML文字が含まれます。**注**: このフィルターは単語間のスペースを使用して文字列を短縮するため、日本語などの文字間にスペースがない言語では期待どおりに機能しないことがあります。 ```text hubl.txt theme={null} {{ "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, "..........") }} ``` ```text 出力のレンダリング.txt theme={null} I only want to show the first sente.......... ``` | パラメーター | タイプ | 説明 | | ---------------------- | ---- | ---------------------------------------------------- | | `number_of_characters` | 数値 | テキストが切り捨てられる前の許容文字数。デフォルト値は255文字です。 | | `breakword` | ブール値 | `true`の場合、長さでテキストが切り捨てられます。`false`の場合は、最後の単語が除去されます。 | | `end` | 文字列 | 切り捨て後に付加されるデフォルトの記号「...」を変更します。 | ## truncatehtml HTMLマークアップを考慮しながら（つまり、ネストしている全てのタグが適切に閉じられ）、特定の文字列を切り捨てます。これにより、切り捨て後にタグが開いたままになることが防止されます。HTML文字は、合計文字数にカウントされません。**注**: このフィルターは単語間のスペースを使用して文字列を短縮するため、日本語などの文字間にスペースがない言語では期待どおりに機能しないことがあります。 ```html example.html theme={null} {% set html_text = " | パラメーター | タイプ | 説明 | | ---------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | `number_of_characters` | 数値 | テキストが切り捨てられる前の許容文字数。デフォルト値は255文字です。 | | `end` | 文字列 | 切り捨て後に付加されるデフォルトの記号「...」を変更します。 | | `breakword` | ブール値 | ブール値。`true`の場合、長さでテキストが切り捨てられます。`false`（デフォルト）の場合は、最後の単語が除去されます。任意のパラメーターのうち1つだけを使用する場合は、例えば`truncatehtml(70, breakwords = false)`のようにキーワード引数を使用します。 | ## unescape\_html HTMLエンコードされたエンティティーを含むテキストを同等のUnicodeに変換します。I want to truncate this text without breaking my HTML
" %} {{ html_text|truncatehtml(28, "..." , false) }} ``` ```html example.html theme={null}
I want to truncate this..
``````text hubl.txt theme={null} {% set escape_string = "me & you" %} {{ escape_string|unescape_html }} ``` ```text 出力のレンダリング.txt theme={null} me & you ``` ## union 2つのセットまたはリストの共通部分を返します。フィルターから返されるリストには、いずれかのリストに含まれる一意の要素が全て格納されます。```text hubl.txt theme={null} {{ [1, 2, 3]|union([2, 3, 4, 5]) }} ``` ```text 出力のレンダリング.txt theme={null} [1, 2, 3, 4, 5] ``` | パラメーター | タイプ | 説明 | | ------ | --- | ------------------------ | | `list` | 整列 | 1つ目のリストに対して結合される2つ目のリスト。 | ## unique オブジェクトのシーケンスまたはディクショナリーから一意のセットを抽出します。（関数から戻される記事リストなどの）ディクショナリーをフィルタリングする場合、どの属性を基準にディクショナリー項目の重複を削除するかを指定できます。```text hubl.txt theme={null} {% set my_sequence = ["one", "one", "two", "three" ] %} {{ my_sequence|unique }} ``` ```text 出力のレンダリング.txt theme={null} [one, two, three] ``` | パラメーター | タイプ | 説明 | | ------ | --- | ----------------------------- | | `attr` | 文字列 | ディクショナリー値を絞り込む際に使用する属性を指定します。 | ## unixtimestamp 日時オブジェクトをUnixタイムスタンプに変換します。### 注: このフィルターは、日付を返す変数でのみ使用してください。2024年9月30日以降、このフィルターはnull値が渡された場合に現在の日付を返さなくなります。この日付を過ぎると、フィルター内のnull値は`September 30, 2024`を返します。 ```text hubl.txt theme={null} {{ local_dt }} {{ local_dt|unixtimestamp }} ``` ```text 出力のレンダリング.txt theme={null} 2017-01-30 17:11:44 1485814304000 ``` ## upper 値に含まれる全ての文字を大文字に変換します。```text hubl.txt theme={null} {% set text="text to make uppercase" %} {{ text|upper }} ``` ```text 出力のレンダリング.txt theme={null} TEXT TO MAKE UPPERCASE ``` ## urlencode 文字列をエスケープしてUTF-8形式でURLエンコードします。ディクショナリーと通常の文字列、およびペアワイズ反復を受け入れます。```text hubl.txt theme={null} {% set encode_value="Escape & URL encode this string" %} {{ encode_value|urlencode }} ``` ```text 出力のレンダリング.txt theme={null} Escape+%26+URL+encode+this+string ``` ## urldecode エンコードされたURL文字列を元のURLにデコードします。ディクショナリーと通常の文字列、およびペアワイズ反復を受け入れます。```text hubl.txt theme={null} {% set decode_value="Escape+%26+URL+decode+this+string" %} {{ decode_value|urldecode }} ``` ```text 出力のレンダリング.txt theme={null} Escape & URL decode this string ``` ## urlize プレーンテキスト内のURLを、クリック可能なリンクに変換します。追加的な整数をこのフィルターに渡した場合、URLがその数値に短縮されます。2番目のパラメーターは、リンクをrel="no follow"にするかどうかを指示するブール値です。最後のパラメーターでは、リンクを新しいタブで開くかどうかを指定できます。 | パラメーター | タイプ | 説明 | | ----------------- | ---- | ----------------------------------------- | | `shorten_text` | 数値 | URLを指定の数に短縮する整数。 | | `no_follow` | ブール値 | `true`に設定すると、リンクに`rel="no follow"`が含まれます。 | | `target="_blank"` | 文字列 | リンクを新しいタブで開くかどうかを指定します。 |```text hubl.txt theme={null} {{ "http://hubspot.com/"|urlize }} {{ "http://hubspot.com/"|urlize(10,true) }} {{ "http://hubspot.com/"|urlize("",true) }} {{ "http://hubspot.com/"|urlize("",false,target="_blank") }} ``` ```html example.html theme={null} http://hubspot.com/ http://... http://hubspot.com/ http://hubspot.com/ ``` ## wordcount 文字列内の単語数をカウントします。HTMLが含まれている文字列の正確なカウントを取得する場合は、`striptags`フィルターを使用します。 ```text hubl.txt theme={null} {% set count_words = "Count the number of words in this variable" %} {{ count_words|wordcount }} ``` ```text 出力のレンダリング.txt theme={null} 8 ``` ## wordwrap 指定された文字数で折り返します。HubSpotではデフォルトで空白が除去されるため、この機能は``で特に役立ちます。```text hubl.txt theme={null} {% 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) }} ``` ```text 出力のレンダリング.txt theme={null} 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. ``` | パラメーター | 説明 | | ----------------- | -------------- | | `character_count` | コンテンツを折り返す文字数。 | ## xmlattr ディクショナリー内の項目に基づいてHTML/XML属性文字列を作成します。「値なし」および未定義値を除き、全ての値が自動的にエスケープされます。最初のパラメーターがfalseの場合以外は、フィルターから返された項目の前に自動的にスペースが追加されます。```html example.html theme={null} {% set html_attributes = {"class": "bold", "id": "sidebar"} %} ``` ```html example.html theme={null} ``` | パラメーター | タイプ | 説明 | | ----------- | ---- | ------------------------------ | | `autospace` | ブール値 | 項目の前にスペースを追加するには、`true`に設定します。 |
