feat: add openOnFocus and remove minLength

README.md

@@ -209,11 +209,11 @@ Whether to show the highlighted suggestion as completion in the input.
 
 ![`showCompletion` preview](https://user-images.githubusercontent.com/6137112/68124812-7e989800-ff10-11e9-88a5-f28c1466b665.png)
 
-#### `minLength`
+#### `openOnFocus`
 
-> `number` | defaults to `1`
+> `boolean` | defaults to `false`
 
-The minimum number of characters long the autocomplete opens.
+Whether to open the dropdown on focus when there's no query.
 
 #### `autoFocus`
 

examples/autocomplete.js/index.tsx

@@ -17,7 +17,7 @@ const searchClient = algoliasearch(
 autocomplete({
   container: '#autocomplete',
   placeholder: 'Search…',
-  minLength: 0,
+  openOnFocus: true,
   showCompletion: true,
   defaultHighlightedIndex: -1,
   shouldDropdownOpen({ state }) {

packages/autocomplete-core/src/defaultProps.ts

@@ -15,7 +15,7 @@ export function getDefaultProps<TItem>(
     : {}) as typeof window;
 
   return {
-    minLength: 1,
+    openOnFocus: false,
     placeholder: '',
     autoFocus: false,
     defaultHighlightedIndex: null,

packages/autocomplete-core/src/onInput.ts

@@ -55,7 +55,7 @@ export function onInput<TItem>({
   setHighlightedIndex(props.defaultHighlightedIndex);
   setQuery(query);
 
-  if (query.length < props.minLength) {
+  if (query.length === 0 && props.openOnFocus === false) {
     setStatus('idle');
     setSuggestions(
       store.getState().suggestions.map(suggestion => ({
@@ -117,7 +117,7 @@ export function onInput<TItem>({
           setSuggestions(suggestions as any);
           setIsOpen(
             nextState.isOpen ??
-              (query.length >= props.minLength &&
+              ((query.length === 0 && props.openOnFocus) ||
                 props.shouldDropdownShow({ state: store.getState() }))
           );
         })

packages/autocomplete-core/src/propGetters.ts

@@ -117,7 +117,7 @@ export function getPropGetters<TItem>({
       onReset: event => {
         event.preventDefault();
 
-        if (props.minLength === 0) {
+        if (props.openOnFocus) {
           onInput({
             query: '',
             store,
@@ -130,7 +130,6 @@ export function getPropGetters<TItem>({
             setContext,
           });
         }
-
         store.send('reset', null);
 
         if (providedProps.inputElement) {
@@ -143,9 +142,9 @@ export function getPropGetters<TItem>({
 
   const getInputProps: GetInputProps = providedProps => {
     function onFocus() {
-      // We want to trigger a query when `minLength` is reached because the
-      // dropdown should open with the current query.
-      if (store.getState().query.length >= props.minLength) {
+      // We want to trigger a query when `openOnFocus` is true
+      // because the dropdown should open with the current query.
+      if (props.openOnFocus || store.getState().query.length > 0) {
         onInput({
           query: store.getState().query,
           store,
@@ -227,8 +226,7 @@ export function getPropGetters<TItem>({
         if (
           providedProps.inputElement ===
             props.environment.document.activeElement &&
-          !store.getState().isOpen &&
-          store.getState().query.length >= props.minLength
+          !store.getState().isOpen
         ) {
           onFocus();
         }

packages/autocomplete-core/src/stateReducer.ts

@@ -103,8 +103,14 @@ export const stateReducer: Reducer = (action, state, props) => {
     case 'reset': {
       return {
         ...state,
-        highlightedIndex: null,
-        isOpen: false,
+        highlightedIndex:
+          // Since we open the menu on reset when openOnFocus=true
+          // we need to restore the highlighted index to the defaultHighlightedIndex. (DocSearch use-case)
+
+          // Since we close the menu when openOnFocus=false
+          // we lose track of the highlighted index. (Query-suggestions use-case)
+          props.openOnFocus === true ? props.defaultHighlightedIndex : null,
+        isOpen: props.openOnFocus, // @TODO: Check with UX team if we want to close the menu on reset.
         status: 'idle',
         statusContext: {},
         query: '',
@@ -115,7 +121,7 @@ export const stateReducer: Reducer = (action, state, props) => {
       return {
         ...state,
         highlightedIndex: props.defaultHighlightedIndex,
-        isOpen: state.query.length >= props.minLength,
+        isOpen: props.openOnFocus || state.query.length > 0,
       };
     }
 

packages/autocomplete-core/src/types/api.ts

@@ -168,11 +168,11 @@ export interface PublicAutocompleteOptions<TItem> {
    */
   showCompletion?: boolean;
   /**
-   * The minimum number of characters long the autocomplete opens.
+   * Whether to open the dropdown on focus when there's no query.
    *
-   * @default 1
+   * @default false
    */
-  minLength?: number;
+  openOnFocus?: boolean;
   /**
    * The number of milliseconds that must elapse before the autocomplete
    * experience is stalled.
@@ -229,7 +229,7 @@ export interface AutocompleteOptions<TItem> {
   autoFocus: boolean;
   defaultHighlightedIndex: number | null;
   showCompletion: boolean;
-  minLength: number;
+  openOnFocus: boolean;
   stallThreshold: number;
   initialState: AutocompleteState<TItem>;
   getSources: GetSources<TItem>;

stories/react.stories.tsx

@@ -240,6 +240,46 @@ storiesOf('React', module)
         container
       );
 
+      return container;
+    })
+  )
+  .add(
+    'Open on focus',
+    withPlayground(({ container, dropdownContainer }) => {
+      render(
+        <Autocomplete
+          placeholder="Search items…"
+          showCompletion={true}
+          dropdownContainer={dropdownContainer}
+          defaultHighlightedIndex={0}
+          openOnFocus={true}
+          getSources={() => {
+            return [
+              {
+                getInputValue({ suggestion }) {
+                  return suggestion.query;
+                },
+                getSuggestions({ query }) {
+                  return getAlgoliaHits({
+                    searchClient,
+                    queries: [
+                      {
+                        indexName: 'instant_search_demo_query_suggestions',
+                        query,
+                        params: {
+                          hitsPerPage: 4,
+                        },
+                      },
+                    ],
+                  });
+                },
+              },
+            ];
+          }}
+        />,
+        container
+      );
+
       return container;
     })
   );