+0
日增长
9,779
stars
1,034
forks
9
watchers
282
prs
429
issues
18
releases
README
Picturefill
A responsive image polyfill.
Authors: See Authors.txt
License: MIT
This project is archived and deprecated!
At the time, it helped us transition to responsive image HTML patterns until browsers supported them. Support and fallback strategies are now very good, and this project is no longer needed or recommended. Thanks everyone!
Picturefill has three versions:
Version 1 mimics the Picture element pattern with span elements. It is no longer maintained.
Version 2 is a lightweight polyfill of the Picture element draft specification.
Version 3.0.3 is the current stable release.
Usage, Demos, Docs
To find out how to use Picturefill, visit the project site.
The gotchas
Be it browser issues, the responsive images specifications, or Picturefill itself, there are a couple gotchas you should be aware of when working with Picturefill:
- Firefox 38 and 39 has some bugs [[1]](https://bugzilla.mozilla.org/show_bug.cgi?id=1139560) [[2]](https://bugzilla.mozilla.org/show_bug.cgi?id=1139554) [[3]](https://bugzilla.mozilla.org/show_bug.cgi?id=1135812) where images won't update on screen resize. These issues are addressed by Picturefill 3.0.0, and was fixed in Firefox 41.
- Per the picture spec, using % _isn't_ allowed in the sizes attribute. Using % will fallback to 100vw.
- Trying to use the src attribute in a browser that _doesn't_ support picture natively can result in a double download. To avoid this, don't use the src attribute on the img tag:
html
- If you only want to have an image show up at certain sizes, and not show up at others, you will need to use a transparent placeholder gif:
html
Contributing
For information on how to contribute code to Picturefill, check out CONTRIBUTING.md
Issues
If you find a bug in Picturefill, please add it to the issue tracker
Discussion
Picturefill discussion takes place via Slack. For an invitation, visit https://pf-slackin.herokuapp.com/
Support
There are currently no known unsupported browsers, provided that you use the markup patterns provided.Top issues
Latest release
Picturefill 3.0.3 3.0.3 2017-03-20JavaScript module sizes and how they're ludicrous is a hot topic on the internet these days, eh? Well, we here at Picturefill are not ones to miss out on a good trend. Thanks to @gpittarelli we've reduced the installed size of Picturefill by about 98%. For those of you concerned that this means 98% of your responsive images won't be polyfilled, fear not. We're only being polite to your disk space and not installing a full copy of the examples directory (and various other small fried fish, by comparison) each time you install Picturefill. These examples are, of course, available on the wider