simple-keyboard/README.md

89 lines
3.3 KiB
Markdown
Raw Normal View History

2019-08-13 01:19:13 -04:00
<p>
<a href="https://simple-keyboard.com/demo">
2021-03-21 14:25:13 -04:00
<img alt="simple-keyboard: Javascript Virtual Keyboard" src="https://i.imgur.com/PrpbdIu.png">
2019-08-13 01:19:13 -04:00
</a>
2019-08-26 23:20:28 -04:00
2019-08-13 01:19:13 -04:00
<a href="https://www.npmjs.com/package/simple-keyboard">
<img src="https://badgen.net/npm/v/simple-keyboard?color=blue" alt="npm version">
</a>
2021-10-20 19:49:00 -07:00
2021-10-20 23:55:00 -07:00
<a href="https://github.com/hodgef/simple-keyboard/blob/master/LICENSE">
<img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT license">
2021-10-20 19:49:00 -07:00
</a>
2019-08-13 01:19:13 -04:00
2019-10-13 12:03:48 -04:00
<a href="https://github.com/hodgef/simple-keyboard/actions">
2021-10-21 00:10:05 -07:00
<img alt="Build Status" src="https://github.com/hodgef/simple-keyboard/workflows/Build/badge.svg" />
2019-10-13 12:03:48 -04:00
</a>
<a href="https://github.com/hodgef/simple-keyboard/actions">
2021-10-21 00:10:05 -07:00
<img alt="Publish Status" src="https://github.com/hodgef/simple-keyboard/workflows/Publish/badge.svg" />
</a>
<a href="https://gitlab.com/hodgef/simple-keyboard" target="_blank">
<img alt="Mirroring" src="https://github.com/hodgef/simple-keyboard/actions/workflows/mirroring.yml/badge.svg" />
2019-08-13 01:19:13 -04:00
</a>
</p>
2018-04-20 16:34:02 -04:00
2021-03-18 22:43:29 -04:00
<blockquote>Virtual Keyboard for Javascript. Compatible with your JS, React, Angular or Vue projects.</blockquote>
2019-08-13 11:14:44 -04:00
2021-03-26 11:42:11 -04:00
## 🚀 Demo
2021-03-16 00:41:42 -04:00
2019-08-13 01:28:28 -04:00
[Demo Showcase (Vanilla, Angular, React, Vue)](https://simple-keyboard.com/demo)
2021-03-26 11:42:11 -04:00
## 📦 Installation & Usage
2021-03-16 00:41:42 -04:00
2018-10-20 14:37:06 -04:00
You can use simple-keyboard as a `<script>` tag from a CDN, or install it from npm.
2021-03-16 00:41:42 -04:00
2018-10-20 14:47:31 -04:00
Check out the [Getting Started](https://simple-keyboard.com/getting-started) docs to begin.
2018-04-20 16:34:02 -04:00
2021-03-26 11:42:11 -04:00
## 📖 Documentation
2021-03-16 00:41:42 -04:00
2018-10-20 14:47:31 -04:00
Check out the [simple-keyboard documentation](https://simple-keyboard.com/documentation) site.
2018-04-24 09:38:14 -04:00
2019-11-03 20:26:45 -05:00
Feel free to browse the [Questions & Answers (FAQ)](https://simple-keyboard.com/qa-use-cases/) page for common use-cases.
2018-09-24 15:52:54 -04:00
2018-04-20 16:34:02 -04:00
### To run demo on your own computer
2021-03-16 00:41:42 -04:00
- Clone this repository
- `npm install`
- `npm start`
- Visit [http://localhost:3000/](http://localhost:3000/)
2018-04-20 16:34:02 -04:00
2018-06-08 10:59:11 -04:00
### Other versions
2018-04-20 16:34:02 -04:00
2021-03-16 00:41:42 -04:00
- [React.js](https://github.com/hodgef/react-simple-keyboard)
- [Angular](https://simple-keyboard.com/demo)
- [Vue.js](https://simple-keyboard.com/demo)
2018-06-08 10:59:11 -04:00
2020-05-28 01:12:00 -04:00
### Questions? Join the chat
2018-10-08 19:12:51 -04:00
2020-06-13 15:38:34 -04:00
<a href="https://discordapp.com/invite/SJexsCG" title="Join our Discord chat" target="_blank"><img src="https://discordapp.com/api/guilds/498978399801573396/widget.png?style=banner2" align="center"></a>
2018-10-08 19:12:51 -04:00
2021-03-26 11:42:11 -04:00
## ✳️ Modules
2019-10-15 17:00:15 -04:00
2020-05-28 01:10:55 -04:00
You can extend simple-keyboard's functionality with [modules](https://hodgef.com/simple-keyboard/modules/). Such as:
2019-10-15 17:00:15 -04:00
2021-03-16 00:41:42 -04:00
- [Autocorrect](https://hodgef.com/simple-keyboard/modules/autocorrect/)
- [Input Mask](https://hodgef.com/simple-keyboard/modules/input-mask/)
- [Key Navigation](https://hodgef.com/simple-keyboard/modules/key-navigation/)
- [Swipe Keyboard](https://hodgef.com/simple-keyboard/modules/swipe-keyboard/)
2019-10-15 17:00:15 -04:00
2020-05-28 01:10:55 -04:00
Want to create your own module? Check out the [Modules page](https://hodgef.com/simple-keyboard/modules/) for instructions.
2019-10-15 17:00:15 -04:00
2021-03-26 11:42:11 -04:00
## 🎯 Compatibility
2021-03-18 00:11:23 -04:00
2021-03-16 00:41:42 -04:00
- Internet Explorer 11
- Edge (Spartan) 16+
- Edge (Anaheim/Edge Chromium) 79+
- Chrome 49+
- Safari 9+
- Firefox 57+
- iOS 9+
2019-09-25 11:34:23 -04:00
2021-10-13 01:52:09 -07:00
> Note: If you don't want to support old browsers, you can use the Modern Browsers bundle ([index.modern.js](https://github.com/hodgef/simple-keyboard/blob/master/build)).
2021-10-12 21:40:31 -07:00
2021-03-26 11:42:11 -04:00
## ✅ Contributing
2019-09-25 11:41:12 -04:00
2020-08-26 00:54:56 -04:00
PRs and issues are always welcome. Feel free to submit any issues you have at:
2019-09-25 11:41:12 -04:00
[https://github.com/hodgef/simple-keyboard/issues](https://github.com/hodgef/simple-keyboard/issues)