https://github.com/maulingmonkey/mmk.lastinputtype
Basic typescript API for tracking the type of input device last used.
https://github.com/maulingmonkey/mmk.lastinputtype
gamepad input keyboard mouse stylus touch typescript ui
Last synced: about 2 months ago
JSON representation
Basic typescript API for tracking the type of input device last used.
- Host: GitHub
- URL: https://github.com/maulingmonkey/mmk.lastinputtype
- Owner: MaulingMonkey
- License: apache-2.0
- Created: 2017-04-22T18:45:20.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2017-04-24T01:11:07.000Z (about 8 years ago)
- Last Synced: 2025-01-22T21:22:50.617Z (3 months ago)
- Topics: gamepad, input, keyboard, mouse, stylus, touch, typescript, ui
- Language: TypeScript
- Homepage:
- Size: 21.5 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# mmk.lastinputtype
MaulingMonKey's basic API for tracking the type of input device last used.
Defines classes directly on the body, allowing fancy CSS transitions of your choice with no other configuration.
Alternatively, `mmk.lastinputtype.id === mmk.lastinputtype.Keyboard` is provided for a programatic option.
Set/define `mmk.lastinputtype.config.trackXYZ = false` to disable input types you don't care about.
License: [Apache 2.0](LICENSE.txt)
# [Example](http://maulingmonkey.com/mmk.lastinputtype/mmk.lastinputtype/)
[mmk.lastinputtype.css](mmk.lastinputtype/res/mmk.lastinputtype.css)
```css
/* ... */
.mmk-lastinputtype-keyboard .highlight-keyboard { color: #FFF; background: #48F; }
.mmk-lastinputtype-mouse .highlight-mouse { color: #FFF; background: #48F; }
.mmk-lastinputtype-stylus .highlight-stylus { color: #FFF; background: #48F; }
.mmk-lastinputtype-touch .highlight-touch { color: #FFF; background: #48F; }
.mmk-lastinputtype-gamepad-xbox .highlight-gamepad-xbox { color: #FFF; background: #48F; }
.mmk-lastinputtype-gamepad-sony .highlight-gamepad-sony { color: #FFF; background: #48F; }
.mmk-lastinputtype-gamepad-standard .highlight-gamepad-standard { color: #FFF; background: #48F; }
.mmk-lastinputtype-controller .highlight-controller { color: #FFF; background: #48F; }
```
[index.html](mmk.lastinputtype/index.html)
```html
Last Input Type
Keyboard
Mouse
Stylus
Touch
Xbox Gamepad
Sony Gamepad (NYI)
"Standard" Gamepad
Nonstandard Controller
```
Live demo: [Example](http://maulingmonkey.com/mmk.lastinputtype/mmk.lastinputtype/)
See also: [HTML5 Gamepad Tester](http://html5gamepad.com/)
# Compatability / Testing
| Browser | Status | Notes |
| --------- | -------- | ----------------------------------------- |
| Chrome 75 | OK | |
| IE 11 | OK | No gamepad API/support |
| ... | Untested | Should work if addEventListener available |
| Input Type | CSS Class | Status |
| ------------------- | ----------------------------------- | ----------------------------------------------------- |
| Keyboard | .mmk-lastinputtype-keyboard | OK |
| Mouse | .mmk-lastinputtype-mouse | OK |
| Stylus [2] | .mmk-lastinputtype-stylus | Untested |
| Touch | .mmk-lastinputtype-touch | Untested |
| GamepadXbox [1] | .mmk-lastinputtype-gamepad-xbox | OK |
| GamepadSony [1] | .mmk-lastinputtype-gamepad-sony | Partial (DS4 works, DS3 may work with dongle/drivers) |
| GamepadStandard [1] | .mmk-lastinputtype-gamepad-standard | OK |
| Controller [1] | .mmk-lastinputtype-controller | OK |
[1] Requires browser support for the gamepad API
[2] Requires browser support for pointer events
| Controller | Status |
| ------------------------- | ------------------------------------------------- |
| Xbox 360 Wired Controller | Verified OK |
| Xbox One Controllers | Verified OK |
| DualShock 4 (Dongle) | Verified OK |
| DualShock 4 (Micro-usb) | Verified OK |
| DualShock 3 (*) | Broken (GamepadSony) [3] |
| ... | NYI (GamepadStandard?) |
| ... | NYI (Controller) |
[3] While Windows 7 recognizes the gamepad without 3rd party drivers, buttons/axes don't respond. I assume I either need to pair with a bluetooth dongle, unpair it from my PS3, or install 3rd party drivers. Or it might just be a broken controller.
# TODO
* Sony / dualshock controller support **Partial support**
* Add an activity detector that makes no assumptions about controller deadzones (will require more state tracking)
* Leverage https://github.com/gabomdq/SDL_GameControllerDB ? No javascript gamepad ids though.
* Add options to disable minor mouse motion and other "false" positives for last input switching
* Publish nuget package
# Installation
## Via NuGet
* Add [mmk.lastinputtype](https://www.nuget.org/packages/mmk.lastinputtype/) to your project via nuget. **Soon(tm)**
* Add `` to your HTML **TODO: determine where this actually ends up**
* Profit