Form¶

セレクト、チェックボックス、ラジオに関するオプション¶

select() 、 checkbox() そして radio() によって共有されるオプションは次の通りです。 (各メソッドの独自のセクションには、そのメソッド特有のオプションが記述されています。)

• 'value' - 影響を受ける要素の値を設定または選択します。

  • チェックボックスの場合、 input 要素に割り当てられた HTML の 'value' 属性を、 値として提供するものに設定します。

  • ラジオボタンまたは選択ピッカーの場合は、フォームが描画されるときに選択される要素を定義します (この場合、 'value' は有効で存在する要素の値を割り当てなければなりません)。 date() 、 time() 、 dateTime() のようなセレクト型コントロールと 組み合わせて使用することもできます。

    echo $this->Form->time('close_time', [
        'value' => '13:30:00'
    ]);
    

  注釈

  date() および dateTime() コントロールの 'value' キーには、 UNIX タイムスタンプまたは DateTime オブジェクトを使用することもできます。

  multiple 属性を true に設定した select コントロールでは、 デフォルトで選択したい値の配列を使うことができます。

  // 値に 1 と 3 を持つ HTML <option> 要素が事前選択されて描画されます。
  echo $this->Form->select(
      'rooms',
      [1, 2, 3, 4, 5],
      [
          'multiple' => true,
          'value' => [1, 3]
      ]
  );
  

• 'empty' - radio() と select() に適用します。デフォルトは false です。

  • radio() に渡して true を設定すると、最初のラジオボタンとして追加の入力要素を作成し、 値を '' に、ラベルを 'empty' にします。ラベルキャプションを制御する場合は、 このオプションを文字列に設定します。

  • select メソッドに渡されると、ドロップダウンリストに空の値を持つ空白の HTML option 要素が作成されます。空の値を空の option の代わりに表示させたい場合は、 'empty' に文字列を渡します。

    echo $this->Form->select(
        'field',
        [1, 2, 3, 4, 5],
        ['empty' => '(一つ選ぶ)']
    );
    

    出力結果:

    <select name="field">
        <option value="">(一つ選ぶ)</option>
        <option value="0">1</option>
        <option value="1">2</option>
        <option value="2">3</option>
        <option value="3">4</option>
        <option value="4">5</option>
    </select>
    

• 'hiddenField' - チェックボックスとラジオボタンの場合、デフォルトでは、 メインの要素とともに hidden input 要素も作成されます。そのため、 値の指定がなくても、 $this->request->getData() の中のキーは必ず存在します。 その値のデフォルトは、チェックボックスの場合は 0 、ラジオボタンの場合は '' です。

  デフォルト出力の例:

  <input type="hidden" name="published" value="0" />
  <input type="checkbox" name="published" value="1" />
  

  これは 'hiddenField' を false とすることで無効にできます。

  echo $this->Form->checkbox('published', ['hiddenField' => false]);
  

  出力結果:

  <input type="checkbox" name="published" value="1">
  

  フォーム上に複数のコントロールブロックを作成してグループ化する場合は、 最初のコントロールを除くすべての入力で、このパラメーターを false に設定する必要があります。 hidden 入力がページ上の複数の場所にある場合は、入力値の最後のグループだけが保存されます。

  この例では Tertiary Colors だけが渡され、Primary Colors は上書きされます。

  <h2>Primary Colors</h2>
  <input type="hidden" name="color" value="0" />
  <label for="color-red">
      <input type="checkbox" name="color[]" value="5" id="color-red" />
      Red
  </label>
  
  <label for="color-blue">
      <input type="checkbox" name="color[]" value="5" id="color-blue" />
      Blue
  </label>
  
  <label for="color-yellow">
      <input type="checkbox" name="color[]" value="5" id="color-yellow" />
      Yellow
  </label>
  
  <h2>Tertiary Colors</h2>
  <input type="hidden" name="color" value="0" />
  <label for="color-green">
      <input type="checkbox" name="color[]" value="5" id="color-green" />
      Green
  </label>
  <label for="color-purple">
      <input type="checkbox" name="color[]" value="5" id="color-purple" />
      Purple
  </label>
  <label for="color-orange">
      <input type="checkbox" name="color[]" value="5" id="color-orange" />
      Orange
  </label>
  

  2番目の入力グループで 'hiddenField' を無効にすると、この動作を防ぐことができます。

  'N' のように 0 以外の別の hidden フィールド値を設定することができます。

  echo $this->Form->checkbox('published', [
      'value' => 'Y',
      'hiddenField' => 'N',
  ]);
  

