美文网首页
input指令

input指令

作者: yb_剑笙 | 来源:发表于2016-09-14 22:13 被阅读0次

    概述

    Angular js的input指令是对html中的input元素的一个封装,Angular js中的input指令使得input的功能更加丰富,完善。input元素是一个具有多种类型,如:button,text等。Angular js的input指令只对其中一部分类型进行了封装,有五种类型是直接使用的html的input元素,任何Angular js无法识别的类型都会默认使用text类型进行处理。
    Input指令对于各种类型的处理情况:

    类型 是否封装
    text
    date
    datetime-local
    time
    week
    month
    number
    url
    email
    radio
    range
    checkbox
    hidden
    button
    submit
    reset
    file

    详细说明

    各种类型的公共部分

    input指令在对每一种type进行处理的时候都会预先进行基本操作,这个操作主要是进行事件监听等工作。其中重点有:

    1、对于android系统,会监听compositionstart和compositionend消息,这两个消息是在使用输入法输入时惨的。接到start消息就会停止对input的处理,接到end消息后就会开始对input的处理。

    2、Angular会监听input消息,如果没有input消息就会监听keydown、paste、cut消息,然后进行相应的处理。

    3、对于date,datetime-local,month,time,week这些类型,如果直接改变了validity,是无法及时响应的,这是由于validity的变化不一定会发送input或change消息,所以对于这些类型增加了一个监听keydown wheel mousedown的消息,在这些消息处理过程中判断validity是否有改变,如果改变了就进行相应的处理。

    公共处理部分的核心,所有的事件监听都是为了这个部分:

    var listener = function(ev) {
        if (timeout) {
          $browser.defer.cancel(timeout);
          timeout = null;
        }
        if (composing) return;
        var value = element.val(),
            event = ev && ev.type;
    
        // By default we will trim the value
        // If the attribute ng-trim exists we will avoid trimming
        // If input type is 'password', the value is never trimmed
        if (type !== 'password' && (!attr.ngTrim || attr.ngTrim !== 'false')) {
          value = trim(value);
        }
    
        // If a control is suffering from bad input (due to native validators), browsers discard its
        // value, so it may be necessary to revalidate (by calling $setViewValue again) even if the
        // control's value is the same empty value twice in a row.
        if (ctrl.$viewValue !== value || (value === '' && ctrl.$$hasNativeValidators)) {
          ctrl.$setViewValue(value, event);
        }
      };
    

    这个消息响应的方法主要做的事情:
    1、各种输入判断,如果composing状态如果为true,就不处理。
    2、输入的值的预处理。
    3、把input的值设置到view上去。

    各种不同类型的处理过程

    文本类型

    text

    text为基本类型,没有进行过多的处理,只是直接把输入的值设置到元素上去。

    url

    url会在text的基础上再增加一个url验证器的设置,主要是验证url有效性的时候使用。

    email

    email和url类似,相对于text增加了一个email的验证器。

    日期

    日期类型主要包括:date,datetime-local,time,week,month。
    所有的日期类型的input指令都有一个共同的部分:日期解析。除了week类型外,其它都是使用同一个函数:createDateParser,该函数会返回一个函数,在这个函数中会进行日期解析,日期解析的核心代码:

    regexp.lastIndex = 0;
    parts = regexp.exec(iso);
    
    if (parts) {
      parts.shift();
      if (date) {
        map = {
          yyyy: date.getFullYear(),
          MM: date.getMonth() + 1,
          dd: date.getDate(),
          HH: date.getHours(),
          mm: date.getMinutes(),
          ss: date.getSeconds(),
          sss: date.getMilliseconds() / 1000
        };
      } else {
        map = { yyyy: 1970, MM: 1, dd: 1, HH: 0, mm: 0, ss: 0, sss: 0 };
      }
    
      forEach(parts, function(part, index) {
        if (index < mapping.length) {
          map[mapping[index]] = +part;
        }
      });
      return new Date(map.yyyy, map.MM - 1, map.dd, map.HH, map.mm, map.ss || 0, map.sss * 1000 || 0);
    }
    

    这段代码中主要的工作:
    1、时间日期的解析,正则表达式regexp作为参数传入。

    /^(\d{4,})-(\d{2})-(\d{2})$/         \\date
    /^(\d{4,})-(\d\d)-(\d\d)T(\d\d):(\d\d)(?::(\d\d)(\.\d{1,3})?)?$/  \\datetime-localb
    /^(\d{4,})-(\d\d)$/                  \\month
    /^(\d\d):(\d\d)(?::(\d\d)(\.\d{1,3})?)?$/ \\time
    

    2、新建一个时间对象,如果传入了默认值,就会复制默认值,如果没有传入,就指定为1970-01-01 00:00:00。
    3、把解析到的数据拷贝的相应的位置上。

    日期类型都具有最大值和最小值控制,可以使用ng-max、max或者ng-min、min指定。

    数值类型

    数值类型主要有:number和range,他们两的功能几乎是一模一样的。
    数值类型主要是增加了一些属性的处理,包括:ng-max,ng-min,max,min,step。
    其中需要说明的是step属性,其处理代码:

    if (isDefined(attr.step) || attr.ngStep) {
      var stepVal;
      ctrl.$validators.step = function(modelValue, viewValue) {
        return ctrl.$isEmpty(viewValue) || isUndefined(stepVal) || viewValue % stepVal === 0;
      };
    
      attr.$observe('step', function(val) {
        stepVal = parseNumberAttrVal(val);
        // TODO(matsko): implement validateLater to reduce number of validations
        ctrl.$validate();
      });
    }
    

    可以看出当定义了step属性,或者ng-step属性的时候,number的值必须是step的整数倍。同事还会监控tep属性,目前当发现step变化时只是简单的再次判断是否有效。

    单选框类型

    对于单选框radio类型,input指令主要做的工作:
    1、如果没有定义name属性,就添加一个name属性,使用调用angualr的nextUid方法得到name的值。
    2、监听click事件和value变化事件,然后处理。

    复选框类型

    对于复选框checkbox类型,input指令主要增加了ng-true-value和ng-false-value属性。通过这两个属性可以指定自定义的true和false,如:Yes和No等,理论上可以为任何值。如果input的value等于ng-true-value的值就是选中,否则就是补选中。如果没有设置这两个属性,ng-true-value = true,ng-false-alue= false。

    代码样例

    字符串类型

    <!DOCTYPE html>
    <html lang="en" ng-app="app">
    <!--<html>-->
    <head>
        <title>Test</title>
    </head>
    <body>
    <form name="myForm" ng-controller="ExampleController">
        <div>Single word:
            <input type="text" name="inputText" ng-model="example.text" required ng-trim="false">
        </div>
        <div>URL:
            <input type="url" name="inputUrl" ng-model="example.url" required>
            <label>
                <div role="alert">
                 <span class="error" ng-show="myForm.inputUrl.$error.required">
                   Required!</span>
                    <span class="error" ng-show="myForm.inputUrl.$error.url">
                   Not valid url!</span>
                </div>
            </label>
        </div>
        <div>Email:
            <input type="email" name="inputEmail" ng-model="example.email" required>
            <div role="alert">
                       <span class="error" ng-show="myForm.inputEmail.$error.required">
                         Required!</span>
                <span class="error" ng-show="myForm.inputEmail.$error.email">
                         Not valid email!</span>
            </div>
        </div>
        <label>Pick a date in 2013:</label>
        <input type="date" name="inputDate" ng-model="example.date"
               placeholder="yyyy-MM-dd" min="2013-01-01" max="2013-12-31" required />
        <div role="alert">
                <span class="error" ng-show="myForm.inputDate.$error.required">
                    Required!</span>
            <span class="error" ng-show="myForm.inputDate.$error.date">
                    Not a valid date!</span>
        </div>
        <label>Pick a date between in 2013:</label>
        <input type="datetime-local"  name="inputLocal" ng-model="example.local"
               placeholder="yyyy-MM-ddTHH:mm:ss" min="2001-01-01T00:00:00" max="2013-12-31T00:00:00" required />
        <div role="alert">
              <span class="error" ng-show="myForm.inputLocal.$error.required">
                  Required!</span>
            <span class="error" ng-show="myForm.inputLocal.$error.datetimelocal">
                  Not a valid date!</span>
        </div>
        <label >Pick a time between 8am and 5pm:</label>
        <input type="time" name="inputTime" ng-model="example.time"
               placeholder="HH:mm:ss" min="08:00:00" max="17:00:00" required />
        <div role="alert">
              <span class="error" ng-show="myForm.inputTime.$error.required">
                  Required!</span>
            <span class="error" ng-show="myForm.inputTime.$error.time">
                  Not a valid date!</span>
        </div>
        <label>Pick a date between in 2013:
            <input type="week" name="inputWeek" ng-model="example.week"
                   placeholder="YYYY-W##" min="2012-W32"
                   max="2013-W52" required />
        </label>
        <div role="alert">
              <span class="error" ng-show="myForm.inputWeek.$error.required">
                  Required!</span>
            <span class="error" ng-show="myForm.inputWeek.$error.week">
                  Not a valid date!</span>
        </div>
        <label >Pick a month in 2013:</label>
        <input  type="month" name="inputMonth" ng-model="example.month"
               placeholder="yyyy-MM" min="2013-01" max="2013-12" required />
        <div role="alert">
             <span class="error" ng-show="myForm.inputMonth.$error.required">
                Required!</span>
            <span class="error" ng-show="myForm.inputMonth.$error.month">
                Not a valid month!</span>
        </div>
        <label>Number:
            <input type="number" name="inputNumber" ng-model="example.number"
                   min="0" max="99" required>
        </label>
        <div role="alert">
                 <span class="error" ng-show="myForm.inputNumber.$error.required">
                   Required!</span>
            <span class="error" ng-show="myForm.inputNumber.$error.number">
                   Not valid number!</span>
        </div>
    
        Model as range: <input type="range" name="range" ng-model="example.range" min="{{example.min}}"  max="{{example.max}}">
        <hr>
        Model as number: <input type="number" ng-model="example.range"><br>
        Min: <input type="number" ng-model="example.min"><br>
        Max: <input type="number" ng-model="example.max"><br>
        value = <code>{{example.range}}</code><br/>
        myForm.range.$valid = <code>{{myForm.range.$valid}}</code><br/>
        myForm.range.$error = <code>{{myForm.range.$error}}</code>
    
        <div>
            <label>
                <input type="radio" ng-model="color.name" value="red">
                Red
            </label><br/>
            <label>
                <input type="radio" ng-model="color.name" ng-value="specialValue">
                Green
            </label><br/>
            <label>
                <input type="radio" ng-model="color.name" value="blue">
                Blue
            </label><br/>
        </div>
        <div>
            <label>Value1:
                <input type="checkbox" ng-model="checkboxModel.value1">
            </label><br/>
            <label>Value2:
                <input type="checkbox" ng-model="checkboxModel.value2"
                       ng-true-value="'YES'" ng-false-value="'NO'">
            </label><br/>
        </div>
    </form>
    </body>
    <script src="./node_modules/angular/angular.js" type="text/javascript"></script>
    <script src="./node_modules/angular-sanitize/angular-sanitize.js" type="text/javascript"></script>
    <script>
        angular.module('app', [])
                .controller('ExampleController', ['$scope', function ($scope) {
                    $scope.example ={
                        text: 'guest',
                        url: 'http://google.com',
                        email:'me@example.com',
                        date: new Date(2013, 9, 22),
                        local:new Date(2010, 11, 28, 14, 57),
                        time: new Date(1970, 0, 1, 14, 57, 0),
                        week: new Date(2013, 0, 3),
                        month: new Date(2013, 9, 1),
                        number: 12,
                        range:75,
                        min:10,
                        max:90
                    };
                    $scope.color = {
                        name: 'blue'
                    };
                    $scope.specialValue = {
                        "id": "12345",
                        "value": "green"
                    };
                    $scope.checkboxModel = {
                        value1 : true,
                        value2 : 'YES'
                    };
                }]);
    </script>
    </html>
    

    这段代码展示了input指令支持的全部类型的基本使用方式。

    相关文章

      网友评论

          本文标题:input指令

          本文链接:https://www.haomeiwen.com/subject/hftbettx.html