VCU Compass Web Framework

Form: Multi 

<div class="cwf-form__field " id="" aria-label="">
    <label for="" class="cwf-form__label"></label>
</div>
 
<div class="cwf-form__field {{ error ? 'cwf-form__field--error' }}"
    {{ type != 'select' ? 'id="' ~ id ~ '"' }}
    {{ type == 'radio' ? 'role="radiogroup"' }}
    {{ type == 'checkbox' ? 'role="group"' }}
    {{ type != 'select' ? 'aria-label="' ~ label ~ '"' }}>
    {% if not hideLabel %}
        <label for="{{ id }}" class="cwf-form__label">{{ label }}</label>
    {% endif %}
    {% if help %}
        <p class="cwf-form__help">
            {{ help }}
        </p>
    {% endif %}
    {% if error %}
        <p class="cwf-form__validation">
            {{ error }}
        </p>
    {% endif %}
    {% if type == 'select' %}
        <div class="cwf-form__icon cwf-form__icon--select">
            <select class="cwf-form__input"
                id="{{ id }}"
                name="{{ id }}"
                {{ required ? 'required' }}>
                {% for option in options %}
                    <option {{ option == value ? 'selected' }}>
                        {{ option }}
                    </option>
                {% endfor %}
            </select>
        </div>
    {% endif %}
    {% if type != 'select' %}
        {% for option in options %}
            <div class="cwf-form__option cwf-form__option--inline">
                <input class="cwf-form__input"
                    id="{{ option.id }}"
                    name="{{ type == 'radio' ? id : option.id }}"
                    type="{{ type }}"
                    {{ option.checked ? 'checked' }} />
                <label class="cwf-form__label" for="{{ option.id }}">
                    {{ option.label }}
                </label>
                {% if option.help %}
                    <p class="cwf-form__help">
                        {{ option.help }}
                    </p>
                {% endif %}
            </div>
        {% endfor %}
    {% endif %}
</div>
 
/* No context defined. */
  • Content: 
    // Form component styles

@use "../../shared/animation";
@use "../../shared/style";
@use "sass:list";

// Selector prefix
$prefix: "cwf" !default;

// Form colors
$input__background-color: style.color("white-dark") !default;
$input__background-color--disabled: style.darken(
    "white-dark",
    5.25%
) !default; // #ebebeb
$input__border-color: style.color("white-darkest") !default;
$input--placeholder__color: style.color("gray-lightest") !default;
$input--hover__border-color: style.color("gray-lightest") !default;
$input--focus__border-color: style.color("gray-darkest") !default;
$input--focus__background-color: style.color("white") !default;
$color--help: style.color("gray-lightest") !default;
$color--error: style.color("red", "accent") !default;
$color--success: style.color("green", "accent") !default;

// Form

.#{$prefix}-form {
    --cwf-form__input--background-color: #{$input__background-color};
    --cwf-form__input--disabled--background-color: #{$input__background-color--disabled};
    --cwf-form__input--border-color: #{$input__border-color};
    --cwf-form__input--placeholder--color: #{$input--placeholder__color};
    --cwf-form__input--hover--border-color: #{$input--hover__border-color};
    --cwf-form__input--focus--border-color: #{$input--focus__border-color};
    --cwf-form__input--focus--background-color: #{$input--focus__background-color};
    --cwf-form__help--color: #{$color--help};
    --cwf-form--error-color: #{$color--error};
    --cwf-form--success-color: #{$color--success};
}

// Field

.#{$prefix}-form__field {
    margin-bottom: 1rem;

    @include style.children("margins", "last");
}

// Label

.#{$prefix}-form__label {
    display: block;
    font-weight: 500;
    margin-bottom: 0.25rem;
}

// Input

.#{$prefix}-form__input {
    display: block;
    margin-bottom: 0.5rem;
    background-color: var(--cwf-form__input--background-color);
    resize: none;
    width: 100%;
    &:hover {
        border-color: var(--cwf-form__input--hover--border-color);
    }
    &:focus {
        border-color: var(--cwf-form__input--focus--border-color);
        background-color: var(--cwf-form__input--focus--background-color);
    }

    &::placeholder {
        color: var(--cwf-form__input--placeholder--color);
        opacity: 1;
    }

    &:disabled,
    &[readonly] {
        background-color: var(--cwf-form__input--disabled--background-color);
        color: var(--cwf-form__input--placeholder--color);
    }

    &:disabled:hover,
    &:disabled:focus {
        border-color: var(--cwf-form__input--border-color);
    }

    &[type="number"] {
        -webkit-appearance: none;
        -moz-appearance: textfield;
    }
}

// Icon

.#{$prefix}-form__icon {
    position: relative;

    &:before {
        position: absolute;
        top: 0;
        right: 0;
        display: flex;
        justify-content: center;
        align-items: center;
        width: 3rem;
        height: 100%;
        @include style.icon;
        color: var(--cwf-form__input--hover--border-color);
        pointer-events: none;
    }

    .#{$prefix}-form__input {
        height: 100%;
        padding-right: 3rem;
    }

    select.#{$prefix}-form__input {
        appearance: none;
    }
}

