• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

ginader/HTML5-placeholder-polyfill: Small and robust polyfill for the HTML5 plac ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称:

ginader/HTML5-placeholder-polyfill

开源软件地址:

https://github.com/ginader/HTML5-placeholder-polyfill

开源编程语言:

JavaScript 64.5%

开源软件介绍:

HTML5 placeholder Polyfill

Lightweight and very robust little jQuery plugin that generates the look and feel of the HTML5 placeholder attribute for browsers without native support. It also adds an extra title in case the placeholder text is too long to be displayed. The polyfill comes with an option to define if the placeholder text should be read to screenreaders or not (on by default). Since version 1.9 the default option is to make it behave like Chrome or mobile Safari (hide placeholder when the users enters content rather than when the fields receives focus).

Demos:

To see the actual work of this polyfill use an old browser like Firefox 3.6!

Dependencies:

Required:

  • jQuery (tested with 1.6.2 but might as well work with older versions)

Optional but recommended:

  • Modernizr (tested with 2.0.6) OR yepnope.js

    • yepnope.js is included with Modernizr by default. Just make sure the setting in the Extras-Block: "Modernizr.load (yepnope.js)" is checked on the Modernizr Download Page
  • fontresize (excellent even though terribly unmaintained event plugin that fires when a user changes the font size of their browser (that usually breaks the other placeholder polyfills))

Optional

Required if hiding the placeholder when user types instead of onfocus (like Chrome or mobile Safari) {hideOnFocus : false}

Highly optional

only needed if you want users to be able to resize textareas:

  • jquery-resize if included a repositioning is triggered when a user resizes a textarea. If not I disable the resizing of textareas to avoid rendering problems

Browser Support

The placeholder attribute has decent support across current Browsers. This script adds support for the older generations including:

  • Internet Explorer < 10
  • Firefox < 4.0
  • Safari < 4.0
  • iOS Safari < 4.0
  • Android Browser < 2.0

For more details on native support see the browser suppport table at caniuse.com.

Installation

You can install HTML5 placeholder Polyfill by using Bower.

bower install html5-placeholder-polyfill

USAGE:

Simply include the Javascript and CSS. The Polyfill will only run when needed.

<head>
	<link rel="stylesheet" href="placeholder_polyfill.min.css">
	<script src="placeholder_polyfill.jquery.min.combo.js" charset="utf-8"></script>
</head>

Please bear in mind that every input needs a linked label in order for the plugin to work.

Using Modernizr, modern browser don't even have to load the polyfill at all.

<script>
Modernizr.load({
    test: Modernizr.input.placeholder,
    nope: [
			'placeholder_polyfill.min.css',
			'placeholder_polyfill.jquery.min.combo.js'
          ]
});
</script>

Using yepnope.js (used as load() in Modernizr), the same as with Modernizr, but with manual feature detection.

<script>
yepnope({
    test: ('placeholder' in $('<input>')[0]),
    nope: [
            'placeholder_polyfill.min.css',
            'placeholder_polyfill.jquery.min.combo.js'
          ]
});
</script>

Configuring the behavior (optional)

<head>
	<link rel="stylesheet" href="placeholder_polyfill.min.css">
	<script>
	placeHolderConfig = {
		// css class that is used to style the placeholder
        	className: 'placeholder',
        // expose the placeholder text to screenreaders or not
            visibleToScreenreaders : true,
        // css class is used to visually hide the placeholder
	        visibleToScreenreadersHideClass : 'placeholder-hide-except-screenreader',
	    // css class used to hide the placeholder for all
            visibleToNoneHideClass : 'placeholder-hide',
        // either hide the placeholder on focus or on type
            hideOnFocus : false,
        // remove this class from a label (to fix hidden labels)
            removeLabelClass : 'visuallyhidden',
        // replace the label above with this class
            hiddenOverrideClass : 'visuallyhidden-with-placeholder',
        // allow the replace of the removeLabelClass with hiddenOverrideClass or not
            forceHiddenOverride : true,
        // apply the polyfill even for browser with native support
            forceApply : false,
        // init automatically or not
        	autoInit : true
	}
	</script>
	<script src="placeholder_polyfill.jquery.min.combo.js" charset="utf-8"></script>
</head>

Customizing the styling (optional)

<head>
	<style>
		/* Example how to style the placeholder itself */
		::-webkit-input-placeholder, /* Chrome/Opera/Safari */
		::-moz-placeholder, /* Firefox 19+ */
		:-ms-input-placeholder, /* IE 10+ */
		:-moz-placeholder, /* Firefox 18- */
		::placeholder, /* standard */
		label .placeholder  /* this polyfill */
		{
		    color:red; /* your awesome style for the the placeholder text */
		}

		/* Example how to style the :placeholder-shown pseudo class so it works with this polyfill: */
		input:placeholder-shown,
		input.placeholder-shown  /* just duplicate the selector and change the :peudo selector to a .class selector */
		{
		    border: 2px solid red /* your awesome style for the input element when the placeholder is visible */
		}
	</style>
</head>

VERSION HISTORY

See the complete Version History here




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap