Tipo de campo number

Reproduce un campo de entrada de texto y se especializa en el manejo de entradas numéricas. Este tipo ofrece diferentes opciones para precisión, redondeo y agrupamiento que desees utilizar para tu número.

Rendered as	input text field
Options	rounding_mode precision grouping
Inherited options	required label read_only disabled error_bubbling invalid_message invalid_message_parameters
Parent type	field
Class	Symfony\Component\Form\Extension\Core\Type\NumberType

Opciones del campo

precision

tipo: integer predeterminado: Específico a la región (usualmente alrededor de 3)

Este especifica cuantos decimales se permitirán para redondear el campo al valor presentado (a través de rounding_mode). Por ejemplo, si precision se establece en 2, un valor presentado de 20.123 se redondeará a, por ejemplo, 20.12 (dependiendo de tu rounding_mode).

rounding_mode

tipo: integer predeterminado: IntegerToLocalizedStringTransformer::ROUND_HALFUP

Si es necesario redondear un número presentado (basándonos en la opción precision), tienes varias opciones configurables para el redondeo. Cada opción es una constante en Symfony\Component\Form\Extension\Core\DataTransformer\IntegerToLocalizedStringTransformer:

• IntegerToLocalizedStringTransformer::ROUND_DOWN modo de redondeo para redondear hacia cero.
• IntegerToLocalizedStringTransformer::ROUND_FLOOR modo de redondeo para redondear hacia el infinito negativo.
• IntegerToLocalizedStringTransformer::ROUND_UP modo de redondeo para redondear alejándose del cero.
• IntegerToLocalizedStringTransformer::ROUND_CEILING modo de redondeo para redondear hacia el infinito positivo.
• IntegerToLocalizedStringTransformer::ROUND_HALFDOWN El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso se redondea hacia abajo.
• IntegerToLocalizedStringTransformer::ROUND_HALFEVEN El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso, se redondea hacia el vecino par.
• IntegerToLocalizedStringTransformer::ROUND_HALFUP El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso se redondea hacia arriba.

grouping

tipo: integer predeterminado: false

Este valor se utiliza internamente como el valor de NumberFormatter::GROUPING_USED cuando se utiliza la clase PHP NumberFormatter. Su documentación no existe, pero parece que si se establece este a true, los números se agrupan con una coma o un punto (dependiendo de tu región): 12345.123 lo mostrará cómo 12,345.123.

Opciones heredadas

Estas opciones las hereda del tipo field:

required

tipo: Boolean predeterminado: true

Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

label

tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

{{ form_label(form.name, 'Tu nombre') }}

read_only

Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly HTML attribute. Previously, it rendered as a disabled attribute. Use the disabled option if you need the old behavior.

tipo: Boolean predeterminado: false

If this option is true, the field will be rendered with the readonly attribute so that the field is not editable.

disabled

Nuevo en la versión 2.1: The disabled option is new in version 2.1

type: boolean default: false

Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

error_bubbling

tipo: Boolean predeterminado: false

Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

invalid_message

tipo: string predefinido: This value is not valid (Este valor no es válido)

Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

invalid_message_parameters

tipo: array predeterminado: array()

Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

$builder->add('some_field', 'some_type', array(
    // ...
    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
    'invalid_message_parameters' => array('%num%' => 6),
));