/pie-rails

Progressive Internet Explorer (PIE) ready for use with Rails asset pipeline

Primary LanguageRubyMIT LicenseMIT

pie-rails

See Progressive Internet Explorer

PIE currently has full or partial support for the following CSS3 features:

  • border-radius
  • box-shadow
  • border-image
  • multiple background images
  • linear-gradient as background image

Other features such as radial gradients, multiple box shadows, and many many bugfixes are under development.

Install

gem 'pie-rails'

bundle and use...

Config

In stylesheet:

#myElement {
    background: #EEE;
    padding: 2em;
    -moz-border-radius: 1em;
    -webkit-border-radius: 1em;
    border-radius: 1em;
    behavior: url(/assets/PIE.htc);
}

See [PIE repo](git://github.com/lojjic/PIE.git) for more usage guides, demos etc.

Note: A `PIE.js` file is also included

## IE7, IE8, IE9

See [github repo](https://github.com/roylory/ie7-js) and [original](http://code.google.com/p/ie7-js/)

IE7.js is a JavaScript library to make Microsoft Internet Explorer behave like a standards-compliant browser. It fixes many HTML and CSS issues and makes transparent PNG work correctly under IE5 and IE6.

Use any of the following (not required if you are using PIE.htc in your CSS classes):

```html
<!--[if lt IE 7]>
<script src="/assets/IE7.js"></script>
<![endif]-->

<!--[if lt IE 8]>
<script src="/assets/IE8.js"></script>
<![endif]-->

<!--[if lt IE 8]>
<script src="/assets/IE9.js"></script>
<![endif]-->

Transparent PNGs

The script only fixes images named: `*-trans.png

If you want the fix to apply to all PNG images then set a global variable as follows:

<script src="/assets/IE8.js">IE7_PNG_SUFFIX=".png";</script>

Box-sizing

A HTC file to enable Box sizing for IE 6 & 7 is also included:

#myElement {
  behavior: url(/assets/boxsizing.htc);
}

Textshadow

The textshadow jquery plugin

Install

//= require jquery.textshadow.min

Usage

The plugin itself offers two functions: textShadow(); and removeTextShadow();, which do what you expect them to do.

textShadow(); Allows you to optionally overwrite the text-shadow declaration from your CSS to tweak the look of the text-shadow in Internet Explorer, if needed. The available options look like this:

$(elem).textShadow({
  color:   "#000",
  xoffset: "5px",
  yoffset: "5px",
  radius:  "5px",
  opacity: "50"
});

Text-overflow

The text-overflow jquery plugin

Install

//= require jquery.text-overflow.min

Usage

$('h1').textOverflow();

See examples for a good usage guide, including options supported.

Contributing to pie-rails

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
  • Fork the project.
  • Start a feature/bugfix branch.
  • Commit and push until you are happy with your contribution.
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

Copyright

Copyright (c) 2012 Kristian Mandrup. See LICENSE.txt for further details.