Input Field (Campo de Input)
Un Input Field es una manera de hacer que el texto de un Text Control sea editable. Como los otros controles de interacción, no es un elemento UI visible en sí y debe ser combinado con uno o más elementos UI visuales con el fin de ser visible.
Propiedades
| Propiedad: | Función: | |
|---|---|---|
| Interactable | Un boolean que determina si con el Input Field se puede interactuar o no. | |
| Transition | Transitions are used to set how the input field transitions when Normal, Highlighted, Pressed or Disabled. | |
| Navigation | Properties that determine the sequence of controls. See Navigation Options. | |
| TextComponent | Una referencia al elemento Text utilizado como contenido de laInput Field | |
| Text | Valor inicial. El texto inicial colocado en el campo antes de comenzar la edición. | |
| Character Limit | El valor del número máximo de caracteres que se pueden ingresar en el campo de entrada. | |
| Content Type | Define the type(s) of characters that your input field accepts | |
| Standard | Any character can be entered. | |
| Autocorrected | The autocorrection determines whether the input tracks unknown words and suggests a more suitable replacement candidate to the user, replacing the typed text automatically unless the user explicitly overrides the action. | |
| Integer Number | Allow only whole numbers to be entered. | |
| Decimal Number | Allow only numbers and a single decimal point to be entered. | |
| Alphanumeric | Allow both letters and numbers. Symbols cannot be entered. | |
| Name | Automatically capitalizes the first letter of each word. Note that the user can circumvent the capitalization rules using the Delete key. | |
| Email Address | Allows you to enter an Alphanumeric string consisting of a maximum of one @ sign. periods/baseline dots cannot be entered next to each other. | |
| Password* | Conceals the characters inputed with an asterisk. Allows symbols. | |
| Pin | Conceals the characters inputed with an asterisk. Only allows only whole numbers to be entered. | |
| Custom | Allows you to customise the Line Type, Input Type, Keyboard Type and Character Validation. | |
| Line Type | Defines how text is formatted inside the text field. | |
| Single Line | Only allows text to be on a single line. | |
| Multi Line Submit | Allows text to use multiple lines. Only uses a new line when needed. | |
| Multi Line Newline | Allows text to use multiple lines. User can use a newline by pressing the return key. | |
| Placeholder | Este es un Graphic ‘vacío’ opcional para mostrar que el Input Field está vacío de texto. Tenga en cuenta que este gráfico ‘vacío’ aún se muestra incluso cuando se selecciona Input Field (es decir, cuando hay un foco en él). p.ej; “Ingrese texto…”. | |
| Caret Blink Rate | Define la frecuencia de parpadeo de la marca colocada en la línea para indicar una inserción propuesta de texto. | |
| Selection Color | El color de fondo de la porción de texto seleccionada. | |
| Hide Mobile Input (iOS only) | Hides the native input field attached to the onscreen keyboard on mobile devices. Note that this only works on iOS devices. | |
Eventos
| Propiedad: | Función: |
|---|---|
| On Value Change | Un UnityEvent que es invocado cuando el contenido del texto del Input Field cambia. El evento puede enviar el contenido de texto actual como un argumento dinámico de tipo string. |
| End Edit | Un UnityEvent que es invocado cuando el usuario terminar de editar el contenido del texto ya sea al enviar o hacer click en alguna parte que quita el foco del Input Field. El evento puede enviar el contenido de texto actual como un argumento dinámico de tipo string. |
Detalles
El script del Input Field puede ser agregado a cualquier objeto de control de Texto existente desde el menú (Component > UI > Input Field). Al tener esto hecho, usted debería también arrastrar el objeto a la propiedad Text del Input Field para habilitar la edición.
La propiedad Text de un controlador de Texto en sí va a cambiar a medida que el usuario escriba y el valor puedas ser obtenido desde un script después de editar. Tenga en cuenta que Rich Text es intencionalmente no soportado para los controles de edición de Texto; el campo va a aplicar cualquier markup de Rich Text de manera instantánea cuando se escriba pero el markup esencialmente “desaparece” y no hay una manera de cambiar o quitar el estilo.
Recomendaciones
- To obtain the text of the Input Field, use the text property on the InputField component itself, not the text property of the Text component that displays the text. The text property of the Text component may be cropped or may consist of asterisks for passwords.