NueForm

Tipos de Preguntas de Elección

Documentación para los tipos de preguntas de Opción Múltiple, Desplegable, Sí/No, Clasificación, Matriz y Lista.

Opción Múltiple

Presenta una lista de opciones para que el encuestado elija. Soporta selección única, selección múltiple, texto libre "Otro", aleatorización y orden alfabético. Cada elección puede llevar su propia imagen, video o ícono, y la propiedad layout alterna entre una lista vertical y una cuadrícula de tarjetas con imagen, de modo que este único tipo cubre tanto las opciones de texto simple como las basadas en imágenes.

Pregunta de Opción Múltiple
Una pregunta de opción múltiple con varias opciones.

Type identifier: multiple_choice

Propiedades

PropiedadTipoDescripciónPredeterminado
choicesChoice[]Array de opciones de elección. Cada elección tiene un id, label y un media opcional.[]
layoutstringCómo se presentan las opciones: stacked (lista vertical, con miniaturas opcionales), blocks (cuadrícula de tarjetas con imagen), staggered (chips del tamaño del contenido que se ajustan en varias líneas) o grid (cuadrícula de columnas fijas).stacked
allowMultiplebooleanPermitir al encuestado seleccionar más de una opción.false
allowOtherbooleanMostrar una opción "Otro" con una entrada de texto libre donde el encuestado puede escribir una respuesta personalizada.false
randomizebooleanAleatorizar el orden de las opciones cada vez que se muestra la pregunta.false
alphabeticalOrderbooleanOrdenar las opciones alfabéticamente. Se ignora si randomize está habilitado (randomize tiene precedencia).false

Objeto de Elección

Cada elección en el array choices tiene:

CampoTipoDescripción
idstringIdentificador único para esta elección. Usado en saltos lógicos y puntuación.
labelstringEl texto de visualización para la elección.
mediaQuestionMediaImagen, video o ícono opcional para esta elección. Establece media.display para controlar cómo se muestra — ver abajo.

Medios de la Elección

Cualquier elección puede llevar sus propios medios. media.display decide cómo se ubican en la elección:

DisplayDescripción
thumbnailUna imagen pequeña junto a la etiqueta de la elección.
backgroundLa imagen llena la superficie de la elección, recortada para cubrirla.
background-fitLa imagen llena la superficie de la elección pero se mantiene completa, con bandas contra el color de fondo de la elección.

Los medios de la elección soportan los mismos tratamientos que los medios de la pregunta: filtros, tinte, bordes, punto focal y zoom. Consulta Visualización de Medios de la Elección para ver en qué se diferencian Fill y Fit y cuándo conviene usar cada uno.

Los medios de la elección son en lo que se convirtió el antiguo tipo de pregunta Elección con Imagen. Para crear una cuadrícula de tarjetas con imagen, usa Opción Múltiple con layout: "blocks" y asigna un objeto media a cada elección. Los formularios importados desde Typeform convierten las preguntas picture_choice a esta forma automáticamente.

Validación

Si required es true, el encuestado debe seleccionar al menos una opción antes de continuar.

Operadores de Salto Lógico

equals, not_equals, is_answered, is_not_answered

Cuando se usa equals o not_equals, el valor de comparación es el ID de la elección. Para preguntas de selección múltiple, equals verifica si el valor está entre los elementos seleccionados.

Formato de Respuesta

  • Selección única (allowMultiple: false): Un string (el ID de la elección seleccionada).
  • Selección múltiple (allowMultiple: true): Un array de strings (los IDs de las elecciones seleccionadas).

Puntuación en Modo Cuestionario

Opción Múltiple es un tipo de pregunta puntuable en todos los modos de cuestionario:

  • Knowledge Quiz: Establece correctAnswers (array de IDs de elecciones correctas) y correctAnswerScore (puntos por respuesta correcta).
  • Lead Qualification: Establece choiceScores (mapeo de ID de elección a valor de puntos).
  • Match Quiz: Establece choiceOutcomes (mapeo de ID de elección a IDs de preguntas de pantalla final).

Los atajos de teclado están disponibles para la selección de opciones. Los encuestados pueden presionar teclas de letras (A, B, C, etc.) para seleccionar opciones, que aparecen como indicadores junto a cada elección.


Desplegable

Un menú desplegable para seleccionar de una lista de opciones. Soporta la misma configuración que Opción Múltiple pero muestra las opciones en un formato de desplegable compacto. El media por elección y el layout no aplican aquí: un desplegable siempre muestra sus opciones como texto simple.

Pregunta de Desplegable
Una pregunta de selector desplegable.

Type identifier: dropdown

Propiedades

PropiedadTipoDescripciónPredeterminado
choicesChoice[]Array de opciones de elección.[]
allowMultiplebooleanPermitir seleccionar múltiples opciones del desplegable.false
allowOtherbooleanMostrar una opción "Otro" con entrada de texto libre.false
placeholderstringTexto de marcador de posición mostrado antes de hacer una selección.Ninguno
randomizebooleanAleatorizar el orden de las opciones.false
alphabeticalOrderbooleanOrdenar las opciones alfabéticamente.false

Validación

Si required es true, el encuestado debe seleccionar al menos una opción.

Operadores de Salto Lógico

equals, not_equals, is_answered, is_not_answered

Formato de Respuesta

  • Selección única: Un string (el ID de la elección seleccionada).
  • Selección múltiple: Un array de strings (los IDs de las elecciones seleccionadas).

Puntuación en Modo Cuestionario

Desplegable es un tipo de pregunta puntuable. La configuración de puntuación es idéntica a Opción Múltiple.


Elección con Imagen

Elección con Imagen ya no es un tipo de pregunta independiente. Se fusionó con Opción Múltiple: ya no existe un identificador picture_choice que se pueda seleccionar.

Para crear lo mismo, usa una pregunta de Opción Múltiple con layout establecido en blocks y un objeto media en cada elección. Todo lo que hacía Elección con Imagen sigue disponible, además de los tratamientos que nunca tuvo: elecciones con video e íconos, filtros, tinte, punto focal, zoom y un modo Fit que muestra completas las imágenes anchas en lugar de recortarlas.

Elecciones como tarjetas con imagen
Opción Múltiple con layout: blocks — la cuadrícula de tarjetas con imagen que reemplazó a Elección con Imagen.
json
{
  "type": "multiple_choice",
  "properties": {
    "layout": "blocks",
    "choices": [
      { "id": "c1", "label": "Mountains", "media": { "type": "image", "url": "https://…", "display": "background" } },
      { "id": "c2", "label": "Coast", "media": { "type": "image", "url": "https://…", "display": "background" } }
    ]
  }
}

Los formularios existentes y las importaciones desde Typeform se manejan automáticamente: una pregunta picture_choice se convierte a Opción Múltiple con layout: "blocks" por sí sola, así que no hay que rehacer nada.


Sí / No

Una pregunta binaria simple que presenta los botones "Sí" y "No".

Pregunta Sí/No
Una pregunta de elección binaria sí/no.

Type identifier: yes_no

Propiedades

El tipo de pregunta Sí/No no tiene propiedades adicionales más allá de las propiedades comunes de preguntas.

Validación

Si required es true, el encuestado debe hacer clic en "Sí" o "No".

Operadores de Salto Lógico

equals, not_equals, is_answered, is_not_answered

Cuando se usa equals, compara contra true (Sí) o false (No). Los valores de string "true" y "false" también son aceptados.

Formato de Respuesta

La respuesta se almacena como un boolean (true para Sí, false para No, o null si no se responde).

Puntuación en Modo Cuestionario

Sí/No es un tipo de pregunta puntuable:

  • Knowledge Quiz: Establece correctAnswers con un solo valor de "true" o "false".
  • Lead Qualification: Establece choiceScores con claves "true" y "false".
  • Match Quiz: Establece choiceOutcomes con claves "true" y "false".

La pregunta Sí/No avanza automáticamente a la siguiente pregunta inmediatamente al seleccionar. No hay un botón "OK" separado.


Clasificación

Presenta una lista de elementos para que el encuestado los ordene en su orden preferido arrastrando y soltando.

Pregunta de Clasificación
Una pregunta de arrastrar para clasificar donde los encuestados reordenan elementos.

Type identifier: ranking

Propiedades

PropiedadTipoDescripciónPredeterminado
choicesChoice[]Array de elementos a clasificar. Cada uno tiene un id y label.[]

Validación

Si required es true, el encuestado debe enviar una clasificación (todos los elementos deben estar en un orden definido).

Operadores de Salto Lógico

equals, not_equals, is_answered, is_not_answered

Formato de Respuesta

La respuesta se almacena como un array de strings (IDs de elecciones en el orden clasificado por el encuestado, del primero al último).

