ValidationGroup

Use the ValidationGroup widget to combine the editors to be validated, the Button widget to validate these editors on button click and the ValidationSummary widget to display validation errors occurred in these editors.

You can create the ValidationGroup widget using one of the following approaches.

• jQuery

  HTML

  JavaScript

  <div id="textBox1"></div>
  <div id="textBox2"></div>
  <div id="summary"></div>
  <div id="button"></div>

  $(function() {
      var validationGroupName = "sampleGroup";
      $("#textBox1").dxTextBox({ name: 'FirstName' })
          .dxValidator({
              validationRules: [
                  // ...
              ],
              validationGroup: validationGroupName
          });
      $("#textBox2").dxTextBox({ name: 'LastName' })
          .dxValidator({
              validationRules: [
                  // ...
              ],
              validationGroup: validationGroupName
          });
      $("#summary").dxValidationSummary({
          validationGroup: validationGroupName
      });
      $("#button").dxButton({
          validationGroup: validationGroupName
          //...
      });
  });

• Angular

  HTML

  <dx-validation-group>
      <dx-text-box name="FirstName">
          <dx-validator>
              <dxi-validation-rule type="required" message="First name is required"></dxi-validation-rule>
              . . .
          </dx-validator>
      </dx-text-box>
      <dx-text-box name="LastName">
          <dx-validator>
              <dxi-validation-rule type="required" message="Last name is required"></dxi-validation-rule>
              . . .
          </dx-validator>
      </dx-text-box>
      <dx-validation-summary></dx-validation-summary>
      <dx-button></dx-button>
  </dx-validation-group>

• AngularJS

  HTML

  <div dx-validation-group="{ }" ng-controller="DemoController">
      <div dx-text-box="{ name: 'FirstName' }"
          dx-validator="{
              validationRules: [
                  // ...
              ]
          }">  
      </div>
      <div dx-text-box="{ name: 'LastName' }"
          dx-validator="{
              validationRules: [
                  // ...
              ]
          }">
      </div>
      <div dx-validation-summary="{  }"></div>
      <div dx-button="{ }"></div>
  </div>

• Knockout

  HTML

  <div data-bind="dxValidationGroup: { }" >
      <div data-bind="dxTextBox: { name: 'FirstName' },
          dxValidator: {
              validationRules: [
                  // ...
              ]
          }">  
      </div>
      <div data-bind="dxTextBox: { name: 'LastName' },
          dxValidator: {
              validationRules: [
                  // ...
              ]
          }">
      </div>  
      <div data-bind="dxValidationSummary: { }"></div>
      <div data-bind="dxButton: { }"></div>
  </div>

• ASP.NET MVC Wrappers

  Razor C#

  Razor VB

  using (Html.DevExtreme().ValidationGroup()) {
      @(Html.DevExtreme().TextBox()
          .Name("FirstName")
      )
      @(Html.DevExtreme().TextBox()
          .Name("LastName")
      )
      @(Html.DevExtreme().ValidationSummary())
      @(Html.DevExtreme().Button()
          .Text("Validate")
          .OnClick(@<text>
              function validate (params) {
                  params.validationGroup.validate();
              }
          </text>)
      )
  }

  @Using (Html.DevExtreme().ValidationGroup())
      @(Html.DevExtreme().TextBox() _
          .Name("FirstName")
      )
      @(Html.DevExtreme().TextBox() _
          .Name("LastName")
      )
      @(Html.DevExtreme().ValidationSummary())
      @(Html.DevExtreme().Button() _
          .Text("Validate") _
          .OnClick("validate")
      )
  End Using
  <script>
      function validate(params) {
          params.validationGroup.validate();
      }
  </script>

Note that DevExtreme widgets require you to link the jQuery library to your application. If you use the Knockout or AngularJS approach, the Knockout or AngularJS library is also required. For detailed information on linking these libraries to your project, refer to the topics in the Installation section.

See Also

• Validation Engine
• Validation Engine - MVVM Approach
• ASP.NET MVC Wrappers - Validate a Group of Editors

You can use the DevExpress.validationEngine.validateGroup(group) method to validate a particular validation group by passing its instance as a parameter.

DevExpress.validationEngine.validateGroup($("#sampleGroup").dxValidationGroup("instance"));

In addition, you can access a validation group's configuration using the DevExpress.validationEngine.getGroupConfig(group) method. The returned configuration exposes the validators included to the group, the validate() method to validate the editors that are associated with the validators and the validated event that occurs after the group is validated.

Watch Video

See Also

• Handle Events - jQuery
• Handle Events - AngularJS
• Handle Events - Knockout