CMS Hub

HubSpot CMS（HubL）でリスト（配列）を極める

目次

  1. 目次
    1. 解決方法
      1. loop.last内で希望の処理を行う
      2. HubSpotモジュールを使用してグローバル変数を作成する
      3. appendメソッドを使用する
    2. リストの活用例
      1. リストをChoiceモジュールに適用する
      2. 「関連記事一覧」から現在閲覧中の記事を除外する
    3. 目次 解決方法 loop.last内で希望の処理を行う HubSpotモジュールを使用してグローバル変数を作成する appendメソッドを使用する リストの活用例 リストをChoiceモジュールに適用する 「関連記事一覧」から現在閲覧中の記事を除外する まとめ
    4. 解決方法 loop.last内で希望の処理を行う まず1番最初は、最も泥臭い方法です。forループ後だと変数から期待する値を取得できないので、forループ内で事を済ませてしまう、という発想です。コードは次のようになります。

HubLのアップデートによりできることが増えたため、この記事の内容は非推奨となりました。リスト（配列）やディクショナリ（連想配列）の制御については、HubL - 配列（リスト）、連想配列（ディクショナリ）に関わる処理まとめを参照してください。

HubSpot CMSに限らず、CMSを扱ううえでよく出くわすのがリスト（または配列）です。ブログ記事一覧やタグ一覧など、いろいろなデータがリストで返ってきますね。HubSpot CMSに使われているHubLはPythonのテンプレートエンジンである Jinja2 の拡張ですので、厳密には配列ではなくリストとなります。

HubLのリストに関するハマりやすいポイント

このリストですが、個人的に少しクセがあると思っています。実務で直面する課題は

  • forループ内の変数の状態が、ブロックスコープ外に持ち出せない
  • JavaScriptでいうpush/pop/shiftなどのメソッドが豊富でなく、データの整形が難しい（上記にも関連しますが）

あたりです。

特にforループ内の変数の状態をブロックスコープ外に持ち出せない問題は深刻で、JavaScriptに慣れているフロントエンドエンジニアにはなかなかつらい制約です。例えば次のコードは、forループ後の変数で期待通りの値を取得できません。

 
      
  1. 



    2.   
  2. 



    3.   
  3. 
 

    4.   
  4. 



    5.   
  5. 



    6.   
  6. 



    7.

そもそもpushメソッドがないので文字列結合するしかないわけですが、それすら期待する値が取得できない訳です。

forループ内で直接HTMLを書いていたりする場合は、あまりこれで困ることはないかもしれません。しかし出力が複雑な場合や、繰り返し出てくるロジックをmacroとして外部化している場合は、どうしてもリストを整形しておきたいケースがあります。その場合に使用できる解決方法を幾つかご紹介します。

なお前提として、データは単純なリストではなく、以下のようにリストの中にディクショナリが格納されている例で示します。blog_recent_posts関数や、hubdb_table_row関数で取得した返り値の形ですね。このリストから、各ポスト名だけを抽出したリストを作成し、そのリストを「post_list」macroに渡し、出力することをゴールとします。

元データ 
 
      
  1. 
[

    2.   
  2. 
 
{

    3.   
  3. 
 name
:
 
'ポスト名1'
,

    4.   
  4. 
 abusolute_url
:
 
'https://example.com/post1'
,

    5.   
  5. 
 featured_image
:
 
'https://example.com/assets/img/post1.png'

    6.   
  6. 
 
},

    7.   
  7. 
 
{

    8.   
  8. 
 name
:
 
'ポスト名2'
,

    9.   
  9. 
 abusolute_url
:
 
'https://example.com/post2'
,

    10.   
  10. 
 featured_image
:
 
'https://example.com/assets/img/post2.png'

    11.   
  11. 
 
},

    12.   
  12. 
 
{

    13.   
  13. 
 name
:
 
'ポスト名3'
,

    14.   
  14. 
 abusolute_url
:
 
'https://example.com/post3'
,

    15.   
  15. 
 featured_image
:
 
'https://example.com/assets/img/post3.png'

    16.   
  16. 
 
}

    17.   
  17. 
]

    18.
データを受け取るmacro 
 
      
  1. 



    2.

目次

  1. 解決方法
    1. loop.last内で希望の処理を行う
    2. HubSpotモジュールを使用してグローバル変数を作成する
    3. appendメソッドを使用する
  2. リストの活用例
    1. リストをChoiceモジュールに適用する
    2. 「関連記事一覧」から現在閲覧中の記事を除外する
  3. まとめ

解決方法

loop.last内で希望の処理を行う

まず1番最初は、最も泥臭い方法です。forループ後だと変数から期待する値を取得できないので、forループ内で事を済ませてしまう、という発想です。コードは次のようになります。

  
       
  1. 



    2.

まず1つ目のループ（loop.first）で変数の初期化を行います。リストに対する追加メソッドがないので、結局文字列型としています。ループ毎にポスト名（post.name）をpost_names変数に追加していき、最後のループ（loop.last）でmacroに変数を渡します。loop.firstとloop.lastはforループ内に予め用意されている予約変数です（参考：For loops | HubL Reference）。

このとき変数に格納されている値は文字列型ですので、macroに渡すときにsplitフィルタを使用してリストに変換しています。これで見事、期待する形でデータが表示されます。

macroが出力したデータ
macroが出力したデータ

しかしまぁ、いかんせん泥臭いのと、ループがネストされると可読性がどんどん悪くなります。

HubSpotモジュールを使用してグローバル変数を作成する

次に紹介するのは、HubSpotのTextモジュールを使用してforループ内から擬似的にグローバル変数を作成する方法です。とはいってもグローバルに定義しますので、乱用は禁物です。ほぼ裏技みたいなものですね……。コードは次のようになります。

  
       
  1. 



    2.    
  2. 
 

    3.    
  3. 



    4.    
  4. 



    5.

まず本筋ではありませんが、変数名が紛らわしいためforループ内でのみ使用するpost_namesは「post_names_in_loop」という名前に変更しました。

loop.lastでmacroを呼び出すのではなく、Textモジュールを設置します。valueのダブルクォーテーションの中で変数展開することによってpost_names_in_loopの文字列（「ポスト名1,ポスト名2,ポスト名3,」）をTextモジュールに設定できます。Textモジュールは値のみを使用するため、export_to_template_contextをTrueに設定します。またこのままだとページ編集画面などでTextモジュールの編集が可能な状態ですので、overrideableをFalseに設定します。

これでグローバル変数のように、どこからでも値にアクセスできるようになりました。後はforループの外でmacroを呼び出すと、1つ目の方法と同じように期待通りに各ポスト名が出力されます。

appendメソッドを使用する

最後に紹介するのは、appendメソッドを使用するです。「pushのようなメソッドは無いのでは？」と思われるかもしれませんが、それはそれでその通りです。HubLやJinja2に配列の末尾に要素を追加するメソッドはありません。このappendメソッドはPythonのメソッドです。そのため、これもまた裏技というか、かなり非公式な方法になります……。が、この方法が1番シンプルで綺麗です。

コードは次のようになります。

  
       
  1. 



    2.    
  2. 



    3.    
  3. 



    4.    
  4. 
 

    5.    
  5. 



    6.    
  6. 



    7.

かなりスッキリしましたね。変数も、最初から文字列型ではなくリストで初期化しています。そのためmacroに渡すときも、いちいちsplitフィルタを使う必要がありません。注意点として、まずappendメソッドを使用するには式デリミタ（波括弧2つ）内でなければなりません。

次の注意点として、このスタイルでappendメソッドを使用すると、返り値としてBooleanのtrueを返します。そのため、何もしないと「true」という文字が出力されていまいます。

appendメソッドの返り値のtrueが表示されている
appendメソッドの返り値のtrueが表示されている

この「true」を出力しないためにcutフィルタを使用してtrueを削除しています。文字列のためのcutフィルタをBooleanに使っていいのかって感じですが……。とにかく、これで無駄なものは表示されず、かつコードもかなりスッキリしました。HubLドキュメントにもJinja2ドキュメントにも書いていない非公式な方法ではありますが、Pythonのメソッドであればいきなり使えなくなることもないだろうと踏んで、現在私は主にこの方法を使用しています。

リストの活用例

データの整形は今まで紹介した形で概ねできるようになりましたので、ここからは実際の活用例を紹介します。

リストをChoiceモジュールに適用する

Choiceモジュールとは、ページ編集画面でこのUIを提供するモジュールですね。

Choiceモジュール
Choiceモジュール

通常通り使用するには、次のように「choices」属性にカンマ区切りで値を設定することにより、それぞれが選択肢として認識されます。

  
       
  1. 





    2.

先ほど整形したデータをChoiceモジュールに渡すには、次のようにchoices属性の中で式デリミタを使用します。

  
       
  1. 





    2.
変数が展開され、Choiceモジュールに適用された
変数が展開され、Choiceモジュールに適用された

なおChoiceモジュールがchoicesの値として受け付けるのは、カンマ区切りの文字列型です。appnedメソッド以外でデータを整形する方法は最初から文字列型なのでよいですが、appendメソッドを使用してデータを用意した場合は、Choiceモジュールに渡す前にjoinフィルタを使用して文字列型に変換しておく必要があります（choicesのクォーテーション内でjoinフィルタを使用しても、上手くいきません）。

リストをChoiceモジュールに設定する場合 
  
       
  1. 



    2.    
  2. 



    3.    
  3. 





    4.

「関連記事一覧」から現在閲覧中の記事を除外する

よくブログポスト画面で、同じタグが付いているポストを「関連記事」として表示したいことがあると思います。1番手っ取り早いベストプラクティスはBlog related postsタグを使用することですが、macroを多段に使用していたりなど、ときに使用しづらいこともあると思います。

そんなときはblog_recent_tag_posts関数を使用して同一のタグを含むポストを取得する訳ですが、普通にやると現在閲覧中の記事まで関連記事に出てしまいます。そんなときに、appendメソッドを使用して現在閲覧中の記事を除外するリストを作成することが可能です。コードは次の通りです。

  
       
  1. 



    2.    
  2. 



    3.    
  3. 
 

    4.    
  4. 



    5.    
  5. 



    6.    
  6. 



    7.    
  7. 
 

    8.    
  8. 



    9.    
  9. 
 

    10.    
  10. 



    11.    
  11. 



    12.    
  12. 
 

    13.    
  13. 



    14.    
  14. 



    15.    
  15. 
 

    16.    
  16. 



    17.    
  17. 



    18.    
  18. 
 

    19.    
  19. 



    20.    
  20. 



    21.

ちょっと複雑になってしまいましたね。1つずつ解説します。

  • blog_recent_tag_posts……タグは簡易に、現在閲覧中の記事の1つ目を指定しています。今回出力したい関連記事は3件ですが、件数は4件取得します。これは現在閲覧中の記事を除外する可能性も考慮しなければならないためです。
  • posts_count……取得した関連記事に万が一現在閲覧中の記事が含まれていない場合、4件出力されてしまいます。そのため、件数を制御するためにカウンターも用意します。

これでposts変数には、現在閲覧中の記事を除外した3件の記事のディクショナリがリストとして格納されています。

まとめ

以上、HubLでリストを扱う際の方法と、活用例をご紹介しました。解決方法については、結局どれも若干モヤっとするところはありますが、テンプレートエンジンなので表現力に乏しいのは仕方ないですね。HubSpot CMSのテンプレートを開発するにおいてリストは避けて通れませんので、何かの際に、ご参考になれば幸いです。

執筆者：Admin

関連記事

© Pensees