Socket
Socket
Sign inDemoInstall

@inventora/better-dateinput-polyfill

Package Overview
Dependencies
0
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    @inventora/better-dateinput-polyfill

input[type=date] polyfill


Version published
Maintainers
1
Created

Readme

Source

input[type=date] polyfill

NPM version NPM downloads Build Status Coverage Status Twitter

DonateYour help is appreciated. Create a PR, submit a bug or just grab me :beer:

Why another date picker? The problem is that most of existing solutions do not follow standards regarding to value property format, that should have “a valid full-date as defined in [RFC 3339]”. In other words representation of date can vary, but the string value should have yyyy-MM-dd format. It helps to work with such values consistently regarding on the current language.

VIEW DEMO

Features

  • lightweight polyfill with no dependencies
  • works for initial and dynamic content elements
  • normalizes input[type=date] presentation for desktop browsers
  • submitted value always has standards based yyyy-MM-dd [RFC 3339] format
  • placeholder attribute works as expected
  • it's possible to change displayed date value format
  • you are able to control where to apply the polyfill
  • keyboard and accessibility friendly

Installation

$ npm install better-dateinput-polyfill

Then append the following scripts to your page:

<script src="node_modules/better-dateinput-polyfill/dist/better-dateinput-polyfill.js"></script>

Forcing the polyfill

Sometimes it's useful to override browser implemetation with the consistent control implemented by the polyfill. To suppress feature detection you can add <meta name="dateinput-polyfill-media"> into your document <head>. Value of content attribute is a media query where polyfill will be applied:

<!-- force polyfill everywhere -->
<meta name="dateinput-polyfill-media" content="screen">
<!-- force polyfill only on mobile devices in portrait mode-->
<meta name="dateinput-polyfill-media" content="screen and (orientation: portrait)">

Change default date presentation format

When no spicified polyfill uses browser settings to format displayed date. You can override date presentation globally with <meta name="dateinput-polyfill-format"> via content attribute or directly on a HTML element with data-format attribute. Value should be options for the Date#toLocaleString call as a stringified JSON object:

<html>
<head>
    <!-- Override default date presentation format -->
    <meta name="dateinput-polyfill-format" content='{"month":"long","year":"numeric","day":"numeric"}'>
</head>
<body>
    <!-- Override date presentation format on a particular element -->
    <input type="date" data-format='{"month":"short","year":"numeric","day":"numeric"}'>
</body>
</html>

Contributing

Download git repository and install project dependencies:

$ npm install

The project uses set of ES6 transpilers to compile the output file. Now use command below to start development:

$ npm run watch

After any change file build/better-dateinput-polyfill.js is recompiled automatically.

Browser support

Desktop
  • Chrome
  • Safari
  • Firefox
  • Opera
  • Edge
  • Internet Explorer 10+
Mobile
  • iOS Safari 10+
  • Chrome for Android 70+

Keywords

FAQs

Last updated on 08 Jun 2021

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc