docs(resetOnOptionsChange): update documentation

Related #1015
sagalbot · Dec 2, 2019 · d4fe9e3 · d4fe9e3
1 parent 2a51460
commit d4fe9e3
Showing 1 changed file with 11 additions and 3 deletions.
diff --git a/docs/api/props.md b/docs/api/props.md
@@ -339,12 +339,20 @@ createOption: {
 
 ## resetOnOptionsChange
 
-When false, updating the options will not reset the select value
+When false, updating the options will not reset the selected value. Accepts
+a `boolean` or `function` that returns a `boolean`. If defined as a function,
+it will receive the params listed below.
 
 ```js
+/**
+* @type {Boolean|Function}
+* @param {Array} newOptions
+* @param {Array} oldOptions
+* @param {Array} selectedValue
+*/
 resetOnOptionsChange: {
-	type: Boolean,
-	default: false
+    default: false,
+    validator: (value) => ['function', 'boolean'].includes(typeof value)
 },
 ```