オプションの作成にコレクションを使用¶

オプション配列の作成に Collection クラスを使うことができます。 この方法は、すでにエンティティーのコレクションを持っていて、 そこから select 要素を作成したい場合に理想的です。

combine メソッドを使って、基本的なオプションの配列を作ることができます。

$options = $examples->combine('id', 'name');

配列を拡張して特別な属性を追加することもできます。 以下は、 コレクションの map メソッドを使って option 要素にデータ属性を作成します。

$options = $examples->map(function ($value, $key) {
    return [
        'value' => $value->id,
        'text' => $value->name,
        'data-created' => $value->created
    ];
});

チェックボックスの作成¶

Cake\View\Helper\FormHelper::checkbox(string $fieldName, array $options)¶

• $fieldName - 'Modelname.fieldname' の形式のフィールド名。

• $options - 上記の 特定のコントロールのための共通オプション または セレクト、チェックボックス、ラジオに関するオプション 、チェックボックス特有のオプション (下記参照) と有効な HTML 属性を含むオプション配列。

checkbox フォーム要素を作成します。使用されるウィジェットテンプレートは、

'checkbox' => '<input type="checkbox" name="{{name}}" value="{{value}}"{{attrs}}>'

チェックボックスのオプション

• 'checked' - このチェックボックスをオンにするかどうかを示すブール値。 デフォルトは false です。

• 'disabled' - 入力不可のチェックボックスを作成。

このメソッドは、関連する隠しフォームの input 要素も生成し、 指定されたフィールドのデータの送信を強制します。

例:

echo $this->Form->checkbox('done');

出力結果:

<input type="hidden" name="done" value="0">
<input type="checkbox" name="done" value="1">

$options 配列を使って checkbox の値を指定することもできます。

例:

echo $this->Form->checkbox('done', ['value' => 555]);

出力結果:

<input type="hidden" name="done" value="0">
<input type="checkbox" name="done" value="555">

FormHelper で hidden 入力を作成したくない場合は、 'hiddenField' を使います。

例:

echo $this->Form->checkbox('done', ['hiddenField' => false]);

出力結果:

<input type="checkbox" name="done" value="1">

ラジオボタンの作成¶

Cake\View\Helper\FormHelper::radio(string $fieldName, array $options, array $attributes)¶

• $fieldName - 'Modelname.fieldname' の形式のフィールド名。

• $options - 少なくともラジオボタンのラベルを含むオプション配列。 値や HTML 属性を含むこともできます。この配列がない場合、メソッドは hidden 入力 を生成する ('hiddenField' が true の場合)、または全く要素がない ('hiddenField' が false の場合) かのいずれかです。

• $attributes - 特定のコントロールのための共通オプション または セレクト、チェックボックス、ラジオに関するオプション 、ラジオボタン特有の属性 (下記参照)と 有効な HTML 属性を含むオプション配列。

radio ボタン入力を作成します。使用されるデフォルトのウィジェットテンプレートは、

'radio' => '<input type="radio" name="{{name}}" value="{{value}}"{{attrs}}>'
'radioWrapper' => '{{label}}'

ラジオボタンの属性

• 'label' - ウィジェットのラベルを表示するかどうかを示すブール値、または、全てのラベルに適用する 属性の配列。 class 属性が定義されている場合、チェックされたボタンの class 属性に selected が追加されます。デフォルトは true 。

