API عمومی

یک نمونه Manager با مجموعه ای از شناسایی کننده های پیش فرض ایجاد می کند و نمونه مدیر را برمی گرداند. مجموعه پیش فرض شامل نمونه های تشخیص دهنده ضربه زدن، دوبار ضربه زدن، حرکت دادن، کشیدن انگشت، فشار دادن، نزدیک کردن و چرخش است.

فقط زمانی باید از آن استفاده کنید که با تنظیمات پیش فرض مشکلی نداشته باشید یا تنظیمات اولیه خود را تنظیم کرده باشید.

سازنده (HTMLElement، [گزینه ها])

فقط عنصر و گزینه های شما. گزینه ها با Hammer. defaults ادغام خواهند شد. همچنین، مجموعه شناسایی همانطور که در Hammer. defaults. preset تعریف شده است اضافه خواهد شد.

اگر یک گزینه شناسایی خالی را پاس کنید، هیچ شناسنده اولیه اضافه نخواهد شد.

Hammer. defaults

پیش فرض ها هنگام ایجاد یک نمونه که با گزینه های شما ادغام می شوند.

touchAction: "محاسبه"

مقادیر compute، auto، pan-y، pan-x و none را می پذیرد. گزینه پیش فرض بر اساس شناسه ها، مقدار صحیح را برای شما انتخاب می کند.

domEvents: نادرست

اجازه دهید Hammer نیز رویدادهای DOM را فعال کند. این کمی کندتر است، بنابراین به طور پیش فرض غیرفعال است. اگر می خواهید با نمایندگی رویداد بازی کنید، توصیه می شود روی true تنظیم شود.

فعال کردن: درست است

یک بولی یا تابعی را می پذیرد که باید یک بولی را برگرداند.

cssProps:

مجموعه ای از ویژگی های css که مدیریت رویدادهای ورودی را بهبود می بخشد. برای جزئیات بیشتر به JSDoc نگاهی بیندازید.

از پیش تعیین شده: [….]

تنظیم پیش فرض شناساگر هنگام فراخوانی Hammer() . هنگام ایجاد یک مدیر جدید، از این موارد صرفنظر می شود.

به طور پیش فرض مجموعه ای از ضربه زدن، دوبار ضربه زدن، فشار دادن، حرکت افقی و کشیدن انگشت، و تشخیص دهنده های چندلمسی و چرخش را اضافه می کند. تشخیص دهنده های pinch and rotate به طور پیش فرض غیرفعال هستند زیرا باعث مسدود شدن عنصر می شوند.

چکش. مدیر

Manager محفظه تمام نمونه های شناسایی کننده برای عنصر شما است. شنونده های رویداد ورودی را تنظیم می کند و ویژگی لمسی-عملی را برای شما در عنصر تنظیم می کند.

سازنده (HTMLElement، [گزینه ها])

فقط عنصر و گزینه های شما. گزینه ها با Hammer. defaults ادغام خواهند شد.

می توانید یک مجموعه شناسایی اولیه را با شناسه های گزینه تنظیم کنید. آرایه باید به این شکل باشد.

مجموعه (گزینه ها)

گزینه ای را در نمونه مدیر تغییر دهید. استفاده از این روش توصیه می شود، زیرا در صورت نیاز مقدار touchAction را به روز می کند.

دریافت (رشته)، افزودن (تشخیص دهنده) و حذف (تشخیص دهنده)

یک نمونه Recognizer جدید به Manager اضافه کنید. ترتیب افزودن نیز دستور شناسایی کننده های در حال اجرا است. درست مانند متد get، نمونه Recognizer اضافه شده را برمی گرداند. متدهای get و remove نام رویداد (از یک شناساگر) یا یک نمونه شناساگر را به عنوان آرگومان می گیرد.

افزودن و حذف ، همچنین مجموعه ای از شناسه ها را بپذیرید.

در (رویدادها ، کنترل کننده) و . off (رویدادها ، [کنترل کننده])

به وقایع ناشی از شناسایی کنندگان اضافه شده گوش دهید ، یا وقایع دو طرفه را حذف کنید. چندین رویداد جدا شده توسط یک فضا را می پذیرد.

توقف ([نیروی])

