From e0addf5b588a1244f9679becd90999dfcb4c3a94 Mon Sep 17 00:00:00 2001 From: "ITSERVICES\\rb7147" Date: Tue, 25 Apr 2017 11:46:00 -0400 Subject: Policy 1707 commit to LF Change-Id: Ibe6f01d92f9a434c040abb05d5386e89d675ae65 Signed-off-by: ITSERVICES\rb7147 --- .../CSS/bootstrap/docs/_includes/css/helpers.html | 208 +++++++++++++++++++++ 1 file changed, 208 insertions(+) create mode 100644 POLICY-SDK-APP/src/main/webapp/app/policyApp/CSS/bootstrap/docs/_includes/css/helpers.html (limited to 'POLICY-SDK-APP/src/main/webapp/app/policyApp/CSS/bootstrap/docs/_includes/css/helpers.html') diff --git a/POLICY-SDK-APP/src/main/webapp/app/policyApp/CSS/bootstrap/docs/_includes/css/helpers.html b/POLICY-SDK-APP/src/main/webapp/app/policyApp/CSS/bootstrap/docs/_includes/css/helpers.html new file mode 100644 index 000000000..40bb9d58b --- /dev/null +++ b/POLICY-SDK-APP/src/main/webapp/app/policyApp/CSS/bootstrap/docs/_includes/css/helpers.html @@ -0,0 +1,208 @@ +
+

Helper classes

+ +

Contextual colors

+

Convey meaning through color with a handful of emphasis utility classes. These may also be applied to links and will darken on hover just like our default link styles.

+
+

Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.

+

Nullam id dolor id nibh ultricies vehicula ut id elit.

+

Duis mollis, est non commodo luctus, nisi erat porttitor ligula.

+

Maecenas sed diam eget risus varius blandit sit amet non magna.

+

Etiam porta sem malesuada magna mollis euismod.

+

Donec ullamcorper nulla non metus auctor fringilla.

+
+{% highlight html %} +

...

+

...

+

...

+

...

+

...

+

...

+{% endhighlight %} +
+

Dealing with specificity

+

Sometimes emphasis classes cannot be applied due to the specificity of another selector. In most cases, a sufficient workaround is to wrap your text in a <span> with the class.

+
+
+

Conveying meaning to assistive technologies

+

Using color to add meaning only provides a visual indication, which will not be conveyed to users of assistive technologies – such as screen readers. Ensure that information denoted by the color is either obvious from the content itself (the contextual colors are only used to reinforce meaning that is already present in the text/markup), or is included through alternative means, such as additional text hidden with the .sr-only class.

+
+ +

Contextual backgrounds

+

Similar to the contextual text color classes, easily set the background of an element to any contextual class. Anchor components will darken on hover, just like the text classes.

+
+

Nullam id dolor id nibh ultricies vehicula ut id elit.

+

Duis mollis, est non commodo luctus, nisi erat porttitor ligula.

+

Maecenas sed diam eget risus varius blandit sit amet non magna.

+

Etiam porta sem malesuada magna mollis euismod.

+

Donec ullamcorper nulla non metus auctor fringilla.

+
+{% highlight html %} +

...

+

...

+

...

+

...

+

...

+{% endhighlight %} +
+

Dealing with specificity

+

Sometimes contextual background classes cannot be applied due to the specificity of another selector. In some cases, a sufficient workaround is to wrap your element's content in a <div> with the class.

+
+
+

Conveying meaning to assistive technologies

+

As with contextual colors, ensure that any meaning conveyed through color is also conveyed in a format that is not purely presentational.

+
+ +

Close icon

+

Use the generic close icon for dismissing content like modals and alerts.

+
+

+
+{% highlight html %} + +{% endhighlight %} + + +

Carets

+

Use carets to indicate dropdown functionality and direction. Note that the default caret will reverse automatically in dropup menus.

+
+ +
+{% highlight html %} + +{% endhighlight %} + + +

Quick floats

+

Float an element to the left or right with a class. !important is included to avoid specificity issues. Classes can also be used as mixins.

+{% highlight html %} +
...
+
...
+{% endhighlight %} +{% highlight scss %} +// Classes +.pull-left { + float: left !important; +} +.pull-right { + float: right !important; +} + +// Usage as mixins +.element { + .pull-left(); +} +.another-element { + .pull-right(); +} +{% endhighlight %} + +
+

Not for use in navbars

+

To align components in navbars with utility classes, use .navbar-left or .navbar-right instead. See the navbar docs for details.

+
+ + +

Center content blocks

+

Set an element to display: block and center via margin. Available as a mixin and class.

+{% highlight html %} +
...
+{% endhighlight %} +{% highlight scss %} +// Class +.center-block { + display: block; + margin-left: auto; + margin-right: auto; +} + +// Usage as a mixin +.element { + .center-block(); +} +{% endhighlight %} + + +

Clearfix

+

Easily clear floats by adding .clearfix to the parent element. Utilizes the micro clearfix as popularized by Nicolas Gallagher. Can also be used as a mixin.

+{% highlight html %} + +
...
+{% endhighlight %} +{% highlight scss %} +// Mixin itself +.clearfix() { + &:before, + &:after { + content: " "; + display: table; + } + &:after { + clear: both; + } +} + +// Usage as a mixin +.element { + .clearfix(); +} +{% endhighlight %} + + +

Showing and hiding content

+

Force an element to be shown or hidden (including for screen readers) with the use of .show and .hidden classes. These classes use !important to avoid specificity conflicts, just like the quick floats. They are only available for block level toggling. They can also be used as mixins.

+

.hide is available, but it does not always affect screen readers and is deprecated as of v3.0.1. Use .hidden or .sr-only instead.

+

Furthermore, .invisible can be used to toggle only the visibility of an element, meaning its display is not modified and the element can still affect the flow of the document.

+{% highlight html %} +
...
+ +{% endhighlight %} +{% highlight scss %} +// Classes +.show { + display: block !important; +} +.hidden { + display: none !important; + visibility: hidden !important; +} +.invisible { + visibility: hidden; +} + +// Usage as mixins +.element { + .show(); +} +.another-element { + .hidden(); +} +{% endhighlight %} + + +

Screen reader and keyboard navigation content

+

Hide an element to all devices except screen readers with .sr-only. Combine .sr-only with .sr-only-focusable to show the element again when it's focused (e.g. by a keyboard-only user). Necessary for following accessibility best practices. Can also be used as mixins.

+{% highlight html %} +Skip to main content +{% endhighlight %} +{% highlight scss %} +// Usage as a mixin +.skip-navigation { + .sr-only(); + .sr-only-focusable(); +} +{% endhighlight %} + + +

Image replacement

+

Utilize the .text-hide class or mixin to help replace an element's text content with a background image.

+{% highlight html %} +

Custom heading

+{% endhighlight %} +{% highlight scss %} +// Usage as a mixin +.heading { + .text-hide(); +} +{% endhighlight %} +
-- cgit 1.2.3-korg