hilios/jQuery.countdown
Fork: 719 Star: 2305 (更新于 2024-12-19 14:20:10)
license: MIT
Language: JavaScript .
The Final Countdown plugin for jQuery
最后发布版本: 2.2.0 ( 2016-08-08 20:23:54)
The Final Countdown
A simple and html agnostic date countdown plugin for jQuery
To get started, check-it out: http://hilios.github.io/jQuery.countdown/
The ultimate countdown plugin designed to fit in any coupon, auction site or product launch. Read our Documentation and follow our Examples to see what suits your particular needs.
Download
Click here to download the latest version
If you want to clone the repo always use the files under dist folder, they are optimized for production and development.
Install via Bower
bower install jquery.countdown
Add a script
to your html:
<script src="/bower_components/jquery.countdown/dist/jquery.countdown.js"></script>
Install via NPM
npm install --save jquery-countdown
Require the script:
require('jquery-countdown');
Getting started
<div id="getting-started"></div>
<script type="text/javascript">
$('#getting-started').countdown('2015/01/01', function(event) {
$(this).html(event.strftime('%w weeks %d days %H:%M:%S'));
});
</script>
Requirements
Since version 2.0.0 we only support jQuery above 1.7 (including 2.x and 3.x). For legacy 1.6 support please use the version 1.0.2.
Documentation
Our documentation is powered by Jekyll (see gh-page
branch) and hosted in GitHub Pages at http://hilios.github.io/jQuery.countdown/.
Examples
There are few ways to get started, from the most simple example to advanced, we support many different countdown styles, see wich one fits your scenario, and if anyone doesn't it's a good starting point to customize your output.
- Basic coupon site with format N days hr:min:sec
- Advance coupon with conditionals and pluralization, format N weeks N days hr:min:sec
- Product launch in... (callback style)
- New year's eve (legacy style)
- Multiple instances on the same page
- Calculate the countdown total hours
Release notes
Current version is 2.2.0, to follow our change log please visit the release notes.
What's new in 2.2.0?
- Total count for hours
%I
, minutes%N
and seconds%T
; - Count to weeks left to complete a month
%W
; - Deferred initialization, allows to control the exact start moment;
- Fix pluralization bug when return is zero;
What's new in 2.1.0?
- Add proper offset for days left to a month and to a week;
- Fix bower amd install;
Contributing
The Final Countdown uses Grunt and Bower with convenient methods for developing the plugin. It's how we compile our code and run tests. To get started install NodeJS, Bower, and then run some Grunt/Bower commands.
bower install
npm install
grunt test # Lint code and run test suite
grunt build # Generate the release files (dev, min and zip)
grunt # Watch for updates than test and build
This plugin is tested with QUnit, under jQuery 1.7 up to 3.1, Bootstrap 3.0 and RequireJS.
The functional tests made against:
- Chrome >= 12
- Safari >= 5
- Firefox >= 5.0
- IE 7/8/9
Code coverage:
---------------|----------|----------|----------|----------|----------------|
File | % Stmts | % Branch | % Funcs | % Lines |Uncovered Lines |
---------------|----------|----------|----------|----------|----------------|
src/ | 98.4 | 90.63 | 100 | 98.4 | |
countdown.js | 98.4 | 90.63 | 100 | 98.4 | 6,283 |
---------------|----------|----------|----------|----------|----------------|
All files | 98.4 | 90.63 | 100 | 98.4 | |
---------------|----------|----------|----------|----------|----------------|
Contributors
Thanks for bug reporting and fixes:
- Daniel Leavitt (@dleavitt)
- Fagner Brack (@FagnerMartinsBrack)
- Matthew Sigley (@msigley)
- Roman Shterenzon (@romanbsd)
- Marios (@assiotis)
- Zane Yao (@yaoazhen)
- Ricardo Calvo (@ricardocalvo)
- Daniel Z. (@nietonfir)
License
Copyright (c) 2011-2015 Edson Hilios. This is a free software is licensed under the MIT License.
- Edson Hilios. Mail me: edson (at) hilios (dot) com (dot) br
最近版本更新:(数据更新于 2024-10-11 09:45:48)
2016-08-08 20:23:54 2.2.0
2015-08-15 00:14:48 2.1.0
2015-07-25 03:29:35 2.0.5
2014-06-04 02:20:34 2.0.4
2014-05-22 21:35:44 2.0.3
2013-12-17 00:59:55 1.0.2
2013-12-13 06:44:23 2.0.0
2013-12-13 06:39:57 2.0.1
2013-12-13 06:46:50 2.0.2
hilios/jQuery.countdown同语言 JavaScript最近更新仓库
2024-12-22 13:19:55 gethomepage/homepage
2024-12-22 11:34:40 chris81605/Degrees-of-Lewdity_Cheat_Extended
2024-12-22 00:44:14 gorhill/uBlock
2024-12-21 12:14:02 layui/layui
2024-12-21 03:44:01 emberjs/ember.js
2024-12-20 02:57:09 nodejs/node