تشخیص جلسه ورودی فعلی را متوقف کنید. هنگامی که مجبور شوید ، چرخه تشخیص دهنده بلافاصله متوقف می شود.

از بین رفتن()

همه رویدادها و رویدادهای ورودی را خنثی می کند و مدیر را غیرقابل استفاده می کند. این هیچ شنونده گنبدی را از بین نمی برد.

چکش.

هر تشخیص دهنده از این کلاس گسترش می یابد. همه تشخیص دهندگان همچنین گزینه ای را دارند که یک مقدار بولی یا عملکرد پاسخ به تماس است تا بتواند تشخیص دهنده را در پرواز فعال یا غیرفعال کند.

سازنده ([گزینه ها])

فقط گزینه ها را تنظیم کنید.

مجموعه (گزینه ها)

گزینه را در نمونه تشخیص تغییر دهید. با استفاده از این روش توصیه می شود ، زیرا در صورت لزوم مقدار TouchAction را به روز می کند.

به رسمیت شناختن با (OtherRecognizer) و DroprecocializeWith (OtherRecognizer)

تشخیص دهنده را همزمان با تشخیص دهنده دیگر ، در هر دو جهت اجرا کنید. این مانند ترکیب یک تابه با کشش در انتها یا یک خرج کردن با امکان چرخش هدف نیز قابل استفاده است. رها کردن اتصال فقط پیوند را بر روی تشخیص دهنده حذف می کند ، نه در تشخیص دهنده دیگر. هر دو مجموعه ای از شناسه ها را می پذیرند.

اگر تشخیص دهنده به یک مدیر اضافه شود ، این روش همچنین نام رویداد تشخیص دهنده دیگر را به عنوان یک رشته می پذیرد.

neadFailure (OtherRecognizer) و DroprequireFailure (OtherRecognizer)

تشخیص دهنده را فقط در صورت عدم موفقیت تشخیص دهنده دیگر اجرا کنید. رها کردن اتصال فقط پیوند را بر روی تشخیص دهنده حذف می کند ، نه در تشخیص دهنده دیگر. هر دو مجموعه ای از شناسه ها را می پذیرند.

اگر تشخیص دهنده به یک مدیر اضافه شود ، این روش همچنین نام رویداد تشخیص دهنده دیگر را به عنوان یک رشته می پذیرد.

Hammer. Input Event

یک رویداد مخفی توسط Hammer ، Hammer. input در حال انجام است. این در هر ورودی دریافتی منتشر می شود و شما را با ورودی خام به مواردی امکان می دهد. ویژگی کوچک ، اما قدرتمند.

موضوع حادثه

تمام رویدادهایی که چکش باعث می شود همه یک شیء رویداد حاوی خصوصیات زیر را دریافت کنند.

ثابت

تمام ثابت ها در شیء چکش تعریف می شوند. از آنجا که پرچم های باینری است ، می توانید از اپراتورهای Bitwise روی آن استفاده کنید. MDN در این باره مستندات بسیار خوبی دارد.

جهت ها

مورد استفاده برای تنظیم جهت یک شناسایی کننده و برای خواندن مقدار یک رویداد.

رویدادهای ورودی

چکش انواع ورودی (Mousedown ، Mousemove ، TouchMove ، Pointercancel) را به این ثابت ها نقشه می کند.

اعلامیه دهنده

در داخل توسط شناسه کنندگان برای تعریف وضعیت آن استفاده می شود.

سود

Hammer. on (عنصر ، انواع ، کنترل کننده)

بسته بندی در اطراف AddEventListener که انواع مختلفی از رویداد را می پذیرد.

Hammer. off (عنصر ، انواع ، کنترل کننده)

مانند Hammer. on ، این یک بسته بندی در اطراف removeventlistener است که انواع مختلفی را می پذیرد.

Hammer. each (OBJ ، Handler)

یک آرایه یا خصوصیات خود یک شی را تکرار کنید.

Hammer. merge (OBJ1 ، OBJ2)

خواص OBJ2 را به OBJ1 ادغام کنید. خواص رونویسی نمی شوند.

Hammer. extend (OBJ1 ، OBJ2)

OBJ1 را با خواص OBJ2 گسترش دهید. خواص رونویسی می شوند.