Method addField

src/Form.js:77–108

* Adds a field to the form. * @param {Field|object} fieldOrSpec Field instance or spec object * @throws {Error} If field name is already assigned. * @return {Form} Fluent interface

(fieldOrSpec)

   * @return {Form} Fluent interface
   */
  addField (fieldOrSpec) {
    // Retrieve field instance
    let field = fieldOrSpec
    if (!(fieldOrSpec instanceof Field)) {
      // Resolve field spec to field instance
      const spec = fieldOrSpec
      if (spec.priority === undefined) {
        // Use default priority
        spec.priority = this._calculateDefaultPriority()
      }
      // Let the factory create an instance from given spec
      field = this.getFieldFactory().create(spec)
    }

    // Verify that given field name is not already assigned
    if (this.getField(field.getName())) {
      throw new Error(
        `Name '${field.getName()}' is already assigned to a field.`)
    }

    // Add field instance to the form
    this._fields.push(field)
    field.setDelegate(this)
    this._sortFields()

    // Add field subview
    if (field.isVisible() && this.hasView()) {
      this.getView().addSubview(field.getView())
    }

    return this
  }

  /**
   * Returns named field value.