• 'hiddenField' - true に設定すると、 '' の値を持つ非表示の入力がインクルードされます。 これは、非連続的なラジオセットを作成する場合に便利です。デフォルトは true 。

• 'disabled' - すべてのラジオボタンを無効にするには true または 'disabled' に設定します。デフォルトは false 。

$options 引数を通してラジオボタンのラベルの見出しを指定してください。

例:

$this->Form->radio('gender', ['Masculine','Feminine','Neuter']);

出力結果:

<input name="gender" value="" type="hidden">
<label for="gender-0">
    <input name="gender" value="0" id="gender-0" type="radio">
    Masculine
</label>
<label for="gender-1">
    <input name="gender" value="1" id="gender-1" type="radio">
    Feminine
</label>
<label for="gender-2">
    <input name="gender" value="2" id="gender-2" type="radio">
    Neuter
</label>

一般に $options は単純な キー => 値 のペアです。 ただし、カスタム属性をラジオボタンに配置する必要がある場合は、拡張形式を使用することができます。

例:

echo $this->Form->radio(
    'favorite_color',
    [
        ['value' => 'r', 'text' => 'Red', 'style' => 'color:red;'],
        ['value' => 'u', 'text' => 'Blue', 'style' => 'color:blue;'],
        ['value' => 'g', 'text' => 'Green', 'style' => 'color:green;'],
    ]
);

出力結果:

<input type="hidden" name="favorite_color" value="">
<label for="favorite-color-r">
    <input type="radio" name="favorite_color" value="r" style="color:red;" id="favorite-color-r">
    Red
</label>
<label for="favorite-color-u">
    <input type="radio" name="favorite_color" value="u" style="color:blue;" id="favorite-color-u">
    Blue
</label>
<label for="favorite-color-g">
    <input type="radio" name="favorite_color" value="g" style="color:green;" id="favorite-color-g">
    Green
</label>

選択ピッカーの作成¶

Cake\View\Helper\FormHelper::select(string $fieldName, array $options, array $attributes)¶

• $fieldName - 'Modelname.fieldname' の形式のフィールド名。 これは、 select 要素の name 属性を提供します。

• $options - 選択ピッカーの項目のリストを含むオプション配列。 この配列がない場合、メソッドは、中に option 要素が一つもない空の select HTML 要素のみを生成します。

• $attributes - 特定のコントロールのための共通オプション または セレクト、チェックボックス、ラジオに関するオプション または select 特有のオプション (下記参照)と、 有効な HTML 属性を含むオプション配列。

$options 配列の項目で設定された select 要素を作成します。 $attributes['value'] が提供された場合、指定された値を持つ HTML option 要素が 選択ピッカーが描画される際に選択されて表示されます。

デフォルトでは、 select は次のウィジェットテンプレートを使用します。

'select' => '<select name="{{name}}"{{attrs}}>{{content}}</select>'
'option' => '<option value="{{value}}"{{attrs}}>{{text}}</option>'

以下も使用します。

'optgroup' => '<optgroup label="{{label}}"{{attrs}}>{{content}}</optgroup>'
'selectMultiple' => '<select name="{{name}}[]" multiple="multiple"{{attrs}}>{{content}}</select>'

選択ピッカーの属性

• 'multiple' - true をセットすると、選択ピッカー内で複数選択ができます。 'checkbox' をセットすると、複数チェックボックスが代わりに作成されます。 デフォルトは null です。

• 'escape' - ブール値。 true の場合、選択ピッカー内の option 要素の内容は エンコードされた HTML エンティティーになります。デフォルトは true です。

• 'val' - 選択ピッカーで値を事前に選択できるようにします。

• 'disabled' - disabled 属性を制御します。 true をセットした場合、選択ピッカー全体を無効にします。 配列をセットした場合、配列に含まれている値を持つ特定の option のみ無効にします。

$options 引数は、 select コントロールの option 要素の内容を手動で指定できます。

例:

echo $this->Form->select('field', [1, 2, 3, 4, 5]);

