Saltar a contenido

Propiedades del control

Todos los controles comparten el mismo panel. Lo que cambia entre uno y otro es qué campos muestra: una fecha no necesita una lista de opciones y un archivo no necesita valor por defecto.

Los campos

Campo Qué hace
ID El identificador del control en la página. Se genera solo y es único; lo que normalmente cambias es el nombre y la variable
Nombre El identificador del control dentro del formulario. Debe ser único, y las condiciones y los scripts se refieren al control por este nombre
Variable La variable del caso donde se guarda el valor
Tipo de dato Solo lectura: el tipo de la variable a la que está asociado el control
Etiqueta El texto que ve el usuario encima o al lado del control
Ayuda Texto de ayuda que se muestra con el control —por ejemplo al pasar el puntero—
Marcador de posición El texto gris dentro de un campo vacío
Valor por defecto El valor con el que arranca el control al abrir el formulario
Requerido El formulario no se envía mientras el campo esté vacío
Modo de visualización Si el control es editable, de solo lectura o deshabilitado en el caso
Valor protegido Oculta el valor guardado en lugar de mostrarlo
Índice de tabulación El orden en que la tecla Tab recorre los controles
Etiqueta ARIA El nombre que anuncia un lector de pantalla, cuando la etiqueta visible no alcanza
Opciones La lista de valores, o la consulta que la produce
Conexión de base de datos La conexión usada cuando las opciones vienen de una base de datos
SQL La consulta que devuelve las opciones

Nombre y variable no son lo mismo, y confundirlos es el error más común en un formulario: el nombre es interno del formulario, la variable viaja con el caso.

De dónde salen las opciones

Los controles de opciones toman sus valores de uno de dos lugares:

Origen Úsalo cuando
Base de datos Los valores viven en una tabla o llegan por una conexión
Variable de arreglo Una variable del proceso ya contiene la lista, y el formulario no debe consultar nada

Con origen de base de datos el control guarda la conexión y la SQL; con una variable de arreglo lee la variable al abrir el formulario.

Propiedades que aceptan una variable

Algunas propiedades reciben una variable en lugar de un valor fijo, escrita con los prefijos habituales: el valor por defecto, y en un control de fecha la fecha mínima, la máxima y la fecha por defecto. Al escribir @@ se abre el selector de variables, así que el valor con el que arranca un control puede depender del caso.

Campos que solo tienen algunos controles

Control Campos extra
file Extensiones permitidas (*.* acepta cualquiera) y tamaño máximo con su unidad
grid La lista de columnas: nombre, tipo, variable asociada y ancho
suggest La consulta de origen, el campo con el que se filtra y el límite de resultados
text, textarea, dropdown, checkgroup, radiogroup, suggest, hidden La conexión de base de datos y la SQL con la que se arman las opciones
date El formato y la máscara

El tamaño del archivo se verifica también contra el límite del servidor: un valor por encima del límite de subida de la configuración de PHP se rechaza al guardar la propiedad, no cuando un usuario sube un archivo.

Cómo se comporta el panel

  • Las etiquetas usan mayúscula inicial, por ejemplo Valor por defecto.
  • El panel se abre en el borde derecho y flota sobre el lienzo.
  • La × lo cierra; la pestaña vertical del borde derecho lo vuelve a abrir.

Relacionado