repository·master·Indexed 27 days ago
https://github.com/guillaumepotier/parsley.jsA powerful JavaScript form validation library (version 2.9.2) that enables developers to implement complex validation logic using HTML5 attributes, minimizing the need for manual JavaScript coding. Requires jQuery >= 1.8 and es5-shim for Internet Explorer 8 support.
Parsley.js is a JavaScript form validation library that allows you to perform validation without writing custom JavaScript code, primarily through HTML5 attributes.
Maintenance Status: The project is considered stable. No new features are planned, and maintenance is minimal, focusing on bug fixes.
The Bootstrap download includes logically grouped assets, providing both compiled and minified variations:
css/: Contains bootstrap.css, bootstrap.min.css, and optional theme files (bootstrap-theme.css, bootstrap-theme.min.css).js/: Contains bootstrap.js and bootstrap.min.js.fonts/: Includes Glyphicons font files (.eot, .svg, .ttf, .woff).es5-shim in your project, as the library source has moved to ECMAScript 6.When upgrading from version 2.1.x to 2.2.0 or higher, note the following architectural changes:
remote and basic versions of Parsley have been merged into a single version that is both remote and promise-aware. This version is lighter than the previous 2.1.x iterations.i18n folder is now located within the dist folder.To set up a development environment and run tests, follow these steps:
gulp globally:npm install -g gulpnpm install
gulp testnpm install -g gulp
npm install
gulp testThe Universal Widget is a simple jQuery plugin used to display collections of objects from a remote API with built-in sorting, filtering, and direction controls.
Requirements:
gh-issues-widget.css stylesheet.To use it, create a div with the class uwidget and initialize it using the .UWidget() method within a jQuery $(document).ready() block.
<html>
<head>
<link href="gh-issues-widget.css" rel="stylesheet">
</head>
<body>
<div class="uwidget" data-width="500px" data-height="300px"></div>
<script type="text/javascript">
$(document).ready(function () {
$('.uwidget').UWidget({
url: 'https://api.url.ext',
handler: function (data) {
// special remote data treatment needed ?
return data;
},
template: 'item_tmpl',
sort: {
enabled: true,
name: 'sort',
values: ['created', 'updated', 'comments'],
labels: ['Creation date', 'Update date', 'Comments']
},
direction: {
enabled: true,
name: 'direction',
values: ['desc', 'asc'],
labels: ['Descending', 'Ascending']
},
filters: {
enabled: true,
name: 'labels',
values: ['bug', 'enhancement'],
labels: ['Bug', 'Enhancement']
}
});
});
</script>
<script type="text/html" id="item_tmpl">
<li>
<span class="gh-issue-comments">
<%= comments %> <%= comments > 1 ? "comments" : "commment" %>
</span>
<span class="gh-issue-title">
<a href="<%= html_url %>"><%= title %></a>
</span>
</li>
</script>
</body>
</html>To use expect.js in a Node.js environment, install it via NPM and require it in your project files.
$ npm install expect.jsvar expect = require('expect.js');Expect.js is compatible with all test frameworks. When an expectation fails, it raises an exception that test runners like Mocha capture and report.
describe('test suite', function () {
it('should expose a function', function () {
expect(add).to.be.a('function');
});
it('should do math', function () {
expect(add(1, 3)).to.equal(4);
});
});To build the dist/ directory and the doc/annotated-source directory, use the following command:
gulp buildUI behaviors and CSS classes have been updated in version 2.0:
.parsley-validated class is no longer added to bound fields.novalidate attribute is now automatically added to <form> elements..parsley-error-list has been renamed to .parsley-errors-list.data-parsley-type-email-message="msg" to data-parsley-type-message="msg".Several validator names and behaviors have changed in version 2.0:
required: Now accepts a false value to become inactive.length: Renamed from rangelength (requirements remain the same).check: Renamed from rangecheck (requirements remain the same).notnull, type="urlstrict", and type="tel" are no longer built-in. Additionally, the types phone, urlstrict, and dateIso have been removed and must be implemented via extra validators.In version 2.0, the remote validator is no longer part of the core bundle; it is now shipped in parsley.remote.js.
Additionally, parsley.extend has been removed. Extra validators are now organized in a directory and can be compiled into a single file using a build script.