PHPackages                             ecommunities/ecms-number-format - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. ecommunities/ecms-number-format

ActiveComponent[Utility & Helpers](/categories/utility)

ecommunities/ecms-number-format
===============================

jQuery plugin for input field number formatting and validation

v0.5.0(11y ago)021MITJavaScript

Since Feb 16Pushed 11y ago1 watchersCompare

[ Source](https://github.com/ecommunities/ecms-number-format)[ Packagist](https://packagist.org/packages/ecommunities/ecms-number-format)[ Docs](https://github.com/ecommunities/ecms-number-format)[ RSS](/packages/ecommunities-ecms-number-format/feed)WikiDiscussions master Synced 6d ago

READMEChangelog (2)Dependencies (1)Versions (7)Used By (0)

ecmsNumberFormat jQuery plugin
==============================

[](#ecmsnumberformat-jquery-plugin)

\#####jQuery Plugin for Input Field Number Formatting MIT license: \[\]

Author: Kevin Farley / eCommunities / \[\]

GitHub: \[\]

This plugin allows you to provide visual validation of a numeric input field (input, number) via addition/removal of classes both during editing, and after leaving the field. In the *standard declaration* below, we demonstrate how you can validate against a variety of criteria without impeding a users ability to enter data in their own way, and then force the field to update to the closest valid value upon losing focus. Criteria currently include: \*\**min*\*\*imum value, \*\**max*\*\*imum value, \*\**dec*\*\*imal precision, and \*\**inc*\*\*rement, but the to-do's include the ability to add additional filters via **Regex** strings, feel free to fork and PR to lend a hand!

### Configuration Parameters

[](#configuration-parameters)

- @param float|null **min** *The minimum value to allow*
- @param float|null **max** *The maximum value to allow*
- @param int **dec** *The number of decimal places to fix the value to*
- @param float **inc** *The increment value to match to*
- @param string **valid** *Class name to be added when value is valid (only while field has focus)*
- @param string **invalid** *Class name to be added when value is invalid (only while field has focus)*

##### Alternate Field Attribute Parameters

[](#alternate-field-attribute-parameters)

*Overrides call time parameters*

- **min** (text|number)
- **max** (text|number)
- **step** (number)

##### Alternate Field Data-Attribute Parameters

[](#alternate-field-data-attribute-parameters)

*Overrides attribute parameters*

- **data-min**
- **data-max**
- **data-dec**
- **data-inc**
- **data-valid**
- **data-invalid**

### Configuration Examples:

[](#configuration-examples)

```
// Defaualt formatting, no decimals, increment by one, no min or max.
var numOpts = {}

// No min or max, fix to two decimals and round to multiples of 0.25.
var numOpts = { dec:2, inc:0.25 };

// Enforce a minimum of 1000 and a maximum of 2000, with no decimals, and increment by one.
var numOpts = { min:1000, max:2000 };

// The kitchen sink.
var numOpts = { min:1000, max:2000, dec:4, inc:0.0025, valid:'valid-class', invalid:'invalid-class' };
```

### Standard Declaration:

[](#standard-declaration)

```
$('#foo').on('keyup paste change', function() { $(this).ecmsNumberValidate(numOpts); });
$('#foo').on('blur', function() { $(this).ecmsNumberFormat(numOpts); }).blur();
```

TO-DO's
-------

[](#to-dos)

- allow precision to be forced in output (i.e. trailing zeros in html5 number field)
- add support for more numerical types (i.e. scientific notation)
- add support for custom match regex queries in addition to standard options
- add support for helpful error messages
- add example html file + test files / cases

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

5

Last Release

4197d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/14225153?v=4)[eCommunities](/maintainers/ecommunities)[@eCommunities](https://github.com/eCommunities)

---

Top Contributors

[![oucil](https://avatars.githubusercontent.com/u/3843802?v=4)](https://github.com/oucil "oucil (38 commits)")

### Embed Badge

![Health badge](/badges/ecommunities-ecms-number-format/health.svg)

```
[![Health](https://phpackages.com/badges/ecommunities-ecms-number-format/health.svg)](https://phpackages.com/packages/ecommunities-ecms-number-format)
```

###  Alternatives

[eternicode/bootstrap-datepicker

A datepicker for Bootstrap

12.7k552.0k6](/packages/eternicode-bootstrap-datepicker)[vakata/jstree

jsTree is jquery plugin, that provides interactive trees.

5.2k1.8M11](/packages/vakata-jstree)[eonasdan/bootstrap-datetimepicker

Date/time picker widget based on twitter bootstrap

7.2k500.2k9](/packages/eonasdan-bootstrap-datetimepicker)[nicolaskruchten/pivottable

Javascript Pivot Table (aka Pivot Grid, Pivot Chart, Cross-Tab) implementation with drag'n'drop.

4.4k223.4k1](/packages/nicolaskruchten-pivottable)[mottie/tablesorter

tablesorter (FORK) is a jQuery plugin for turning a standard HTML table with THEAD and TBODY tags into a sortable table without page refreshes. tablesorter can successfully parse and sort many types of data including linked data in a cell.

2.6k234.4k](/packages/mottie-tablesorter)[components/jqueryui

jQuery UI is a curated set of user interface interactions, effects, widgets, and themes built on top of the jQuery JavaScript Library. Whether you're building highly interactive web applications or you just need to add a date picker to a form control, jQuery UI is the perfect choice.

1775.9M61](/packages/components-jqueryui)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)