کتابخانه
@floating-ui/utils یه بسته npm کمکی از خانواده Floating UI هست که توابع و تایپ های مشترک بین بسته های این کتابخونه رو یه جا نگه می داره. تولتیپ، پاپ آور و منوی کشویی که با Floating UI ساخته می شن، پشت صحنه از همین پایه استفاده می کنن و معمولا لازم نیست مستقیم سراغش بری.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۵۳ کیلوبایت · ۱۳ فایل · انتشار
دانلود هفتگی جهانی
۱۲۵٫۳ میلیون
هفته ۲۵ مهر تا ۱ آبان۱٫۴٪ بیشتر از هفته قبل
منبع: npmبه‌روزرسانی آمار
SHA-256: 83c4c07e8bbeb76cc2f184401d01f9beb5263f4499df9b3ef6bf467eb6b0fb41
Floating UI یه کتابخونه برای جا دادن عنصرهای شناور کنار یه عنصر مرجع هست، مثل تولتیپ، پاپ آور، منوی کشویی و لیست انتخاب. @floating-ui/utils بخش مشترک این خانواده هست. توضیح رسمی خودش فقط می گه «Utilities for Floating UI»، یعنی ابزارهای کمکی برای Floating UI. بسته های دیگه مثل core و dom روش تکیه می کنن تا هر کدوم مجبور نباشن یه کد رو از نو بنویسن.
محتوایش از جنس ابزارهای کوچیک و پایه ای هست. چند تابع برای کار با جهت و هم ترازی (مثل بالا، پایین، شروع و پایان)، چند تابع عددی ساده، تایپ هایی برای مختصات و مستطیل ها، و یه ورودی جدا برای کار با DOM که کمکت می کنه نوع عنصرها رو تشخیص بدی یا والدها و عنصرهای اسکرول دار رو پیدا کنی. اگه می خوای دقیق بدونی چه توابعی داره، فهرست export های خود بسته رو ببین و از حافظه کار نکن.
این بسته به تنهایی چیزی رو روی صفحه جابه جا نمی کنه. اگه فقط می خوای یه تولتیپ یا منو کنار دکمه بیاد، سراغ @floating-ui/dom یا نسخه مخصوص فریم ورکت برو. utils وقتی به کارت میاد که داری افزونه یا میدل ور (middleware) اختصاصی برای Floating UI می نویسی، یا می خوای همون تابع های کمکی رو توی پروژه خودت هم استفاده کنی. اگه اسمش رو توی node_modules پروژه ات دیدی هم نگران نباش. فقط یه وابستگی هست که با بسته اصلی نصب شده.
برای سایت های ایرانی یه نکته عملی هم داره. وقتی اینترنت بین الملل قطع یا کند می شه، نصب npm معمولا سر همین وابستگی های ریز گیر می کنه. بسته اصلی دانلود می شه، ولی یکی از زیرمجموعه هاش نه، و بیلد خطا می ده. پس بسته های Floating UI رو هماهنگ نگه دار و نسخه هاشون رو قاطی نکن، چون اعضای این خانواده با هم جلو می رن. مجوزش MIT هست که معمولا استفاده شخصی و تجاری رو آزاد می ذاره، ولی متن مجوز همراه بسته رو هم یه بار نگاه کن. نسخه های رسمی و بدون تغییرش رو توی مخزن داخلی ما هم می تونی پیدا کنی.
اگه با ابزار بیلد مثل Vite یا webpack کار می کنی، ساده ترین راه نصب با npm یا yarn هست. معمولا لازم نیست جدا نصبش کنی، چون با @floating-ui/dom یا @floating-ui/react خودش میاد. فقط وقتی می خوای مستقیم ازش import کنی، اسم بسته رو توی وابستگی های پروژه ات هم بنویس.
اگه بیلد نداری و می خوای توی یه صفحه معمولی یا قالب وردپرس استفاده کنی، از کد آماده پایین همین صفحه کمک بگیر. مراحل کلی اینه:
اگه فقط برای تولتیپ یا پاپ آور اومدی، به جای این بسته مستقیم سراغ @floating-ui/dom برو. وابستگی ها رو خودش میاره.
یه بسته کمکی از خانواده Floating UI هست که توابع و تایپ های مشترک بین بسته های اصلی رو نگه می داره. خودش تولتیپ یا منو نمی سازه و چیزی رو روی صفحه نشون نمی ده. بیشتر به درد کسایی می خوره که روی Floating UI چیز اختصاصی می نویسن یا می خوان از همون ابزارهای پایه توی پروژه شون استفاده کنن.
معمولا نه. برای تولتیپ و پاپ آور، بسته @floating-ui/dom یا نسخه فریم ورک خودت، مثل react، کافیه. utils به عنوان وابستگی همراهشون نصب می شه. فقط اگه مستقیم ازش import می کنی، بهتره اسمش رو هم توی وابستگی های پروژه بنویسی تا به نصب غیرمستقیم تکیه نکرده باشی.
فقط جاوااسکریپته. این بسته استایلی به صفحه اضافه نمی کنه و ظاهر تولتیپ یا منو رو خودت با CSS خودت می سازی. کارش محاسبه و کارهای کمکیه که بقیه بسته های Floating UI بهش نیاز دارن، مثل مختصات، هم ترازی و پیدا کردن والد اسکرول دار.
اول مطمئن شو مشکل از دسترسی به رجیستری npm نیست. وقتی اینترنت بین الملل ضعیفه، وابستگی های ریز مثل همین بسته راحت جا می مونن. بعدش چک کن بسته های Floating UI با هم هماهنگ باشن. اگه باز هم گیر کرد، node_modules رو پاک کن و دوباره نصب کن.
مجوزش MIT هست که معمولا استفاده شخصی و تجاری رو اجازه می ده، به شرطی که اعلان مجوز و کپی رایت رو حفظ کنی. اگه پروژه حساسی داری، متن مجوز همراه خود بسته رو یه بار بخون و مجوز بقیه وابستگی هات رو هم چک کن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.