این کد رو بهم توضیح بده function setupSuggestionBoxmultiselect(inputId,…
- User
این کد رو بهم توضیح بده
function setupSuggestionBox_multi_select(inputId, suggestionsBoxId, data, selectedArray) { const inputElement = document.getElementById(inputId); const suggestionsBox = document.getElementById(suggestionsBoxId); const dataList = data.map(item => item.data);
inputElement.addEventListener('input', function() { const query = inputElement.value.split(',').pop().trim().toLowerCase(); suggestionsBox.innerHTML = ''; const filteredData = query ? dataList.filter(item => item.toLowerCase().includes(query)) : dataList; filteredData.forEach(item => { const suggestionItem = document.createElement('div'); suggestionItem.className = 'suggestion-item'; suggestionItem.textContent = item; suggestionItem.addEventListener('click', function() { if (selectedArray.includes(item)) { const index = selectedArray.indexOf(item); if (index > -1) { selectedArray.splice(index, 1); } } else { selectedArray.push(item); } if(selectedArray.length > 0){ inputElement.value = selectedArray.join(', ') + ', '; }else{ inputElement.value = ''; } suggestionsBox.innerHTML = ''; inputElement.scrollLeft = -inputElement.scrollWidth; }); if (selectedArray.includes(item)) { suggestionItem.style.color = '#007bff'; } suggestionsBox.appendChild(suggestionItem); }); }); inputElement.addEventListener('focus', function() { suggestionsBox.innerHTML = ''; dataList.forEach(item => { const suggestionItem = document.createElement('div'); suggestionItem.className = 'suggestion-item'; suggestionItem.textContent = item; suggestionItem.addEventListener('click', function() { if (selectedArray.includes(item)) { const index = selectedArray.indexOf(item); if (index > -1) { selectedArray.splice(index, 1); } } else { selectedArray.push(item); } if(selectedArray.length > 0){ inputElement.value = selectedArray.join(', ') + ', '; }else{ inputElement.value = ''; } suggestionsBox.innerHTML = ''; inputElement.scrollLeft = -inputElement.scrollWidth; }); if (selectedArray.includes(item)) { suggestionItem.style.color = '#007bff'; } suggestionsBox.appendChild(suggestionItem); }); }); document.addEventListener('click', function(event) { if (!inputElement.contains(event.target) && !suggestionsBox.contains(event.target)) { suggestionsBox.innerHTML = ''; } });}
- Assistant
این کد یک تابع به نام
setupSuggestionBox_multi_selectاست که برای ایجاد یک باکس پیشنهادات (suggestion box) چندانتخابی (multi-select) در صفحه وب استفاده میشود. در واقع، به کاربر اجازه میدهد در یک input متنی چند مقدار را به صورت جدا شده با کاما انتخاب کند، و به کمک یک لیست پیشنهادات نمایش داده شده، انتخابهای خود را راحتتر انجام دهد.در ادامه جزئیات عملکرد این تابع را مرحله به مرحله توضیح میدهم:
پارامترهای ورودی تابع:
inputId: شناسه (id) المان<input>که کاربر در آن تایپ میکند.suggestionsBoxId: شناسه المان HTML که داخل آن پیشنهادات نمایش داده میشود (مثلاً یک<div>).data: آرایهای از اشیاء که حداقل شامل فیلدی به نامdataاست؛ مقادیر پیشنهادی از همین فیلد استخراج میشوند.selectedArray: آرایهای خارج از تابع که مقادیر انتخابشده توسط کاربر را نگه میدارد و در طول اجرای تابع بهروزرسانی میشود.
شرح عملکرد:
-
دریافت المانها و استخراج دادهها:
- ابتدا المان input و suggestions box را از طریق
getElementByIdمیگیرد. - سپس از آرایه
data، فقط رشتههای متناظر با فیلدdataرا استخراج کرده و درdataListذخیره میکند.
- ابتدا المان input و suggestions box را از طریق
-
رویداد
inputبر روی فیلد متنی:- هر بار که کاربر متنی تایپ میکند، مقدار فعلی input را میگیرد.
- چون این input چند مقداری است که مقادیر با
,از هم جدا شدهاند، با استفاده ازsplit(',').pop()، آخرین قسمت متنی (آخرین مقدار در حال تایپ) را جدا میکند. - سپس با حذف فاصلهها و تبدیل به حروف کوچک (
toLowerCase) آن را به عنوانqueryبرای جستجو در لیست پیشنهادات آماده میکند. - سپس پیشنهادها را به صورت فیلتر شده بر اساس این
queryبدست میآورد (تمام عباراتی که شاملqueryباشند). - پیشنهادات مطابق لیست فیلتر شده درون
suggestionsBoxاضافه میشوند.
-
ساخت هر مورد پیشنهاد:
- برای هر مورد یک
<div>با کلاسsuggestion-itemساخته میشود. - متن آن مقدار پیشنهادی است.
- اگر آن مقدار در آرایه
selectedArrayموجود باشد، رنگ متن به رنگ آبی (مثلاً#007bff) تغییر میکند، یعنی نشان میدهد که آن مقدار انتخاب شده است. - با کلیک روی این پیشنهاد:
- اگر مقدار از قبل انتخاب شده باشد، از آرایه
selectedArrayحذف میشود (حذف تکراری). - اگر انتخاب نشده باشد، به آرایه اضافه میشود.
- سپس مقدار input به شکل رشتهای از مقادیر انتخابشده جدا شده با کاما (و کاما و فاصله آخر) بروزرسانی میشود.
- پیشنهادها پاک شده و اسکرول input به ابتدای متن تغییر میکند (ولی کد جاوااسکریپتی
inputElement.scrollLeft = -inputElement.scrollWidth;ظاهراً تلاش میکند به چپ ترین نقطه اسکرول برود؛ که شاید به درستی کار نکند یا نیاز به بررسی بیشتر دارد).
- اگر مقدار از قبل انتخاب شده باشد، از آرایه
- برای هر مورد یک
-
رویداد
focusروی input:- وقتی کاربر وارد input میشود (focus میشود) لیست تمام دادهها (بدون فیلتر) نمایش داده میشود.
- مشابه رویداد
input، همه گزینهها ایجاد و به suggestionsBox اضافه میشوند و روی هر کدام هم listener کلیک میگذارند.
-
پاک کردن پیشنهادات با کلیک بیرون:
- وقتی کاربر در جایی بیرون از input و suggestionsBox کلیک میکند، پنجره پیشنهادات پاک میشود.
خلاصه:
این تابع به شما امکان میدهد یک input چند انتخابی داشته باشید که کاربر میتواند با تایپ، پیشنهاداتی دریافت کند و آنها را انتخاب و از انتخابهای قبلی خود آگاه شود. انتخابها در یک آرایه خارجی نگهداری و نمایش داده میشوند و کاربر میتواند به راحتی آیتمها را اضافه یا حذف کند.
نکتهها:
- ورودی
dataباید به شکل آرایهای از آبجکتها باشد که هر آبجکت حداقل فیلدی به نامdataداشته باشد، مثلاً:
[ { data: 'Apple' }, { data: 'Banana' }, { data: 'Orange' }, ]- آرایه
selectedArrayباید از بیرون نگهداری شود تا وضعیت انتخابها حفظ شود. - CSS مربوط به کلاس
.suggestion-itemباید تعریف شود تا ظاهر مناسبی داشته باشد. - برای چند انتخابی بودن input، این کد فرض میکند مقادیر input به صورت رشتههای جدا شده با
,نمایش داده شدهاند.
اگر بخواهید من میتوانم نمونهای ساده بسازم یا نحوه استفاده از این تابع را هم نشان دهم.
- User
میتونی یدونه همین مدلی برام برای انتخاب یدونه ای بسازی ؟
- Assistant
البته! در ادامه نسخه سادهشده و اصلاح شدهای از تابع بالا میآورم که فقط اجازه انتخاب یک مقدار را میدهد (single select) به طوری که وقتی یک گزینه انتخاب شود، جایگزین مقدار قبلی شود و در input نمایش داده شود.
تابع
setupSuggestionBox_single_selectfunction setupSuggestionBox_single_select(inputId, suggestionsBoxId, data) { const inputElement = document.getElementById(inputId); const suggestionsBox = document.getElementById(suggestionsBoxId); const dataList = data.map(item => item.data); function renderSuggestions(filteredData) { suggestionsBox.innerHTML = ''; filteredData.forEach(item => { const suggestionItem = document.createElement('div'); suggestionItem.className = 'suggestion-item'; suggestionItem.textContent = item; suggestionItem.addEventListener('click', function() { inputElement.value = item; suggestionsBox.innerHTML = ''; }); suggestionsBox.appendChild(suggestionItem); }); } inputElement.addEventListener('input', function() { const query = inputElement.value.trim().toLowerCase(); if (query.length === 0) { suggestionsBox.innerHTML = ''; return; } const filteredData = dataList.filter(item => item.toLowerCase().includes(query)); renderSuggestions(filteredData); }); inputElement.addEventListener('focus', function() { renderSuggestions(dataList); }); // بستن پنجره پیشنهادات هنگام کلیک در خارج document.addEventListener('click', function(event) { if (!inputElement.contains(event.target) && !suggestionsBox.contains(event.target)) { suggestionsBox.innerHTML = ''; } }); }
نحوه استفاده:
فرض کنید در HTML موارد زیر دارید:
<input type="text" id="myInput" autocomplete="off" /> <div id="mySuggestions"></div>و دادهها به شکل زیر هستند:
const data = [ { data: 'Apple' }, { data: 'Banana' }, { data: 'Orange' }, { data: 'Mango' }, ];سپس:
setupSuggestionBox_single_select('myInput', 'mySuggestions', data);
ویژگیها و تفاوتها:
- فقط یک مقدار قابل انتخاب است؛ انتخاب جدید مقدار قبلی را جایگزین میکند.
- وقتی کلیک روی پیشنهاد میشود، مقدار input بلافاصله با آن مقدار پر میشود.
- پنجره پیشنهادات هنگام کلیک بیرون بسته میشود.
- هنگام فوکوس، کل دادهها نمایش داده میشوند.
- هنگام تایپ، فقط موارد مطابق عبارت جستجو نمایش داده میشوند.
- دیگر از آرایه انتخابها خبری نیست چون فقط یک مقدار انتخاب میشود.
نکته:
- برای ظاهر بهتر و تعامل راحتتر، میتوانید استایل
.suggestion-itemرا در CSS تعریف کنید. - اگر بخواهید کد را کمی پیچیدهتر کنید (مثلاً امکان انتخاب به صورت کیبورد یا با کلیدهای جهتدار)، میتوانم کمکتان کنم.
اگر نیاز داشتید، بگویید تا بیشتر توضیح دهم یا نمونه کامل HTML+JS+CSS آماده کنم.