Características de las etiquetas de formulario

Los artículos de la categoría Manual del desarrollador abordan temas que requieren conocimiento técnico. Ten cuidado y utiliza las técnicas descritas a continuación bajo tu propia responsabilidad. Si no tienes experiencia en desarrollo, y necesitas ayuda, te recomendamos solicitar el apoyo de un profesional.

This page is also available in English.

¿Recuerdas cuando aprendimos a registrar un tipo de etiqueta de formulario personalizada en una receta anterior? Usamos la función wpcf7_add_form_tag() y establecimos el tercer parámetro como array( 'name-attr' => true ).

A esto le llamamos características de una etiqueta de formulario. Contact Form 7 tiene un conjunto de características predefinidas (enumeradas a continuación) y, al especificar algunas de ellas a través de una etiqueta de formulario, puedes personalizar cada instancia del mismo tipo de etiquetas de formulario.

display-block

Al ser procesada, una etiqueta de formulario compatible con display-block genera un elemento HTML que normalmente se muestra como un bloque, como lo hacen las etiquetas <div> o <p>.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes:

  • recaptcha (el widget de reCAPTCHA v2)
  • reflection
  • response
  • stripe

display-hidden

Al ser procesada, una etiqueta de formulario compatible con display-hidden genera un elemento HTML que no es visible, tal como <input type="hidden" />.

La etiqueta de formulario nativa que soporta esta característica es la siguiente:

  • hidden

do-not-store

En envíos correctos, los datos de entrada del usuario enviados a través de un campo de una etiqueta de formulario compatible con do-not-store no son almacenados por módulos de almacenamientos de mensajes tales como Flamingo.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes:

file-uploading

Una etiqueta de formulario compatible con file-uploading representa un campo de subida de archivos.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes:

  • file
  • file*

multiple-controls-container

Al ser procesada, una etiqueta de formulario compatible con multiple-controls-container genera un elemento HTML que puede contener varios controles de formulario.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes:

  • checkbox
  • checkbox*
  • radio

name-attr

Una etiqueta de formulario compatible con name-attr representa un control de formulario o un grupo de controles de formulario que tiene un atributo name. El valor del atributo name se tomará a partir del nombre dado a la etiqueta de formulario.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes:

  • acceptance
  • checkbox
  • checkbox*
  • radio
  • count
  • date
  • date*
  • file
  • file*
  • hidden
  • number
  • number*
  • range
  • range*
  • quiz
  • captchac
  • captchar
  • select
  • select*
  • text
  • text*
  • email
  • email*
  • url
  • url*
  • tel
  • tel*
  • textarea
  • textarea*
  • reflection

not-for-mail

Una etiqueta de formulario compatible con not-for-mail puede tener un valor, pero dicho valor no se usará dentro del mensaje enviado por correo electrónico.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes:

  • count
  • quiz
  • captchac
  • captchar
  • reflection

selectable-values

Una etiqueta de formulario compatible con selectable-values representa un grupo de opciones de las cuales puedes seleccionar una o más opciones.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes:

  • select
  • select*
  • checkbox
  • checkbox*
  • radio

singular

Si una etiqueta de formulario es compatible con singular, no se te permitirá usar dos o más instancias de la misma etiqueta dentro de un formulario.

La etiqueta de formulario nativa que soporta esta característica es la siguiente:

  • stripe (widget de pago de Stripe)

zero-controls-container

Al ser procesada, una etiqueta de formulario compatible con zero-controls-container genera un elemento HTML que no contiene controles de formulario.

Las etiquetas de formulario nativas que soportan esta característica son las siguientes: