aboutsummaryrefslogtreecommitdiff
path: root/docs/getting-started/third-party-support.md
diff options
context:
space:
mode:
authorMark Otto <[email protected]>2014-07-12 01:52:44 -0700
committerMark Otto <[email protected]>2014-07-12 01:52:44 -0700
commit7c0c51c9d66d20da3c8d607ff94fd27c5f8e0ec0 (patch)
tree5424e5d5f9f5dcacd3e1de3444993f1b7bbe9fc6 /docs/getting-started/third-party-support.md
parenta2c5febdb21f254d09c6eb33c84536b830adb054 (diff)
downloadbootstrap-7c0c51c9d66d20da3c8d607ff94fd27c5f8e0ec0.tar.xz
bootstrap-7c0c51c9d66d20da3c8d607ff94fd27c5f8e0ec0.zip
move remaining getting started files to new folder
Diffstat (limited to 'docs/getting-started/third-party-support.md')
-rw-r--r--docs/getting-started/third-party-support.md51
1 files changed, 51 insertions, 0 deletions
diff --git a/docs/getting-started/third-party-support.md b/docs/getting-started/third-party-support.md
new file mode 100644
index 000000000..77d869c53
--- /dev/null
+++ b/docs/getting-started/third-party-support.md
@@ -0,0 +1,51 @@
+<div class="bs-docs-section">
+ <h1 id="third-parties" class="page-header">Third party support</h1>
+ <p class="lead">While we don't officially support any third party plugins or add-ons, we do offer some useful advice to help avoid potential issues in your projects.</p>
+
+ <h3 id="third-box-sizing">Box-sizing</h3>
+ <p>Some third party software, including Google Maps and Google Custom Search Engine, conflict with Bootstrap due to <code>* { box-sizing: border-box; }</code>, a rule which makes it so <code>padding</code> does not affect the final computed width of an element. Learn more about <a href="http://css-tricks.com/box-sizing/">box model and sizing at CSS Tricks</a>.</p>
+ <p>Depending on the context, you may override as-needed (Option 1) or reset the box-sizing for entire regions (Option 2).</p>
+{% highlight scss %}
+/* Box-sizing resets
+ *
+ * Reset individual elements or override regions to avoid conflicts due to
+ * global box model settings of Bootstrap. Two options, individual overrides and
+ * region resets, are available as plain CSS and uncompiled Less formats.
+ */
+
+/* Option 1A: Override a single element's box model via CSS */
+.element {
+ -webkit-box-sizing: content-box;
+ -moz-box-sizing: content-box;
+ box-sizing: content-box;
+}
+
+/* Option 1B: Override a single element's box model by using a Bootstrap Less mixin */
+.element {
+ .box-sizing(content-box);
+}
+
+/* Option 2A: Reset an entire region via CSS */
+.reset-box-sizing,
+.reset-box-sizing *,
+.reset-box-sizing *:before,
+.reset-box-sizing *:after {
+ -webkit-box-sizing: content-box;
+ -moz-box-sizing: content-box;
+ box-sizing: content-box;
+}
+
+/* Option 2B: Reset an entire region with a custom Less mixin */
+.reset-box-sizing {
+ &,
+ *,
+ *:before,
+ *:after {
+ .box-sizing(content-box);
+ }
+}
+.element {
+ .reset-box-sizing();
+}
+{% endhighlight %}
+</div>