Edit this page

NumericTextBox HtmlHelper Overview

The NumericTextBox HtmlHelper extension is a server-side wrapper for the Kendo UI NumericTextBox widget.

Configuration

Below are listed the steps for you to follow when configuring the Kendo UI NumericTextBox.

  1. Make sure you followed all the steps from the introductory article on Telerik UI for ASP.NET MVC.

  2. Create a new action method which renders the view.

    Example
        public ActionResult Index()
        {
            return View();
        }
    
  3. Add a NumericTextBox.

    Example
    
            <%: Html.Kendo().NumericTextBox()
                    .Name("numerictextbox") //The name of the NumericTextBox is mandatory. It specifies the "id" attribute of the widget.
                    .Min(-100) //Set the min value of the NumericTextBox.
                    .Max(100) //Set the min value of the NumericTextBox.
                    .Value(10) //Set the value of the NumericTextBoxNumericTextBox.
            %>
    
    
            @(Html.Kendo().NumericTextBox()
                  .Name("numerictextbox") //The name of the NumericTextBox is mandatory. It specifies the "id" attribute of the widget.
                  .Min(-100) //Set the min value of the NumericTextBox.
                  .Max(100) //Set the min value of the NumericTextBox.
                  .Value(10) //Set the value of the NumericTextBox.
            )
    

Event Handling

You can subscribe to all NumericTextBox events.

By Handler Name

The following example demonstrates how to subscribe to events by a handler name.

Example

      <%: Html.Kendo().NumericTextBox()
              .Name("numerictextbox")
              .Events(e => e
                  .Change("numerictextbox_change")
                  .Spin("numerictextbox_spin")
              )
      %>
      <script>
      function numerictextbox_spin() {
          //Handle the spin event.
      }

      function numerictextbox_change() {
          //Handle the change event.
      }
      </script>

      @(Html.Kendo().NumericTextBox()
            .Name("numerictextbox")
            .Events(e => e
                  .Change("numerictextbox_change")
                  .Spin("numerictextbox_spin")
            )
      )
      <script>
      function numerictextbox_spin() {
          //Handle the spin event.
      }

      function numerictextbox_change() {
          //Handle the change event.
      }
      </script>

By Template Delegate

The following example demonstrates how to subscribe to events by a template delegate.

Example

    @(Html.Kendo().NumericTextBox()
          .Name("numerictextbox")
          .Events(e => e
              .Change(@<text>
                function() {
                    //Handle the change event inline.
                }
              </text>)
              .Spin(@<text>
                function() {
                    //Handle the spin event inline.
                }
                </text>)
          )
    )

Reference

Existing Instances

To reference an existing Kendo UI NumericTextBox instance, use the jQuery.data() configuration option. Once a reference is established, use the NumericTextBox API to control its behavior.

Example
  //Put this after your Kendo UI NumericTextBox for ASP.NET MVC declaration.
  <script>
  $(function() {
      //Notice that the Name() of the NumericTextBox is used to get its client-side instance.
      var numerictextbox = $("#numerictextbox").data("kendoNumericTextBox");
  });
  </script>

See Also