a-blog cms のカスタムフィールドグループでフェーダーを実装する

この記事はa-blog cms Advent Calendar 18日目の記事です。

a-blog cms にはjs-faderというフェーダーがありますが、カスタムフィールド グループで使おうとすると、「追加」ボタンをクリックした後の追加項目は{i}が使えないので、id属性を適用するためにJavaScriptを使う必要があります。

そこで、JavaScriptで解決した小ネタをご紹介します。紹介しているコードはコピペして使えますが、自分へのメモも兼ねてコードの紹介もすこし行なっています。

今回作成するカスタムフィールドグループ

今回作成するカスタムフィールドグループは以下の画像のようなものになります。


スクリーンショット:カスタムフィールド グループでも動作しているフェーダー

クリックしたコンテンツが開き、再度クリックしない限り他の箇所をクリックしても閉じません。保存済みコンテンツの<code>{fruit_name}</code>という変数に入力された項目がフェーダーのタイトルとして扱われるため、編集時もコンテンツを開かなくてもどんな内容が入っているか想像できるものにしました。


JavaScript

以下のコードはjQueryです。a-blog cmsではデフォルトでjQueryが読み込まれるようになっているので、使用するカスタムフィールド のページで外部のJSファイルとして読み込むか、<code>script</code>で囲んでHTMLファイルに直接記入してお使いください。

 $(function(){

  function getUniqueStr(myStrong){
   var strong = 1000;
   if (myStrong) strong = myStrong;
   return new Date().getTime().toString(16)  + Math.floor(strong*Math.random()).toString(16)
  }

  function addUniqueId() {
    var detectElm = $('.js-detect-unique');
    detectElm.each(function(i,item){
     var uuid = getUniqueStr();
     $(item).attr('data-id', uuid);

     $(item).find('.js-add-random-num').attr('href', '#cfg-' + uuid);
     $(item).find('.js-add-random-num').parent().next().attr('id', 'cfg-' + uuid);
    });
  }

  function fader(elm) {
      $('.js-fader-original').parent().next().hide();
       $(document).on('click','.js-fader-original',function(){
       var target = $(this).attr('href');
       $(target).fadeToggle();
       return false;
     });
  }

  addUniqueId();
  fader();

  ACMS.addListener("acmsAddCustomFieldGroup",function(item){
   addUniqueId();
  });
 });

冒頭でもご説明した通り、「追加」ボタンをクリックして追加したコンテンツには{i}のように、ユニークな数値が出力できません。そのため、ランダムな数値をJavaScriptで作成しています。

今回は「追加」ボタンクリック時にaddUniqueId();を発火させたいので、組み込みJSのイベントハンドラであるacmsAddCustomFieldGroupを使っています。

カスタムフィールド グループの記述

<h2 class="acms-admin-admin-title2">フルーツ</h2>
<table class="js-fieldgroup-sortable adminTable acms-admin-table-admin-edit">
  <thead>
    <tr>
      <th class="acms-admin-table-nowrap"></th>
      <th>項目</th>
      <th class="acms-admin-table-nowrap">削除</th>
    </tr>
  </thead>
  <tbody>
    <!-- BEGIN group_fruit:loop -->
    <tr class="sortable-item">
      <td class="item-handle" style="vertical-align: top;">
        <i class="acms-admin-icon-sort"></i>
      </td>
      <td>
        <h3 class="acms-admin-accordion-title"><a href="#cfg-fruit-{i}" class="js-fader-original acms-admin-accordion-title-link">{fruit_name}<span class="acms-admin-icon-arrow-small-down"></span></a></h3>
        <div id="cfg-fruit-{i}">
          <table class="acms-admin-table-admin-edit-child">
            <tr>
              <th>フルーツの名前</th>
              <td>
                <input type="text" name="fruit_name[]" value="{fruit_name}" class="acms-admin-form-width-full">
              </td>
            </tr>
            <tr>
              <th>備考</th>
              <td>
                <textarea name="fruit_note[]" class="acms-admin-form-width-full">{fruit_note}</textarea>
              </td>
            </tr>
          </table>
        </div>
      </td>
      <td>
        <input type="button" class="item-delete acms-admin-btn-admin acms-admin-btn-admin-danger" value="削除">
      </td>
    </tr>
    <!-- END group_fruit:loop -->
    <tr class="sortable-item item-template js-detect-unique">
      <td class="item-handle">
        <i class="acms-admin-icon-sort"></i>
      </td>
      <td>
        <h3 class="acms-admin-accordion-title"><a class="js-fader-original js-add-random-num acms-admin-accordion-title-link">新規項目<span class="acms-admin-icon-arrow-small-down"></span></a></h3>
        <div class="js-add-random-num-box">
          <table class="acms-admin-table-admin-edit-child">
            <tr>
              <th>フルーツの名前</th>
              <td>
                <input type="text" name="fruit_name[]" value="" class="acms-admin-form-width-full">
              </td>
             </tr>
            <tr>
              <th>備考</th>
               <td>
                <textarea name="fruit_note[]" class="acms-admin-form-width-full"></textarea>
              </td>
            </tr>
          </table>
        </div>
      </td>
      <td>
        <input type="button" class="item-delete acms-admin-btn-admin acms-admin-btn-admin-danger" value="削除">
      </td>
    </tr>
  </tbody>
  <tfoot>
    <tr>
      <td colspan="17">
        <input type="button" class="item-insert acms-admin-btn-admin" value="追加">
      </td>
    </tr>
  </tfoot>
</table>
<input type="hidden" name="@group_fruit[]" value="fruit_name">
<input type="hidden" name="field[]" value="fruit_name">
<input type="hidden" name="@group_fruit[]" value="fruit_note">
<input type="hidden" name="field[]" value="fruit_note">
<input type="hidden" name="field[]" value="@group_fruit">

ポイントとしては、カスタムフィールド メーカーで作成したソースコードに対して以下のコードを付け足します。

  1. 追加済みコンテンツにはhref="#cfg-fruit-{i}"class="js-fader-original"id="cfg-fruit-{i}"を追加する
  2. 新規追加コンテンツにはclass="js-fader-original js-add-random-num"class="js-add-random-num-box"を追加する

最後に

カスタムフィールド グループでフェーダーを実装する際に、閲覧側のコンテンツと同じ見栄えで表示したい場合などにぜひお使いください。

明日19日のAdvent Calendarは岡田さんです!


関連タグ

この記事をシェアする

著者

デザイナー

森田かすみ

名古屋のスタートアップで働く、デジタルプロダクトデザイナー。

2013年に新卒でWeb制作会社に入社し、受託制作のマークアップエンジニアとして勤務した後、CMS開発部門のデザイナーへ転身。

2023年5月にSaaSのプロダクトデザイナーへ転身。
現在は新機能にまつわるUXを考慮したUI設計、機能マーケティング支援などを担当。
ストレス発散方法はかっぱのイラストを描くこと。

おすすめ記事

この記事のハッシュタグ から関連する記事を表示しています。

他の方法で記事を探す

2024年12月

年間カレンダーへ
            1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31