Expose Internal Methods and Properties

I’ve hit an issue where I need to programmatically control other Autocomplete instances on the same page, but (at least from my understanding) this is impossible.

Having an initiation function like this, is great:

autocomplete({
  element: document.querySelector( '' ),
  source: [ 'option', 'option-1', 'options-2']
})

But there is no way to reference this input after it initiates. How hard would it be to have this return the input instance? i.e.

const input = autocomplete({
  element: document.querySelector( '' ),
  source: [ 'option', 'option-1', 'options-2']
})

// Later
input.hide();

[walkermatt]

@JakeChampion this change to the accessibleAutocomplete function returns the component instance.

[JakeChampion]

Another good use-case I have come across for returning the component from the wrapper module:

https://github.com/alphagov/accessible-autocomplete/blob/935f0d43aea1c606e6b38985e3fe7049ddbe98be/src/wrapper.js#L4

We wanted to implement a button to clear and re-focus the input field, this currently has a sub-optimal user-experience because it requires aligning to some timers internal to accessible-autocomplete. If we reset the input and then re-focus the input before the internal timer has fired, then the input’s value reverts to what it was before being reset. Those timers are there to integrate with Dragon NaturallySpeaking – https://github.com/alphagov/accessible-autocomplete/blob/935f0d43aea1c606e6b38985e3fe7049ddbe98be/src/autocomplete.js#L107-L125

If the component was returned, we would be able to call component.getDirectInputChanges() to update the internal state of the component and then immediately focus on the input, and have it work correctly.

This is the code we have to have right now to reset and re-focus the input:

let timeout = null;
clearButton.addEventListener('click', function clearInput() {
	input.value = '';
	clearButton.remove();
	// We need to wait longer than 100ms before focusing
	// onto the input element because accessible-autocomplete
	// only checks the value of the input every 100ms.
	// If we modify input.value and then focus into the input in less
	// than 100ms, accessible-autocomplete would not have the updated
	// value and would instead write the old value back into the input.
	// https://github.com/alphagov/accessible-autocomplete/blob/935f0d43aea1c606e6b38985e3fe7049ddbe98be/src/autocomplete.js#L107-L125
	if (!timeout) {
		// The user could press the button multiple times
		// whilst the setTimeout handler has yet to execute
		// We only want to call the handler once
		timeout = setTimeout(() => {
			input.focus();
			timeout = null;
		}, 110);
	}
});

If we had access to the component instance, we could refactor the above into:

clearButton.addEventListener('click', function clearInput() {
	input.value = '';
	clearButton.remove();
	// We need to update the internal state of accessible-autocomplete
	// with the new value in the input
	component.getDirectInputChanges();
	input.focus();
});