
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 pide que nombres la variable que almacenará la respuesta del participante. Dale un nombre descriptivo que refleje los datos que se recopilan (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 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 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 | falso | Cuando se establece en verdadero, mueve el foco del teclado a este campo. Configurable por ensayo 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 permitido. |
Date Format | browser-locale | Solo para tipo date. Controla cómo se muestra e 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 está configurado 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.
Utiliza 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 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 garantizar que los participantes proporcionen datos útiles 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 completar un campo requerido, el campo se resalta.
Rango numérico: Para entradas number, establece Min Value y Max Value para limitar las entradas aceptadas. Si un participante introduce un valor fuera del rango y luego sale del 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 de respuesta actual del participante y se registra al final del ensayo.
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 trabaja 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 desencadenador 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 desencadenador.
Ejemplo: enviar el marco cuando el participante presiona Enter
Desencadenador:
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 foco al campo de entrada programáticamente. |
required | Puede cambiarse 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
Desencadenador:
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
Desencadenador:
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 en función de lo que el participante ha escrito.
Lectura Adicional
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 descripció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 dato de variable diferente.
Sistema de Eventos
Cómo están estructurados los desencadenadores y las acciones. Cubre la configuración de propiedades de objetos en tiempo de ejecución, incluidos los controles Enfocado y Requerido para el Objeto de Entrada.