Diferencias

Muestra las diferencias entre dos versiones de la página.

--- controles:wform [25/02/2020 17:50]
pedro
+++ controles:wform [26/03/2022 12:17] (actual)
pedro [Ejemplo de uso]
@@ Línea 1: / Línea 1: @@
 ====== wForm ======
-El control wForm es el contenedor estándar para el tratamiento de formularios, equivale a <form></form> de [[https://www.w3schools.com/html/html_forms.asp|HTML]].
+El control wForm es el contenedor estándar para el tratamiento de formularios, equivale a <form> de [[https://www.w3schools.com/html/html_forms.asp|HTML]].
 Puede contener cualquier control de edición de datos, para una vez realizado el submit enviar el valor de todos los controles a nuestro CGI para poder tratarlos.
@@ Línea 8: / Línea 8: @@
 Normalmente en los formularios HTML cuando en un campo de texto pulsamos **[Intro]** se ejecuta el submit de dicho formulario. En Néfele, al pulsar **[Intro]** pasamos el foco al siguiente control, excepto que dicho [[controles:wEdit]] tenga su propiedad **lSubmit** a .T., asignándola directamente o utilizando el método **:SetSubmit()**, en ese caso se ejecutaría el submit del formulario al pulsar **[Intro]** en dicho control.
-El Submit enviara al CGI un parámetro por cada control, siempre que tengan algún valor, por ejemplo los [[controles:wCheck]] si están a False no se envía ningún parámetro, por eso es muy practico utilizar le método [[ocgi:GetCGIValue|oCGI:GetCGIValue]] con el parámetro **xdefault** con el valor que nos debe retornar en caso de que no venga.
+  El ultimo control de un Formulario provoca el submit al pulsar [Intro] tenga o no la propiedad lSubmit.
+El Submit enviara al CGI un parámetro por cada control, siempre que tengan algún valor, por ejemplo los [[controles:wCheckBox]] si están a False no se envía ningún parámetro, por eso es muy practico utilizar le método [[ocgi:GetCGIValue|oCGI:GetCGIValue]] con el parámetro **xdefault** con el valor que nos debe retornar en caso de que no venga.
 Los controles que permitan múltiples valores, retornaran un array por lo que es más apropiado tratarlos con [[ocgi:GetCGIArray|oCGI:GetCGIArray]].
@@ Línea 16: / Línea 18: @@
 Por defecto se le asigna el foco al primer control del Formulario que permita edición, si queremos que sea otro deberemos indicarlo en la propiedad **lAutoFocus** de dicho control, y habilitar la propiedad **lNoAutoFocus** del Formulario.
+Cuando en el formulario se utilicen controles que necesiten enviar algo más que texto, sera necesario habilitar la propiedad **lFormData** del formulario, si los controles que lo necesitan son de Néfele no sera necesario hacerlo ya que ellos mismo lo asignaran si es necesario.
 <nodisp> your text here </nodisp>
 ===== Ejemplo de uso =====
-{{url>https://samples.nefele.dev/wform  100%,280px}}
+{{url>https://samples.nefele.dev/wiki/wform  100%,320px}}
 <Code:xailer linenums:1>
-   WITH OBJECT WBevel():New(o)
+  WITH OBJECT WBevel():New(:WO)
-      :cTitle      := "Introduzca Usuario y Contraseña"
+    :cTitle      := "Introduzca Usuario y Contraseña"
-      :cTitleAlign := xc_Center
+    :cTitleAlign := xc_Center
-      :aWidth      := {12,8}
+    WITH OBJECT WForm():New(:WO)
-      :aOffset     := {,2}
+      :cFunction := "visparam"
-      WITH OBJECT WForm():New(:WO)
+      :aParams   := {{"control","cadena de control"}}
-         :cFunction := "visparam"
+      WITH OBJECT WEdit():New(:WO)
-         WITH OBJECT WEdit():New(:WO)
+        :cId   := "usuario"
-            :cId   := "usuario"
+        :cHint := "Usuario"
-            :cHint := "Usuario"
+        :cIcon := "person"
-            :cIcon := "person"
+        :SetRequired()
-            :SetRequired()
+        :Create()
-            :Create()
+      END WITH
-         END WITH
+      WITH OBJECT WEdit():New(:WO)
-         WITH OBJECT WEdit():New(:WO)
+        :cId   := "password"
-            :cId   := "password"
+        :cHint := "Password"
-            :cHint := "Password"
+        :cIcon := "vpn_key"
-            :cIcon := "vpn_key"
+        :SetPassword()
-            :SetPassword()
+        :SetRequired()
-            :SetRequired()
+        :Create()
-            :Create()
+      END WITH
-         END WITH
+      WITH OBJECT WButton():New(:WO)
-         :Create()
+        :lSubmit := .T.
+        :cText   := "Enviar"
+        :Create()
       END WITH
       :Create()
-   END WITH
+    END WITH
+    :Create()
+  END WITH
 </Code>
+===== Control de reenvió de formularios =====
+Para evitar que el usuario provoque el reenvío del formulario, porque de más de una vez al summit o porque de al botón atrás del navegador, hemos de habilitar la propiedad **lUniqueId** de forma que cada wForm se generará con un identificador único por cada llamada que se realice al CGI.
+Luego en el Método de nuestro CGI que ha de procesar el summit del formulario, controlaremos la validez del identificador del wForm, para lo que utilizaremos la función [[funciones:nfl_ChkFormUID]] que nos retornara **.T.** o **.F.** dependiendo de si el identificador es valido o no.
 ----
@@ Línea 55: / Línea 67: @@
 ^Nombre         ^Init   ^Descripción                                                                     ^Versión ^
-|cClassId    |  swt  |  |  0.1|
+|cClassId    |  frm  |  |  0.1|
-|cTitle      |    | Texto en pequeño que aparece sobre el Check |  0.1|
+|cFunction   |       | Función del CGI que sera llamada al hacer Submit del formulario |  0.1|
-|cTextOn     |    | Texto en para el estado On (a la derecha) |  0.1|
+|[[propiedades:aParams]] |  {}    | aParams que se añadirán al submit aparte del los input visibles |  0.1|
-|cTitle      |    | Texto en para el estado Off (a la izquierda) |  0.1|
+|lAutoComplete |  .t.  | Habilita o no el Autocompletado de los campos por el Navegador |  0.1|
-|[[nefele:constantes#alineaciones|cAlign]]      |  xc_NoAlign  | Alineación|  0.1|
+|cMethod     |  POST  | Método de envió de los datos del formulario (POST o GET) |  0.1|
-|lChecked    |  .F.  | Estado inicial del Switch|  0.1|
+|lFormData   |  .f.   | Habilita el envió de ficheros adjuntos |  0.1|
-|cClrTitle   |  black  | Color del título según [[https://materializecss.com/color.html#palette|Materialize]]|  0.1|
+|cFormAction |        | URL a la que se envían los datos del formulario, si es vació se envían al mismo CGI |  0.1|
-|cChecked    |  true  | Valor que devuelve cuando esta seleccionado, solo en formularios con Submit, si se pide su Value por [[propiedades:aParams]] nos devuelve siempre este valor, este o no Checkeado|  0.1|
+|lNoValidate |   .f.  | Evita que se validen los campos del formulario |  0.1|
-|[[propiedades:aWidth]]      |  {11,,,}  |Valores de Width apropiados para checkbox|  0.1|
+|lNoAutoFocus |  .f.  | Deshabilita la asignación automática del Foco al primer control editable |  0.1|
-|[[propiedades:aOffset]]     |  {1,,,}  |Valores de Offset apropiados para checkbox|  0.1|
+|lUniqueId   |   .f.  | Genera un código único para la llamada actual a este formulario para evitar la rellamada |  0.4|
 ===== Hereda de... =====
@@ Línea 72: / Línea 85: @@
 {{page>controles:wcontrol#metodos}}
-~~DISCUSSION|Comentario wSwitch~~
+~~DISCUSSION|Comentario wForm~~
 /*{{tag>[nefele  primeros-pasos]}}*/

Herramientas de usuario

Herramientas del sitio

Diferencias

Herramientas de la página