.#{$prefix}-form__icon--select {
    &:before {
        content: "\f078";
        @include animation.transition(transform);
    }

    &:focus-within {
        &:before {
            @include animation.flip;
        }
    }
}

// Select option

.#{$prefix}-form__option {
    margin-bottom: 0.5rem;
}

.#{$prefix}-form__option--inline .#{$prefix}-form__input,
.#{$prefix}-form__option--inline .#{$prefix}-form__label {
    display: inline;
    width: auto;
}

// Input & symbol

.#{$prefix}-form__input,
.#{$prefix}-form__symbol {
    padding: 0.5rem 0.75rem;
    border: 1px solid var(--cwf-form__input--border-color);
    border-radius: 0.25rem;
}

// Symbol

.#{$prefix}-form__symbol {
    display: flex;
    justify-content: center;
    align-items: center;
    line-height: 1;
    color: var(--cwf-form__input--placeholder--color);
}

// Group

.#{$prefix}-form__group {
    display: flex;
    margin-top: 0.5rem;
    margin-bottom: 0.5rem;

    .#{$prefix}-form__input {
        border-radius: 0;
    }

    & > * {
        margin: 0;
        margin-right: -1px;
        border-radius: 0;
        @include style.z-index("content");

        &:not(.#{$prefix}-form__symbol) {
            flex: 1;
            @include style.z-index("content", "middle");
        }

        &:first-child:not(.#{$prefix}-form__icon),
        &:first-child .#{$prefix}-form__input {
            border-top-left-radius: 0.25rem;
            border-bottom-left-radius: 0.25rem;
        }

        &:last-child:not(.#{$prefix}-form__icon),
        &:last-child .#{$prefix}-form__input {
            margin-right: 0;
            border-top-right-radius: 0.25rem;
            border-bottom-right-radius: 0.25rem;
        }
    }
}

// Help & validation

.#{$prefix}-form__help {
    color: var(--cwf-form__help--color);
    font-style: italic;
}

.#{$prefix}-form__help,
.#{$prefix}-form__validation {
    font-size: 0.75rem;
    margin-bottom: 0.5rem;
    padding-top: 0;
}

// Field status

$field--statuses: error, success;

@function field--status--validate($status) {
    @return list.index($field--statuses, $status);
}

@mixin field--status($status) {
    @if field--status--validate($status) {
        .#{$prefix}-form__field--#{ $status } {
            .#{$prefix}-form__icon:before,
            .#{$prefix}-form__validation {
                color: var(--cwf-form--#{$status}-color);
            }

            .#{$prefix}-form__input {
                border-color: var(--cwf-form--#{$status}-color);
            }
        }
    } @else {
        @warn "#{$status} is not a valid form field status. Must be one of the following: #{$field--statuses}.";
    }
}

@include field--status(error);

@include field--status(success);
  • URL: /components/raw/form/_index.scss
  • Filesystem Path: components/form/_index.scss
  • Size: 5.9 KB

Form

The form component defines styles and structural conventions to be used by forms and their necessary child elements (such as labels, inputs, text areas, and help text).

Structure

A form must always be wrapped in an element with the .cwf-form class, usually a <form> HTML element. Each grouping of a label, help text, and input must be wrapped in a .cwf-form__field element; This ensures optimal spacing between each field exists. Labels use the .cwf-form__label class, help text uses the .cwf-form__help class, and inputs, regardless of element type, use the .cwf-form__input class.

Groups

Groups allow the prepending and appending of elements to a form input to provide more context. A group is wrapped by a .cwf-form__group element, and can contain an input flanked by .cwf-form__symbol elements, which can be given FontAwesome icon classes to display an icon instead of text.

Icons

To provide a contextual icon on a form input, wrap it in a .cwf-form__icon element with addition FontAwesome icon classes.

Select boxes

Select boxes can be wrapped in an icon wrapper with a special .cwf-form__icon--select class; This displays a downward chevron icon that rotates when the select box is opened/closed.

Options

Options, such as radio or select buttons, wrap a label/input pair in a .cwf-form__option element. Optionally, a .cwf-form__option--inline modifier may be added to it to ensure the option and label are next to each other horizontally.

Styles

Form styles try to make inputs stand out from the background by giving them a light-gray background instead of the standard white background.

Validation

Visual form validation feedback can be provided by adding a validation modifier to .cwf-form__field element. This will change the color of .cwf-form__validation text, as well as the border and icon color of inputs.

  • .cwf-form__field--error - Changes targeted colors to red to imply an error.
  • .cwf-form__field--success - Changes targeted colors to green to imply success.

Functionality

There is no form-specific functionality provided via javascript.

T4 implementation

The form component is not tied to a specific content type. It is included in the Compass T4 page layout CSS on every page.