FormHelper 拡張クラス

package Baser.View.Helper

 Methods

Creates a checkbox input widget.

checkbox(string $fieldName, array $options = array()) : string
MODIFIED 2008/10/24 egashira hiddenタグを出力しないオプションを追加 ### Options: - `value` - the value of the checkbox - `checked` - boolean indicate that this checkbox is checked. - `hiddenField` - boolean to indicate if you want the results of checkbox() to include a hidden input with a value of ''. - `disabled` - create a disabled input. - `default` - Set the default value for the checkbox. This allows you to start checkboxes as checked, without having to check the POST data. A matching POST data value, will overwrite the default value.
link http://book.cakephp.org/2.0/en/core-libraries/helpers/form.html#options-for-select-checkbox-and-radio-inputs

Parameters

$fieldName

string

Name of a field, like this "Modelname.fieldname"

$options

array

Array of HTML attributes.

Returns

stringAn HTML text input element.

CKEditorを出力する

ckeditor(string $fieldName, array $options = array()) : string
access public

Parameters

$fieldName

string

$options

array

Returns

string

create フック用にラッピング

create(array $model = null, array $options = array()) : string

Parameters

$model

array

$options

array

Returns

string

Returns a set of SELECT elements for a full datetime setup: day, month and year, and then time.

dateTime(string $fieldName, string $dateFormat = 'DMY', string $timeFormat = '12', array $attributes = array()) : string
### Attributes: - `monthNames` If false, 2 digit numbers will be used instead of text. If a array, the given array will be used. - `minYear` The lowest year to use in the year select - `maxYear` The maximum year to use in the year select - `interval` The interval for the minutes select. Defaults to 1 - `separator` The contents of the string between select elements. Defaults to '-' - `empty` - If true, the empty select option is shown. If a string, that string is displayed as the empty element. - `round` - Set to `up` or `down` if you want to force rounding in either direction. Defaults to null. - `value` | `default` The default value to be used by the input. A value in `$this->data` matching the field name will override this value. If no default is provided `time()` will be used.
link http://book.cakephp.org/2.0/en/core-libraries/helpers/form.html#FormHelper::dateTime

Parameters

$fieldName

string

Prefix name for the SELECT element

$dateFormat

string

DMY, MDY, YMD, or null to not generate date inputs.

  • W が入力された場合、和暦のselectと年月日の接尾辞が付与される

$timeFormat

string

12, 24, or null to not generate time inputs.

$attributes

array

Array of Attributes

Returns

stringGenerated set of select boxes for the date and time formats chosen.

日付カレンダーと時間フィールド

dateTimePicker(string $fieldName, array $attributes = array()) : string

Parameters

$fieldName

string

$attributes

array

Returns

string

カレンダーコントロール付きのテキストフィールド jquery-ui-1.7.2 必須

datepicker($fieldName, $attributes = array()) : string

Parameters

$fieldName

$attributes

Returns

stringhtml

フォームの最後のフィールドの後に発動する前提としてイベントを発動する

dispatchAfterForm(string $type = '') : string
### 発動側 フォームのの直前に記述して利用する ### コールバック処理 プラグインのコールバック処理で CakeEvent::data['fields'] に 配列で行データを追加する事でフォームの最後に行を追加する事ができる。 ### イベント名 コントローラー名.Form.afterForm Or コントローラー名.Form.afterOptionForm ### 行データのキー(配列) - title:見出欄 - input:入力欄 ### 行データの追加例 $View = $event->subject(); // $event は、CakeEvent $input = $View->BcForm->input('Page.add_field', array('type' => 'input')); $event->data['fields'][] = array( 'title' => '追加フィールド', 'input' => $input );

Parameters

$type

string

フォームのタイプ タイプごとにイベントの登録ができる

Returns

string行データ

エディタを表示する

editor(string $fieldName, array $options = array()) : string

Parameters

$fieldName

string

$options

array

Returns

string

end フック用にラッピング

end(array $options = null, $secureAttributes = array()) : string
access public

Parameters

$options

array

$secureAttributes

Returns

string

ファイルインプットボックス出力

file(string $fieldName, array $options = array()) : string
画像の場合は画像タグ、その他の場合はファイルへのリンク そして削除用のチェックボックスを表示する 《オプション》 imgsize 画像のサイズを指定する rel A タグの rel 属性を指定 title A タグの title 属性を指定 link 大きいサイズへの画像へのリンク有無 delCheck 削除用チェックボックスの利用可否 force ファイルの存在有無に関わらず強制的に画像タグを表示するかどうか

Parameters

$fieldName

string

$options

array

Returns

string

モデルよりリストを生成する

generateList(string $modelName, mixed $conditions = array(), mixed $fields = array(), mixed $order = array()) : mixed

Parameters

$modelName

string

$conditions

mixed

$fields

mixed

$order

mixed

Returns

mixedリストまたは、false

コントロールソースを取得する Model側でメソッドを用意しておく必要がある

getControlSource(string $field, array $options = array()) : array

Parameters

$field

string

フィールド名

$options

array

Returns

arrayコントロールソース

Creates a hidden input field.

hidden(string $fieldName, array $options = array()) : string
link http://book.cakephp.org/2.0/en/core-libraries/helpers/form.html#FormHelper::hidden

Parameters

$fieldName

string

Name of a field, in the form of "Modelname.fieldname"

$options

array

Array of HTML attributes.

Returns

stringA generated hidden input

Generates a form input element complete with label and wrapper div

input(string $fieldName, array $options = array()) : string
Options - See each field type method for more information. Any options that are part of $attributes or $options for the different type methods can be included in $options for input(). - 'type' - Force the type of widget you want. e.g. ```type => 'select'``` - 'label' - control the label - 'div' - control the wrapping div element - 'options' - for widgets that take options e.g. radio, select - 'error' - control the error message that is produced

Parameters

$fieldName

string

This should be "Modelname.fieldname"

$options

array

Each type of input takes different options.

Returns

stringCompleted form widget

JsonList

jsonList(string $field, string $attributes) : array

Parameters

$field

string

フィールド文字列

$attributes

string

Returns

array属性

都道府県用のSELECTタグを表示する

prefTag(string $fieldName, mixed $selected = null, array $attributes = array()) : string

Parameters

$fieldName

string

Name attribute of the SELECT

$selected

mixed

Selected option

$attributes

array

Array of HTML options for the opening SELECT element

Returns

string都道府県用のSELECTタグ

Returns a formatted SELECT element.

select(string $fieldName, array $options = array(), array $attributes = array()) : string
### Attributes: - `showParents` - If included in the array and set to true, an additional option element will be added for the parent of each option group. You can set an option with the same name and it's key will be used for the value of the option. - `multiple` - show a multiple select box. If set to 'checkbox' multiple checkboxes will be created instead. - `empty` - If true, the empty select option is shown. If a string, that string is displayed as the empty element. - `escape` - If true contents of options will be HTML entity encoded. Defaults to true. - `value` The selected value of the input. - `class` - When using multiple = checkbox the class name to apply to the divs. Defaults to 'checkbox'. - `disabled` - Control the disabled attribute. When creating a select box, set to true to disable the select box. When creating checkboxes, `true` will disable all checkboxes. You can also set disabled to a list of values you want to disable when creating checkboxes. ### Using options A simple array will create normal options: ``` $options = array(1 => 'one', 2 => 'two); $this->Form->select('Model.field', $options)); ``` While a nested options array will create optgroups with options inside them. ``` $options = array( 1 => 'bill', 'fred' => array( 2 => 'fred', 3 => 'fred jr.' ) ); $this->Form->select('Model.field', $options); ``` In the above `2 => 'fred'` will not generate an option element. You should enable the `showParents` attribute to show the fred option. If you have multiple options that need to have the same value attribute, you can use an array of arrays to express this: ``` $options = array( array('name' => 'United states', 'value' => 'USA'), array('name' => 'USA', 'value' => 'USA'), ); ```
link http://book.cakephp.org/2.0/en/core-libraries/helpers/form.html#options-for-select-checkbox-and-radio-inputs

Parameters

$fieldName

string

Name attribute of the SELECT

$options

array

Array of the OPTION elements (as 'value'=>'Text' pairs) to be used in the SELECT element

$attributes

array

The HTML attributes of the select element.

Returns

stringFormatted SELECT element

文字列保存用複数選択コントロール

selectText(string $fieldName, array $options = array(), mixed $selected = null, array $attributes = array(), mixed $showEmpty = '') : string

Parameters

$fieldName

string

id,nameなどの名前

$options

array

optionタグの値

$selected

mixed

selectedを付与する要素

$attributes

array

htmlの属性

$showEmpty

mixed

空要素の表示/非表示、初期値

Returns

string

Creates a submit button element. This method will generate `<input />` elements that can be used to submit, and reset forms by using $options. image submits can be created by supplying an image path for $caption.

submit(string $caption = null, array $options = array()) : string
### Options - `div` - Include a wrapping div? Defaults to true. Accepts sub options similar to FormHelper::input(). - `before` - Content to include before the input. - `after` - Content to include after the input. - `type` - Set to 'reset' for reset inputs. Defaults to 'submit' - Other attributes will be assigned to the input element. ### Options - `div` - Include a wrapping div? Defaults to true. Accepts sub options similar to FormHelper::input(). - Other attributes will be assigned to the input element.
link http://book.cakephp.org/2.0/en/core-libraries/helpers/form.html#FormHelper::submit

Parameters

$caption

string

The label appearing on the button OR if string contains :// or the extension .jpg, .jpe, .jpeg, .gif, .png use an image if the extension exists, AND the first character is /, image is relative to webroot, OR if the first character is not /, image is relative to webroot/img.

$options

array

Array of options. See above.

Returns

stringA HTML submit button

和暦年

wyear(string $fieldName, integer $minYear = null, integer $maxYear = null, string $selected = null, array $attributes = array(), boolean $showEmpty = true) : string

Parameters

$fieldName

string

Prefix name for the SELECT element

$minYear

integer

First year in sequence

$maxYear

integer

Last year in sequence

$selected

string

Option which is selected.

$attributes

array

Attribute array for the select elements.

$showEmpty

boolean

Show/hide the empty select option

Returns

string

Generates option lists for common <select /> menus

_generateOptions(string $name, array $options = array()) : array

Parameters

$name

string

List type name.

$options

array

Options list.

Returns

array

フォームのIDを取得する BcForm::create より呼出される事が前提

_getId(string $model = null, array $options = array()) : string

Parameters

$model

string

$options

array

Returns

string

Returns an array of formatted OPTION/OPTGROUP elements

_selectOptions(array $elements = array(), array $parents = array(), boolean $showParents = null, array $attributes = array()) : array

Parameters

$elements

array

$parents

array

$showParents

boolean

$attributes

array

Returns

array

 Properties

 

$helpers

$helpers 

Default

array('Html', 'BcTime', 'BcText', 'Js', 'BcUpload', 'BcCkeditor')
 

sizeCounter用の関数読み込み可否

$sizeCounterFunctionLoaded : boolean

Default

false
 

フォームID

$__id : string

Default

null