rich-input: فیلد جستجوی پیشرفته با HTML استاندارد
خلاصهٔ کاملتر
rich-input یه وبکامپوننت از Bramus هست که شکل و رفتارش مثل یه معمولیه، ولی برای کوئریهای ساختاریافته پیشنهاد خودکار و هایلایت داخل فیلد اضافه میکنه. منظور کوئریهایی با فیلتر keyword:value، عملگرهای پیشوندی مثل - برای حذف، ترکیبکنندههایی مثل AND و OR و پرانتز برای گروهبندیه. مثلاً (label:"We Play House Recordings" OR year:2026) AND -style:"Acid House".
تنظیماتش کاملاً declarative هست: داخل چندتا میذاری که id هرکدوم اسم کلیدواژهست (مثلاً id="label" میشه label:) و هاش مقدارهای پیشنهادی. عملگرها، ترکیبکنندهها و جداکنندهها هم با attributeهای operators، combinators و delimiters یا از طریق JavaScript تنظیم میشن. حتی میشه داخل یه گذاشت تا کنار پیشنهادها لوگو یا آواتار نشون بده.
قلب کار دو API جدیده. OpaqueRange (یعنی APIای که از Chromium 152 اومده و اجازه میده روی متن داخل و مستقیم range بسازی) با متد createValueRange موقعیت دقیق یه تیکه از متن رو میده. قبلاً برای این کار باید فیلد رو تو یه div مخفی کپی میکردی و اندازه میگرفتی. CSS Custom Highlight API هم اجازه میده اون rangeها رو بدون دست زدن به DOM رنگی کنی:
const range = input.createValueRange(caretPos, caretPos);
const rect = range.getBoundingClientRect();
const valueRange = input.createValueRange(valStart, valEnd);
const highlight = new Highlight(valueRange);
CSS.highlights.set('label', highlight);بعدش هر بخش رو با CSS معمولی استایل میدی، مثل ::highlight(label) برای مقدار label یا ::highlight(rich-input-invalid) که کلیدواژههای نامعتبر رو با زیرخط موجدار نشون میده. پاپاور پیشنهادها هم به شروع range فعال وصل میشه نه به مکاننما، پس موقع تایپ اینور و اونور نمیره.
کامپوننت خودش قابلیتهای مرورگر رو تشخیص میده. تو Safari 17.2 به بعد و Firefox 141 به بعد که OpaqueRange ندارن ولی Highlight API دارن، از یه المان [contenteditable] تکخطی داخل shadow DOM استفاده میکنه تا هایلایت کار کنه. با ElementInternals تو فرمها و FormData شرکت میکنه، با ::part کامل قابل استایله و الگوی combobox استاندارد W3C رو با ARIA 1.2 و ناوبری کیبورد پیاده کرده.
نکات کلیدی:
- کلیدواژهها و گزینهها با و داخل خود HTML تعریف میشن
- OpaqueRange از Chromium 152 در دسترسه و با createValueRange کار میکنه
- تو Safari 17.2+ و Firefox 141+ از یه [contenteditable] جایگزین استفاده میشه
- استایلدهی با ::highlight() برای بخشهای کوئری و ::part() برای اجزای کامپوننت
- از طریق ElementInternals مثل یه فیلد واقعی تو ارسال میشه




