From 2b3ebc617f525a1b7c7f6c89e8fe5e97c54534f7 Mon Sep 17 00:00:00 2001 From: Karl Swedberg Date: Thu, 14 Jul 2016 08:34:39 -0400 Subject: [PATCH 1/5] val(): Update select multiple no selected statement for 3.0. Fixes #828 --- entries/val.xml | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/entries/val.xml b/entries/val.xml index 1ba0c365..7ab00ff3 100644 --- a/entries/val.xml +++ b/entries/val.xml @@ -11,7 +11,8 @@ Get the current value of the first element in the set of matched elements. -

The .val() method is primarily used to get the values of form elements such as input, select and textarea. When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), it returns an array containing the value of each selected option, or null if no options are selected. When called on an empty collection, it returns undefined.

+

The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.

+

When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.

For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:


 // Get the value from a dropdown select
@@ -27,7 +28,7 @@ $( "input:checkbox:checked" ).val();
 $( "input:radio[name=bar]:checked" ).val();
-

Note: At present, using .val() on textarea elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:

+

Note: At present, using .val() on textarea elements strips carriage return characters from the browser-reported value. When this value is sent to the server via XHR, however, carriage returns are preserved (or added by browsers which do not include them in the raw value). A workaround for this issue can be achieved using a valHook as follows:


 $.valHooks.textarea = {
@@ -115,17 +116,17 @@ $( "input" )
       1.4
       
         
-             
-                 
+        
+        
         A function returning the value to set. this is the current element. Receives the index position of the element in the set and the old value as arguments.
       
     
     Set the value of each element in the set of matched elements.
     
       
This method is typically used to set the values of form fields. 

-      
val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that don't match one of the elements of the array will be unchecked or unselected, depending on the type. In case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.

+      
val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that doesn't match one of the elements of the array will be unchecked or unselected, depending on the type. In the case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.

       
Setting values using this method (or using the native value property) does not cause the dispatch of the change event. For this reason, the relevant event handlers will not be executed. If you want to execute them, you should call .trigger( "change" ) after setting the value.

-      
The .val() method allows us to set the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 

+      
The .val() method allows settting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 

       

 $( "input:text.items" ).val(function( index, value ) {
   return value + " " + this.className;

From 3f3b61896c67f1bbef499e2135ebfb534ed86684 Mon Sep 17 00:00:00 2001
From: Karl Swedberg 
Date: Sun, 17 Jul 2016 13:19:35 -0400
Subject: [PATCH 2/5] Fix typo

---
 entries/val.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/entries/val.xml b/entries/val.xml
index 7ab00ff3..d2e9dbfd 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -126,7 +126,7 @@ $( "input" )
       
This method is typically used to set the values of form fields. 

       
val() allows you to pass an array of element values. This is useful when working on a jQuery object containing elements like <input type="checkbox">, <input type="radio">, and <option>s inside of a <select>. In this case, the inputs and the options having a value that matches one of the elements of the array will be checked or selected while those having a value that doesn't match one of the elements of the array will be unchecked or unselected, depending on the type. In the case of <input type="radio">s that are part of a radio group and <select>s, any previously selected element will be deselected.

       
Setting values using this method (or using the native value property) does not cause the dispatch of the change event. For this reason, the relevant event handlers will not be executed. If you want to execute them, you should call .trigger( "change" ) after setting the value.

-      
The .val() method allows settting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 

+      
The .val() method allows setting the value by passing in a function. As of jQuery 1.4, the function is passed two arguments, the current element's index and its current value: 

       

 $( "input:text.items" ).val(function( index, value ) {
   return value + " " + this.className;

From c0cd6b2d045ea2b8b481c424849f1107a8074549 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Sun, 17 Jul 2016 17:17:50 +0100
Subject: [PATCH 3/5] Updated methods removed in jQuery 3

Fixes gh-956
Closes gh-957
---
 entries/andSelf.xml    | 3 ++-
 entries/context.xml    | 1 +
 entries/error.xml      | 3 ++-
 entries/load-event.xml | 3 ++-
 entries/size.xml       | 3 ++-
 entries/unload.xml     | 3 ++-
 6 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/entries/andSelf.xml b/entries/andSelf.xml
index 6870b479..5adfd1ae 100644
--- a/entries/andSelf.xml
+++ b/entries/andSelf.xml
@@ -1,5 +1,5 @@
 
-
+
   .andSelf()
   
     1.2
@@ -75,4 +75,5 @@ $( "div.after-andself" ).find( "p" ).andSelf().addClass( "background" );
   
   
   
+  
 
diff --git a/entries/context.xml b/entries/context.xml
index 0cf0f7b4..5fc5362a 100644
--- a/entries/context.xml
+++ b/entries/context.xml
@@ -26,4 +26,5 @@ Context: 
    
   
   
   
+  
     
diff --git a/entries/error.xml b/entries/error.xml
index 872ff70d..6f646aa2 100644
--- a/entries/error.xml
+++ b/entries/error.xml
@@ -1,5 +1,5 @@
 
-
+
   .error()
   Bind an event handler to the "error" JavaScript event.
   
@@ -60,4 +60,5 @@ $( "img" )
   
   
   
+  
 
diff --git a/entries/load-event.xml b/entries/load-event.xml
index d95f81bc..e3739cb7 100644
--- a/entries/load-event.xml
+++ b/entries/load-event.xml
@@ -1,5 +1,5 @@
 
-
+
   .load()
   Bind an event handler to the "load" JavaScript event.
   
@@ -76,4 +76,5 @@ $( "img.userIcon" ).load(function() {
   
   
   
+  
 
diff --git a/entries/size.xml b/entries/size.xml
index 2d092a37..e7dd1223 100644
--- a/entries/size.xml
+++ b/entries/size.xml
@@ -1,5 +1,5 @@
 
-
+
   .size()
   
     1.0
@@ -66,4 +66,5 @@ $( document.body )
   
   
   
+  
 
diff --git a/entries/unload.xml b/entries/unload.xml
index 173d560e..1306ddd6 100644
--- a/entries/unload.xml
+++ b/entries/unload.xml
@@ -1,5 +1,5 @@
 
-
+
   .unload()
   
     1.0
@@ -46,4 +46,5 @@ $( window ).unload(function() {
   
   
   
+  
 

From 1b230db9c25a2fe55801454bf83487ca903bca97 Mon Sep 17 00:00:00 2001
From: Aurelio De Rosa 
Date: Tue, 19 Apr 2016 02:12:21 +0100
Subject: [PATCH 4/5] jQuery.uniqueSort: Fixed category name

Fixes gh-908
Closes gh-913
---
 categories.xml                | 8 ++++++++
 entries/jQuery.uniqueSort.xml | 3 ++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/categories.xml b/categories.xml
index 55038248..d4d31106 100644
--- a/categories.xml
+++ b/categories.xml
@@ -414,6 +414,14 @@ var files = event.originalEvent.dataTransfer.files;
         
    
       ]]>
     
+    
+      
+    
     
       
   
   
+  
     

From 56358d08841fc49d842012d82051e9a085471d1e Mon Sep 17 00:00:00 2001
From: Anton Rieder 
Date: Sun, 17 Jul 2016 13:25:40 -0400
Subject: [PATCH 5/5] Fix documentation for .val()

---
 entries/val.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/entries/val.xml b/entries/val.xml
index d2e9dbfd..73d9d521 100644
--- a/entries/val.xml
+++ b/entries/val.xml
@@ -14,6 +14,7 @@
       
    The .val() method is primarily used to get the values of form elements such as input, select and textarea. When called on an empty collection, it returns undefined.
    
       
    When the first element in the collection is a select-multiple (i.e., a select element with the multiple attribute set), .val() returns an array containing the value of each selected option. As of jQuery 3.0, if no options are selected, it returns an empty array; prior to jQuery 3.0, it returns null.
    
       
    For selects and checkboxes, you can also use the :selected and :checked selectors to get at values, for example:
    
+      
    jQuery 3 changes the behavior of this method to return an empty array if a collection is a select-multiple and no options are selected.
    
       
    
 // Get the value from a dropdown select
 $( "select.foo option:selected").val();
@@ -44,6 +45,8 @@ $.valHooks.textarea = {
 function displayVals() {
   var singleValues = $( "#single" ).val();
   var multipleValues = $( "#multiple" ).val() || [];
+  // When using jQuery 3:
+  // var multipleValues = $( "#multiple" ).val()
   $( "p" ).html( "Single: " + singleValues +
     " Multiple: " + multipleValues.join( ", " ) );
 }