ASISTENTE DE FORMULARIOS

El archivo Asistente de Formulario contiene funciones que asisten al trabajo con formularios.

CARGANDO EL ASISTENTE

1. Puede ser cargado desde el archivo de configuración general: home/acer/public_html/Agenda/application/config/ autoload.php
   
   
   De nuestra aplicación agenda, tenemos en un array a los siguientes asistentes:
   $autoload['helper'] = array('url','form','text','date','security','html','file','download','smiley','string');

Puede ser cargado en el propio controlador con:  $this->load->helper('form');

FUNCIONES DISPONIBLES

• Elemento de Apertura de Formularios: <form>
  form_open()
  
  
  El principal beneficio de usar esta etiqueta en vez de hardcodear su propio HTML es que permite que su sitio sea más portable en caso de que sus URLs cambien alguna vez.
  
  
  Ejemplo: 
  echo form_open('contacto/agregarUsuarioBD');
  
  
  Donde:
  login, corresponde al nombre del controlador al cual se le enviará por post todos los elementos del formulario
  validarLogin, corresponde al nombre de la función que se encuentra dentro del controlador login
  
  
  Agregando atributos
  Los atributos pueden ser agregados pasando un arreglo asociativo como segundo
  parámetro, así:
  
  
  $formularioCaracteristicas = array( 'class' =>'form-horizontal',  'role' =>'form' );
  echo form_open('contacto/agregarUsuarioBD',$formularioCaracteristicas);
  
  
  
• Elemento de Cierre de Formularios: </form>
  

  form_close()

  
  La única ventaja de usar esta función es que permite pasar datos que serán agregados debajo de la etiqueta.
  

  $cadena = "</div></div>";

  echo form_close($cadena);

  
  
  
• Elemento de Formularios para subir archivos:
  form_open_multipart()
  Esta función es idéntica a la etiqueta form_open(), excepto que agrega el atributo multipart, el cual es necesario si desea usar el formulario para subir archivos.
  
  
• Elemento de Formularios de entrada de texto, similar a <input type="text"/>
  form_input()
  
  
  Puede pasar minimamente el nombre del campo y el valor en el primer y segundo parámetro:
  echo form_input('nombres', 'Maria');
  
  
  O se puede pasar un arreglo asociativo como segundo parámetro. (De nuestro estudio es más útil para la aplicación agenda)
  
  
  $nombres = array(  ''name' =>'nombres', 'id' =>'nombres', 'class' =>'form-control',
  'placeholder' =>'Ingrese sus dos primeros nombres...', 'autofocus'=>'TRUE', 'required'=>'True', 'size' =>'20');
  
  
  echo form_input($nombres);
  
  
• Elemento de Formularios de contraseñas, similar a <input type="password"/>
  form_password()
  
  
  Con este tipo de formulario a diferencia del anterior que recibe caracteres y los muestra. La entrada de los datos son vistas como ****. (Vamos a enviarle las propiedades de este elemento como un array asociativo)
  $password = array( 'name' =>'clave', 'id' =>'clave', 'class' =>'form-control',
                  'placeholder' =>'Ingrese su contraseña...', 'required'=>'True', );
  
  echo form_password($password);




• Elemento de Formulario para subir archivos, similar a <input type="file"/>
  form_upload()
  $foto = array(  'name' =>'foto', 'id' =>'foto', 'class' =>'form-control');
  echo form_upload($foto);
  
  
• Elemento de Formulario que nos permite escribir texto en mas de una linea, similar a la caja de texto multilínea <textarea name="comentario" rows="4" cols="50"> **** </textareas>
  form_textarea()
  
  
  Es necesario que tenga como atributos el número de "rows" y "cols".
  
  
  $comentario=array( 'name' =>'comentario', 'id' =>'comentario', 'rows'=>'4',
  'class' =>'form-control',  'cols'=>'5', 'style'=>'background:pink', 'align'=>'center' );
  
  
  echo form_textarea($comentario);
  
  
• Elemento de Formulario que permite crear un menú desplegable estándard, similar a los cuadros de selección <select name="opciones"> <option> Estudiante </option><option> Docente </option> </select>
  form_dropdown()
  El primer parámetro contendrá el nombre del campo, el segundo parámetro contendrá un arreglo asociativo de opciones, y el tercer parámetro contendrá el valor que desea sea preseleccionado.
  
  
  $estadoCivil = array('soltero'=>'Soltero','casado'=>'Casado');
  echo form_dropdown('estado_civil',$estadoCivil);
  
  
• Elemento de Formularios para casillas de verificación, similar a <input type="checkbox" name="intereses" value="solterio"> Soltero
  form_checkbox()
  
  
  $datos = array( 'name' => 'cerrarCuenta', 'id' => 'cerrarCuenta', 'value' => 'aceptar',
                'checked' => TRUE, 'style' => 'margin:10px', );
  
  
  echo form_checkbox($datos).'  Cerrar Cuenta';
  
  
• Elemento de Formularios para radio (selección única de un conjunto de opciones), similar  a  los botones de selección <input type="radio" name="genero" value="F"  checked >Femenino
  <input type="radio" name="genero" value="M> Masculino 
  form_radio()
  
  
  echo form_radio('genero','1','true').'Femenino';
  echo form_radio('genero','2').'Másculino'.'<br>';
  
  
• Elemento de Formulario para generar un botón de envío, similar a <input type="submt"/>
  form_submit()
  
  
  echo form_submit('guardar','Guardar');
  
  
  Donde:
  El primer parámetro (guardar) corresponde al name del botón
  El segundo parámetro (Guardar) es el valor de dicho botón.
  
  
• Elemento de Formulario para crear un botón de reestablecer
  form_reset()
  
  
  echo form_reset($boton, 'Reestablecer los datos iniciales');
  
  
  Donde:
  El primer parámetro (guardar) corresponde al name del botón
  El segundo parámetro (Guardar) es el valor de dicho botón.
  
  
  
  
• Elemento de Formulario para crear un label, similar a <label>
  form_label()
  $atributos = array( 'class' => 'col-lg-2 control-label', 'style' => 'color: #000;', );
  echo form_label('Cual es tu nombre', 'nombre', $atributos);
  
  
  Donde: 
  El primer parámetro es el texto que mostrará el label
  El segundo parámetro es el id de la etiqueta
  El tercer parámetro (opcional) son los atributos que le afectará al elemento.