A JavaScript library that adds support for typing Unicode Nepali(नेपाली) input on HTML <input> and <textarea> (using both traditional and romanized layouts).
This library has been tested to work most modern browsers, the oldest ones being Internet Explorer 9, 10 and 11. If you are running an even older browser, you might want to look into the legacy version.
Official Demo : https://www.thapaliya.com/en/writings/practice-romanized-nepali-unicode-in-your-browser/
If you've used Nepalify in a project and would like to include it in this list, feel free to reach out or open an issue.
- NID Pre-Enrollment System, Government of Nepal: On the NID New Enrollment Form
- Samajik/सामाजिक: View the source at https://glitch.com/edit/#!/samajik
Nepalify is available in CommonJS2, ES6 as well as UMD formats for all different needs.
It can be consumed directly via Unpkg CDN into your pages, or installed via NPM to include in your application bundle.
Via Unpkg, you can directly use the bare url for the latest version.
<script src="https://unpkg.com/nepalify" />Or, include the full fixed url.
<script src="https://unpkg.com/[email protected]/umd/nepalify.production.min.js" />Also, add an input/textarea element with a unique id, if you want to follow along.
<input id="unique-input" />
<textarea id="unique-textarea"></textarea>Optionally the following attributes can be used on the elements above.
autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"The library is available on NPM as nepalify.
npm install nepalifyAfterwards, you can use CommonJS imports
const nepalify = require('nepalify');Or, you can use ES6 imports
import nepalify from "nepalify";The default exports from the library consists of a handful of functions, as explained below.
This method returns all available layouts, currently romanized and traditional. These layout names can be provided as options to other functions.
console.log(nepalify.availableLayouts());
// ["romanized", "traditional"]This method allows the library code to intercept the keypress events on <input> and <textarea> html elements, given an id selector. This can only be used in a browser.
The argument to this function is the same as you'd provide to the standard getElementById
var inputEl = nepalify.interceptElementById("unique-input-1");
var textareaEl = nepalify.interceptElementById("unique-textarea-1");
// Further options can be provided as a second argument
const options = {
layout: "traditional",
enable: false,
};
nepalify.interceptElementById("unique-input-2", options);
// When the options are not provided, the following defaults are used
const defaultOptions = {
layout: "romanized",
enable: true,
};At this point, the library should already be intercepting the keypresses. Go ahead and give it a try.
The object returned by the function above has more methods that can be used to control the interception.
Returns a boolean value indicating whether the interception is turned on or not.
Enable the interception on the element. Already done by default.
Disable the interception on the element. Useful for clean up or building toggle behaviour.
This method allows you to format the text to Unicode nepali. Also usable in Node or any other non-browser javascript code.
var text = "kiMkr/tv/ybimuX/";
console.log(nepalify.format(text));
// किंकर्तव्यबिमुढ्
// Further options can be provided as a second argument
var text = "asdfghjkl";
const options = {
layout: "traditional",
};
console.log(nepalify.format(text, options));
// बकमानजवपि
// When the options are not provided, the following defaults are used
const defaultOptions = {
layout: "romanized",
};While the library is intended to run in the browser, you'll need to have node (and npm) installed locally for development.
Most of the npm targets are explained in the package.json file itself. The following flow is preferred for contribution.
npm installfor installing all the dependencies.npm run testfor running the test suite.npm run devto run a local server, serves an html page with the library injected for manual testing.npm run formatto format all the changes before making a PR.
Please check the CHANGELOG.md for details.
Please check the contribution graph graph for now.
The legacy version of this package supported ancient browsers such as IE6, used jQuery as a dependency and relied on a bunch of hacks. It's still preserved on the legacy-jquery branch
Copyright © 2020, Suvash Thapaliya
Distributed under the ISC License.