improved description of choice_list option of Choice form type

azielinski · azielinski · commit 5bc5969903e7 · 2015-03-02T03:17:33.000+01:00
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
@@ -111,17 +111,27 @@ The ``choice_list`` option must be an instance of the ``ChoiceListInterface``.
 For more advanced cases, a custom class that implements the interface
 can be created to supply the choices.
 
-With this option you can also allow float values to be selected as data.
+With this option you can also allow float values to be selected as data. For example:
 
 .. code-block:: php
 
     use Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceList;
 
     // ...
     $builder->add('status', 'choice', array(
-      'choice_list' => new ChoiceList(array(1, 0.5), array('Full', 'Half'))
+      'choice_list' => new ChoiceList(array(1, 0.5, 0.1), array('Full', 'Half', 'Almost empty'))
     ));
 
+The ``status`` field created by the code above will be rendered as:
+
+.. code-block:: html
+
+    <select name="status">
+        <option value="0">Full</option>
+        <option value="1">Half</option>
+        <option value="2">Almost empty</option>
+    </select>
+
 .. include:: /reference/forms/types/options/empty_value.rst.inc
 
 .. include:: /reference/forms/types/options/expanded.rst.inc
