8. Form Types (フォームタイプ)

8.1. Admin related form types (Adminはフォームタイプに関連しています)

The bundle come with different form types to handle model values:

バンドルはモデルの値を処理するために異なるフォームタイプから構成される。

8.1.1. sonata_type_model

The Model Type allows you to choose an existing model or create new ones. This type doesn’t allow to directly edit the selected model.

Model Type は存在しているモデルを選択したり、新しいモデルを作成することを許します。

このタイプは選択されたモデルを直接編集することを許可しません。

8.1.2. sonata_type_admin

The Admin Type will delegate the form construction for this model to its related admin class. This type is useful to cascade edition or creation of linked models.

Admin Type はモデルに関連したadminクラスにformの構築を委譲します。

このタイプはカスケード表示による編集やリンクされたモデルの作成に役立ちます。

8.1.3. sonata_type_collection

The Collection Type is meant to handle creation and edition of model collections. Rows can be added and deleted, and your model abstraction layer may allow you to edit fields inline.

Collection Type はコレクションモデルの作成と編集を扱うために重要です。

行を追加したり削除したり、モデルの抽象化層はインラインでフィールドを編集することができるでしょう。

TIP: A jQuery event is fired after a row has been added(sonata-collection-item-added) or deleted(sonata-collection-item-deleted). You can bind to them to trigger some custom javascript imported into your templates(eg: add a calendar widget to a just added date field)

8.1.4. Type configuration

todo

8.1.5. Field configuration

• admin_code: Force for any field involving a model the admin class used to

  handle it (useful for inline editing with sonata_type_admin). The expected value here is the admin service name, not the class name. If not defined, the default admin class for the model type will be used (even if you didn’t define any admin for the model type).

Other specific field configuration options are detailed in the related abstraction layer documentation.

8.2. Other form types

The bundle comes with some handy form types which are available from outside the scope of the SonataAdminBundle:

バンドルは SonataAdminBundle のスコープの外から利用できるいくつかの便利なフォームタイプを備えています。

8.2.1. sonata_type_immutable_array

The Immutable Array allows you to edit an array property by defining a type per key.

Immutable Array はキーごとにタイプを定義することにより配列プロパティを編集することができます。

The type has a keys parameter which contains the definition for each key. A definition is an array with 3 options :

このタイプ(sonata_type_immutable_array)はそれぞれのキーごとに定義を含んだキーパラメーターを持っています。（訳が意味不明ですね。。）

定義は３つのオプションを持った配列です

• key name
• type : a type name or a FormType instance (タイプ名 もしくは FormType のインスタンス)
• related type parameters : please refer to the related form documentation.

(関係したform documentationを参照して下さい)

Let’s say a Page have options property with some fixed key-pair values, each value has a different type : integer, url, or string for instance.

例えば、固定化されたいくつかのkey-pair 値のオプションプロパティを持った Page があるとして、 それぞれの値は異なるタイプを持っています。具体的には、数字やurlもしくは文字列といったものがあるでしょう。 （翻訳がちょっと怪しいです）

<?php
class Page
{
    protected $options = array(
        'ttl'       => 1,
        'redirect'  => ''
    );

    public function setOptions(array $options)
    {
        $this->options = $options;
    }

    public function getOptions()
    {
        return $this->options;
    }
}

Now, the property can be edited by setting a type for each type

これから、そのプロパティはそれぞれのタイプに応じてタイプが設定され編集されます。

<?php
$form->add('options', 'sonata_type_immutable_array', array(
    'keys' => array(
        array('ttl',        'text', array('required' => false)),
        array('redirect',   'url',  array('required' => true)),
    )
));

8.2.2. sonata_type_boolean

The boolean type is a specialized ChoiceType where the choices list is locked to ‘yes’ and ‘no’.

boolean タイプは選択リストがyesかnoに固定された ChoiceType に特化しています。

8.2.3. sonata_type_translatable_choice

The translatable type is a specialized ChoiceType where the choices values are translated with the Symfony Translator component.

translatable type は選択肢の値がSymfony Translator component で翻訳することに 特化した ChoiceType です。

The type has one extra parameter (このタイプは１つの追加パラメーターを持っています):

• catalogue : the catalogue name to translate the value (値を翻訳するためのカタログの名前)

<?php

// The delivery list
class Delivery
{
    public static function getStatusList()
    {
        return array(
            self::STATUS_OPEN      => 'status_open',
            self::STATUS_PENDING   => 'status_pending',
            self::STATUS_VALIDATED => 'status_validated',
            self::STATUS_CANCELLED => 'status_cancelled',
            self::STATUS_ERROR     => 'status_error',
            self::STATUS_STOPPED   => 'status_stopped',
        );
    }
}

// form usage
$form->add('deliveryStatus', 'sonata_type_translatable_choice', array(
    'choices' => Delivery::getStatusList(),
    'catalogue' => 'SonataOrderBundle'
))