Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support for fractional viewport widths (zoom/high-dpi displays) #24299

Merged
merged 9 commits into from
Nov 20, 2017
3 changes: 3 additions & 0 deletions _includes/callout-info-mediaqueries-breakpoints.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{% callout info %}
Note that since browsers do not currently support [range context queries](https://www.w3.org/TR/mediaqueries-4/#range-context), we work around the limitations of [`min-` and `max-` prefixes](https://www.w3.org/TR/mediaqueries-4/#mq-min-max) and viewports with fractional widths (which can occur under certain conditions on high-dpi devices, for instance) by using values with higher precision for these comparisons.
{% endcallout %}
4 changes: 4 additions & 0 deletions docs/4.0/content/tables.md
Original file line number Diff line number Diff line change
Expand Up @@ -579,6 +579,10 @@ Regular table background variants are not available with the dark table, however
{% capture callout-include %}{% include callout-warning-color-assistive-technologies.md %}{% endcapture %}
{{ callout-include | markdownify }}

Create responsive tables by adding `.table-responsive{-sm|-md|-lg|-xl}` to any `.table` to make them scroll horizontally at each `max-width` breakpoint of 575.99px, 767.99px, 991.99px, and 1119.99px, respectively.

{% capture callout-include %}{% include callout-info-mediaqueries-breakpoints.md %}{% endcapture %}
{{ callout-include | markdownify }}

## Captions

Expand Down
2 changes: 1 addition & 1 deletion docs/4.0/examples/offcanvas/offcanvas.css
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ footer {
* Off Canvas
* --------------------------------------------------
*/
@media screen and (max-width: 767px) {
@media screen and (max-width: 767.99px) {
.row-offcanvas {
position: relative;
transition: all .25s ease-out;
Expand Down
21 changes: 12 additions & 9 deletions docs/4.0/layout/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,21 +88,24 @@ We occasionally use media queries that go in the other direction (the given scre

{% highlight scss %}
// Extra small devices (portrait phones, less than 576px)
@media (max-width: 575px) { ... }
@media (max-width: 575.99px) { ... }

// Small devices (landscape phones, less than 768px)
@media (max-width: 767px) { ... }
@media (max-width: 767.99px) { ... }

// Medium devices (tablets, less than 992px)
@media (max-width: 991px) { ... }
@media (max-width: 991.99px) { ... }

// Large devices (desktops, less than 1200px)
@media (max-width: 1199px) { ... }
@media (max-width: 1199.99px) { ... }

// Extra large devices (large desktops)
// No media query since the extra-large breakpoint has no upper bound on its width
{% endhighlight %}

{% capture callout-include %}{% include callout-info-mediaqueries-breakpoints.md %}{% endcapture %}
{{ callout-include | markdownify }}

Once again, these media queries are also available via Sass mixins:

{% highlight scss %}
Expand All @@ -116,16 +119,16 @@ There are also media queries and mixins for targeting a single segment of screen

{% highlight scss %}
// Extra small devices (portrait phones, less than 576px)
@media (max-width: 575px) { ... }
@media (max-width: 575.99px) { ... }

// Small devices (landscape phones, 576px and up)
@media (min-width: 576px) and (max-width: 767px) { ... }
@media (min-width: 576px) and (max-width: 767.99px) { ... }

// Medium devices (tablets, 768px and up)
@media (min-width: 768px) and (max-width: 991px) { ... }
@media (min-width: 768px) and (max-width: 991.99px) { ... }

// Large devices (desktops, 992px and up)
@media (min-width: 992px) and (max-width: 1199px) { ... }
@media (min-width: 992px) and (max-width: 1199.99px) { ... }

// Extra large devices (large desktops, 1200px and up)
@media (min-width: 1200px) { ... }
Expand All @@ -146,7 +149,7 @@ Similarly, media queries may span multiple breakpoint widths:
{% highlight scss %}
// Example
// Apply styles starting from medium devices and up to extra large devices
@media (min-width: 768px) and (max-width: 1199px) { ... }
@media (min-width: 768px) and (max-width: 1199.99px) { ... }
{% endhighlight %}

The Sass mixin for targeting the same screen size range would be:
Expand Down
6 changes: 4 additions & 2 deletions scss/mixins/_breakpoints.scss
Original file line number Diff line number Diff line change
Expand Up @@ -29,13 +29,15 @@
}

// Maximum breakpoint width. Null for the largest (last) breakpoint.
// The maximum value is calculated as the minimum of the next one less 0.1.
// The maximum value is calculated as the minimum of the next one less 0.01px
// to work around the limitations of `min-` and `max-` prefixes and viewports with fractional widths.
// See https://www.w3.org/TR/mediaqueries-4/#mq-min-max
//
// >> breakpoint-max(sm, (xs: 0, sm: 576px, md: 768px, lg: 992px, xl: 1200px))
// 767px
@function breakpoint-max($name, $breakpoints: $grid-breakpoints) {
$next: breakpoint-next($name, $breakpoints);
@return if($next, breakpoint-min($next, $breakpoints) - 1px, null);
@return if($next, breakpoint-min($next, $breakpoints) - .01px, null);
}

// Returns a blank string if smallest breakpoint, otherwise returns the name with a dash infront.
Expand Down