json
["choice_3", "choice_1", "choice_2"]

El campo de clasificación usa interacción de arrastrar y soltar. En dispositivos móviles, los encuestados pueden usar gestos táctiles para reordenar elementos.


Matriz

Un tipo de pregunta basado en cuadrícula donde los encuestados califican múltiples elementos (filas) a través de múltiples categorías (columnas). Cada intersección fila-columna es una opción seleccionable.

Pregunta de Matriz
Una pregunta de cuadrícula de matriz con filas y columnas.

Type identifier: matrix

Propiedades

PropiedadTipoDescripciónPredeterminado
rowsstring[]Array de etiquetas de fila (los elementos que se están calificando).[]
columnsstring[]Array de etiquetas de columna (las categorías de calificación).[]
randomizeRowsbooleanAleatorizar el orden de las filas.false
randomizeColumnsbooleanAleatorizar el orden de las columnas.false

Validación

Si required es true, el encuestado debe seleccionar una opción por fila.

Operadores de Salto Lógico

equals, not_equals, is_answered, is_not_answered

Formato de Respuesta

La respuesta se almacena como un object (Record<string, string>) mapeando cada etiqueta de fila a la etiqueta de columna seleccionada:

json
{
  "Product Quality": "Excellent",
  "Customer Service": "Good",
  "Value for Money": "Average"
}

Las preguntas de Matriz se muestran como una cuadrícula responsiva en escritorio y se adaptan a un formato apilado en dispositivos móviles para mejor usabilidad. Tanto las filas como las columnas soportan aleatorización independiente.

Lista

Recopila múltiples entradas del mismo tipo. Una Lista contiene elementos de texto simples (escribe y pulsa Intro, o toca Añadir) o elementos de compuesto repetidos — entradas estructuradas creadas a partir de un compuesto reutilizable, como añadir cualquier número de miembros de junta a una sola pregunta.

Type identifier: list

Propiedades

PropiedadTipoDescripciónPredeterminado
itemTypestringstring para elementos de texto simples, composite para instancias de compuesto repetibles.string
compositeIdstringEl compuesto referenciado (solo elementos de compuesto). Se establece a través del selector.
itemPlaceholderstringTexto de marcador de posición para la entrada de elementos (elementos de texto).
addButtonLabelstringEtiqueta personalizada para el botón Añadir en ambos modos de elementos.
minItemsnumberNúmero mínimo de elementos requeridos para enviar.
maxItemsnumberNúmero máximo de elementos. Tope absoluto de 100.100
itemRegexstringPatrón de validación por elemento (elementos de texto).
itemRegexErrorstringMensaje de error mostrado cuando el patrón falla.
itemMinLengthnumberCaracteres mínimos por elemento (elementos de texto).
itemMaxLengthnumberCaracteres máximos por elemento (elementos de texto).
allowDuplicatesbooleanPermitir añadir el mismo elemento de texto dos veces (elementos de texto).true
allowReorderbooleanPermitir a los encuestados arrastrar elementos para reordenar (elementos de texto).true
defaultItemsstring[]Elementos prerrellenados la primera vez que se carga la pregunta (elementos de texto, formularios web).[]
displayModestringCómo se muestra una entrada de compuesto contraída: compact (resumen de una línea) o card (etiqueta + valor de cada campo).compact
compactFieldsstring[]IDs de subcampos ordenados que se muestran en el resumen contraído compacto. Por defecto, el primer campo del compuesto.

Validación

Si required es true, se debe añadir al menos un elemento. minItems / maxItems se aplican al enviar; las reglas de patrón y longitud por elemento (elementos de texto) se aplican a medida que se añade cada elemento.

Operadores de Salto Lógico

list_count_equals, list_count_greater_than, list_count_less_than, contains, not_contains, is_answered, is_not_answered

Los operadores de recuento comparan contra el número de elementos en la respuesta.

Formato de Respuesta

  • Elementos de texto: un array de strings.
  • Elementos de compuesto: un array de objetos, cada uno indexado por ID de subcampo:
json
[
  { "sub_first_name": "Ada", "sub_email": "ada@example.com" },
  { "sub_first_name": "Grace", "sub_email": "grace@example.com" }
]

Cada elemento de compuesto también se registra como una entrada de compuesto independiente — consulta la guía de Compuestos para la vista de Entradas entre formularios y los modos de visualización contraídos.

Ultima actualizacion: 24 de agosto de 2026