
p.location-badge.
  exported from <a href="/angular2/forms.html">angular2/forms</a>
  defined in <a href="https://github.com/angular/angular/tree/master/modules/angular2/src/forms/form_builder.js#L26">angular2/src/forms/form_builder.js (line 26)</a>

:markdown
  Creates a form object from a user-specified configuration.
  
  # Example
  
  This example creates a <a href='ControlGroup-class.html'><code>ControlGroup</code></a> that consists of a `login` <a href='Control-class.html'><code>Control</code></a>, and a nested 
  <a href='ControlGroup-class.html'><code>ControlGroup</code></a> that defines a `password` and a `passwordConfirmation` <a href='Control-class.html'><code>Control</code></a>.
  
  ```
   var loginForm = builder.group({
     login: ["", Validators.required],
  
     passwordRetry: builder.group({
       password: ["", Validators.required],
       passwordConfirmation: ["", Validators.required]
     })
   });
  
   ```
.l-main-section
  h2 Members
  .l-sub-section
    h3 array

    
    pre.prettyprint
      code.
        array(controlsConfig:List, validator:Function = null)
    
    :markdown

      





  .l-sub-section
    h3 control

    
    pre.prettyprint
      code.
        control(value, validator:Function = null)
    
    :markdown

      





  .l-sub-section
    h3 group

    
    pre.prettyprint
      code.
        group(controlsConfig, extra = null)
    
    :markdown

      