出力結果:

<select name="field">
    <option value="0">1</option>
    <option value="1">2</option>
    <option value="2">3</option>
    <option value="3">4</option>
    <option value="4">5</option>
</select>

$options の配列はキーと値のペアとしても指定することができます。

例:

echo $this->Form->select('field', [
    'Value 1' => 'Label 1',
    'Value 2' => 'Label 2',
    'Value 3' => 'Label 3'
]);

出力結果:

<select name="field">
    <option value="Value 1">Label 1</option>
    <option value="Value 2">Label 2</option>
    <option value="Value 3">Label 3</option>
</select>

optgroup 付きで select を生成したい場合は、データを階層形式 (ネストした配列) で渡すだけです。 これは複数のチェックボックスとラジオボタンでも機能しますが、 optgroup の代わりに fieldset 要素で囲みます。

例:

$options = [
    'Group 1' => [
        'Value 1' => 'Label 1',
        'Value 2' => 'Label 2'
    ],
    'Group 2' => [
        'Value 3' => 'Label 3'
    ]
];
echo $this->Form->select('field', $options);

出力結果:

<select name="field">
    <optgroup label="Group 1">
        <option value="Value 1">Label 1</option>
        <option value="Value 2">Label 2</option>
    </optgroup>
    <optgroup label="Group 2">
        <option value="Value 3">Label 3</option>
    </optgroup>
</select>

option タグ内で HTML 属性を生成するには:

$options = [
    [ 'text' => 'Description 1', 'value' => 'value 1', 'attr_name' => 'attr_value 1' ],
    [ 'text' => 'Description 2', 'value' => 'value 2', 'attr_name' => 'attr_value 2' ],
    [ 'text' => 'Description 3', 'value' => 'value 3', 'other_attr_name' => 'other_attr_value' ],
];
echo $this->Form->select('field', $options);

出力結果:

<select name="field">
    <option value="value 1" attr_name="attr_value 1">Description 1</option>
    <option value="value 2" attr_name="attr_value 2">Description 2</option>
    <option value="value 3" other_attr_name="other_attr_value">Description 3</option>
</select>

属性による選択ピッカーの制御

$attributes パラメーター内の特定のオプションを使用することにより、 select() メソッドの特定の振る舞いを制御することができます。

• 'empty' - $attributes 引数の中で 'empty' キーを true にセットすると (デフォルトの値は false)、ドロップダウンリストの先頭に空の値の空白オプションを追加できます。

  例:

  $options = ['M' => 'Male', 'F' => 'Female'];
  echo $this->Form->select('gender', $options, ['empty' => true]);
  

  出力結果:

  <select name="gender">
      <option value=""></option>
      <option value="M">Male</option>
      <option value="F">Female</option>
  </select>
  

• 'escape' - select() メソッドは 'escape' という属性が使用でき、 ブール値を受け取り、HTML エンティティーに select オプションの内容をエンコードするかどうかを決定します。

  例:

  // これで、各オプション要素の内容の HTML エンコードを止められます
  $options = ['M' => 'Male', 'F' => 'Female'];
  echo $this->Form->select('gender', $options, ['escape' => false]);
  

• 'multiple' - true にセットすると、選択ピッカーは複数選択ができます。

  例:

  echo $this->Form->select('field', $options, ['multiple' => true]);
  

  または、関連するチェックボックスのリストを出力するために 'multiple' を 'checkbox' に設定します。

  $options = [
      'Value 1' => 'Label 1',
      'Value 2' => 'Label 2'
  ];
  echo $this->Form->select('field', $options, [
      'multiple' => 'checkbox'
  ]);
  

  出力結果:

  <input name="field" value="" type="hidden">
  <div class="checkbox">
    <label for="field-1">
     <input name="field[]" value="Value 1" id="field-1" type="checkbox">
     Label 1
     </label>
  </div>
  <div class="checkbox">
     <label for="field-2">
     <input name="field[]" value="Value 2" id="field-2" type="checkbox">
     Label 2
     </label>
  </div>
  

