====== wForm ======
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.

Para realizar en envió (submit) sera necesario añadir un [[controles:wButton]] con la propiedad **lSubmit** a .T., solo puede existir un botón submit en cada formulario, también podemos asignarle la funcionalidad submit a un [[controles:wEdit]] que este en el formulario.

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 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]].

En HTML los controles que estén **disabled**, por defecto no se envían en el submit, tengan o no valor. En Néfele si tiene valor se tratan como al resto de controles.

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/wiki/wform  100%,320px}}
<Code:xailer linenums:1>
  WITH OBJECT WBevel():New(:WO)
    :cTitle      := "Introduzca Usuario y Contraseña"
    :cTitleAlign := xc_Center
    WITH OBJECT WForm():New(:WO)
      :cFunction := "visparam"
      :aParams   := {{"control","cadena de control"}}
      WITH OBJECT WEdit():New(:WO)
        :cId   := "usuario"
        :cHint := "Usuario"
        :cIcon := "person"
        :SetRequired()
        :Create()
      END WITH
      WITH OBJECT WEdit():New(:WO)
        :cId   := "password"
        :cHint := "Password"
        :cIcon := "vpn_key"
        :SetPassword()
        :SetRequired()
        :Create()
      END WITH
      WITH OBJECT WButton():New(:WO)
        :lSubmit := .T.
        :cText   := "Enviar"
        :Create()
      END WITH
      :Create()
    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.

----

===== Propiedades =====

^Nombre         ^Init   ^Descripción                                                                     ^Versión ^
|cClassId    |  frm  |  |  0.1|
|cFunction   |       | Función del CGI que sera llamada al hacer Submit del formulario |  0.1|
|[[propiedades:aParams]] |  {}    | aParams que se añadirán al submit aparte del los input visibles |  0.1|
|lAutoComplete |  .t.  | Habilita o no el Autocompletado de los campos por el Navegador |  0.1|
|cMethod     |  POST  | Método de envió de los datos del formulario (POST o GET) |  0.1|
|lFormData   |  .f.   | Habilita el envió de ficheros adjuntos |  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|
|lNoValidate |   .f.  | Evita que se validen los campos del formulario |  0.1|
|lNoAutoFocus |  .f.  | Deshabilita la asignación automática del Foco al primer control editable |  0.1|
|lUniqueId   |   .f.  | Genera un código único para la llamada actual a este formulario para evitar la rellamada |  0.4|


===== Hereda de... =====
====== wControl ======
{{page>controles:wcontrol#propiedades}}

{{page>controles:wcontrol#metodos}}

~~DISCUSSION|Comentario wForm~~

/*{{tag>[nefele  primeros-pasos]}}*/