Skip to content

Latest commit

 

History

History
89 lines (71 loc) · 3.38 KB

README.md

File metadata and controls

89 lines (71 loc) · 3.38 KB
Raw

angular-shims-placeholder

Bower version npm version Build Status devDependency Status

Angular directive to emulate the placeholder attribute on text and password input fields for old browsers, such as IE9, IE8, and IE7. Also works on textareas and html5 input types.

This directive works in both directions, which means that changing the value from inside the model is honoured in the form.

In comparison to https://github.com/urish/angular-placeholder-shim, this Angular directive is implementend purely on the AngularJS API and does not depend on other libraries, such as jQuery and jquery-html5-placeholder-shim.

Demo

View Demo

Usage

Include

<script src="angular-shims-placeholder.min.js"></script>

into your application.

Add the module as a dependency to your application module:

angular.module('MyAwesomeApp', [/* other dependencies */, 'ng.shims.placeholder']);

That's it. Now, text fields having an attribute placeholder behave almost as native placeholder fields, even on IE8 and below.

Example:

<input type="text" name="email" placeholder="Enter your email" />

Notes

The class empty is added when the input is empty and the placeholder is showing. Make it look like a placeholder e.g. .empty { color: #a9a9a9; }

If you modify a shimmed input from outside of Angular, trigger the 'change' event to update the placeholder display e.g. elem.triggerHandler('change')

Compatibility

  • Angular 1.0.8 - 1.x
  • IE9, IE8, IE7 * (see known issues)
  • ngModel, ngDisabled, ngReadonly, ngRequired, ngShow, ngHide, ngAttrPlaceholder
  • ngAnimate (Angular 1.3+ only)

Known Issues

  • Angular 1.3 dropped support for IE8, and 1.2 dropped IE7. If you need to support those browsers, use an older version of Angular.
  • Ignores text input from drag and drop
  • Does not support modern-style placeholders that persist until text is entered
  • IE8/9: Disabled textareas show the text insertion cursor on hover. This is due to an IE bug.
  • IE8/9: Clearing a filled input while its text is selected can cause the resulting placeholder text to appear selected
  • No way for an individual input to opt out
  • Not tested with ngSubmit
  • Not tested with ngClass
  • ngAnimate: Password placeholder text pops in after animations complete
  • The unit tests only work with Angular 1.2 and up

Development

  • First, run npm install and bower install to get the required dependencies
  • the source files are in the lib folder
  • grunt build to build the dist files
  • grunt dev to show the demo page and watch for changes
  • grunt test to run unit tests

Authors

Original author: Jacob Rief
Maintained by: Chad von Nau

License

Released under the terms of MIT License.