• 'disabled' - このオプションを設定して、すべてまたは一部の select の option 項目を 無効にすることができます。すべての項目を無効にするには、 'disabled' に true を 設定します。特定の項目のみを無効にするには、無効にする項目をキーに含む配列を 'disabled' に 設定してください。

  すべてのチェックボックスを無効にするには disabled を true にします。

  例:

  $options = [
      'M' => 'Masculine',
      'F' => 'Feminine',
      'N' => 'Neuter'
  ];
  echo $this->Form->select('gender', $options, [
      'disabled' => ['M', 'N']
  ]);
  

  出力結果:

  <select name="gender">
      <option value="M" disabled="disabled">Masculine</option>
      <option value="F">Feminine</option>
      <option value="N" disabled="disabled">Neuter</option>
  </select>
  

  このオプションは 'multiple' が 'checkbox' に設定されている場合にも有効です。

  $options = [
      'Value 1' => 'Label 1',
      'Value 2' => 'Label 2'
  ];
  echo $this->Form->select('field', $options, [
      'multiple' => 'checkbox',
      'disabled' => ['Value 1']
  ]);
  

  出力結果:

  <input name="field" value="" type="hidden">
  <div class="checkbox">
     <label for="field-1">
     <input name="field[]" disabled="disabled" value="Value 1" type="checkbox">
     Label 1
     </label>
  </div>
  <div class="checkbox">
     <label for="field-2">
     <input name="field[]" value="Value 2" id="field-2" type="checkbox">
     Label 2
     </label>
  </div>
  

日付と時刻のコントロールの共通オプション¶

これらのオプションは、日付と時刻に関するコントロールに共通します。

• 'empty' - true の場合、余分の空の option HTML 要素が、 select の中のリストの先頭に追加されます。文字列の場合、 その文字列は空の要素として表示されます。デフォルトは true です。

• 'default' | value - 2つのいずれかを使用して、 フィールドに表示されるデフォルト値を設定します。 フィールド名と一致する $this->request->getData() の値は、この値を上書きします。 デフォルトが指定されていない場合、 time() が使用されます。

• 'year', 'month', 'day', 'hour', 'minute', 'second', 'meridian' - これらのオプションを使用すると、コントロール要素が生成されるかどうか制御できます。 これらのオプションを false にセットすることにより、特定の選択ピッカーの生成を 無効にすることができます (デフォルトでは、使用されたメソッドの中で描画されます) 。 さらに、各オプションでは、HTML 属性を指定した select 要素に渡すことができます。

日付関連コントロールのオプション¶

これらのオプションは、日付関連のメソッド、つまり year() 、 month() 、 day() 、 dateTime() そして date() に関連しています。

• 'monthNames' - false の場合は、選択ピッカーの月の表示で テキストの代わりに2桁の数字が使用されます。配列をセットした場合 (例 ['01' => 'Jan', '02' => 'Feb', ...])、指定された配列が使用されます。

• 'minYear' - 年の select フィールドで使用される最小の年。

• 'maxYear' - 年の select フィールドで使用される最大の年。

• 'orderYear' - 年選択ピッカー内の年の値の順序。 利用可能な値は 'asc' と 'desc' 。デフォルトは 'desc' です。

• 'year', 'month', 'day' - これらのオプションを使用すると、コントロール要素が生成されるかどうか制御できます。 これらのオプションを false にセットすることにより、特定の選択ピッカーの生成を 無効にすることができます (デフォルトでは、使用されたメソッドの中で描画されます) 。 さらに、各オプションでは、HTML 属性を指定した select 要素に渡すことができます。

時刻関連コントロールのオプション¶

これらのオプションは、時刻関連のメソッド、 hour() 、 minute() 、 second() 、 dateTime() そして time() に関連しています。

• 'interval' - 分選択ピッカーの option 要素の中に表示される分の値の間隔。 デフォルトは 1 です。

• 'round' - 値が一定の間隔にきちんと収まらないときに、いずれかの方向に丸めるようにしたい場合は、 up または down に設定します。デフォルトは null です。

• timeFormat - dateTime() と time() に適用されます。 選択ピッカーで使用する時刻の書式は、 12 または 24 のいずれかです。 このオプションに 24 以外の何かをセットした場合、書式は自動的に 12 がセットされ、 秒選択ピッカーの右側に meridian 選択ピッカーが自動的に表示されます。 デフォルトは 24 です。

• format - hour() に適用されます。 選択ピッカーで使用する時刻の書式は、 12 または 24 のいずれかです。 12 をセットした場合、 meridian 選択ピッカーは自動的に表示されません。 それを追加するか、フォームコンテキストから適切な期間を推論する方法を提供するかは、 あなた次第です。デフォルトは 24 です。

• second - dateTime() と time() に適用されます。 秒を有効にするために true に設定します。デフォルトは false です。

• 'hour', 'minute', 'second', 'meridian' - これらのオプションを使用すると、コントロール要素が生成されるかどうか制御できます。 これらのオプションを false にセットすることにより、特定の選択ピッカーの生成を 無効にすることができます (デフォルトでは、使用されたメソッドの中で描画されます) 。 さらに、各オプションでは、HTML 属性を指定した select 要素に渡すことができます。

日時入力の作成¶

Cake\View\Helper\FormHelper::dateTime($fieldName, $options = [])¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $options - 特定のコントロールのための共通オプション または日時特有のオプション (下記参照)、 そして有効な HTML 属性を含むオプション配列。

日付と時刻の select 要素のセットを生成します。

コントロールの順序、およびコントロール間の要素/内容を制御するには、 dateWidget テンプレートを上書きします。デフォルトで dateWidget テンプレートは:

{{year}}{{month}}{{day}}{{hour}}{{minute}}{{second}}{{meridian}}

オプションを指定せずにメソッドを呼び出すと、デフォルトでは、年（4桁）、月（英語の完全名）、 曜日（数値）、時間（数値）、分（数値）の5つの選択ピッカーが生成されます。

例:

<?= $this->form->dateTime('registered') ?>

出力結果:

<select name="registered[year]">
    <option value="" selected="selected"></option>
    <option value="2022">2022</option>
    ...
    <option value="2012">2012</option>
</select>
<select name="registered[month]">
    <option value="" selected="selected"></option>
    <option value="01">January</option>
    ...
    <option value="12">December</option>
</select>
<select name="registered[day]">
    <option value="" selected="selected"></option>
    <option value="01">1</option>
    ...
    <option value="31">31</option>
</select>
<select name="registered[hour]">
    <option value="" selected="selected"></option>
    <option value="00">0</option>
    ...
    <option value="23">23</option>
</select>
<select name="registered[minute]">
    <option value="" selected="selected"></option>
    <option value="00">00</option>
    ...
    <option value="59">59</option>
</select>

特定の select ボックスにカスタムクラス/属性を含む datetime コントロールを作成するには、 $options 引数の中で各コンポーネントのオプションの配列として指定します。

例:

echo $this->Form->dateTime('released', [
    'year' => [
        'class' => 'year-classname',
    ],
    'month' => [
        'class' => 'month-class',
        'data-type' => 'month',
    ],
]);

これは、次の2つの選択ピッカーを作成します。

<select name="released[year]" class="year-class">
    <option value="" selected="selected"></option>
    <option value="00">0</option>
    <option value="01">1</option>
    <!-- .. 以下省略 .. -->
</select>
<select name="released[month]" class="month-class" data-type="month">
    <option value="" selected="selected"></option>
    <option value="01">January</option>
    <!-- .. 以下省略 .. -->
</select>

日付コントロールの作成¶

Cake\View\Helper\FormHelper::date($fieldName, $options = [])¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $options - 特定のコントロールのための共通オプション 、 日付と時刻のコントロールの共通オプション 、 適用可能な 時刻関連コントロールのオプション 、そして有効な HTML 属性を含むオプション配列。

デフォルトでは、年（4桁）、月（英語の完全名）、日（数値）の値が設定された 3つの選択ピッカーを作成します。

生成された select 要素をさらに制御するには、オプションを追加します。

例:

// 今年が 2017 年だと仮定すると、これは日ピッカーを無効にし、年ピッカーの空の
// オプションを削除し、最低年を制限し、年の HTML 属性を追加し、
// 月の文字列の 'empty' オプションを追加し、月を数値に変更します。
<?php
    echo $this->Form->date('registered', [
        'minYear' => 2018,
        'monthNames' => false, // 月は数字で表示されます。
        'empty' => [
            'year' => false, // 年選択コントロールは空の値のオプションを持ちません。
            'month' => 'Choose month...' // しかしながら、月選択コントロールは持ちます。
        ],
        'day' => false, // 日付選択コントールを表示しない。
        'year' => [
            'class' => 'cool-years',
            'title' => 'Registration Year'
        ]
    ]);
?>

出力結果:

<select class= "cool-years" name="registered[year]" title="Registration Year">
    <option value="2022">2022</option>
    <option value="2021">2021</option>
    ...
    <option value="2018">2018</option>
</select>
<select name="registered[month]">
    <option value="" selected="selected">Choose month...</option>
    <option value="01">1</option>
    ...
    <option value="12">12</option>
</select>

時間コントロールの作成¶

Cake\View\Helper\FormHelper::time($fieldName, $options = [])¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $options - 特定のコントロールのための共通オプション 、 日付と時刻のコントロールの共通オプション 、 適用可能な 時刻関連コントロールのオプション 、そして有効な HTML 属性を含むオプション配列。

デフォルトでは、 24 時間と 60 分の値が入力された２つの select 要素 (hour と minute) を生成します。さらに、HTML 属性は、特定のコンポーネントごとに $options で指定することができます。 $options['empty'] が false の場合、選択ピッカーは空のデフォルトオプションを含みません。

たとえば、15 分単位で選択できる時間範囲を作成し、各 select ボックスにクラスを適用するには、 次のようにします。

echo $this->Form->time('released', [
    'interval' => 15,
    'hour' => [
        'class' => 'foo-class',
    ],
    'minute' => [
        'class' => 'bar-class',
    ],
]);

これは、次の2つの選択ピッカーを作成します。

<select name="released[hour]" class="foo-class">
    <option value="" selected="selected"></option>
    <option value="00">0</option>
    <option value="01">1</option>
    <!-- .. 中略 .. -->
    <option value="22">22</option>
    <option value="23">23</option>
</select>
<select name="released[minute]" class="bar-class">
    <option value="" selected="selected"></option>
    <option value="00">00</option>
    <option value="15">15</option>
    <option value="30">30</option>
    <option value="45">45</option>
</select>

年コントロールの作成¶

Cake\View\Helper\FormHelper::year(string $fieldName, array $options = [])¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $options - 特定のコントロールのための共通オプション 、 日付と時刻のコントロールの共通オプション 、 適用可能な 時刻関連コントロールのオプション 、そして有効な HTML 属性を含むオプション配列。

minYear から maxYear （これらのオプションが提供されているとき）、 または今日から数えて-5年から+5年までの値を持つ select 要素を作成します。 さらに、HTML 属性は、 $options で指定することができます。 $options ['empty'] が false の場合、選択ピッカーはリスト内に空の項目を含みません。

たとえば、2000 年から今年までの年を作成するには、次のようにします。

echo $this->Form->year('purchased', [
    'minYear' => 2000,
    'maxYear' => date('Y')
]);

2009 年だった場合は、次のようになるでしょう。

<select name="purchased[year]">
<option value=""></option>
<option value="2009">2009</option>
<option value="2008">2008</option>
<option value="2007">2007</option>
<option value="2006">2006</option>
<option value="2005">2005</option>
<option value="2004">2004</option>
<option value="2003">2003</option>
<option value="2002">2002</option>
<option value="2001">2001</option>
<option value="2000">2000</option>
</select>

月コントロールの作成¶

Cake\View\Helper\FormHelper::month(string $fieldName, array $attributes)¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $attributes - 特定のコントロールのための共通オプション 、 日付と時刻のコントロールの共通オプション 、 適用可能な 時刻関連コントロールのオプション 、そして有効な HTML 属性を含むオプション配列。

月の名前を列挙した select 要素を作成します。

例:

echo $this->Form->month('mob');

出力結果:

<select name="mob[month]">
<option value=""></option>
<option value="01">January</option>
<option value="02">February</option>
<option value="03">March</option>
<option value="04">April</option>
<option value="05">May</option>
<option value="06">June</option>
<option value="07">July</option>
<option value="08">August</option>
<option value="09">September</option>
<option value="10">October</option>
<option value="11">November</option>
<option value="12">December</option>
</select>

'monthNames' 属性に独自の月の名前を配列で設定することもできます。 また false を指定すると、月が数字で表示されます。

例:

echo $this->Form->month('mob', ['monthNames' => false]);

日コントロールの作成¶

Cake\View\Helper\FormHelper::day(string $fieldName, array $attributes)¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $attributes - 特定のコントロールのための共通オプション 、 日付と時刻のコントロールの共通オプション 、 適用可能な 時刻関連コントロールのオプション 、そして有効な HTML 属性を含むオプション配列。

（数字の）日を列挙する select 要素を作成します。

あなたの選択した指示テキストで空の option を作成するには（たとえば、 最初のオプションは 'Day'）、 'empty' パラメーターにテキストを指定できます。

例:

echo $this->Form->day('created', ['empty' => 'Day']);

出力結果:

<select name="created[day]">
    <option value="" selected="selected">Day</option>
    <option value="01">1</option>
    <option value="02">2</option>
    <option value="03">3</option>
    ...
    <option value="31">31</option>
</select>

時間コントロールの作成¶

Cake\View\Helper\FormHelper::hour(string $fieldName, array $attributes)¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $attributes - 特定のコントロールのための共通オプション 、 日付と時刻のコントロールの共通オプション 、 適用可能な 時刻関連コントロールのオプション 、そして有効な HTML 属性を含むオプション配列。

時を列挙した select 要素を作成します。

format オプションを使用して、12 時間または 24 時間のピッカーを作成することができます。

echo $this->Form->hour('created', [
    'format' => 12
]);
echo $this->Form->hour('created', [
    'format' => 24
]);

分コントロールの作成¶

Cake\View\Helper\FormHelper::minute(string $fieldName, array $attributes)¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $attributes - 特定のコントロールのための共通オプション 、 日付と時刻のコントロールの共通オプション 、 適用可能な 時刻関連コントロールのオプション 、そして有効な HTML 属性を含むオプション配列。

分の値を列挙した select 要素を作成します。 interval オプションを使用して特定の値のみを含む選択ピッカーを作成することができます。

たとえば、10 分ずつ増やしたい場合は、次のようにします。

// ビューテンプレートファイルの中で
echo $this->Form->minute('arrival', [
    'interval' => 10
]);

これは、以下を出力します。

<select name="arrival[minute]">
    <option value="" selected="selected"></option>
    <option value="00">00</option>
    <option value="10">10</option>
    <option value="20">20</option>
    <option value="30">30</option>
    <option value="40">40</option>
    <option value="50">50</option>
</select>

午前と午後コントロールの作成¶

Cake\View\Helper\FormHelper::meridian(string $fieldName, array $attributes)¶

• $fieldName - select 要素の HTML name 属性のプレフィックスとして使用される文字列。

• $attributes - 特定のコントロールのための共通オプション と有効な HTML 属性を含むオプション配列。

'am' と 'pm' を列挙した select 要素を生成します。これは、時間の書式を 24 の代わりに 12 をセットした時に便利で、時間が属する期間を指定することができます。