openmct/example/styleguide/res/templates/controls.html

<!--
 Open MCT, Copyright (c) 2014-2016, United States Government
 as represented by the Administrator of the National Aeronautics and Space
 Administration. All rights reserved.

 Open MCT is licensed under the Apache License, Version 2.0 (the
 "License"); you may not use this file except in compliance with the License.
 You may obtain a copy of the License at
 http://www.apache.org/licenses/LICENSE-2.0.

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 License for the specific language governing permissions and limitations
 under the License.

 Open MCT includes source code licensed under additional open source
 licenses. See the Open Source Licenses file (LICENSES.md) included with
 this source code distribution or the Licensing information page available
 at runtime from the About dialog for additional information.
-->
<div class="l-style-guide s-text">
    <p class="doc-title">Open MCT Style Guide: Controls</p>
    <h1>Controls</h1>
    <div class="l-section">
        <p>Intro about controls</p>
    </div>

    <div class="l-section">
        <h2>Standard Buttons</h2>
        <div class="cols cols1-1">
            <div class="col">
                <p>Use a standard button in locations where there's sufficient room and you must make it clear that the element is an interactive button element. Buttons can be displayed with only an icon, only text, or with icon and text combined.</p>
                <p>Use an icon whenever possible to aid the user's recognition and recall. If both and icon and text are to be used, the text must be within a <code>span</code> with class <code>.title-label</code>.</p>
            </div>
            <div class="col">
                <h3>Markup</h3>
                <pre>
&lt;a class="s-button icon-pencil"&gt;&lt;/a&gt;
&lt;a class="s-button"&gt;Edit&lt;/a&gt;
&lt;a class="s-button icon-pencil"&gt;
    &lt;span class="title-label"&gt;Edit&lt;/span&gt;
&lt;/a&gt;</pre>
                <h3>Examples</h3>
                <a class="s-button icon-pencil"></a>
                <a class="s-button">Edit</a>
                <a class="s-button icon-pencil">
                    <span class="title-label">Edit</span>
                </a>
            </div>
        </div>
    </div>

    <div class="l-section">
        <h2>&quot;Major&quot; Buttons</h2>
        <div class="cols cols1-1">
            <div class="col">
                <p>Major buttons allow emphasis to be placed on a button. Use this on a single button when the user has a small number of choices, and one choice is a normal default. Just add <code>.major</code> to any element that uses <code>.s-button</code>.</p>
            </div>
            <div class="col">
                <h3>Markup</h3>
                <pre>
&lt;a class="s-button major"&gt;Ok&lt;/a&gt;
&lt;a class="s-button"&gt;Cancel&lt;/a&gt;</pre>
                <h3>Example</h3>
                <a class="s-button major">Ok</a>
                <a class="s-button">Cancel</a>
            </div>
        </div>
    </div>

    <div class="l-section">
        <h2>Button Sets</h2>
        <div class="cols cols1-1">
            <div class="col">
                <p>Use button sets to connect buttons that have related purpose or functionality. Buttons in a set round the outer corners of only the first and last buttons, any other buttons in the middle simply get division spacers.</p>
                <p>To use, simply wrap two or more <code>.s-button</code> elements within <code>.l-btn-set</code>.</p>
            </div>
            <div class="col">
                <h3>Markup</h3>
                <pre>
&lt;span class="l-btn-set"&gt;
    &lt;a class="s-button icon-magnify"&gt;&lt;/a&gt;
    &lt;a class="s-button icon-magnify-in"&gt;&lt;/a&gt;
    &lt;a class="s-button icon-magnify-out"&gt;&lt;/a&gt;
&lt;/span&gt;</pre>
                <h3>Example</h3>
                <span class="l-btn-set">
                    <a class="s-button icon-magnify"></a>
                    <a class="s-button icon-magnify-in"></a>
                    <a class="s-button icon-magnify-out"></a>
                </span>
            </div>
        </div>
    </div>
</div>