
Objeto de Entrada
El Objeto de Entrada recopila respuestas libres de los participantes durante un experimento. Soporta cinco tipos de entrada: número, texto, fecha, hora y color. La respuesta se almacena en una variable vinculada y se registra automáticamente al final de cada ensayo. Puedes configurar reglas de validación, mostrar texto de marcador de posición para guiar a los participantes antes de que comiencen a escribir, y controlar el elemento a través de eventos.
Tabla de Contenidos
Agregar el Objeto de Entrada
En la barra de herramientas del editor de tareas, abre el grupo Question Inputs y selecciona Input para agregar un Objeto de Entrada al marco actual.
Cuando se agrega el elemento, Labvanced te solicita que nombres la variable que almacenará la respuesta del participante. Dale un nombre descriptivo que refleje los datos que se están recopilando (por ejemplo, response_text o age).
Tipos de Entrada
Selecciona el tipo de entrada en el panel Propiedades del Objeto. El tipo de datos de la variable vinculada se establece automáticamente para que coincida.
| Tipo de Entrada | Tipo de Datos de Variable | Notas |
|---|---|---|
number | Numérico | Acepta enteros y decimales. Validación de valor mínimo/máximo disponible. |
text | Cadena | Acepta cualquier texto. Validación de longitud de caracteres disponible. |
date | Fecha y hora | Muestra un selector de fecha. Formato de fecha configurable. |
time | Hora | Muestra un selector de hora. |
color | Cadena | Muestra un selector de color. Almacena el valor de color seleccionado como una cadena. |
Propiedades
| Propiedad | Predeterminado | Descripción |
|---|---|---|
Show Question Header | Activado | Muestra la etiqueta de texto de la pregunta por encima del campo de entrada. |
Show Placeholder | Desactivado | Cuando está habilitado, muestra texto de marcador de posición dentro del campo antes de que el participante comience a escribir. Disponible solo para los tipos number y text. |
Placeholder | (vacío) | El texto de marcador de posición. Solo visible en el panel cuando Show Placeholder está activado. |
Required | Desactivado | Cuando está habilitado, el participante no puede enviar el marco o la página del cuestionario hasta que este campo contenga un valor válido. |
Input type | number | El tipo de campo de entrada mostrado al participante. Opciones: number, text, date, time, color. |
Focused | falso | Cuando se establece en verdadero, mueve el enfoque del teclado a este campo. Configurable por ensayo a través del sistema de eventos. |
Min-Value | (ninguno) | Solo para el tipo number. El valor más bajo aceptado. |
Max-Value | (ninguno) | Solo para el tipo number. El valor más alto aceptado. |
Min-Nr-Chars | (ninguno) | Solo para el tipo text. El número mínimo de caracteres requeridos. |
Max-Nr-Chars | (ninguno) | Solo para el tipo text. El número máximo de caracteres permitidos. |
Date Format | browser-locale | Solo para el tipo date. Controla cómo se muestra y se ingresa la fecha. Opciones: browser-locale, yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy. Solo visible en el panel cuando el tipo de entrada se establece en date. |
Texto de Marcador de Posición
El texto de marcador de posición aparece dentro del campo de entrada cuando está vacío, antes de que el participante comience a escribir. Desaparece tan pronto como el participante comienza a ingresar un valor.
Para habilitarlo:
- En el panel de Propiedades del Objeto, habilita
Enable Placeholder. - Ingresa el texto deseado en el campo
Placeholder Text.
Usa texto de marcador de posición para dar a los participantes una pista de formato (por ejemplo, Enter a number between 1 and 100) o una breve instrucción, sin ocupar espacio por encima del campo con una etiqueta completa.
Note: El texto de marcador de posición no se registra como una respuesta. Es solo para visualización y no afecta el valor de la variable.
Validación
El Objeto de Entrada incluye opciones de validación integradas para asegurar que los participantes proporcionen datos utilizables antes de continuar.
Campo requerido: Habilita Is Required para evitar el envío de marco o página hasta que el campo contenga un valor válido y no vacío. Si un participante intenta continuar sin llenar un campo requerido, se resalta el campo.
Rango numérico: Para entradas number, establece Min Value y Max Value para limitar las entradas aceptadas. Si un participante ingresa un valor fuera del rango y luego deja el campo, el valor se corrige automáticamente al límite más cercano.
Longitud de caracteres: Para entradas text, establece Min Nr Chars y Max Nr Chars para hacer cumplir las restricciones de longitud. Estas se verifican cuando Is Required está habilitado.
Integración de Variables
Cada Objeto de Entrada está vinculado a una variable global, creada cuando agregas el elemento. La variable almacena el valor actual de respuesta del participante y se registra al final del ensayo.
El tipo de datos de la variable se establece automáticamente según el tipo de entrada seleccionado:
number→ Variable numéricatext→ Variable de cadenadate→ Variable de fecha y horatime→ Variable de horacolor→ Variable de cadena
Para volver a vincular el elemento a una variable diferente, utiliza el selector de variable en el panel de Propiedades del Objeto.
Integración de Eventos
El Objeto de Entrada funciona con eventos de dos maneras: como un objetivo de activación y como un objetivo de acción.
Activar eventos desde el Objeto de Entrada
El disparador Enter On Input se activa cuando el participante presiona Enter o Retorno mientras el campo de entrada está enfocado. Agrega tu Objeto de Entrada bajo Targets: en la configuración del disparador.
Ejemplo: enviar el marco cuando el participante presiona Enter
Disparador:
Enter On Input→Targets: agrega tu Objeto de Entrada Acción:Jump to Next Frame
Controlando el Objeto de Entrada a través de acciones
Dos propiedades son modificables en tiempo de ejecución a través de la acción Set Object Property:
| Propiedad Modificable | Descripción |
|---|---|
Focused | Cuando se establece en verdadero, mueve el enfoque al campo de entrada de manera programática. |
required | Se puede alternar en tiempo de ejecución para requerir condicionalmente el campo según las respuestas anteriores del participante. |
Ejemplo: enfocar el campo de entrada cuando comienza el marco
Disparador:
On Frame StartAcción:Set Object Property→Set Target: tu Objeto de Entrada → propiedad:Focused→ valor:true
Ejemplo: hacer que el campo sea requerido según una respuesta anterior
Disparador:
Variable Value Changed→ tu variable de condición Acción:Set Object Property→Set Target: tu Objeto de Entrada → propiedad:required→ valor:true
También puedes leer el valor actual de respuesta de la variable vinculada en cualquier acción de evento, por ejemplo, para ramificar el flujo del experimento según lo que el participante ha escrito.
Lectura Adicional
Sistema de Eventos
Cómo están estructurados los disparadores y acciones. Cubre la configuración de propiedades de objetos en tiempo de ejecución, incluyendo los controles Enfocado y Requerido para el Objeto de Entrada.
Trabajando con Variables
Cómo crear, configurar y registrar variables. Cubre los tipos de datos, opciones de registro y configuraciones de validación que se aplican a las respuestas del Objeto de Entrada.
Tipos de Variables
Una visión general de todos los tipos de variables en Labvanced. Te ayuda a entender por qué cada tipo de entrada se vincula a un tipo de datos de variable diferente.