diff --git a/extensions/amp-autocomplete/amp-autocomplete.md b/extensions/amp-autocomplete/amp-autocomplete.md index 08ed09e957d3..359e9897f363 100644 --- a/extensions/amp-autocomplete/amp-autocomplete.md +++ b/extensions/amp-autocomplete/amp-autocomplete.md @@ -155,7 +155,11 @@ The max specified number of items to suggest at once based on a user input, disp ### `suggest-first` -Suggest the first entry in the list of results by marking it active; only possible if filter==prefix (does nothing otherwise) +Suggest the first entry in the list of results by marking it active. + +[filter formats="websites"] +This is only possible if filter==prefix (does nothing otherwise). +[/filter] ### `submit-on-enter` @@ -171,6 +175,8 @@ If present, exposes the autocomplete-partial class on the substring Specifies the key to the data array within the JSON response. Nested keys can be expressed with a dot-notated value such as field1.field2. The default value is "items". The following are examples with and without usage: +[filter formats="websites"] +
 
       
@@ -187,12 +193,42 @@ Specifies the key to the data array within the JSON response. Nested keys can be
       
         
         
       
 
   
- In the first example, the JSON payload is queued by the "items" key, and thus no component attribute is needed because the default value corresponds. In the second example, the JSON payload is queued by the "fruit" key, so the items attribute is given the value "fruit" so as to accurately etrieve the intended datasource. In both examples, the end user interaction is the same. +[/filter] + +[filter formats="email"] + +Note that the following data is returned by the remote `src`: + +
+    { 
+      "items" : ["apples", "bananas", "pears"], 
+      "fruit" : ["kiwis", "oranges", "watermelons"] 
+    }
+  
+ +
+
+      
+        
+      
+
+  
+
+
+      
+        
+      
+
+  
+ +[/filter] + +In the first example, the JSON payload is queued by the "items" key, and thus no component attribute is needed because the default value corresponds. In the second example, the JSON payload is queued by the "fruit" key, so the items attribute is given the value "fruit" so as to accurately retrieve the intended datasource. In both examples, the end user interaction is the same. ### `inline` @@ -219,6 +255,7 @@ representation of the corresponding object, which is then made available in the `valueAsObject` field of the `event`. Example: +[filter formats="websites"] ```html ``` +[/filter] + +[filter formats="email"] + +```html + + + + +

+ No fruit selected +

+``` + +[/filter] + ## Validation See [amp-autocomplete rules](validator-amp-autocomplete.protoascii) in the AMP validator specification.