From ae4a1c8404c34d1717a293464dbea1755214dca8 Mon Sep 17 00:00:00 2001 From: Maarten van Elsas Date: Mon, 29 Feb 2016 10:05:55 +0100 Subject: Added colon before enumeration --- docs/getting-started/build-tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/build-tools.md b/docs/getting-started/build-tools.md index 0dabd30f9..47c25b494 100644 --- a/docs/getting-started/build-tools.md +++ b/docs/getting-started/build-tools.md @@ -49,7 +49,7 @@ Bootstrap uses [Autoprefixer][autoprefixer] (included in our Gruntfile and build ## Local documentation -Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us basic includes, Markdown-based files, templates, and more. Here's how to get it started: +Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here's how to get it started: 1. Run through the [tooling setup](#tooling-setup) above to install Jekyll (the site builder) and other Ruby dependencies with `bundle install`. 2. From the root `/bootstrap` directory, run `bundle exec jekyll serve` in the command line. -- cgit v1.2.3 From 0016c7f3038c3f7dd8feef0a6bb6178f4f9b4571 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Sun, 6 Mar 2016 20:53:45 -0800 Subject: Docs: Add link to Chrome bug regarding `body { overflow: hidden; }` https://bugs.chromium.org/p/chromium/issues/detail?id=175502 [skip sauce] --- docs/getting-started/browsers-devices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index d06845e90..0709eee72 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -195,7 +195,7 @@ As a heads up, we include this in all of Bootstrap's documentation and examples ### Overflow and scrolling -Support for `overflow: hidden;` on the `` element is quite limited in iOS and Android. To that end, when you scroll past the top or bottom of a modal in either of those devices' browsers, the `` content will begin to scroll. See [WebKit bug #153852](https://bugs.webkit.org/show_bug.cgi?id=153852). +Support for `overflow: hidden;` on the `` element is quite limited in iOS and Android. To that end, when you scroll past the top or bottom of a modal in either of those devices' browsers, the `` content will begin to scroll. See [Chrome bug #175502](https://bugs.chromium.org/p/chromium/issues/detail?id=175502) (fixed in Chrome v40) and [WebKit bug #153852](https://bugs.webkit.org/show_bug.cgi?id=153852). ### Virtual keyboards -- cgit v1.2.3 From f86bd01b639410045869c00fb0e06cd5baa60668 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Sun, 6 Mar 2016 21:22:15 -0800 Subject: Docs: Link directly to printing-related browser bugs * https://bugs.chromium.org/p/chromium/issues/detail?id=273306 * https://bugs.webkit.org/show_bug.cgi?id=138192 [skip sauce] --- docs/getting-started/browsers-devices.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index 0709eee72..5d977d2ee 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -218,13 +218,13 @@ Bootstrap includes a workaround for this, although it is disabled by default. By Even in some modern browsers, printing can be quirky. -In particular, as of Chrome v32 and regardless of margin settings, Chrome uses a viewport width significantly narrower than the physical paper size when resolving media queries while printing a webpage. This can result in Bootstrap's extra-small grid being unexpectedly activated when printing. See [issue #12078](https://github.com/twbs/bootstrap/issues/12078) for some details. Suggested workarounds: +In particular, as of Chrome v32 and regardless of margin settings, Chrome uses a viewport width significantly narrower than the physical paper size when resolving media queries while printing a webpage. This can result in Bootstrap's extra-small grid being unexpectedly activated when printing. See [issue #12078](https://github.com/twbs/bootstrap/issues/12078) and [Chrome bug #273306](https://bugs.chromium.org/p/chromium/issues/detail?id=273306) for some details. Suggested workarounds: * Embrace the extra-small grid and make sure your page looks acceptable under it. * Customize the value of the `$grid-breakpoints` Sass variable so that your printer paper is considered larger than extra-small. * Add custom media queries to change the grid size breakpoints for print media only. -Also, as of Safari v8.0, use of the fixed-width `.container` class can cause Safari to use an unusually small font size when printing. See [issue #14868](https://github.com/twbs/bootstrap/issues/14868) for more details. One potential workaround is the following CSS: +Also, as of Safari v8.0, use of the fixed-width `.container` class can cause Safari to use an unusually small font size when printing. See [issue #14868](https://github.com/twbs/bootstrap/issues/14868) and [WebKit bug #138192](https://bugs.webkit.org/show_bug.cgi?id=138192) for more details. One potential workaround is the following CSS: {% highlight css %} @media print { -- cgit v1.2.3 From b8fceb17a4091eef73fdae40990549b10e072451 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Sun, 6 Mar 2016 22:57:42 -0800 Subject: Remove iOS virtual keyboard bug section from docs The modal backdrop positioning bug related to iOS' virtual keyboard doesn't seem to reproduce in iOS 8.0+. (Possibly as a side-effect of https://bugs.webkit.org/show_bug.cgi?id=153224 ) Refs #9023 [skip sauce] --- docs/getting-started/browsers-devices.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index 0709eee72..6a28358cf 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -191,16 +191,12 @@ For more information and usage guidelines, read [Windows Phone 8 and Device-Widt As a heads up, we include this in all of Bootstrap's documentation and examples as a demonstration. -## Modals, navbars, and virtual keyboards +## Modals and dropdowns on mobile ### Overflow and scrolling Support for `overflow: hidden;` on the `` element is quite limited in iOS and Android. To that end, when you scroll past the top or bottom of a modal in either of those devices' browsers, the `` content will begin to scroll. See [Chrome bug #175502](https://bugs.chromium.org/p/chromium/issues/detail?id=175502) (fixed in Chrome v40) and [WebKit bug #153852](https://bugs.webkit.org/show_bug.cgi?id=153852). -### Virtual keyboards - -Also, note that if you're using a fixed navbar or using inputs within a modal, iOS has a rendering bug that doesn't update the position of fixed elements when the virtual keyboard is triggered. A few workarounds for this include transforming your elements to `position: absolute;` or invoking a timer on focus to try to correct the positioning manually. This is not handled by Bootstrap, so it is up to you to decide which solution is best for your application. - ### Navbar Dropdowns The `.dropdown-backdrop` element isn't used on iOS in the nav because of the complexity of z-indexing. Thus, to close dropdowns in navbars, you must directly click the dropdown element (or [any other element which will fire a click event in iOS](https://developer.mozilla.org/en-US/docs/Web/Events/click#Safari_Mobile)). -- cgit v1.2.3 From 49d411058cb3fa0e6c40f65786191ca49941870f Mon Sep 17 00:00:00 2001 From: David Lormor Date: Sun, 13 Mar 2016 11:24:34 -0500 Subject: Document $enable-grid-classes variable Closes #19532 [skip sauce] --- docs/getting-started/options.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/options.md b/docs/getting-started/options.md index 0a98c40d3..8ed206888 100644 --- a/docs/getting-started/options.md +++ b/docs/getting-started/options.md @@ -28,12 +28,13 @@ Do the same for any variable you need to override, including the global options You can find and customize these variables for key global options in our `_variables.scss` file. -| Variable | Values | Description | -| --------------------------- | ---------------------------------- | ----------------------------------------------------------------------- | -| `$spacer` | `1rem` (default), or any value > 0 | Specifies the default spacer value for our spacer utilities. | -| `$enable-flex` | `true` or `false` (default) | Swaps `float` and `display: table` styles for `display: flex`. | -| `$enable-rounded` | `true` (default) or `false` | Enables predefined `border-radius` styles on various components. | -| `$enable-shadows` | `true` or `false` (default) | Enables predefined `box-shadow` styles on various components. | -| `$enable-gradients` | `true` or `false` (default) | Enables predefined gradients via `background-image` styles on various components. | -| `$enable-transitions` | `true` (default) or `false` | Enables predefined `transition`s on various components. | -| `$enable-hover-media-query` | `true` or `false` (default) | ... | +| Variable | Values | Description | +| --------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------- | +| `$spacer` | `1rem` (default), or any value > 0 | Specifies the default spacer value for our spacer utilities. | +| `$enable-flex` | `true` or `false` (default) | Swaps `float` and `display: table` styles for `display: flex`. | +| `$enable-rounded` | `true` (default) or `false` | Enables predefined `border-radius` styles on various components. | +| `$enable-shadows` | `true` or `false` (default) | Enables predefined `box-shadow` styles on various components. | +| `$enable-gradients` | `true` or `false` (default) | Enables predefined gradients via `background-image` styles on various components. | +| `$enable-transitions` | `true` (default) or `false` | Enables predefined `transition`s on various components. | +| `$enable-hover-media-query` | `true` or `false` (default) | ... | +| `$enable-grid-classes` | `true` (default) or `false` | Enables the generation of CSS classes for the grid system (e.g. `.col-md-1` etc.). | -- cgit v1.2.3 From 79490e7e2263c69955df58efbf0b45af7ca668d9 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 14 Mar 2016 02:01:31 -0700 Subject: Mention https://webkit.org/b/153856 in the docs Refs #14839, #19088 [skip sauce] --- docs/getting-started/browsers-devices.md | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index 6832f3481..497553610 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -197,6 +197,10 @@ As a heads up, we include this in all of Bootstrap's documentation and examples Support for `overflow: hidden;` on the `` element is quite limited in iOS and Android. To that end, when you scroll past the top or bottom of a modal in either of those devices' browsers, the `` content will begin to scroll. See [Chrome bug #175502](https://bugs.chromium.org/p/chromium/issues/detail?id=175502) (fixed in Chrome v40) and [WebKit bug #153852](https://bugs.webkit.org/show_bug.cgi?id=153852). +### iOS text fields and scrolling + +As of iOS 9.2, while a modal is open, if the initial touch of a scroll gesture is within the boundary of a textual `` or a `