Permalink
Browse files

Merge pull request #12398 from twbs/deprecate-box-shadow-mixin

mark .box-shadow() mixin as deprecated
  • Loading branch information...
2 parents 1a36e4f + 602e5f8 commit 16fd8cd01e73a4370b4370e42b627554c0b6cbcd @mdo mdo committed Jan 27, 2014
Showing with 6 additions and 1 deletion.
  1. +2 −1 docs/css.html
  2. +4 −0 less/mixins.less
View
@@ -2989,7 +2989,8 @@ <h3 id="less-mixins-rounded-corners">Rounded corners</h3>
{% endhighlight %}
<h3 id="less-mixins-box-shadow">Box (Drop) shadows</h3>
- <p>If your target audience is using the latest and greatest browsers and devices, be sure to just use the <code>box-shadow</code> property on its own. If you need support for older Android (pre-v4) and iOS devices (pre-iOS 5), use the mixin to pick up the required <code>-webkit</code> prefix.</p>
+ <p>If your target audience is using the latest and greatest browsers and devices, be sure to just use the <code>box-shadow</code> property on its own. If you need support for older Android (pre-v4) and iOS devices (pre-iOS 5), use the <strong>deprecated</strong> mixin to pick up the required <code>-webkit</code> prefix.</p>
+ <p>The mixin is <strong>deprecated</strong> as of v3.1.0, since Bootstrap doesn't officially support the outdated platforms that don't support the standard property. To preserve backwards-compatibility, Bootstrap will continue to use the mixin internally until Bootstrap v4.</p>
<p>Be sure to use <code>rgba()</code> colors in your box shadows so they blend as seamlessly as possible with backgrounds.</p>
{% highlight css %}
.box-shadow(@shadow: 0 1px 3px rgba(0,0,0,.25)) {
View
@@ -115,6 +115,10 @@
}
// Drop shadows
+//
+// Note: Deprecated `.box-shadow()` as of v3.1.0 since all of Bootstrap's
+// supported browsers that have box shadow capabilities now support the
+// standard `box-shadow` property.
.box-shadow(@shadow) {
-webkit-box-shadow: @shadow; // iOS <4.3 & Android <4.1
box-shadow: @shadow;

0 comments on commit 16fd8cd

Please sign in to comment.