コンポーネントの作成とテンプレート連携 - チェックボックス編

公開日 :

これまで紹介をしていたデータの形式は一般的なデータとして利用することが多い項目でしたが、今回はチェックボックスを紹介する地味なトピックとなります。

チェックボックスコンポーネントの作成

今回はチェックボックスのデータに関するフィールドを複数設定することができるコンポーネントを作成し、記述方法および動作を確認していきます。

コンポーネントの作成

まず最初に、以下のコードを実行して Data/CheckboxSample の定義ファイル2つを準備します。

jss scaffold Data/CheckboxSample

random desc

これにより、以下の2つのファイルが作成されます。

  • sitecore/definitions/components/Data/CheckboxSample.sitecore.ts

  • src/components/Data/CheckboxSample.tsx

1つ目のファイルはテンプレートを構成するフィールドのタイプを定義することができます。以下のファイルにコードを追加します。

export default function CheckboxSample(manifest: Manifest): void {
  manifest.addComponent({
    name: 'CheckboxSample',
    icon: SitecoreIcon.DocumentTag,
    fields: [
      { name: 'checkbox1', type: CommonFieldTypes.Checkbox },
      { name: 'checkbox2', type: CommonFieldTypes.Checkbox },
    ],
  });
}

チェックボックスの値がどうなっているのかを確認するために、以下のコードを表示の際に利用します。

import { Field, withDatasourceCheck } from '@sitecore-jss/sitecore-jss-nextjs';
import { StyleguideComponentProps } from 'lib/component-props';

type CheckboxSampleProps = StyleguideComponentProps & {
  fields: {
    checkbox1: Field<boolean>;
    checkbox2: Field<boolean>;
  };
};

const CheckboxSample = (props: CheckboxSampleProps): JSX.Element => (
  <div>
    <p>チェックボックス1</p>
    <div>
      {props.fields && props.fields.checkbox1 && props.fields.checkbox1.value && (
        <li>
          <code>チェックボックス1</code> はチェックされています
        </li>
      )}
      {!props.fields ||
        !props.fields.checkbox1 ||
        (!props.fields.checkbox1.value && (
          <li>
            <code>チェックボックス1</code> はチェックされていません
          </li>
        ))}
    </div>
    <p>チェックボックス2</p>
    <div>
      {props.fields && props.fields.checkbox2 && props.fields.checkbox2.value && (
        <li>
          <code>チェックボックス2</code> はチェックされています
        </li>
      )}
      {!props.fields ||
        !props.fields.checkbox2 ||
        (!props.fields.checkbox2.value && (
          <li>
            <code>チェックボックス2</code> はチェックされていません
          </li>
        ))}
    </div>
  </div>
);

export default withDatasourceCheck()<CheckboxSampleProps>(CheckboxSample);

Sitecore にテンプレートを作成する

Sitecore にテンプレートを作成します。今回は2つのチェックボックスのフィールドを用意します。

random desc

データ保存のためのフォルダの作成

すでに作成されている Components/Data のフォルダの下に CheckboxSample というフォルダを作成します。そしてそのフォルダの下にサンプルとなるアイテムを作成します。アイテムの作成の際には、テンプレートを指定する必要があり、その際に1つ前のステップで作成をしたテンプレートを指定します。

random desc

サンプルのデータを設定しますが、今回はチェックボックス1はチェックせず、2はチェックする形とします。

random desc

レンダリングの追加、プレースホルダーの設定

続いてレンダリングを追加します。/sitecore/layout/Renderings/Project/sitecoredemo-jp/Data のパスの下に新しく Json Rendering を追加します。レンダリング名は CheckboxSample を指定してください。作成したレンダリングの設定のうち、以下の2つの項目を設定します。

  • データソースの場所: 事前に作成をしたフォルダ

  • データソース テンプレート: 事前に作成をしたテンプレート

設定は以下のようになります。

random desc

作成をしたレンダリングをプレースホルダーに追加します。

random desc

検証

今回も管理画面でコンポーネントを配置します。結果は以下の通りです。

random desc

アイテムのチェックボックスがチェックされているかどうかを判別できました。

まとめ

チェックボックスを使うケースとしては、アイテムの中で複数のフィールドがあり、チェックしておくと追加のフィールドに関しての処理をする、といった用途での利用が想定されます。例えば、ログインをしているときにのみ表示されるコンテンツ、というような使い方をしたいなどのケースが考えられます。