The checkbox group component is structured with a fieldset/legend element, for a11y concerns.
<fieldset class="sds-checkboxGroup sds-stackLg">
<legend>
<div class="sds-label -labelForm">
Label
</div>
</legend>
<ul class="list-unstyled">
<li class="form-group">
<div class="sds-checkbox custom-control custom-checkbox">
<input value="checkbox-value" type="checkbox" name="" class="sr-only custom-control-input " id="default"><span class="sds-checkboxDot sds-checkbox__shape" aria-hidden="true"></span>
<label class="custom-control-label" for="default">Check this custom checkbox</label>
</div>
</li>
<li class="form-group">
<div class="sds-checkbox custom-control custom-checkbox">
<input value="checkbox-value" type="checkbox" name="" class="sr-only custom-control-input " id="default"><span class="sds-checkboxDot sds-checkbox__shape" aria-hidden="true"></span>
<label class="custom-control-label" for="default">Check this custom checkbox</label>
</div>
</li>
<li class="form-group">
<div class="sds-checkbox custom-control custom-checkbox">
<input value="checkbox-value" type="checkbox" name="" class="sr-only custom-control-input " id="default"><span class="sds-checkboxDot sds-checkbox__shape" aria-hidden="true"></span>
<label class="custom-control-label" for="default">Check this custom checkbox</label>
</div>
</li>
<li class="form-group">
<div class="sds-checkbox custom-control custom-checkbox">
<input value="checkbox-value" type="checkbox" name="" class="sr-only custom-control-input " id="default"><span class="sds-checkboxDot sds-checkbox__shape" aria-hidden="true"></span>
<label class="custom-control-label" for="default">Check this custom checkbox</label>
</div>
</li>
<li class="form-group">
<div class="sds-checkbox custom-control custom-checkbox">
<input value="checkbox-value" type="checkbox" name="" class="sr-only custom-control-input " id="default"><span class="sds-checkboxDot sds-checkbox__shape" aria-hidden="true"></span>
<label class="custom-control-label" for="default">Check this custom checkbox</label>
</div>
</li>
</ul>
</fieldset>
<fieldset class="{{ namespace }}checkboxGroup {{ namespace }}stackLg{% for mod in modifiers %} {{ mod }}{% endfor %}{% for mod in classes %} {{ mod }}{% endfor %}"{% if loading %} aria-busy="{{ ariaBusy or "false" }}"{% endif %} {% if hint or error %} aria-describedby="{% if error %}{{ errorID }}{% endif %}{% if hint %} {{ hintID }}{% endif %}"{% endif %}>
<legend>
{% render "@label--form",{
eltType: "div",
text: labelText
}, true %}
</legend>
<ul class="list-unstyled{% if groupErrorClass %} {{ groupErrorClass }}{% endif %}">
{% if hint %}
{% set indicatorAttrs = {
"aria-describedby": hintID
} %}
{% endif %}
{% if error %}
{% set indicatorAttrs = {
"aria-describedby": errorID
} %}
{% endif %}
{% if hint and error %}
{% set indicatorAttrs = {
"aria-describedby": hintID + " " + errorID
} %}
{% endif %}
{% for i in range(0,5) %}
<li class="form-group">
{% render "@checkbox",{
state: checkboxErrorState,
checkboxDotClasses: checkboxDotClasses,
checkboxShapeAttrs: indicatorAttrs
} ,true %}
</li>
{% endfor %}
</ul>
{% if hint or error %}
<div class="{{ namespace }}checkboxGroup__message">
{% endif %}
{% if hint %}
<div class="{{ namespace }}checkboxGroup__hint {{ namespace }}textHelperSmall">
{% render "@hint",{
text: "Checkbox hint",
attrs: {
id: hintID
}
},true %}
</div>
{% endif %}
{% if error %}
<div class="{{ namespace }}checkboxGroup__error invalid-feedback">
{% render "@hint--error",{
text: "Error message",
attrs: {
id: errorID
}
},true %}
</div>
{% endif %}
{% if hint or error %}
</div>
{% endif %}
</fieldset>
/* variables specific to current element */
$element-specific-variables: "";
.#{$namespace}checkboxGroup {
/* Save root element context for easy access if nesting is needed */
$self: &;
/* properties of current element + media queries */
/* Pseudo Elements */
&::before {
}
&::after {
}
/*
Include elements that are linked to the current element but have to reside at the root level of the stylesheet
(e.g: keyframes)
*/
@at-root {
}
/* children - write selector in full in comments in order to facilitate search */
// checkboxGroup__error
// checkboxGroup__hint
&__error,
&__hint {
margin-top: 0;
padding-left: $custom-control-label-shape-space;
}
&__hint {
@include custom-prop-fallback("color", "sys-color-text-primary-muted");
}
&__message {
.invalid-feedback {
margin-top: map-deep-get($design-tokens,"ui-space-stack-static-125");
}
}
.is-invalid ~ * .invalid-feedback {
display: block;
}
/* modifiers */
// checkboxGroup -altStyle
&.-altStyle {
// follows same logic as base element
}
/* random parent element */
/*
*
* Syntax : .randomParentElt & {}
*
*/
/* Pseudo Classes */
&:hover {
@media (hover: hover) {
}
}
&:focus {
}
&:active {
}
&:focus,
&:active {
}
}