Objeto de Entrada
El Objeto de Entrada recopila respuestas de formato libre 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 prueba. 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
Añadiendo el Objeto de Entrada
En la barra de herramientas del editor de tareas, abre el grupo Question Inputs y selecciona Input para añadir un Objeto de Entrada al marco actual.
Cuando se añade el elemento, Labvanced te solicita nombrar la variable que almacenará la respuesta del participante. Dale un nombre descriptivo que refleje los datos que se están recogiendo (por ejemplo, response_text o age).
Tipos de Entrada
Selecciona el tipo de entrada en el panel de Propiedades del Objeto. El tipo de dato de la variable vinculada se establece automáticamente para que coincida.
| Tipo de Entrada | Tipo de Dato de la 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 fechas. 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 sobre el 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 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 | false | Cuando se establece en verdadero, mueve el foco del teclado a este campo. Configurable por prueba a través del sistema de eventos. |
Min-Value | (ninguno) | Solo para tipo number. El valor más bajo aceptado. |
Max-Value | (ninguno) | Solo para tipo number. El valor más alto aceptado. |
Min-Nr-Chars | (ninguno) | Solo para tipo text. El número mínimo de caracteres requeridos. |
Max-Nr-Chars | (ninguno) | Solo para tipo text. El número máximo de caracteres permitidos. |
Date Format | browser-locale | Solo para tipo date. Controla cómo se muestra y se introduce la fecha. Opciones: browser-locale, yyyy-mm-dd, dd.mm.yyyy, mm/dd/yyyy. Solo visible en el panel cuando el tipo de entrada está configurado para 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 el 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 sobre el campo con una etiqueta completa.
Note: El texto de marcador de posición no se registra como 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 proceder.
Campo requerido: Habilita Is Required para evitar el envío del 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 comprueban cuando Is Required está habilitado.
Integración de Variables
Cada Objeto de Entrada está vinculado a una variable global, creada cuando añades el elemento. La variable almacena el valor actual de respuesta del participante y se registra al final de la prueba.
El tipo de dato 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 variables en el panel de Propiedades del Objeto.
Integración de Eventos
El Objeto de Entrada funciona con eventos de dos maneras: como objetivo de activación y como objetivo de acción.
Activar eventos desde el Objeto de Entrada
El disparador Enter On Input se activa cuando el participante presiona Enter o Return 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: añade 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 foco al campo de entrada programáticamente. |
required | Puede ser alternado en tiempo de ejecución para requerir condicionalmente el campo basándose en las respuestas anteriores del participante. |
Ejemplo: enfocar el campo de entrada cuando el marco comienza
Disparador:
On Frame StartAcción:Set Object Property→Set Target: tu Objeto de Entrada → propiedad:Focused→ valor:true
Ejemplo: hacer que el campo sea obligatorio basado en 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 de respuesta actual de la variable vinculada en cualquier acción de evento, por ejemplo, para ramificar el flujo del experimento basado en lo que el participante ha escrito.
Lecturas Adicionales
Sistema de Eventos
Cómo se estructuran los disparadores y acciones. Cubre la configuración de propiedades de objetos en tiempo de ejecución, incluidas las 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 Variable
Una visión general de todos los tipos de variable en Labvanced. Te ayuda a entender por qué cada tipo de entrada se vincula a un tipo de dato de variable diferente.