Merge branch 'searchfield' of git://github.com/shieldo/symfony-docs into shieldo-searchfield

weaverryan · weaverryan · commit 03c228e09928 · 2011-05-24T11:29:05.000-05:00
diff --git a/reference/forms/types.rst b/reference/forms/types.rst
@@ -31,6 +31,7 @@ Form Types Reference
    types/percent
    types/radio
    types/repeated
+   types/search
    types/text
    types/textarea
    types/time
diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
@@ -9,6 +9,7 @@ Text Fields
 * :doc:`number</reference/forms/types/number>`
 * :doc:`password</reference/forms/types/password>`
 * :doc:`percent</reference/forms/types/percent>`
+* :doc:`search</reference/forms/types/search>`
 * :doc:`url</reference/forms/types/url>`
 
 Choice Fields
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
@@ -0,0 +1,40 @@
+.. index::
+   single: Forms; Fields; search
+
+search Field Type
+=================
+
+The ``search`` field is a text field that is used for the entry of searches, and is rendered by default using a ``search`` input type which can be used by user agents to present a specialised rendering for search boxes (such as the `one used in WebKit-based browsers`_).
+
++-------------+----------------------------------------------------------------------+
+| Rendered as | ``input search`` field                                               |
++-------------+----------------------------------------------------------------------+
+| Inherited   | - ``default_protocol``                                               |
+| options     | - ``max_length``                                                     |
+|             | - ``required``                                                       |
+|             | - ``label``                                                          |
+|             | - ``read_only``                                                      |
+|             | - ``trim``                                                           |
+|             | - ``error_bubbling``                                                 |
++-------------+----------------------------------------------------------------------+
+| Parent type | ``text``                                                             |
++-------------+----------------------------------------------------------------------+
+| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` |
++-------------+----------------------------------------------------------------------+
+
+Options
+-------
+
+.. include:: /reference/forms/types/options/max_length.rst.inc
+
+.. include:: /reference/forms/types/options/required.rst.inc
+
+.. include:: /reference/forms/types/options/label.rst.inc
+
+.. include:: /reference/forms/types/options/read_only.rst.inc
+
+.. include:: /reference/forms/types/options/trim.rst.inc
+
+.. include:: /reference/forms/types/options/error_bubbling.rst.inc
+
+.. _`one used in WebKit-based browsers`: http://alexking.org/blog/2006/11/12/safari-search-boxes
