'));
// A11y: Live region to announce result count / status to screen readers (WCAG 4.1.3)
$inputField.closest('.formField-inputWrapper--companyName').after(
''
);
// Find the container (assuming it's the direct parent with the class)
const $container = $inputField.closest('#formField--companyName');
// Demo display element
const $idDisplaySpan = $('#selected-id-display span');
let $resultsContainer = null;
let $resultsList = null;
let valueWasSelected = false; // Flag to track if the current value is from selection
let responseData = null; // Store the response data
// --- Helper Functions ---
function ensureResultsListExists() {
if(!$resultsContainer || $resultsContainer.length === 0) {
$resultsContainer = $container.find('.autocomplete-results');
if($resultsContainer.length === 0) {
$resultsContainer = $('
with listbox role so screen readers treat items as selectable options
$resultsList = $('
').attr({
'id': 'company-autocomplete-listbox',
'role': 'listbox',
'aria-label': 'Company suggestions'
});
$resultsContainer.append($resultsList);
}
}
}
$resultsList.empty();
return $resultsList;
}
function hideResults() {
if($resultsContainer && $resultsContainer.length) {
$resultsContainer.hide();
if($resultsList) {
$resultsList.empty();
}
}
// A11y: Collapse combobox and clear active descendant when results are hidden
$inputField.attr('aria-expanded', 'false');
$inputField.removeAttr('aria-activedescendant');
if(currentRequest) {
currentRequest.abort();
currentRequest = null;
}
}
// Function to clear the stored ID
function clearSelectedId() {
$hiddenFirmIdInput.val('');
valueWasSelected = false;
$idDisplaySpan?.text('(None)'); // Update demo display
// console.log("Hidden ID cleared");
}
// Function to handle selection (from click or Enter key)
function handleSelection($selectedItem) {
if(!$selectedItem || $selectedItem.length === 0 || $selectedItem.hasClass('autocomplete-message')) {
return; // Do nothing if no valid item or it's a message
}
const selectedText = $selectedItem.text();
const selectedId = $selectedItem.data('company-id'); // Retrieve stored ID
if(selectedId) {
$inputField.val(selectedText); // Update visible input
$hiddenFirmIdInput.val(selectedId); // Update hidden input
valueWasSelected = true; // Mark that selection occurred
$idDisplaySpan?.text(selectedId); // Update demo display
// console.log("Selected:", selectedText, "ID:", selectedId);
hideResults();
$inputField.trigger('change'); // Optional: Trigger change event for other listeners
}
else {
console.warn('Selected item missing company ID data:', $selectedItem);
hideResults(); // Hide results even if ID is missing
}
}
// --- Event Handlers ---
$inputField.on('input', function() {
const currentInputValue = $(this).val();
const searchTerm = currentInputValue.trim();
// CRITICAL: If the user types anything, clear the previously selected ID
// Only clear if the flag 'valueWasSelected' is true, meaning the last change
// wasn't already a manual input modification.
if(valueWasSelected) {
clearSelectedId();
}
// We always set valueWasSelected to false here, because *any* input
// event means the current value is potentially manual, until a selection happens again.
valueWasSelected = false;
clearTimeout(debounceTimer);
if(currentRequest) {
currentRequest.abort();
currentRequest = null;
}
if(searchTerm.length === 0) {
hideResults();
clearSelectedId(); // Also clear ID if input is emptied
return;
}
debounceTimer = setTimeout(() => {
const $currentResultsList = ensureResultsListExists();
$currentResultsList.html('
Searching...
');
$resultsContainer.show();
currentRequest = $.ajax({
url: `${apiUrl}?size=10&term=${encodeURIComponent(searchTerm)}`,
method: 'GET',
dataType: 'json',
success: function(responsePayload) {
$currentResultsList.empty();
responseData = [];
let hasResults = false;
if(responsePayload && Array.isArray(responsePayload) && responsePayload.length > 0) {
responseData = responsePayload;
$.each(responsePayload, function(index, item) {
if(item && item.name && item.id) { // Ensure name and ID exist
// A11y: Each suggestion is an option with a unique id for aria-activedescendant
$('
')
.text(item.name)
.attr({
'role': 'option',
'id': 'company-option-' + index,
'aria-selected': 'false'
})
.data('company-id', item.id) // Store ID using jQuery's data()
.appendTo($currentResultsList);
hasResults = true;
}
});
}
if(hasResults) {
$resultsContainer.show();
// A11y: Expand combobox and announce result count to screen readers
$inputField.attr('aria-expanded', 'true');
var count = $currentResultsList.find('li[role="option"]').length;
$('#company-autocomplete-status').text(count + ' suggestion' + (count !== 1 ? 's' : '') + ' available. Use up and down arrows to browse.');
}
else {
$currentResultsList.html('