Alpaca components for Magento 2

List 

<ul class="list ">
    <li class="list__item ">
        Lorem ipsum

    </li>
    <li class="list__item ">
        Lorem ipsum

    </li>
    <li class="list__item ">
        Lorem ipsum

    </li>
    <li class="list__item ">
        Lorem ipsum

    </li>
    <li class="list__item ">
        Lorem ipsum

    </li>
</ul>
 
<{{{ listTag }}} class="list {{ class }}" {{{ attributes }}}>
    {{# each elements }}
        <{{{ ../elementTag }}} class="list__item {{ this.class }}">
            {{#if text}}
                {{{ text }}}
            {{/if}}

            {{#if component}}
                {{ render (component component.content) component.context merge=true }}
            {{/if}}
        </{{{ ../elementTag }}}>
    {{/ each }}
</{{{ listTag }}}>
 
{
  "listTag": "ul",
  "elementTag": "li",
  "elements": [
    {
      "text": "Lorem ipsum"
    },
    {
      "text": "Lorem ipsum"
    },
    {
      "text": "Lorem ipsum"
    },
    {
      "text": "Lorem ipsum"
    },
    {
      "text": "Lorem ipsum"
    }
  ]
}
  • Content: 
    $list__margin                                          : 0 !default;
$list__padding                                         : 0 !default;
$list__color                                           : $font-color-base !default;
$list__font-size                                       : $font-size-base !default;
$list__list-style                                      : none !default;
$list__item-padding                                    : 0 0 $spacer--medium !default;
$list__item-last-child-padding                         : inherit inherit 0 !default;
$list__label-padding                                   : 0 $spacer $spacer 0 !default;
$list__label-after-content                             : ': ' !default;
$list__value-padding                                   : 0 $spacer $spacer 0 !default;
$list__content-padding-left                            : $spacer !default;

// Horizontal variant
$list__item-padding--horizontal                        : $spacer !default;

// With Icon variant
$list__item-padding--with-icon                         : 0 !default;
$list__icon-link-padding--with-icon                    : $spacer--medium !default;

// With Image variant
$list__image-width--with-image                         : $spacer--medium !default;
$list__image-height--with-image                        : auto !default;

// Divided variant
$list__item-border-bottom--divider                     : 1px solid $gray-dark !default;
$list__item-padding--divider                           : $spacer 0 !default;
$list__item-last-child-border-bottom--divider          : none !default;
$list__item-border-bottom--divider-horizontal          : none !default;
$list__item-border-right--divider-horizontal           : $border-base !default;
$list__item-last-child-border-right--divider-horizontal: none !default;
$list__item-padding--divider-horizontal                : $spacer !default;

// Native variant
$list__item-width--native                              : $spacer--extra-small !default;
$list__item-height--native                             : $spacer--extra-small !default;
$list__item-padding--native                            : 0 0 $spacer calc(#{$spacer--medium - $list__item-height--native}) !default;
$list__item-background-color--native                   : $color-secondary !default;
$list__item-before-top--native                         : 30% !default;
$list__item-before-left--native                        : 0 !default;

// Columns variant
$list__column-padding                                  : 0 $spacer--small 0 0 !default;
$list__column-last-child-padding                       : 0 !default;
$list__column-item-last-child-padding-bottom           : $spacer !default;
$list__column-item-fist-child-padding-top              : $spacer !default;

// Table
$list__margin--table                                   : 0 0 $spacer !default;
$list__label-font-size--table                          : $font-size-medium !default;
$list__label-font-weight--table                        : $font-weight-bold !default;
$list__value-font-size--table                          : $font-size-medium !default;
$list__item-line-height--table                         : 32px !default;

%bullet:before {
    content: "";
    position: absolute;
    top: $list__item-before-top--native;
    left: $list__item-before-left--native;
    width: $list__item-width--native;
    height: $list__item-height--native;
    background-color: $list__item-background-color--native;
}
  • URL: /components/raw/list/_list-variables.scss
  • Filesystem Path: build/components/Molecules/list/_list-variables.scss
  • Size: 3.5 KB
  • Content: 
    @import 'list-variables';

.list {
    margin: $list__margin;
    padding: $list__padding;
    list-style: $list__list-style;
    color: $list__color;
    font-size: $list__font-size;

    &--center {
        justify-content: center;
        text-align: center;
    }

    &--horizontal {
        display: flex;
        flex-flow: row wrap;

        @include mq($screen-m) {
            flex-flow: row nowrap;
        }

        .list__item {
            padding: $list__item-padding--horizontal;

            &:first-child,
            &:last-child {
                padding: $list__item-padding--horizontal;
            }
        }
    }

    &--with-icon {
        justify-content: center;

        .list__item {
            display: flex;
            align-items: center;
            padding: $list__item-padding--with-icon;

            &:first-child,
            &:last-child {
                padding: $list__item-padding--with-icon;
            }
        }

        .list__icon-link {
            padding: $list__icon-link-padding--with-icon;
        }
    }

    &--with-image {
        .list__item {
            display: flex;
        }
        .list__image {
            width: $list__image-width--with-image;
            height: $list__image-height--with-image;
        }
    }

    &--divided {
        .list__item {
            border-bottom: $list__item-border-bottom--divider;
            padding: $list__item-padding--divider;

            &:last-child {
                border-bottom: $list__item-last-child-border-bottom--divider;
            }
        }

        &.list--horizontal {
            .list__item {
                border-bottom: $list__item-border-bottom--divider-horizontal;
                border-right: $list__item-border-right--divider-horizontal;
                padding: $list__item-padding--divider-horizontal;

                &:last-child {
                    border-right: $list__item-last-child-border-right--divider-horizontal;
                }
            }
        }
    }

    &--description {
        display: inline-block;
    }

    &--native {
        .list__item {
            @extend %bullet;
            position: relative;
            padding: $list__item-padding--native;
        }
    }

    &--table {
        display: table;
        margin: $list__margin--table;

        .list__item {
            display: table-row;
        }

        .list__label {
            display: table-cell;
            float: none;
            font-size: $list__label-font-size--table;
            font-weight: $list__label-font-weight--table;
            line-height: $list__item-line-height--table;
        }

        .list__value {
            display: table-cell;
            float: none;
            font-size: $list__value-font-size--table;
            line-height: $list__item-line-height--table;
        }
    }

    &--font-medium {
        font-size: $font-size-medium;
    }

    &__item {
        display: list-item;
        padding: $list__item-padding;

        &:last-child {
            padding: $list__item-last-child-padding;
        }
    }

    &__label {
        clear: left;
        float: left;
        padding: $list__label-padding;

        &:after {
            content: $list__label-after-content;
        }
    }

    &__value {
        float: left;
        padding: $list__value-padding;
    }

    &__content {
        padding-left: $list__content-padding-left;
    }

    &__columns {
        display: flex;
        flex-direction: column;
        flex-wrap: wrap;

        @include mq($screen-m) {
            flex-direction: row;
        }
    }

    &__column {
        padding: $list__column-padding;

        &:last-child {
            padding: $list__column-last-child-padding;
        }

        &--hidden {
            & > .link {
                display: none;
            }
        }
    }

    &__column-item {
        &:first-child {
            padding-top: $list__column-item-fist-child-padding-top;
        }

        &:last-child {
            padding-bottom: $list__column-item-last-child-padding-bottom;
        }
    }
}
  • URL: /components/raw/list/_list.scss
  • Filesystem Path: build/components/Molecules/list/_list.scss
  • Size: 4.1 KB

Improve a11y on the lists

If the list is preceded by the title (in heading or some other element), it’s recommended to add an aria-labelledby attribute on the list and bind there the list title:

<h2 id="list-title">List title</h2>
<ul class="list" aria-labelledby="list-title">
    <li class="list__item">
        Lorem ipsum
    </li>
    <li class="list__item">
        Lorem ipsum
    </li>
    <li class="list__item">
        Lorem ipsum
    </li>
    <li class="list__item">
        Lorem ipsum
    </li>
    <li class="list__item">
        Lorem ipsum
    </li>
</ul>