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

最終更新日： 2024年11月27日

作成対象：

  • 開発者
  • 管理者
  • ユーザー

チェックボックスは、ソフトウェアアプリケーションやフォームで一般的に使用されるグラフィカルユーザーインターフェイス要素で、オン（選択）とオフ（選択解除）の 2 つのオプションをバイナリ選択できます。

チェックボックスは通常、小さな四角形で表され、クリックまたはタップするとオン/オフを切り替えることができます。 チェックボックスをオンにすると、関連するオプションまたは機能がアクティブまたは有効であることを示すチェックマークが表示されます。

NOTE
AEM 6.5 Forms の場合、このコンポーネントは AEM 6.5 Forms Service Pack 19（6.5.19.0）で導入されました。このコンポーネントを有効にするには、Forms コアコンポーネントと WCM コアコンポーネントの両方に、必要なバージョンがインストールされていることを確認します。 アダプティブフォームのコアコンポーネントのリリースについて詳しくは、アダプティブフォームのコアコンポーネントリリースを参照してください。

例

チェックボックスグループ

使用方法

アダプティブフォームでチェックボックスを使用する一般的な理由は次のとおりです。

  • 使いやすさ：チェックボックスは視覚的にわかりやすく、二者択一の選択を簡単に行うことができます。 直感的でわかりやすく、使いやすくなっています。

  • 同意と契約：チェックボックスは、利用条件の受け入れ、ニュースレターの購読、年齢の検証など、様々な目的でユーザーの同意を得るために使用されます。 ユーザーが何かに積極的に同意していることを明確にします。

  • 視覚的確認：チェックボックスをオンにすると、ユーザーの選択が記録されたことを視覚的に確認できます。 このフィードバックは、ユーザーのエラーを防ぎ、選択内容が登録されたことを確認するのに役立ちます。

  • エラー回避：チェックボックスを使用すると、フォームを送信する前に選択内容をレビューし確認できるので、エラーの確率が低下します。

バージョンと互換性

アダプティブフォームのチェックボックスコアコンポーネントは、コアコンポーネント 2.0.52 の一部としてリリースされました。次の表に、サポートされているすべてのバージョン、AEM の互換性、対応するドキュメントへのリンクを示します。

コンポーネントのバージョン
AEM as a Cloud Service
—
—
v1
リリース 2.0.52 以降と互換性あり

コアコンポーネントのバージョンとリリースについて詳しくは、コアコンポーネントのバージョンドキュメントをご覧ください。

技術的詳細

アダプティブフォームのチェックボックスコアコンポーネントの最新情報については、GitHub のテクニカルドキュメントをご覧ください。 コアコンポーネントの開発について詳しくは、コアコンポーネント開発者向けドキュメントをご覧ください。

設定ダイアログ

設定ダイアログでは、訪問者向けのチェックボックスエクスペリエンスを簡単にカスタマイズできます。 また、簡単にチェックボックスのオプションを定義して、シームレスなユーザーエクスペリエンスを実現することもできます。

「基本」タブ

「基本」タブ

  • 名前 - フォームコンポーネントは、フォーム内とルールエディター内の両方で一意の名前で簡単に識別できますが、名前にスペースや特殊文字を含めることはできません。

  • タイトル - タイトルを使用すると、フォーム内のコンポーネントを簡単に識別できます。デフォルトでは、コンポーネントの横にタイトルが表示されます。 タイトルを追加しない場合、コンポーネントは表示されません。

  • タイトルのリッチテキストを許可 - この機能により、ユーザーは、太字、斜体、下線付きのテキスト、様々なフォント、フォントサイズ、カラー、追加オプションなどの機能を組み込んで、プレーンテキストのタイトルを書式設定でき、視覚的なプレゼンテーションとカスタマイズが強化されます。 これにより、ドキュメント、web サイト、アプリケーション内でタイトルを目立たせる際の柔軟性とクリエイティブなコントロールが向上します。
    「タイトルのリッチテキストを許可」 チェックボックスをオンにすると、コンポーネントのタイトルをスタイル設定するための書式設定オプションが表示されます。 使用可能なすべての書式設定オプションにアクセスするには、 全画面表示アイコン タブをクリックします。

    リッチテキストのサポート

  • タイトルを非表示 - コンポーネントのタイトルを非表示にするには、このオプションを選択します。

  • バインド参照 - バインド参照は、外部データソースに保存され、フォーム内で使用されるデータ要素への参照です。 バインド参照を使用すると、データをフォームフィールドに動的にバインドして、フォームにデータソースの最新のデータを表示できます。 例えば、フォームに入力された顧客 ID に基づいて、顧客の名前と住所をフォームに表示できます。 さらに、フォームに入力されたデータでデータソースを更新することもできます。 このように AEM Formsで外部データソースとやり取りするフォームを作成して、データの収集と管理のためのシームレスなユーザーエクスペリエンスを提供できます。

  • 非連結フォーム要素としてマーク：どのスキーマにもリンクされていないフォームフィールドを設定する場合は、このオプションを選択します。 このオプションを使用すると、データソースを更新せずにデータを保存できます。 また、標準のデータベース統合とは別に、カスタム方法でデータを処理できます。

  • 送信された値のデータタイプ：このオプションでは、いずれかのオプションが選択された場合に送信される値のデータタイプを指定します。「送信された値のデータタイプ」が「Number」に設定されている場合に、「オプション」タブの「データ値」に文字列データを追加すると、画面に Value type mismatch エラーメッセージが表示されます。

  • コンポーネントを非表示 - フォームでコンポーネントを非表示にするには、このオプションを選択します。 このコンポーネントは、他の目的（ルールエディターでの計算に使用するなど）にも利用できます。 これは、ユーザーが表示する必要のない情報や直接変更した情報を保存する必要がある場合に役立ちます。

  • コンポーネントの無効化 - コンポーネントを無効にするかロックする場合は、このオプションを選択します。 エンドユーザーは、無効になっているコンポーネントをアクティブにしたり、編集したりすることはできません。 ユーザーはフィールドの値を表示できますが、変更することはできません。 このコンポーネントは、他の目的（ルールエディターでの計算に使用するなど）にも利用できます。

  • オンの場合は、値が返されます - チェックボックスがオンまたは選択されている際にチェックボックスに関連付ける値を指定するには、このオプションを選択します。 これは、チェックボックスをマークまたはオンにした際に発生するアクションです。

  • 状態値をオフにして保持 - このオプションを選択すると、チェックボックスコンポーネントが選択されていない場合に返される値を指定できます。 「状態値をオフにして保持」が有効になっているか true に設定している場合、「オフの場合は、値が返されます」オプションが表示されます。

  • オフの場合は、値が返されます - このオプションを使用すると、チェックボックスがオフまたは選択解除された状態にある際に、チェックボックスに関連付ける値を指定できます。

  • デフォルト値 - このオプションを使用すると、フォームフィールドにデフォルト値を追加できます。 無効なコンポーネント ​が選択されている場合、デフォルト値が画面に表示されます。 ユーザーがフォームフィールドに値を入力しない場合、この値はフォームの送信時に送信されます。