jQuery属性操做之.val()函数

时间 2019-12-11

标签 jquery 属性 val 函数栏目 JQuery 繁體版

原文原文链接

目录node

@函数

.val()实例方法的三种用法

$('xxx').val() : 获取匹配的元素集合中第一个元素的当前value属性值(property)
$('xxx').val(value) : 设置匹配的元素集合中每一个元素的value属性值(property)
$('xxx').val(function(index,value){}) :

钩子函数未设置或无效时,将函数function(index,value)的返回值设为每个DOM元素的value属性值(property).
其中,两个形参不须要传值,index指代当前DOM元素的在jQuery对象中的索引,value指代当前DOM对象的旧的value属性值.

.val()函数源码

jQuery.fn.extend( {
    val: function( value ) {
        var hooks, ret, isFunction,
            elem = this[ 0 ]; //elem为jQuery对象匹配的第一个DOM元素
        
        //无参数传入时
        if ( !arguments.length ) { 

            if ( elem ) { //若是jQuery有匹配到DOM元素的话

                //钩子判断与执行:匹配用户自定义的钩子函数,并执行和返回
                hooks = jQuery.valHooks[ elem.type ] ||  //若是valHooks有type属性,赋值对应钩子
                    jQuery.valHooks[ elem.nodeName.toLowerCase() ];  //若是valHooks有与DOM节点名相关的属性,赋值对应钩子



                if ( // 若是定义了钩子及相关方法,调用钩子函数处理并返回
                    hooks &&
                    "get" in hooks &&
                    ( ret = hooks.get( elem, "value" ) ) !== undefined
                ) {
                    return ret;
                }

                ret = elem.value;  //无钩子时,直接取元素的value值

                return typeof ret === "string" ?

                    // 返回字符串:处理通常状况下的返回值
                    ret.replace( rreturn, "" ) :

                    // 返回非字符串:value为null/undefined,返回空串;其他状况,返回ret
                    ret == null ? "" : ret;
            }

            return; //若是jQuery对象未匹配到DOM元素时,直接返回
        }


        //传入一个参数时的状况:函数,非函数
        isFunction = jQuery.isFunction( value ); //判断传入参数是否为函数,为后续条件开关作准备

        return this.each( function( i ) {  //实例方法.each():对匹配到的每个DOM元素,执行括号中的函数:obj[i].callback(i);
            var val;

            if ( this.nodeType !== 1 ) { //当前DOM元素不为元素节点时,直接返回
                return;
            }

            if ( isFunction ) { //若是传入参数为函数类型,val=obj[i].value(i,obj的value属性值)

                val = value.call( this, i, jQuery( this ).val() );
                //[注:value的两个形参,咱们不用给它手动传值,会在val函数内部自动传值,一个表明DOM元素的索引,一个表明DOM元素当前的value属性的值]

            } else {
                val = value; //若是传入参数不为函数类型,val=传入参数;
            }

            // 将val为null/undefined的状况,统一处理为空串
            if ( val == null ) {
                val = "";
            } else if ( typeof val === "number" ) {
                val += "";
            } else if ( jQuery.isArray( val ) ) {
                val = jQuery.map( val, function( value ) {
                    return value == null ? "" : value + "";
                } );
            }

            //有传参的状况下的,钩子判断与执行:匹配用户自定义的钩子函数,并执行和返回
            hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; 

            // 若是钩子的"set"属性未定义,仍旧返回上面通常状况下处理的结果
            if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
                this.value = val;
            }
        } );
    }
} );

调用形式:$('xxx').val();

调用形式:$('xxx').val(value);

调用形式:$('xxx').val(function(index,value){});

相关代码:源码

if ( isFunction ) { //若是传入参数为函数类型,val=obj[i].value(i,obj的value属性值)

            val = value.call( this, i, jQuery( this ).val() );
            //[注:value的两个形参,咱们不用给它手动传值,会在val函数内部自动传值,一个表明DOM元素的索引,一个表明DOM元素当前的value属性的值]

        } else {
            val = value; //若是传入参数不为函数类型,val=传入参数;
        }

        // 将val为null/undefined的状况,统一处理为空串
        if ( val == null ) {
            val = "";
        } else if ( typeof val === "number" ) {
            val += "";
        } else if ( jQuery.isArray( val ) ) {
            val = jQuery.map( val, function( value ) {
                return value == null ? "" : value + "";
            } );
        }

        //有传参的状况下的,钩子判断与执行:匹配用户自定义的钩子函数,并执行和返回
        hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; 

        // 若是钩子的"set"属性未定义,仍旧返回上面通常状况下处理的结果
        if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) {
            this.value = val;
        }

说明:(value为函数类型状况下)
1.令val=obj[i].value(i,jQuery( this ).val());
[注]string

value函数两个形参由本函数自动传值,自行传值无效.
传参i-当前DOM元素在jQuery对象中的索引值
传参jQuery( this ).val()-将当前DOM元素包装为jQuery对象,以便以无参形式调用val方法获得的value属性旧值.

2.一样,先进行钩子的判断,若是知足如下几个条件,if条件判断语句中的三个表达式依次执行,设置好当前DOM元素value属性值:

钩子之中存在type属性或者存在与当前DOM元素节点同名的属性
钩子之中存在set属性
调用set,获得的返回值不为undefined

3.不然,直接设置val为当前元素的value属性值

1. jquery属性操做之html，text，val方法
2. jQuery属性操做之.attr()
3. jQuery特殊属性之val方法
4. jQuery属性操做
5. jQuery 属性操做
6. jQuery---属性操做
7. jQuery特殊属性操做
8. 04-jQuery的属性操做
9. jquery属性操做.html(),, .prop()
10. jQuery-CSS类属性操做
更多相关文章...
• jQuery Mobile Data 属性 - jQuery Mobile 教程
• SQL IN 操作符 - SQL 教程
• 互联网组织的未来：剖析GitHub员工的任性之源
• JDK13 GA发布：5大特性解读