ModulesUse the links below & the back button to navigate

About

Skin is the official CSS framework of eBay. Skin represents the eBay brand and adheres to the following core principals:

Accessible
Skin leverages semantic HTML, SVG & ARIA to apply our styles wherever possible; thus enforcing correct, accessible markup.
Declarative
Skin follows the BEM methodology of "Block, Element and Modifier" to ensure our HTML class name and structure is human readable and understandable.
Decoupled
Skin is decoupled from the JavaScript layer, meaning the HTML and CSS is agnostic of the frontend framework.
Evergreen
As the eBay design system evolves, so too does Skin, meaning apps only need to keep their Skin package updated to ensure the latest look and feel.

Skin is a pure CSS framework and is bundled with zero JavaScript. This website uses makeup-js to add interactivity to examples where needed.

Install

Skin is distributed via NPM under the @ebay/skin package name.

To use Skin, the package should be added as a dependency in your project's package.json file.

Bundling

Skin supports Webpack and Lasso.js.

Webpack

Add @ebay/skin and @ebay/browserslist-config as dependencies to package.json.

The Skin webpack modules will import CSS so make sure to also have css-loader and style-loader as dev dependencies.

Webpack configuration:

Usage:

Lasso.js

Add the @ebay/skin module as a browser.json dependency to include the entire set of Skin modules.

Or, alternatively, by specifying modules on a per-need basis.

Token System

As of v14, Skin's token-based design system leverages CSS Custom Properties (previously it used LESS).

Tokens are grouped into three distinct sets, that cascade in the following order:

  1. Primitive tokens
  2. Semantic tokens for light mode
  3. Semantic tokens for dark mode

In order for Skin to render correctly, values for core tokens and light tokens are required.

The easiest way to satisfy this requirement is to include one of the following bundles:

It is also possible for a page to roll their own tokens sets, enabling a themed or even non-eBay branded look and feel. More information will be provided in a future release.

NOTE: Primitive tokens are not intended to be used by the application; instead, they are utilized by the semantic tokens.

Themes

CSS Custom Properties allow various aspects of the design system language to be dynamically "themed". Typically these aspects are colors, font, border-radius, spacing and grids.

Warning! Changing the value of any product-level token will cause a ripple effect through all skin modules. If this is not your intention, tokens are also available at the component-level. See switch-variables for an example.

Animation

This section provides information on CSS animations/transitions that are common across one or more modules.

Dialog Transitions

Skin currently supports two types of dialog transition: fade and slide. Because CSS cannot transition an element to and from hidden (i.e. "display:none"), transitions are acheived using two classes applied during different stages of the animation. Before applying an animation class to the dialog component you must first apply the primer class which will be $name-init where $name is the base class. The dialog component has two different animation base classes dialog--show and dialog--hide.

Firstly the -init postfix must be applied to dialog component to prime animation. One animation frame later the -init postfix must be removed and the base class applied to start the animation. Finally once the animation has completed remove the base class.

An example implementation is shown below.

@ebay/skin/alert-dialog

DS v2.1

An alert dialog is a specific type of lightbox-dialog that must be explicitly acknowledged in order to dimiss.

The markup requirements are very strictly: a heading, description and button.

@ebay/skin/avatar

DS v1

Avatars are graphical assets that represent users’ identities across products.

Avatars can show a default image (the first letter of the user's name), custom image, or unknown image.

NOTE: Avatars can be considered as decorative or informative depending on their context and surroundings. Typically, an avatar is displayed adjacent to the user's name, or a sign-in link, therefore making it decorative.

Default Avatar

The default avatar displays the first letter of the user's name.

The default avatar can have a background color of teal, light-teal, green, lime, yellow, orange, magenta, or pink.

Custom Avatar

Avatars can be customized with an image.

NOTE: Sighted users can visually distinguish an avatar based on the image; for non-sighted users the equivalent experience is the name of the user (not a description of the image contents, e.g. "dog in car"!).

Signed-Out Avatar

The avatar-signed-out icon is used to a represent a user that is not signed in.

Avatar Sizes

Avatars can have a size of 32, 40, 48, 56, 64, 96 or 128 pixels.

@ebay/skin/badge

DS v1.2

A badge is a visual indicator added to an element to convey quantity, newness or both. Badges are intended to remind a user of previous actions taken, or to alert them of new actions that they should consider.

The badge module contains the basic, base styles for a static badge element. Badges can also be placed inside of the icon button and menu modules.

22499+

@ebay/skin/button

DS v1.6

A button is typically used to trigger a JavaScript action (e.g. fetch results, open a dialog or expand a menu). In this case, the <button> tag is required.

A button may also be used to submit or reset a form. In this case use the <button> tag with type=submit or type=reset respectively. Use of the <input> tag is not currently supported.

Finally, a link may be styled to look like a button. We call this a fake button. In this case the <a> tag is required with a valid HREF attribute.

Default Button

Use the btn or fake-btn class respectively, to create a minimal, default button. This default button is the foundation for all other button types.

Link

Use the large modifier to increase the size of the button.

Large Link

Use the small modifier to decrease the size of the button.

Small Link

Primary Button

Use the primary modifier to create a primary button style.

Link

Secondary Button

Use the secondary modifier to create a secondary button style.

Link

Tertiary Button

Use the tertiary modifier to create a tertiary button style.

Link

Disabled Button

The disabled attribute is required to fully disable a button tag.

Remove the href attribute to fully disable an anchor tag.

Partially Disabled Button

Partially disabled buttons are programmatically disabled but retain keyboard focus when disabled. This helps prevent keyboard focus being moved back to the start of the page when focus is lost.

Destructive Button

Use the destructive modifier to create a destructive button style used for removing data.

Primary Destructive Button

Primary Link

Secondary Destructive Button

Secondary Link

Tertiary Destructive Button

Tertiary Link

Adjacent Icon Button

Any SVG icon can be placed adjacent to the button text. To flip position of text and icon, simply swap the DOM order.

Busy State for Button

Replace the button contents with a progress spinner to represent a busy state. Note also, that the button will need an aria-label to programmatically convey the busy state to assistive technology.

Click the button below for an interactive example.

NOTE: it is recommended to use a snackbar dialog or inline-notice in order to convey any status of success or failure.

Flexible Button

Because the button cell uses flex box layout, it is fairly trivial to achieve alternate layouts, as in the example below.

Fixed Height Button

To ensure the same height as other controls, apply a fixed height to a button with btn--fixed-height or btn--large-fixed-height.

Fixed Width Button

Buttons naturally grow wider with their text. The text will wrap naturally once the button width grows to exceed its constrained width.

Fixed Width and Height Button

Of course, with a constrained width and a fixed height, the text will begin to overflow.

The solution is to apply truncation, via the btn--truncated or btn--large-truncated modifiers.

Expandable Buttons

Use the "chevron-down-12" icon to create an expandable button style. Use aria-expanded to convey state.

Use the borderless modifier to remove the border from the expandable button.

Use the form modifier to create an expandable button style that matches the look of form controls (e.g. textbox, select).

Use the btn--slim modifier, in conjunction with btn--form, if displaying an icon only.

For a floated "label", which will appear above the value, use the btn--floating-label and btn__floating-label classes.

In a resting state, with no value, the btn__floating-label--inline modifier is required. This should be added with JavaScript

@ebay/skin/calendar

DS v1

The calendar module offers readonly and interactive calendar capabilities.

Both types of calendar are structured as data tables; each column representing a day of the week.

Readonly Calendar

A readonly calendar has cells containing static text or hypertext.

The current date is conveyed using calendar__cell--current and clipped text.

August 2023
SuMoTuWeThFrSa
12345
6789101112
1314 - today1516171819
20212223242526
2728293031

NOTE: for the eagle-eyed BEM afionados, we are saying each span has an implicit class of calendar__cell.

Read-Only Calendar with Inactive Dates

Inactive/unavailable dates are conveyed using calendar__cell--disabled and offscreen text.

August 2023
SuMoTuWeThFrSa
1 - inactive2 - inactive3 - inactive4 - inactive5 - inactive
6 - inactive7 - inactive8 - inactive9 - inactive10 - inactive11 - inactive12 - inactive
13 - inactive14 - today1516171819
20212223242526
2728293031

Read-Only Calendar with Date Range

Date ranges are conveyed using calendar__cell--selected, calendar__range, calendar__range--start, calendar__range-end and clipped text.

August 2023
SuMoTuWeThFrSa
1 - inactive2 - inactive3 - inactive4 - inactive5 - inactive
6 - inactive7 - inactive8 - inactive9 - inactive10 - inactive11 - inactive12 - inactive
13 - inactive14 - today151617 - start of range18 - in range19 - in range
20 - in range21 - in range22 - in range23 - in range24 - in range25 - end of range26
2728293031

Interactive Calendar

An interactive calendar uses toggle buttons to allow the input of single dates or date ranges.

NOTE: a fully functional and accessible interactive calendar requires JavaScript and is outside the scope of a CSS library such as eBay Skin. The examples below are NOT fully functional and serve to demonstrate the necessary HTML semantics and styling hooks only.

Interactive Calendar With Single Date Selection

A single date selection is conveyed using aria-pressed.

NOTE: in comparison to the readonly calendar, with buttons we can now leverage the disabled property and aria-current instead of clipped text.

August 2023
SuMoTuWeThFrSa

Interactive Calendar With Date Range Selection

Date ranges are bookended by two buttons with the aria-pressed property. All buttons in between these dates leverage clipped text for assistive technology.

August 2023
SuMoTuWeThFrSa

Calendar With Header Pagination

The calendar module allows an optional header section for pagination between months.

August 2023

August 2023
SuMoTuWeThFrSa
12345
6789101112
1314 - today1516171819
20212223242526
2728293031

Multi-month Calendar with Header Pagination

Multiple instances of calendar__month can be rendered inside of the calendar__body.

July 2023

August 2023

September 2023

July 2023
SuMoTuWeThFrSa
1
2345678
9101112131415
16171819202122
23242526272829
3031
August 2023
SuMoTuWeThFrSa
12345
6789101112
1314 - today1516171819
20212223242526
2728293031
September 2023
SuMoTuWeThFrSa
12
3456789
10111213141516
17181920212223
24252627282930

@ebay/skin/chart-legend

DS v1

A representation of legend keys and their values on the plotted area of any chart or graph.

Portion 1
10%
Portion 2
20%
Portion 3
30%
Portion 4
30%
Portion 5
10%

@ebay/skin/checkbox

DS v2

A checkbox is a form control that allows multiple selections from a group of choices.

The purpose of a checkbox is to collect form data; therefore a checkbox should always be used in conjunction with a form, label and submit button.

The checkbox is decoupled from its text label to allow more flexibility in terms of layout. How and where you provide this label is up to you, but do not forget it!

Default Checkbox

Use the checkbox base class to create a checkbox.

NOTE: Skin uses SVG to give a custom checkbox appearance. This SVG is hidden by default to prevent it from appearing alongside the browser default checkbox in a non-CSS state.

Mixed Checkbox

For a mixed checkbox, that is partially checked, or indeterminate, apply the aria-checked="mixed" state and use icon-checkbox-mixed-18 .

NOTE : JavaScript is required to toggle the aria-checked state.

Large Checkbox

For a larger checkbox, use the checkbox--large modifier plus the #icon-checkbox-unchecked-24 , #icon-checkbox-checked-24 and #icon-checkbox-unchecked-24 icons.

Disabled Checkbox

Use the disabled attribute to disable any checkbox input.

Grouped Checkboxes

A group of checkboxes allows multi-select (unlike a group of radio buttons which enforces single-select).

A fieldset and legend are required in order to create the correct grouping semantics. Note that the Skin global module removes the default fieldset border and padding.

The following example uses the field module for simple layout of checkbox fields and labels.

Choose an Option

TIP : For large checkboxes, wrap each label and control inside of a field__group element to maintain vertical alignment.

To stack checkboxes vertically instead of side-by-side, simply replace the span wrapper with a div wrapper.

Choose an Option

@ebay/skin/chip

DS v1.0.0

A chip represents a descrete highlighted value.

Static Chip

A static chip simply for informational purposes.

Football

Interactive Chip

An interactive chip has a delete button inside for chip removal.

Football

Chip Containers

When chips appear next to each other in a set, spacing and positioning adjustments should be made on the container, and if necessary, margins adjusted as such. Please review design documentation and follow the guidance here for appropriate specifications.

Note on Chips in Containers

Chips have a display of inline-flex so they will naturally inherit some native inline attributes. One of those is the implied white space between each one. Bear this mind when creating your container.

Here is an example of a container constrained to 300px (for vertical spacing demo reasons) that uses flex with wrapping to remove the whitespace and provide a clean set of chips (whitespace-free) within a container using the appropriate spacing conventions.

FootballBasketballBaseballHockeyCricketSwimmingRugby

@ebay/skin/chips-combobox

DS v1.0.0

Chips Combobox are creators and managers of chip components. They allow user search of existing chip options, additions, and removals of chips. The search/selection follows the pattern of the combobox pattern.

Empty Chips Combobox

This is the simplest type of implementation with an empty chips combobox component usually encountered on initial information entry.

NOTE : For empty Chips Combobox implementations, to avoid layout issues, make sure .chips-combobox__items does NOT have any whitespace.

    Soccer
    Hockey
    Tennis

    Fluid Chips Combobox

    Adding the modifier, .chips-combobox--fluid makes the component fluid and expands it to the width of its container.

      Soccer
      Hockey
      Tennis

      Prefilled Chips Combobox

      This is the chips combobox with pre-populated chip items, something you'd see when editing a chips combobox component.

      • Football
      • Basketball
      • Baseball
      Soccer
      Hockey
      Tennis

      Chips Combobox in Disabled State

      When disabled, Chips Combobox becomes "frozen" and users are unable to interact with the module - search for, add, and remove chips.

      To turn on this state, add aria-disabled="true" to the outer element of the module. Additonally, you'll need to add the disabled attribute to all the buttons inside as well as the input element for combobox.

      • Football
      • Basketball
      • Baseball
      Soccer
      Hockey
      Tennis

      Chips Combobox in Error State

      When a user enters text that is considered to be invalid, the Chips Combobox module can enter an error state. Developers can validate the text entry and trigger invalid/valid states as needed.

      To turn on the error state, add a class of chips-combobox--error to the outer element of the module. To turn off the error state, remove the class.

      In addition to the inclusion of the modifier to turn on the error state, there should also be an accompanying error message relevant to the reason for the error. Per a11y rules, color alone should not be used to indicate an error. For more information, please see the field error state docs .

      • Football
      • Basketball
      • Baseball
      Soccer
      Hockey
      Tennis

      @ebay/skin/combobox

      DS v2.2

      A combobox is a combination of textbox and listbox. The textbox value can be constructed via manual text entry as normal, or via selection from the listbox options, or a combination of both.

      TIP : A combobox can be further enhanced with autocomplete behaviour .

      Default Combobox

      Selecting an option should simply fill the textbox with that value. Options may not have state or any other kind of secondary behaviour.

      Option 1
      Option 2
      Option 3

      Disabled Combobox

      Apply the disabled property to disable the combobox.

      Option 1
      Option 2
      Option 3

      @ebay/skin/confirm-dialog

      DS v2.1

      A confirm dialog is a specific type of lightbox-dialog that prompts a user to confirm or reject their action.

      The markup requirements are very strictly: a heading, description and two buttons.

      @ebay/skin/cta-button

      DS v1.2

      An action button takes users to another URL destination (i.e. it is always a hyperlink).

      @ebay/skin/date-textbox

      DS v1

      The date textbox offers a calendar based "date picker" as an alternative to manual text entry.

      Single Select Date Textbox

      The single select date textbox consists of a textbox plus icon button . The icon button launches an interactive calendar inside of a flyout.

      The aria-label of the calendar button should be intuitive enough for users of speech recognition software to identify.

      NOTE: a fully functional interactive calendar requires JavaScript and is outside the scope of a CSS library. The calendar in this example is a simple readonly version.

      Disabled Date Textbox

      The disabled date textbox is a disabled textbox input with a calendar icon button that's also disabled. Use the disabled attribute on the input as well as button .

      Date Range Textbox

      Selecting a date range requires two textboxes; one for the start date and one for the end date.

      @ebay/skin/details

      DS v1.2

      A details element is an interactive control used to expand and collapse content.

      NOTE: The details-element-polyfill is required to polyfill older browsers.

      Default Details

      Details

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      Opened Details

      Apply the open attribute to change the state.

      Details

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      Centered Details

      Apply the details__summary--center class to center the summary.

      Details

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      Small Details

      Apply the details__summary--small class to use the smaller version of summary.

      Details

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      RTL Details

      Works with right-to-left languages.

      Details

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      @ebay/skin/donut-chart

      DS v1

      ALPHA: APIs are subject to change

      The donut chart is a data visualization module designed to display comparative data in an easily digestible and visually appealing format. Our donut chart is composed of four sections: the title, metric, graph, and legend, each serving a distinct purpose to enhance the user's understanding of the data presented.

      In practice, the .donut-chart__graph is where we will load in the third-party donut chart.

      Small container

      Donut chart title

      175
      Returns processed
      Graph placeholder
      Portion 1
      10%
      Portion 2
      20%
      Portion 3
      30%

      Variable width container

      Donut chart title

      175
      Returns processed
      Graph placeholder
      Portion 1
      10%
      Portion 2
      20%
      Portion 3
      30%

      @ebay/skin/education-notice

      DS v1

      Education Notice

      The education notice is meant to display a variety of informational content. By default it has a gray background color that has less prominence.

      Education notice can use any large 24x24 program badge icon. The icon can be black or blue. They are black by default, but approved program badges can use blue. If the blue is too prominent or noisy, program badges can use black as well.

      Did you know?

      You can now split payments on two cards.

      Education Notice with a Prominent Icon

      Default educational notice (gray background) can use a blue icon by adding an icon--prominent modifier on the icon element.

      Did you know?

      You can now split payments on two cards.

      Prominent Education Notice

      The prominent education notice includes a background color that pops a bit more. It can be used with a education-notice--prominent modifier.

      Authenticity Guaranteed

      Authenticity Guarantee means your item is authentic or your money back.

      Dismissable Education Notice

      A close button can be placed in a education-notice__header element.

      Did you know?

      You can now split payments on two cards.

      Actionable Education Notice

      Link or button actions can be placed in the education-notice__footer element.

      The Vault

      You can now use the Vault to store items like this securely.

      Actionable Education Notice Using Fake Button

      The Vault

      You can now use the Vault to store items like this securely.

      @ebay/skin/eek

      DS v1.1

      EEKs have two parts, a range, and a rating. The following ranges are available:

      EEK MINEEK MAXICON
      DA+++A+++D
      EA+++A+++E
      GA+++A+++G
      EA++A++E
      GA++A++G
      FA+A+F
      EA+A+E
      GAAG

      And for each range, making sure each rating exists within that given range, the EEK can have the following ratings:

      Then each rating needs to have a different color. This depends on the distance it is from the upper range

      EEK RATING NAMEA+++DA+++EA+++GA++E
      A+++.eek--rating-7.eek--rating-7.eek--rating-7.eek--rating-7
      A++.eek--rating-1.eek--rating-1.eek--rating-1.eek--rating-7
      A+.eek--rating-2.eek--rating-2.eek--rating-2.eek--rating-1
      A.eek--rating-3.eek--rating-3.eek--rating-3.eek--rating-2
      B.eek--rating-4.eek--rating-4.eek--rating-4.eek--rating-3
      C.eek--rating-5.eek--rating-5.eek--rating-5.eek--rating-4
      D.eek--rating-6.eek--rating-6.eek--rating-6.eek--rating-5
      E.eek--rating-7.eek--rating-7.eek--rating-7.eek--rating-6
      F.eek--rating-7.eek--rating-7.eek--rating-7.eek--rating-7
      G.eek--rating-7.eek--rating-7.eek--rating-7.eek--rating-7
      EEK RATING NAMEA++GA+FA+EAG
      A+++.eek--rating-7.eek--rating-7.eek--rating-7.eek--rating-7
      A++.eek--rating-7.eek--rating-7.eek--rating-7.eek--rating-7
      A+.eek--rating-1.eek--rating-7.eek--rating-7.eek--rating-7
      A.eek--rating-2.eek--rating-1.eek--rating-1.eek--rating-7
      B.eek--rating-3.eek--rating-2.eek--rating-2.eek--rating-1
      C.eek--rating-4.eek--rating-3.eek--rating-3.eek--rating-2
      D.eek--rating-5.eek--rating-4.eek--rating-4.eek--rating-3
      E.eek--rating-6.eek--rating-5.eek--rating-5.eek--rating-4
      F.eek--rating-7.eek--rating-6.eek--rating-6.eek--rating-5
      G.eek--rating-7.eek--rating-7.eek--rating-7.eek--rating-6

      @ebay/skin/field

      DS v

      The field module facilitates the layout of a form control and its associated label, plus any other applicable text or sub-controls (e.g. error text or help button).

      Unstacked Field

      The field__label & field__control elements are inline by default, taking up only as much horizontal space as they need.

      Multiple fields can be laid out inline by using the span tag with field class, as per the example below.

      Replace the span tag with a div tag to layout unstacked fields in blocks, as per the following example.

      For a textarea, the label will be vertically aligned to the middle of the field by default. Apply the field--align-top modifier to align it to the top.

      Stacked Field

      For a label stacked above the control, use the field__label--stacked element modifier.

      Again, multiple fields can be laid out inline by using a span tag, as per the example below.

      Replace the span tag with a div tag to layout the stacked fields in blocks, as per the example below.

      Field Font-Size

      The field label will honour any font-size cascade. Wrap the label and control in a field__group element to maintain vertical alignment.

      NOTE: form controls do not inherit the font-size cascade. This is default browser behaviour.

      Disabled Field

      The disabled control is conveyed using the disabled attribute. The value of a disabled control is not passed to the server.

      TIP: Disabled controls are exempt from WCAG colour contrast requirements.

      Readonly Field

      A readonly control is conveyed using the readonly attribute. The value of a readonly control is passed to the server.

      Required Field

      A required field is conveyed visually with an asterisk, and non-visually using the aria-required property.

      Invalid Field

      An invalid control is conveyed visually via a combination of red outline and some other indicator (usually either text and/or an icon). The invalid state is conveyed non-visually using the aria-invalid state.

      IMPORTANT: The example below shows the field with red border only. Do not forget that colour should not be used as the only visual means of conveying information. A description and/or icon is also required. See next section for more details.

      Field Description

      A field may have nearby text to describe additional instructions, status or validation error of the control.

      The field__description element defines some minimal styling, but does not dictate location or layout. This element has modifiers for confirmation, information and attention, depending on the type of descriptive text (or icon).

      TIP: The description element can be designated as an ARIA live-region if client-side updates occur.

      Text on Side of Field

      A description can be placed adjacent to any stacked or unstacked field simply by using an inline-level tag, such as span.

      Field description or error

      To change the type of decription you would use field__description--confirmation, field__description--information, or field__description--attention.

      Field description - default
      Field description - confirmation
      Field description - information
      Field description - error (attention)

      Text Below Stacked Field

      A description can be placed underneath a stacked field simply by using a block-level tag, such as div.

      Field description or error

      Text Above or Below Unstacked Field

      A description can be added directly above and/or below the control by utlising CSS table-layout via the field--table modifier and field__row elements.

      Field description or error

      Text Below Floating label

      When you use a floating label, you can have the description text below

      Field description or error

      Listbox Button with Label in Error State

      You can use a listbox button as a field. This example includes a label, the listbox button as well an error message with the entire thing in an error state.

      Red
      Blue
      Yellow
      Green
      There was an error

      Textbox in Error State

      You can use a textbox in an error state. This example includes a label, the textbox as well an error message with the entire thing in an error state.

      There was an error

      Textbox in Error State

      You can use a textbox in an error state. This example includes a label, the textbox as well an error message with the entire thing in an error state.

      Fluid Field

      Form control elements (such as select and input) are inline-block by default, and will only use up as much of their parent's horizontal space as they need.

      For a stacked field the control must be set to 100% width (using the fluid utility class) to fill all available space.

      The above example shows the fields in a flexbox layout. This layout is created using the field-group helper class. Notice that each field is also set to fluid, in order to fill all available flexbox space (flexbox layout takes care of dividing the space evenly between fluid fields).

      If we set the form control width to 100% in an unstacked field, the control would flow to a new line below the label (effectively behaving like a stacked label). This behaviour can be avoided by adding an additional field__group element to create flex layout inside of the field.

      TIP: You may want to experiment with sizes other than 100%, and also the flexbox justify-content property.

      For a fluid control and description, those elements can be wrapped in a field__group container to create flex layout.

      Field description or error
      Field description or error

      Field Character Count

      A field may have a character count section typically under the input and aligned to the right.

      This variant adds a top-level container that houses both the field description and the character count, though field description or error is not necessary.

      In order to be accessible, the character count should have a clipped element to describe what it is. At the same time, aria-describedby should be added to the input element that points to the character count element. Finally, aria-live should be off by default, but if it passes the current max characters, then it should be changed to polite. Once it goes back down below the max, it should go back to off.

      Field with Character Count Only

      Character character can be added by utlising CSS grid via the field__description--group modifier and the addition of the relevant markup. By default if there is only one element in the group, it will align to the right

      0 of 140 charaters

      Field Description and Character Count

      A field description (or error) and character count can be added by adding an element before the field count. It will left align the description and right align the character count.

      Field description or error0 of 140 charaters

      Field Description and Character Count with Text area

      A field description (or error) and character count can also be added to a text area. Use similar markup as before but add a textarea element.

      Field description or error0 of 140 charaters

      @ebay/skin/file-inputALPHA

      DS v0.1

      The file-input lets the user choose one or more files from their device storage. Once chosen, the files can be uploaded to a server using form submission , or manipulated using JavaScript code and the File API .

      The entire element can function as a dropzone for drag and drop, however this functionality requires JavaScript and is outside the scope of a CSS library such as eBay Skin.

      Base

      Drag and drop files

      Up to 10MB per file in JPG, JPEG, PNG, MP4.

      @ebay/skin/file-preview-card-groupALPHA

      DS v0.1

      The file-preview-card-group is a group of single or multiple file preview cards.

      This component is an atomic piece file-preview-card which is the recommended piece to use. Using other components may result in unexpected results.

      Base

      • CSV
      • Image
      • Image

      Responsive Out of the Box

      Similar to Toggle Button Group, this component is responsive out of the box. The cards will responsively shrink and stretch the specific type of cards inside and attempt to fit the cards nicely within the container at any and all screen sizes.

      We use display: grid to create a predefined allotted number of card slots per breakpoint. We also use container queries to modify how many slots should be available per breakpoint. This allows cards to shrink/stretch the predefined number of cards at each breakpoint with a fallback to media queries for unsupported browsers.

      The responsive rules around how many toggle cards appear on a single line before wrapping into a new line have all been predefined and baked into the component, so developers don't need to provide anything else to have an optimal responsive layout at various screen sizes.

      In the demo below, drag the range to see the responsive rules in action.

      320

      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image
      • Image

      @ebay/skin/file-preview-cardALPHA

      DS v0.1

      The file-preview-card can be used to display file previews. A css grid layout is used to define the areas in which certain elements can be placed.

      Uploading File Preview Card

      Image File Preview Card

      For image file types, the image is showcased in the body of the card.

      Image

      Video File Preview Card

      For video file types, a preview is shown within the body of the card.

      MP4

      Document File Preview Card

      For document file types, such as documents, the card does not display a preview within its body.

      CSV

      See More File Preview Card

      If the number of visual files exceeds the maximum display limit, a "See More" action button will appear at the center of the preview card, allowing you to view the additional files.

      Image

      @ebay/skin/filter-button

      DS v2

      Use the filter-button or filter-link classes, to create a button or link styled as a filter button. Group together multiple filter buttons inside of a filter-group container.

      Unselected Filter Button

      By default, a filter button is in a non-selected state.

      Link

      Selected Filter Button

      Apply the aria-pressed state to a button, or filter-link--selected modifier to a link.

      Disabled Filter Button

      Apply the disabled property or remove the href attribute to disable a button or link, respectively.

      Truncated Filter Button

      Long text will automatically become truncated when it reaches the maximum width.

      Link with lots of text that will become truncated

      @ebay/skin/filter-menu-button

      DS v2

      A filter menu button opens a menu of options by which to filter a result set.

      Non-Active Filter Menu Button

      With no filters active, a filter menu button should be in a non-active state. Set the aria-pressed property to false.

      Active Filter Menu Button

      With one or more filters active, set the button's aria-pressed property to true.

      Disabled Filter Menu Button

      The button can be disabled using the disabled property.

      Filter Menu Button with a Form

      When a native form is required, wrap the menu items with a form and use the appropriate checkbox markup.

      @ebay/skin/filter-menu

      DS v2

      A filter menu forms the basis of the filter-menu-button module; we provide it here as a standalone version in the case it might be opened or rendered via other means (in a dialog for example).

      Multi-Select Filter Menu

      Single-Select Filter Menu

      Filter Menu with Disabled Options

      Filter Menu as Form

      A form version is also available. It uses the checkbox and radio modules to render checkboxes or radios instead of ARIA menu items. The form version must contain a submit button.

      @ebay/skin/flag

      DS v1

      The flag module is a bundle that provides full access to all the country flags via the <svg> and <use> tags.

      Including an Flag

      A flag can be referenced from the flags svg file. We also provide individual flags as SVGs located in this directory. You can include these on your page as raw SVGs as needed.

      NOTE: the SVG tag does not support the hidden attribute, hence a hidden wrapper element is needed.

      • afAfghanistan
      • axAland Islands
      • alAlbania
      • dzAlgeria
      • asAmerican Samoa
      • adAndorra
      • aoAngola
      • aiAnguilla
      • aqAntarctica
      • agAntigua and Barbuda
      • arArgentina
      • amArmenia
      • awAruba
      • acAscension Island
      • auAustralia
      • atAustria
      • azAzerbaijan
      • bsBahamas
      • bhBahrain
      • bdBangladesh
      • bbBarbados
      • es-pvBasque Country
      • byBelarus
      • beBelgium
      • bzBelize
      • bjBenin
      • bmBermuda
      • btBhutan
      • boBolivia
      • bqBonaire, Sint Eustatius and Saba
      • baBosnia and Herzegovina
      • bwBotswana
      • bvBouvet Island
      • brBrazil
      • ioBritish Indian Ocean Territory
      • bnBrunei Darussalam
      • bgBulgaria
      • bfBurkina Faso
      • biBurundi
      • cvCabo Verde
      • khCambodia
      • cmCameroon
      • caCanada
      • icCanary Islands
      • es-ctCatalonia
      • kyCayman Islands
      • cfCentral African Republic
      • ceftaCentral European Free Trade Agreement
      • tdChad
      • clChile
      • cnChina
      • cxChristmas Island
      • cpClipperton Island
      • ccCocos (Keeling) Islands
      • coColombia
      • kmComoros
      • ckCook Islands
      • crCosta Rica
      • hrCroatia
      • cuCuba
      • cwCuraçao
      • cyCyprus
      • czCzech Republic
      • ciCôte d'Ivoire
      • cdDemocratic Republic of the Congo
      • dkDenmark
      • dgDiego Garcia
      • djDjibouti
      • dmDominica
      • doDominican Republic
      • ecEcuador
      • egEgypt
      • svEl Salvador
      • gb-engEngland
      • gqEquatorial Guinea
      • erEritrea
      • eeEstonia
      • szEswatini
      • etEthiopia
      • euEurope
      • fkFalkland Islands
      • foFaroe Islands
      • fmFederated States of Micronesia
      • fjFiji
      • fiFinland
      • frFrance
      • gfFrench Guiana
      • pfFrench Polynesia
      • tfFrench Southern Territories
      • gaGabon
      • es-gaGalicia
      • gmGambia
      • geGeorgia
      • deGermany
      • ghGhana
      • giGibraltar
      • grGreece
      • glGreenland
      • gdGrenada
      • gpGuadeloupe
      • guGuam
      • gtGuatemala
      • ggGuernsey
      • gnGuinea
      • gwGuinea-Bissau
      • gyGuyana
      • htHaiti
      • hmHeard Island and McDonald Islands
      • vaHoly See
      • hnHonduras
      • hkHong Kong
      • huHungary
      • isIceland
      • inIndia
      • idIndonesia
      • irIran
      • iqIraq
      • ieIreland
      • imIsle of Man
      • ilIsrael
      • itItaly
      • jmJamaica
      • jpJapan
      • jeJersey
      • joJordan
      • kzKazakhstan
      • keKenya
      • kiKiribati
      • xkKosovo
      • kwKuwait
      • kgKyrgyzstan
      • laLaos
      • lvLatvia
      • lbLebanon
      • lsLesotho
      • lrLiberia
      • lyLibya
      • liLiechtenstein
      • ltLithuania
      • luLuxembourg
      • moMacau
      • mgMadagascar
      • mwMalawi
      • myMalaysia
      • mvMaldives
      • mlMali
      • mtMalta
      • mhMarshall Islands
      • mqMartinique
      • mrMauritania
      • muMauritius
      • ytMayotte
      • mxMexico
      • mdMoldova
      • mcMonaco
      • mnMongolia
      • meMontenegro
      • msMontserrat
      • maMorocco
      • mzMozambique
      • mmMyanmar
      • naNamibia
      • nrNauru
      • npNepal
      • nlNetherlands
      • ncNew Caledonia
      • nzNew Zealand
      • niNicaragua
      • neNiger
      • ngNigeria
      • nuNiue
      • nfNorfolk Island
      • kpNorth Korea
      • mkNorth Macedonia
      • gb-nirNorthern Ireland
      • mpNorthern Mariana Islands
      • noNorway
      • omOman
      • pkPakistan
      • pwPalau
      • paPanama
      • pgPapua New Guinea
      • pyParaguay
      • pePeru
      • phPhilippines
      • pnPitcairn
      • plPoland
      • ptPortugal
      • prPuerto Rico
      • qaQatar
      • cgRepublic of the Congo
      • roRomania
      • ruRussia
      • rwRwanda
      • reRéunion
      • blSaint Barthélemy
      • shSaint Helena, Ascension and Tristan da Cunha
      • knSaint Kitts and Nevis
      • lcSaint Lucia
      • mfSaint Martin
      • pmSaint Pierre and Miquelon
      • vcSaint Vincent and the Grenadines
      • wsSamoa
      • smSan Marino
      • stSao Tome and Principe
      • saSaudi Arabia
      • gb-sctScotland
      • snSenegal
      • rsSerbia
      • scSeychelles
      • slSierra Leone
      • sgSingapore
      • sxSint Maarten
      • skSlovakia
      • siSlovenia
      • sbSolomon Islands
      • soSomalia
      • zaSouth Africa
      • gsSouth Georgia and the South Sandwich Islands
      • krSouth Korea
      • ssSouth Sudan
      • esSpain
      • lkSri Lanka
      • psState of Palestine
      • sdSudan
      • srSuriname
      • sjSvalbard and Jan Mayen
      • seSweden
      • chSwitzerland
      • sySyria
      • twTaiwan
      • tjTajikistan
      • tzTanzania
      • thThailand
      • tlTimor-Leste
      • tgTogo
      • tkTokelau
      • toTonga
      • ttTrinidad and Tobago
      • taTristan da Cunha
      • tnTunisia
      • tmTurkmenistan
      • tcTurks and Caicos Islands
      • tvTuvalu
      • trTürkiye
      • ugUganda
      • uaUkraine
      • aeUnited Arab Emirates
      • gbUnited Kingdom
      • unUnited Nations
      • umUnited States Minor Outlying Islands
      • usUnited States of America
      • xxUnknown
      • uyUruguay
      • uzUzbekistan
      • vuVanuatu
      • veVenezuela
      • vnVietnam
      • vgVirgin Islands (British)
      • viVirgin Islands (U.S.)
      • gb-wlsWales
      • wfWallis and Futuna
      • ehWestern Sahara
      • yeYemen
      • zmZambia
      • zwZimbabwe

      @ebay/skin/floating-label

      DS v2.2

      Floating labels appear to sit inside the textbox when it has no value or focus, and sit above the textbox otherwise.

      Floating Label with no Value

      If the textbox has no value, the label can be positioned inside the textbox.

      Floating Label with Value

      If the textbox has a value, the label must be positioned above the textbox.

      Large floating label

      Floating Label with Disabled Textbox

      Use the disabled property & floating-label__label--disabled modifier on the input element and the label element respectively to disable the input.

      Floating Label with Placeholder

      The placeholder should only be shown when the textbox is focused and there is no text

      Floating Label with Invalid Textbox

      Set the aria-invalid property to true and add floating-label__label--invalid to the label to semantically and visually highlight the invalid state.

      Floating Label with Textarea

      Use the textarea tag for a multi-line textbox.

      A multi-line textbox allows line breaks and has a minimum height of 200px.

      In order to prevent overlap for floating label, use .floating-label--opaque class

      Floating label with Combobox

      Use the textarea tag for a multi-line textbox.

      A multi-line textbox allows line breaks and has a minimum height of 200px.

      Option 1
      Option 2
      Option 3

      Floating Label with long text

      This example shows how the floating label will truncate with long text

      Floating Label with select

      Floating Label with large select

      Floating Label with Phone input

      For phone input, the label always remains in floating state above the input. This state ensures that the label does not obscure the phone number.

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1

      Floating Label Transitions

      By default, with only the base markup shown above, the label remains in a floating state above the input. This default state ensures that the label does not obscure the textbox value while we wait for JavaScript.

      When JavaScript is ready, the label can be re-positioned inside the textbox by adding the floating-label__label--inline modifier class. By default, this re-positioning of label happens instantly, without a transition. Typically, we do not want to show transitions on the initial page render, as this might be too jarring and distracting for some users.

      You will also need to add the floating-label__label--focus class when the input recieves focus and remove it when the input loses focus. This is to ensure the right colors are applied to the label when focusing the input.

      To opt into transitions after the initial render is complete, add the floating-label__label--animate modifier when the textbox receives focus.

      The examples above use makeup-floating-label, a simple JavaScript module that adds the aforementioned logic. Feel free to use this module or use it as the basis to roll your own.

      @ebay/skin/global

      The global module defines the styles of any common page aspects, such as font family, font size, background color, text color and link states.

      @ebay/skin/icon-button

      DS v1.6

      Use the icon-btn class (for buttons) or the icon-link class (for links) and any of the available icons for a borderless, actionable icon style.

      To remove the background colour and hover states, apply the icon-btn--transparent modifier. This is typically needed if the icon button is placed on a non-default background colour or if the icon has a colour fill (as in the case below).

      Badged Icon Button

      An icon button can be badged using the badge module.

      The button or anchor element requires an additional icon-btn--badged or icon-link--badged modifier, respectively.

      Primary Icon Button

      Use the primary modifier to create a primary icon button variant.

      Secondary Icon Button

      Use the secondary modifier to create a secondary icon button variant.

      Tertiary Icon Button

      Use the tertiary modifier to create a tertiary icon button variant.

      Using with a Progress Spinner

      You may use a progress spinner inside the icon button.

      You may use an <a> to create a link icon button as well.

      @ebay/skin/icon

      DS v1.3

      The icon module is a bundle that provides full access to the entire range of eBay iconography via the <svg> and <use> tags.

      Base Icons Only

      Only base icons should be used. No state-based icons, such as disabled icons or even possibly an icon relaying an error state (likely red), should be used. Those state modifications on icons should be handled downstream using css modifiers to allow for those variations.

      General Markup Approach

      To avoid gigantic icons when in a non-CSS state, we use the SVG width and height attributes to override the browser's default 300x150 size.

      NOTE: Skin removes all pointer events on icons (via pointer-events: none) due to a bug in IE. To add events to these icons you should wrap them in another element and attach your events there.

      Including an Icon

      An icon symbol declaration can be referenced from the same file or an external SVG file. If in the same file, the symbol must be stamped on the page inside of an SVG block.

      We also provide individual icons as SVGs located in this directory. You can include these on your page as raw SVGs as needed.

      NOTE: the SVG tag does not support the hidden attribute, hence a hidden wrapper element is needed.

      Presentational Icons

      A presentational icon provides no additional content, context or affordance to a page, section or widget.

      Presentational icons require aria-hidden="true", in order to hide them from assistive technology.

      Non-Presentational Icons

      A non-presentational icon provides essential content, context or affordance to a page, section or widget.

      Non-presentational icons require both role="img" and an aria-label for assistive technology.

      Icon Classes

      Each icon can have a class that corresponds to its width. For example, icon--24 corresponds to the 24px width icon. These correspond with the size associated with each icon.

      For colored icons use icon--24-colored These will set the height, and the width will align with the aspect ratio

      Icons have a name postfix that corresponds to the width of the icon. For example, "icon-information-24" corresponds to the information icon of the 24px width. Heights may differ depending on the icon.

      • add-24
      • add-16
      • add-image-24
      • add-12
      • afterpay-24-colored
      • afterpay-12-colored
      • afterpay-18-colored
      • ai-16
      • afterpay-32-colored
      • ai-20
      • ai-24
      • ai-filled-20
      • ai-filled-16
      • ai-filled-24
      • ai-spectrum-20-colored
      • ai-spectrum-16-colored
      • ai-spectrum-filled-20-colored
      • ai-spectrum-24-colored
      • ai-spectrum-filled-16-colored
      • ai-thin-16
      • ai-spectrum-filled-24-colored
      • alipay-cn-12-colored
      • ai-spectrum-thin-16-colored
      • alipay-cn-18-colored
      • amex-12-colored
      • amex-18-colored
      • alipay-cn-24-colored
      • amex-24-colored
      • amex-32-colored
      • apple-24
      • apple-pay-12-colored
      • apple-pay-18-colored
      • archive-16
      • apple-pay-24-colored
      • apple-pay-32-colored
      • archive-24
      • arrow-left-12
      • arrow-left-16
      • arrow-left-24
      • arrow-left-20
      • arrow-right-20
      • arrow-right-24
      • arrow-right-16
      • arrows-3d-16
      • arrows-3d-24
      • arrows-3d-filled-64-colored
      • arrows-expand-16
      • arrows-expand-24
      • article-16
      • attention-16
      • attention-24
      • attention-filled-16
      • attention-64
      • article-24
      • attention-filled-24
      • atv-24
      • audio-high-16
      • audio-low-16
      • atv-16
      • audio-off-16
      • authenticity-guarantee-filled-16-colored
      • authenticity-guarantee-16
      • authenticity-guarantee-filled-24-colored
      • authenticity-guarantee-24
      • auto-adjust-24
      • background-removal-16
      • background-removal-24
      • bank-16
      • bank-24
      • bank-account-12-colored
      • bank-64
      • bank-account-24-colored
      • bank-account-18-colored
      • bank-account-32-colored
      • bar-chart-24
      • bids-16
      • bar-chart-16
      • bids-24
      • bids-64
      • boat-16
      • boat-24
      • book-24
      • book-16
      • bookmark-16
      • bookmark-filled-16
      • bookmark-filled-24
      • brand-authorized-seller-16
      • brand-authorized-seller-24
      • brightness-20
      • brightness-16
      • brightness-24
      • calendar-16
      • camera-16
      • calendar-24
      • calendar-64
      • bookmark-24
      • camera-24
      • camera-64
      • car-24
      • car-brake-16
      • car-16
      • car-brake-24
      • carryon-24
      • arrow-right-12
      • cart-20
      • cart-16
      • cart-64
      • categories-16
      • categories-24
      • cart-24
      • cb-32-colored
      • cb-18-colored
      • cb-24-colored
      • chair-16
      • certified-recycled-24
      • chair-24
      • certified-recycled-16
      • chat-16
      • cb-12-colored
      • chat-24
      • chat-64
      • check-in-24
      • checkmark-24
      • checkbox-mixed-24
      • chevron-down-12
      • chevron-down-16
      • chevron-down-24
      • chevron-down-20
      • chevron-left-12
      • chevron-left-20
      • chevron-left-16
      • chevron-right-16
      • chevron-right-20
      • chevron-up-12
      • chevron-right-12
      • chevron-left-24
      • chevron-up-16
      • chevron-right-24
      • chevron-up-20
      • chinese-coin-16
      • chinese-coin-24
      • chevron-up-24
      • clear-16
      • clear-24
      • click-to-call-16
      • clear-20
      • click-to-call-24
      • clock-24
      • clock-16
      • clock-64
      • close-12
      • close-16
      • close-20
      • closed-caption-16
      • close-24
      • coin-24
      • collections-16
      • condensed-grid-24
      • closed-caption-filled-16
      • collections-24
      • condensed-grid-filled-24
      • confirmation-64
      • confirmation-24
      • confirmation-filled-12
      • confirmation-filled-24
      • confirmation-filled-16
      • contract-16
      • contrast-24
      • copy-16
      • copy-24
      • credit-card-16
      • credit-card-64
      • customize-16
      • crop-24
      • delete-16
      • delete-20
      • customize-24
      • density-default-16
      • delete-24
      • confirmation-16
      • density-default-24
      • credit-card-24
      • density-relaxed-16
      • density-compact-16
      • diamond-24
      • density-relaxed-24
      • diamond-16
      • diners-12-colored
      • diners-18-colored
      • diners-32-colored
      • diners-24-colored
      • direct-debit-12-colored
      • direct-debit-18-colored
      • direct-from-brand-24
      • direct-debit-24-colored
      • direct-debit-32-colored
      • discord-24
      • direct-from-brand-16
      • discount-16
      • density-compact-24
      • discount-24
      • discover-12-colored
      • dollar-16
      • discover-18-colored
      • discover-24-colored
      • dollar-24
      • download-16
      • download-20
      • download-24
      • drag-drop-16
      • discover-32-colored
      • drag-drop-24
      • ebay-balance-18-colored
      • ebay-balance-24-colored
      • ebay-balance-12-colored
      • ebay-balance-32-colored
      • ebay-for-charity-16
      • ebay-for-charity-24
      • ebay-bucks-logo-16-colored
      • ebay-international-shipping-16
      • ebay-international-shipping-24
      • ebay-live-16
      • ebay-international-shipping-64
      • ebay-live-24
      • ebay-mastercard-18-colored
      • ebay-money-back-guarantee-logo-16-colored
      • ebay-mastercard-12-colored
      • ebay-mastercard-24-colored
      • ebay-plus-16
      • ebay-plus-24
      • ebay-mastercard-32-colored
      • ebay-plus-logo-16-colored
      • ebay-preloved-24
      • ebay-refurbished-24
      • ebay-preloved-16
      • ebay-refurbished-16
      • escrow-24
      • escrow-card-18-colored
      • escrow-card-24-colored
      • escrow-card-12-colored
      • escrow-card-32-colored
      • euro-16
      • exclude-16
      • expand-16
      • euro-24
      • explore-16
      • explore-24
      • external-link-16
      • exclude-24
      • external-link-20
      • face-happiest-24
      • face-happy-24
      • face-happy-16
      • face-neutral-24
      • face-saddest-24
      • facebook-24
      • fall-leaf-16
      • facebook-messenger-24
      • alipay-cn-32-colored
      • fast-and-free-16
      • fall-leaf-24
      • fast-and-free-24
      • face-sad-24
      • fast-and-free-64
      • feedback-16
      • feedback-received-16
      • feedback-24
      • escrow-16
      • feedback-received-24
      • file-24
      • file-16
      • filter-16
      • fingerprint-64
      • filter-24
      • fingerprint-24
      • flag-24
      • flag-filled-16
      • flag-filled-24
      • flash-auto-24
      • flash-off-24
      • flash-24
      • flag-16
      • folder-24
      • franc-16
      • free-warranty-16
      • franc-24
      • full-view-16
      • free-warranty-24
      • full-view-filled-16
      • full-view-filled-24
      • folder-16
      • full-view-24
      • gallery-16
      • gallery-24
      • general-card-12-colored
      • general-card-32-colored
      • general-card-18-colored
      • general-card-24-colored
      • generic-card-18-colored
      • generic-card-24-colored
      • generic-card-12-colored
      • gift-16
      • gift-24
      • gift-card-18-colored
      • generic-card-32-colored
      • gift-card-24-colored
      • gift-64
      • gift-card-32-colored
      • girocard-18-colored
      • gift-card-12-colored
      • girocard-12-colored
      • glasses-64
      • glasses-24
      • google-24
      • google-pay-12-colored
      • external-link-24
      • girocard-32-colored
      • google-pay-18-colored
      • graph-16
      • girocard-24-colored
      • google-pay-24-colored
      • google-pay-32-colored
      • graph-64
      • graph-24
      • graph-dynamic-16
      • grid-view-16
      • graph-dynamic-24
      • grid-view-24
      • handbag-16
      • grid-view-filled-24
      • hanger-24
      • handbag-24
      • headlight-24
      • hanger-16
      • headphone-16
      • headphone-24
      • help-16
      • help-20
      • help-24
      • headlight-16
      • grid-view-filled-16
      • help-outline-16
      • hide-24
      • help-outline-24
      • help-outline-20
      • hide-16
      • home-24
      • history-64
      • history-16
      • history-24
      • image-24
      • home-filled-24
      • feedback-20
      • inbox-16
      • image-64
      • inbox-24
      • information-24
      • information-filled-16
      • inspect-16
      • image-16
      • inspect-24
      • information-16
      • information-filled-24
      • inspect-64
      • item-list-16
      • instagram-24
      • jcb-24-colored
      • item-list-24
      • jcb-12-colored
      • jcb-18-colored
      • key-24
      • jcb-32-colored
      • jet-ski-16
      • jet-ski-24
      • item-list-20
      • keyboard-16
      • klarna-black-12-colored
      • klarna-black-24-colored
      • klarna-black-18-colored
      • keyboard-24
      • klarna-pink-18-colored
      • klarna-pink-12-colored
      • klarna-black-32-colored
      • klarna-pink-32-colored
      • klarna-pink-24-colored
      • klarna-white-24-colored
      • key-16
      • klarna-white-18-colored
      • klarna-white-12-colored
      • krona-24
      • lamp-16
      • krona-16
      • klarna-white-32-colored
      • lamp-24
      • large-box-24
      • large-box-16
      • legacy-click-to-call-48-colored
      • legacy-authenticity-guarantee-48-colored
      • legacy-free-warranty-48-colored
      • legacy-money-back-guarantee-chf-48-colored
      • legacy-escrow-48-colored
      • legacy-money-back-guarantee-us-48-colored
      • legacy-money-back-guarantee-zl-48-colored
      • legacy-money-back-guarantee-eu-48-colored
      • legacy-top-rated-seller-48-colored
      • lightbulb-24
      • lightbulb-16
      • lightning-bolt-24
      • lightning-bolt-16
      • legacy-money-back-guarantee-uk-48-colored
      • linkedin-24
      • link-24
      • list-view-filled-16
      • list-view-16
      • live-eye-16
      • list-view-24
      • list-view-filled-24
      • location-24
      • live-eye-24
      • location-16
      • location-64
      • locked-24
      • locked-20
      • maestro-12-colored
      • mail-20
      • maestro-18-colored
      • mail-16
      • maestro-24-colored
      • mail-24
      • locked-16
      • mail-64
      • mail-move-16
      • mail-move-24
      • mail-open-16
      • mail-unread-16
      • masonry-view-16
      • map-16
      • map-20
      • mail-unread-24
      • masonry-view-filled-16
      • masonry-view-24
      • masonry-view-filled-24
      • mail-open-24
      • mastercard-12-colored
      • mastercard-18-colored
      • map-24
      • mastercard-24-colored
      • mastercard-32-colored
      • medium-box-16
      • medium-box-24
      • megaphone-24
      • megaphone-16
      • menu-20
      • menu-24
      • mobile-24
      • microphone-24
      • mobile-signal-24
      • money-back-guarantee-16
      • money-back-guarantee-24
      • money-back-guarantee-filled-16-colored
      • money-back-guarantee-filled-24-colored
      • money-stack-16
      • money-stack-24
      • monthly-invoice-18-colored
      • monthly-invoice-12-colored
      • monthly-invoice-24-colored
      • moon-16
      • maestro-32-colored
      • monthly-invoice-32-colored
      • moon-20
      • moon-24
      • motorcycle-24
      • mountain-16
      • move-24
      • motorcycle-16
      • microphone-16
      • mountain-24
      • negative-filled-16
      • move-16
      • nectar-logo-24-colored
      • negative-filled-24
      • neutral-24
      • notification-20
      • notification-16
      • neutral-16
      • notification-64
      • notification-24
      • notification-filled-24
      • on-the-way-16
      • overflow-horizontal-16
      • overflow-horizontal-24
      • on-the-way-24
      • overflow-vertical-16
      • overflow-vertical-20
      • package-16
      • overflow-vertical-24
      • package-24
      • package-64
      • panel-16
      • panel-20
      • panel-24
      • overflow-horizontal-20
      • panel-close-24
      • panel-open-16
      • panel-open-20
      • panel-close-16
      • passkey-16
      • panel-open-24
      • panel-close-20
      • passkey-64
      • pause-16
      • pause-24
      • pause-filled-64-colored
      • passkey-24
      • payoneer-24-colored
      • payoneer-12-colored
      • payoneer-18-colored
      • paypal-12-colored
      • paypal-18-colored
      • payoneer-32-colored
      • paypal-24-colored
      • paypal-32-colored
      • paypal-credit-24-colored
      • paypal-credit-12-colored
      • paypal-credit-32-colored
      • paypal-credit-18-colored
      • paypal-disabled-12-colored
      • paypal-disabled-24-colored
      • paypal-disabled-18-colored
      • paypal-disabled-32-colored
      • pencil-20
      • pencil-16
      • peso-16
      • pencil-24
      • phone-16
      • peso-24
      • phone-24
      • pin-24
      • pin-filled-24
      • pinterest-24
      • play-16
      • play-24
      • play-filled-16-colored
      • play-filled-24-colored
      • play-filled-64-colored
      • postepay-24-colored
      • postepay-12-colored
      • postepay-18-colored
      • postepay-32-colored
      • potted-plant-16
      • potted-plant-24
      • print-24
      • pound-16
      • print-16
      • pound-24
      • profile-20
      • profile-16
      • profile-24
      • profile-filled-24
      • promotion-16
      • progress-upcoming-24
      • promotion-24
      • progress-current-24
      • qr-code-16
      • qr-code-24
      • recovery-code-16
      • recovery-code-24
      • reddit-24
      • relaxed-grid-24
      • refresh-24
      • relaxed-grid-filled-24
      • refresh-16
      • remove-12
      • remove-24
      • remove-16
      • return-16
      • reply-16
      • ribbon-16
      • ribbon-24
      • return-24
      • reply-24
      • rim-16
      • ringgit-24
      • rim-24
      • rotate-24
      • ringgit-16
      • rotate-portrait-right-24
      • rotate-landscape-left-24
      • rupee-16
      • rotate-landscape-right-24
      • rupee-24
      • satchel-16
      • save-16
      • save-filled-20
      • save-20
      • save-24
      • save-filled-24
      • save-filled-16
      • scan-16
      • search-16
      • search-20
      • satchel-24
      • scan-24
      • rotate-portrait-left-24
      • search-64
      • search-24
      • search-similar-20
      • search-similar-16
      • search-filled-24
      • seasons-24
      • search-similar-24
      • seasons-16
      • select-all-24
      • security-key-24
      • selling-16
      • settings-16
      • selling-20
      • selling-24
      • selling-filled-24
      • settings-20
      • send-24
      • share-android-16
      • settings-24
      • share-android-20
      • sharpen-24
      • share-ios-16
      • share-android-24
      • share-ios-24
      • ship-and-local-16
      • ship-and-local-24
      • shirt-24
      • shirt-16
      • shoe-box-24
      • share-ios-20
      • shovel-24
      • show-24
      • show-16
      • small-box-24
      • shovel-16
      • small-letter-24
      • small-box-16
      • sneaker-24
      • snowmobile-16
      • snowflake-24
      • sneaker-16
      • sort-12
      • sort-16
      • snowmobile-24
      • sort-24
      • sort-down-12
      • sparkline-down-16
      • sparkline-down-24
      • sort-up-12
      • sparkline-up-20
      • sparkline-down-20
      • sparkline-up-24
      • sparkline-up-filled-24
      • sparkline-up-16
      • speedometer-24
      • snowflake-16
      • speedometer-16
      • split-payment-16
      • split-payment-24
      • split-view-filled-24
      • split-view-24
      • spring-leaf-16
      • spring-leaf-24
      • star-empty-24
      • star-empty-40
      • star-empty-16
      • star-filled-24
      • star-filled-40
      • star-filled-16
      • star-half-24-colored
      • star-half-16-colored
      • star-half-dark-24-colored
      • stepper-attention-24
      • stepper-current-24
      • star-half-dark-16-colored
      • stepper-confirmation-24
      • stepper-upcoming-24
      • store-64
      • store-24
      • store-16
      • suitcase-24
      • store-filled-24
      • swap-24
      • support-24
      • switch-camera-24
      • target-16
      • target-24
      • text-messaging-20
      • text-messaging-16
      • text-messaging-64
      • thumb-down-16
      • text-messaging-24
      • the-ebay-vault-16
      • the-ebay-vault-24
      • thumb-down-filled-16
      • thumb-down-filled-20
      • thumb-down-24
      • thumb-down-filled-24
      • thumb-down-20
      • thumb-up-16
      • thumb-up-20
      • thumb-up-64
      • thumb-up-filled-24
      • tick-16
      • thumb-up-24
      • tick-24
      • thumb-up-filled-20
      • toggle-mode-bottom-24
      • tiktok-24
      • thumb-up-filled-16
      • top-rated-seller-16
      • top-service-16
      • toggle-mode-top-24
      • top-rated-seller-24
      • top-service-24
      • trading-card-16
      • translate-16
      • trading-card-24
      • transaction-24
      • translate-20
      • trend-down-16-fit
      • trend-up-16-fit
      • translate-24
      • trophy-24
      • trophy-16
      • undo-16
      • twitter-24
      • unionpay-18-colored
      • unionpay-24-colored
      • unionpay-12-colored
      • undo-24
      • unionpay-32-colored
      • unlocked-16
      • unselect-all-24
      • upload-16
      • unlocked-24
      • upload-24
      • venmo-12-colored
      • venmo-24-colored
      • venmo-32-colored
      • verified-condition-16
      • verified-condition-24
      • venmo-18-colored
      • video-24
      • visa-18-colored
      • visa-32-colored
      • visa-24-colored
      • visa-12-colored
      • wallet-balance-18-colored
      • wallet-balance-12-colored
      • wallet-64
      • wallet-balance-32-colored
      • wallet-24
      • watch-16
      • wallet-balance-24-colored
      • watch-24
      • whatsapp-24
      • won-24
      • youtube-24
      • won-16
      • wrench-24
      • yuan-16
      • wrench-16
      • zloty-16
      • yuan-24
      • zoom-in-16
      • zoom-in-24
      • zloty-24
      • zoom-out-24
      • zoom-out-16

      Disabled Icons

      Most icons can be given a disabled appearance by adding the icon--disabled modifier.

      Simple Icons

      Icons that are simple and have only a stroke/fill of a single color simply inherit color and are disabled by inheriting that color as the stroke/fill.

      Filled Icons

      There are certain filled icons that show up black by default. In order to color these icons, apply the icon--{name}-filled modifier.

      Complex Icons

      Icons that are more complex and have multiple colors with a suffix of -colored are grayscaled with an opacity.

      @ebay/skin/image-placeholder

      Image placeholder should be used when an image is not present. By default this is 300x300px, but can be resized to it a container.

      This asset can be found either in dist/svg/icons/image-placeholder.svg or in the icons bundle

      Variable widths with borders

      @ebay/skin/infotip

      DS v2

      An infotip is a button which can be clicked to display information about another element or area on the page.

      Toggle the aria-expanded state of the button to expand or collapse the infotip.

      Infotip

      Here's a tip to help you be successful at your task.

      By default, the position of the overlay and its pointer will remain static. For these following examples, we are using floating-ui to help position the tooltip and the pointer dynamically.

      In order to get this to work with floating-ui, you need to remove pointer position infotip__pointer--top-left and remove any style positioning

      Infotip

      Here's a tip to help you be successful at your task.

      If nesting an infotip inside of a paragraph element, make sure that there are no block level elements, such as div, h1-6, or p elements.

      Inside paragraph InfotipHere's a tip to help you be successful at your task.

      Modal Infotip

      On small screens, the infotip should launch a modal lightbox-dialog.

      @ebay/skin/inline-notice

      DS v2.2

      The purpose of a notice is to convey the next course of action for a task or flow. The notice must be clear and concise, with minimum cognitive load.

      An inline-level notice provides tips, guidance and feedback on individual elements and form controls.

      An inline-level notice may have a status of general (default), confirmation, information or attention.

      Your price has been updated.

      Your price has been updated.

      Send offers to interested buyers.

      Add required aspects to keep item alive.

      @ebay/skin/less

      DS v1

      DEPRECATED. Use SASS mixins and variables instead

      In comparison to past versions, Skin now offers a very minimal public LESS API (i.e. LESS variables and mixins). Over time this may be reduced to zero. This is due to the introduction of CSS Custom Properties, which give us many benefits over LESS variables in our token based system.

      Also, our Less module is not intended as a general-purpose library of utility mixins and variables such as LessHat .

      NOTE : Lasso requires the additional lasso-less plugin dependency in your app package.json.

      Spacing Tokens (deprecated)

      Skin uses a proportional spacing system anchored around a base value of 8px.

      NOTE: Spacing variables in LESS are deprecated. In a future release, they will become part of the new CSS Custom Property API.

      Spacing Tokens
      NAMESIZE
      spacing-25spacing-100 * 0.25
      spacing-50spacing-100 * 0.50
      spacing-1008
      spacing-200spacing-100 * 2
      spacing-400spacing-100 * 4
      spacing-600spacing-100 * 6
      spacing-800spacing-100 * 8

      Typography Mixins

      • .typography-giant-3();
      • .typography-giant-2();
      • .typography-giant-1();
      • .typography-large-2();
      • .typography-large-2-secondary();
      • .typography-large-1();
      • .typography-large-1-secondary();
      • .typography-medium-bold();
      • .typography-medium();
      • .typography-medium-secondary();
      • .typography-regular-bold();
      • .typography-regular();
      • .typography-regular-secondary();
      • .typography-small-bold();
      • .typography-small();
      • .typography-small-secondary();

      @ebay/skin/list

      DS v1

      A list component is used to display certain types of data in a structured format. It can be used to display a list of items, a list of links, or a list of buttons.

      This can be placed inside a container and will resize to fit the contents. The list expands to a maxumum of 480px.

      Default List

      • Text 1
      • Text 2
      • Text 3

      Actionable list

      List also supports buttons or links as a list item. Actionable components, such as a switch, can be added in the trailing portion of the list, but they cannot be used in conjunction with buttons or link.

      • Link
      • Item 1 with an action

      List with dividers

      To add a divider, add a hr element after the list item.

      • Item 1

      • Item 2
      • Item with a large amount of text that should wrap and go to the next line. If there is too much it would wrap

      List with variable width

      The list will adjust to the width of the container it is in.

      • Item 1
      • Item 2

      @ebay/skin/listbox-button

      DS v2.2

      A listbox button is intended for use as a custom implementation of the native HTML select element's single -select use case.

      Because a button element does not store form data, its value will not be submitted along with other form data without the assistance of JavaScript.

      Unselected Listbox Button

      By default, the listbox button is in an unselected state.

      Red
      Blue
      Yellow
      Green

      To give the illusion of a floated label use the btn--floating-label and btn__floating-label classes.

      NOTE : a btn__floating-label--inline class must also be toggled with JavaScript. It should be present when there is no selection, and vice versa.

      Red
      Blue
      Yellow
      Green

      Selected Listbox Button

      A selection can be made by applying the aria-selected state to a single option; JavaScript is required to update all ARIA and button text state.

      Red
      Blue
      Yellow
      Green

      The following example shows the "floated label" version with a value selected.

      Red
      Blue
      Yellow
      Green

      Listbox Button with option description

      You can also add a description to each option by using .listbox-button__description

      In order to make the description accessible, you need to add a clipped punctuation marker. This ensures screen readers will read the subtitle as a separate sentence.

      Red. This is a red color
      Blue. This is a blue color
      Yellow. This is a yellow color
      Green. This is a green color

      Borderless

      Apply the btn--borderless modifier to create a borderless listbox button.

      1
      2
      3

      Error State

      Apply the listbox-button--error modifier to create a listbox button in an error state.

      This is a simple example with a simple error indication. For usage of the error state with an error message, please see the field module .

      Red
      Blue
      Yellow
      Green

      Form Variant

      Apply the listbox-button--form modifier to create a listbox button inside a form matching other form controls.

      Additionally, to allow the component to send the value from a selected option in a form submission, there needs to be custom js to populate the select.listbox__native with the value upon selection. If using Skin outside of eBay UI, you will need to account for that independantly.

      NOTE: This component is a bit in transiton and will likely undergo some changes to integrate and simplify the variant implementation. Currently, .listbox-button--form is used as a bit of a patch to create the form variant of the control. It adds some of the styles needed to do form variant styling while other styles are applied separately by .btn--form . In the future, these styles will be consolidated into .btn--form and will be .listbox-button--form will be phased out.

      Red
      Blue
      Yellow
      Green

      @ebay/skin/listbox

      DS v2.2

      A listbox is intended for use as a custom, non-form based implementation of the native HTML select element.

      Unselected Listbox

      By default, no option is selected until interacting with the widget. This matches the behaviour of a native HTML select element.

      Option 1
      Option 2
      Option 3
      Option 4

      Selected Listbox

      An initial selection can be specified by applying the aria-selected state to a single option.

      Option 1
      Option 2
      Option 3

      Listbox with subtitles

      You can add a subtitle to an option by adding a .listbox__description element.

      Option 1. More info about option 1
      Option 2. More info about option 1
      Option 3. More info about option 1

      @ebay/skin/marketsans

      Market Sans is an exclusive typeface developed specifically for eBay. This module downloads and installs the typeface directly from the eBay CDN servers. The typeface can then be referenced via the 'Market Sans' font-family name.

      ABCDEFGHIJKLMNOPQRSTUVWXYZ
      abcdefghijklmnopqrstuvwxyz

      TIP: The Market Sans font-family, and all fallbacks, can also be applied using the Less variable @font-family-market-sans.

      @ebay/skin/page-grid

      DS v1.0.0

      The page grid module establishes the rows, columns and areas onto which child elements can be placed. The page grid is fully responsive.

      Setting up a responsive page grid requires two key elements: a container element, and the grid element itself.

      The container element takes care of positioning the grid in relation to the page (typically center-justified) and adds outer margins.

      The grid element creates the actual columns (and gutters); eight columns for small viewports, sixteen for large.

      Any content that is off-grid , a full bleed banner for example, should be placed outside of these two elements.

      Grid areas are definable with CSS Grid syntax .

      Responsive Methodology

      When working with responsive web pages, the mindset should always be mobile-first. This means that your default styles (outside of media queries) should be targeting phones - the smallest of screens. As such, there is no need to have a minimum threshold by wrapping mobile styles inside a media query.

      Though our minimum screen width support starts at 320px , in theory this means that default styles will support devices much narrower than that since we don't set a minimum. The 320px is, at best, an implied breakpoint.

      Subsequent media queries should increase in screen width and alter the UI styling additively avoiding style declaration duplications when possible. The following CSS shows the grid layout of the Skin website itself.

      You can see that for small screens, our top-level landmark elements simply span the full width of the grid. For large screens, things are a little more interesting, and we specify exactly how many rows and columns each landmark should occupy on the grid.

      Here is the corresponding HTML.

      You can see how it looks on this page by enabling our debug mode , which gives a quick visual indication of the grid columns.

      Page Grid LESS/CSS Properties

      We've set up CSS properties and LESS constants to provide developers with easy reference for responsive adjustments of UIs. The CSS properties allow for customization of page grid for UIs that require it, but please use them sparingly and be mindful of the impact those overrides can have .

      The CSS properties to allow for customization

      These properties allow for costumization of page grid for UIs that require it, but please use them sparingly and be mindful of the impact those overrides can have .

      Additionally, we've set up LESS constants for easier reference of the current breakpoints as well as some other dimension/spacing values.

      Please do NOT overwrite these!

      They are meant to be consumed ONLY as constants for read-only purposes as references.

      Subgrids

      Subgrids allow you to create alignment of child elements on the same grid as page grid. Currently, subgrid only has partial support (with and without CSS Subgrid support), but fallbacks allow for a seamless implementation. You will need to add a bit of CSS on your implementation side to accomplish this.

      Firstly, you will need to add a class of page-grid__subgrid to the internal subgrid:

      Additionally, you will need to set up the corresponding subgrid CSS as such to allow for support of subgrids in browsers that do not yet have support:

      Page Grid Templates

      To see how the page grid system (engine) works in conjunction with various types of implementations (templates), check out our set of templates utilizing page grid and subgrid.

      Page Grid Templates

      @ebay/skin/page-notice

      DS v3

      A page notice appears prominently at the top of the page, for high priority use cases, conveying the next course of action for a task or flow.

      To aid discoverabilty for assistive technology, each page notice is a labelled landmark region with a level-2 heading.

      A page notice can have a status of general (default), confirmation, attention or information.

      We've updated the look and feel of this page. Customize anytime in settings.

      You have opted into eBay Pay and will now get paid directly.

      Your selling account has been deactivated.

      Opt into eBay payments before Jan 12th to pay no selling fees.

      Dismissable Page Notice With Title

      Notice Title

      Opt into eBay payments before Jan 12th to pay no selling fees.

      Opt in

      Form Error Page Notice

      We found problems with your form.

      Error 1 , Error 2 , Error 3 .

      @ebay/skin/panel-dialog

      DS v2

      Panel dialogs are modal and require a close button. They fill the entire y-axis of the screen and a portion of the x-axis.

      The dialog must remain in a hidden state for all users and devices until opened.

      End Panel

      Apply the panel-dialog__window--end modifier to display the panel at the end of the x-axis.

      End panels typically contain an additional CTA button.

      Sliding Panel

      Panels can slide in and out, using the dialog__window--slide modifier.

      The slide transition duration is 32ms. An accompanying dialog--mask-fade-slow modifier on the panel-dialog should also be applied. This slower fade matches the 32ms of the slide transition.

      @ebay/skin/phone-input

      DS v4

      The phone input pattern is a progressive enhancement of a textbox that allows users to select the country associated with their phone number.

      Default Phone input

      Use the phone-input class to create the default phone input. The phone input consists of a listbox button and a textbox with type=tel . The listbox button is used to select the country code and the textbox is used to enter the local phone number.

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1

      With Group Label

      Use ARIA to provide a grouping role, similar to fieldset and legend, for more flexibility when using field classes. For label inline usage, please see the field module .

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1

      Large Phone input

      Use the phone-input--large modifier to increase the size of the phone input. Also, use btn--large, btn--large-fixed-height and textbox--large for the button and textbox respectively.

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1

      Readonly Phone input

      Use the phone-input--readonly modifier to make the control readonly. The listbox button is disabled and readonly attribute is added on the textbox to prevent any modification of its value.

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1

      Disabled Phone Input

      Use the phone-input--disabled modifier to turn on the disabled state. Besides modifier, disabled attribute on both the listbox button and textbox input to completely disable the phone input.

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1

      Error Phone Input

      Using the listbox-button--error modifier, turns on the error state to the listbox button and aria-invalid="true" to the textbox.

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1
      There was an error

      Fluid Phone input

      Using the phone-input--fluid modifier makes the component fluid and expands it to the width of its container.

      Albania(+355)
      India(+91)
      Saint Helena, Ascension and Tristan da Cunha(+290)
      United Kingdom(+44)
      United States of America(+1)
      +1

      @ebay/skin/progress-bar-expressive

      DS v1.1

      The expressive progress bar can replace our traditional spinner to feel faster during periods of longer loading. To portray responsive and quicker loads, the expressive loader's design uses visual momentum to indicate progression across refreshing, page loading and user actions.

      This pattern consists of an animated progress bar in various colors and an optional set of messages that are cycled into view. These messages render in an element with role="status" , which announces new content to assistive technology. The live examples that follow use aria-live="off" to prevent the status element from proactively announcing new content. This is only for demo purposes, so that this documentation page does not overwhelm the viewer with example status updates. The aria-live override should not be included in implementations of this pattern.

      The expressive progress bar also renders different experiences depending on the prefers-reduced-motion media query. Toggle your reduced motion settings to view examples with the default behavior and reduced motion behavior.

      Default Expressive Progress Bar

      The base expressive loader consists of a progressbar with 12 lines of varying widths. Each line has a width of 10% - 40% of its container, with each set of four lines adding up to 100% width. You can use JavaScript to randomly generate the line widths, though it's not required.

      In the default behavior, lines scale up from 0% to their defined width and move horizontally across the screen. When the user prefers reduced motion, the lines still animate. However, instead of growing from 0% to their defined width, they stay a fixed size and scroll more slowly across the screen.

      Expressive Progress Bar with Single Message

      If there is only one message, add the progress-bar-expressive__message--in class to its status element to animate it in.

      Hang tight.

      Expressive Progress Bar with Multiple Messages

      The following examples demonstrate cycling through messages using JavaScript. Note that JavaScript is not bundled with Skin, so you will need to write your own js implementation of this pattern. We have outlined the steps below so you can recreate them in your JavaScript framework of choice.

      Default behavior

      To cycle a message into view in the default mode:

      1. Animate in the message:
        1. Put the message content in the aria-hidden element with class progress-bar-expressive__message . This element is used just for the visual message animation; it is not read to screen readers.
        2. Add the progress-bar-expressive__message--in class to animate that message into view.
      2. After the message animates in:
        1. Put the message content in the status element with class progress-bar-expressive__message . This will read the message aloud to screen reader users.
        2. Remove the progress-bar-expressive__message--in class from the aria-hidden element.
      3. After a fixed amount of time, add the expressive_loader__message--out class to the current message to animate it out of view. This can happen concurrently with the next message animating in.

      Reduced motion behavior

      When @media (prefers-reduced-motion: reduce) , there is no transition state between messages, so the aria-hidden message is not needed. To fade in the first message, add the progress-bar-expressive__message--initial class to the status element. For all subsequent messages, remove the progress-bar-expressive__message--initial class and simply update the content in the status element.

      Hang tight.

      Medium text

      By default, the expressive progress bar displays with large text. For smaller text, apply the progress-bar-expressive--medium class to the message container.

      Hang tight.

      @ebay/skin/progress-bar

      DS v3.1

      The progress bar gives an immediate, real-time visualisation of the current task completion status.

      Initial State

      A value of 0 reflects an initial state, with zero progress.

      0%

      Loading State

      Any value between 0 and 100 reflects a loading state.

      50%

      Completed State

      A value of 100 reflects a completed state.

      100%

      Fluid Progress Bar

      To fill the entire width of the container, use the progress-bar--fluid modifier.

      50%

      Animated Progress Bar

      Use the buttons below to see an example of the progress bar value being animated.

      0%

      @ebay/skin/progress-spinner

      DS v3.1

      A progress-spinner animation is used to convey a busy or loading state.

      A progress-spinner is considered a critical graphic, therefore an img role and aria-label property are required.

      Small Progress Spinner

      Use the progress-spinner--small modifier class to create a small progress spinner.

      Large Progress Spinner

      Use the progress-spinner--large modifier class to create a large progress spinner.

      @ebay/skin/progress-stepper

      DS v4

      Steppers portray progress through a sequence of steps.

      Default Progress Stepper

      The default stepper has a horizontal layout. The stepper fills all available space and evenly distributes its steps.

      Use the aria-currentattribute to denote the current step in the list. All items after the current will be shown in progress.

      The default state for each item will be the complete or active state until it reaches [aria-current] element. Then the rest will be upcoming state. You can also use .progress-stepper__items--upcoming on the progress-stepper__items container to show upcoming state for all items.

      Shipment Progress

      Started

      July 3rd

      Shipped

      July 4th

      Transit

      July 5th

      Delivered

      July 6th

      The stepper can be sized and aligned using standard CSS:

      Shipment Progress

      Started

      July 3rd

      Shipped

      July 4th

      Transit

      July 5th

      Delivered

      July 6th

      Vertical Progress Stepper

      Use the progress-stepper--vertical modifier for a stepper with vertical layout.

      Order placed

      New Mens Addidas Ultra Boost

      Preparing for shipment

      We will notify you once it ships.

      Delivered

      Guaranteed Wednesday, October 09.

      Shipment Progress

      Started

      July 3rd

      Blocked

      July 5th

      Delivery

      July 6th

      @ebay/skin/radio

      DS v2

      A radio button is a form control that allows a single selection from a group of choices.

      The purpose of a radio button is to collect form data. Therefore, radio buttons should always be used in conjunction with a form, label and submit button.

      The radio is decoupled from its text label to allow more flexibility in terms of layout. How and where you provide this label is up to you, but do not forget it!

      Default Radio

      Use the radio base class to create a styled radio.

      NOTE: Skin uses SVG to give a custom radio button appearance. This SVG is hidden by default to prevent it from appearing alongside the browser default radio button in a non-CSS state.

      Large Radio

      For a larger radio button, use the radio--large modifier plus the #icon-radio-unchecked-24 and #icon-radio-checked-24 icons.

      Disabled Radio

      Use the disabled attribute to disable any radio input.

      Grouped Radio

      A group of radios enforces single-select (unlike a group of checkboxes which allows multi-select).

      A fieldset and legend are required in order to create the correct grouping semantics. Note that the Skin global module removes the default fieldset border and padding.

      The following example uses the field module for simple layout of radio button fields and labels.

      Choose an Option

      TIP : For large radios, wrap each label and control inside of a field__group element to maintain vertical alignment.

      To stack radio buttons vertically instead of side-by-side, simply replace the span wrapper with a div wrapper.

      Choose an Option

      @ebay/skin/section-notice

      DS v3

      A section notice conveys either system status and feedback to users about their actions and options or, for educational section notices, contextually educates users about programs, features and opportunities.

      To aid discoverabilty for assistive technology, each section notice is a labelled landmark region.

      Lorem ipsum dolor sit amet, consectetur adipiscing elit.

      Status Section Notice

      A status-based section notice has a 16x16 icon representing confirmation, attention or information.

      Lorem ipsum dolor sit amet, consectetur adipiscing elit.

      Lorem ipsum dolor sit amet, consectetur adipiscing elit.

      Lorem ipsum dolor sit amet, consectetur adipiscing elit.

      Titled Section Notice

      Use a heading element to create a titled section notice.

      Notification title

      Lorem ipsum dolor sit amet, consectetur adipiscing elit.

      Dismissable Section Notice

      A close button can be placed in a section-notice__footer element.

      Notification title

      Lorem ipsum dolor sit amet, consectetur adipiscing elit.

      Actionable Section Notice

      Link or button actions can be placed in a section-notice__cta element.

      Notification title

      Lorem ipsum dolor sit amet, consectetur adipiscing elit.

      Action

      @ebay/skin/section-title

      DS v4

      Section titles function as identifiers for groups of elements.

      Static Section Title

      The standard, static section title is designed to support a single line on desktop and wrap only when displayed on narrow screens such as mWeb or native.

      Static Section Title

      Subtitled Section Title

      The subtitle is designed to support any additional information. This text should be concise and fit onto a single line.

      Subtitled Section Title

      Plus, guaranteed best prices.

      An arrow icon gives visual affordance that the title is a link. A linked section title can also have a subtitle.

      Linked Section Title

      See all

      Section Title with Favorite

      Section Title with Favorite

      Overflow Section Title

      The optional overflow control can house less frequently accessed controls, (e.g., personalization feedback).

      Overflow Section Title

      @ebay/skin/segmented-buttons

      DS v1

      Segmented Buttons are non-form toggle buttons used in certain cases. For detailed requirements and when to use these over tabs, please visit the eBay MIND Pattern for Segmented Buttons .

      The selected toggle button is toggled by aria-current="true" attribute.

      NOTE: JavaScript is required to handle segmented buttons currently selected button.

      Default Segmented Buttons

      The default segmented button has a 40px height that matches other buttons.

      Segmented Buttons - large

      Use the segmented-buttons--large modifier to create large segemented buttons. These have a 48px height to match large buttons.

      Segmented buttons - with icons

      Any 24x24 icon can be added inside of a segmented-buttons__button-cell block.

      Segmented buttons - in fixed width container

      @ebay/skin/select

      DS v2.2

      A select allows the user to select one item from a list of options. A select is exactly the same as a normal HTML select (because it is one), but Skin's version uses a wrapper to style it.

      The purpose of a select is to collect form data; therefore a select should always be used in conjunction with a form, label and submit button. If you are not submitting form data, then a menu maybe a better choice.

      IMPORTANT: The examples below show the select in isolation, without any label. Please see the field module for details on labeling controls. Remember: every select requires a label!

      Default select

      Disabled select

      Selected option

      Unselected Select

      If no suitable default value exists, the first option in the list can be used as a prompt and set to disabled & selected .

      Fluid select

      Borderless select

      Large Select

      For a large select, apply the select--large modifier.

      @ebay/skin/signal

      DS v1

      Signals are data-backed recommendations to help customers make more informed decisions.

      There are four signal types, each with its own corresponding modifier class: trustworthy, recent, time-sensitive & neutral.

      TrustworthyRecentTime SensitiveNeutral

      @ebay/skin/skeleton BETA

      A skeleton is a graphical placeholder, reserving physical space in the page for content that is not yet available for the client to render. A skeleton can be considered as an alternative to the progress spinner in many situations.

      A skeleton is appropriate as a placeholder for content in cases where a service or action may be slow to resolve.

      A skeleton is NOT appropriate as a placeholder for content if rendering that content or placeholder would cause unexpected page layout shift (see below for more details).

      Cumulative Layout Shift (CLS)

      It is the developer's responsibility to ensure the CLS metric of a page is not negatively impacted by the introduction of a skeleton placeholder; a poor CLS score will occur whenever content shifts unexpectedly . Unexpected movement of page content usually happens because resources are loaded asynchronously or DOM elements get dynamically added to the page above existing content. Skeletons can help mask these problems if they reserve the correct amount of physical space, but can compound the problem when they do not.

      The skeleton examples page illustrates various techniques for implementing skeletons across some common loading scenarios.

      Skeleton Types

      SkeletonDefaultOn-SecondaryPurpleGreenBlue
      Avatar
      Button
      Textbox
      Image
      Text

      On large screens, skeleton loaders use a solid fill for background color; on small screens, a shimmer is applied.

      The color can be changed to purple, green or blue by applying the appropriate modifier, e.g. skeleton--green . View the composite skeletons examples for further details.

      Avatar Skeleton

      Use the skeleton__avatar class to create a skeleton placeholder for an avatar.

      Button Skeleton

      Use the skeleton__button class to create a skeleton placeholder for the default button shape.

      Use the small modifier to match the shape of a small button.

      Use the large modifier to match the shape of a large button.

      Textbox Skeleton

      Use the skeleton__textbox class to create a skeleton placeholder for a textbox.

      Image Skeleton

      Use the skeleton__image class to create a skeleton placeholder for an image.

      Notice that the height and width must be set on the skeleton__image element.

      Text Block Skeleton

      Use the skeleton__text class to create a skeleton for a single block of text.

      Use the skeleton__text--large modifier to match the shape of a large block of text.

      Use the skeleton__text--multiline mofifier to create a skeleton for two lines of text.

      Composite Skeleton

      Combinations of skeletons can form a custom placeholder for more complex content, such as a typical eCommerce item tile in the example below.

      Here is a skeleton for a compact user profile. Notice that a div tag can be replaced with a span tag for inline-block layout of elements.

      Skeleton Variables EXPERIMENTAL

      The following custom properties (aka CSS Variables) are available for component-level overrides and other general theming purposes.

      • --skeleton-background

      @ebay/skin/snackbar-dialog

      DS v2

      A snackbar is a non-modal dialog that appears in response to a lightweight user action. It dissapears automatically after a minimum of 6 seconds.

      The display of the snackbar should be toggled using the hidden property. Please refer to the Dialog Transitions section for information on how to correctly trigger a CSS transition from a hidden state. With the correct JavaScript in place, applying the snackbar-dialog--transition modifier class will opt into a transition that slides in on show, and fades out on hide.

      NOTE : A toast is non-modal and therefore should not capture or trap keyboard focus when opened.

      Default Snackbar

      The default snackbar displays a short, non-interactive message.

      Action Snackbar

      A snackbar can contain a single shortcut action. Typically this is an "undo".

      In order to give all users adequate time to find and reach the action, the snackbar DOM position must be placed closely after the users current location (i.e. document.activeElement ). This ensures a natual reading and keyboard order. In addition, an accesskey attribute allows quick access via the operating system's access keys .

      Stacked Snackbar

      The content and action can be stacked vertically by using the snackbar-dialog__window--column modifier.

      @ebay/skin/split-button

      DS v1.6

      A split button is a button broken into two seperately actionable portions: a common action (a button) at the start, and supplemental actions (a menu button) at the end.

      Split buttons are for actions only, and should not be used for site navigation.

      Note the usage of btn--split-start to denote the start of a split button sequence, and btn--split-end to denote its end.

      Secondary Split Button

      Use the secondary modifiers to create a secondary split button style.

      Tertiary Split Button

      Use the tertiary modifiers to create a tertiary split button style.

      Fake Split Button Primary

      Link

      Fake Split Button Secondary

      Link

      Fake Split Button Tertiary

      Link

      @ebay/skin/star-rating-select

      DS v1

      Star rating select allows users to interact with and set a star rating.

      Star rating select uses radio buttons under the hood so even in the absence of CSS, its gracefully degradation should allow for full accessible interactivity and use.

      NOTE: JavaScript is required to handle the filled visual marking of all stars previous to the currently selected star rating.

      Star Rating Select with Visual Semantic Grouping

      This instance of star rating select uses visible HTML fieldset and legend for semantic grouping.

      Rate this product

      Star Rating Select with Invisible ARIA Semantic Grouping

      This instance of star rating select uses an invisible ARIA radio group for semantic grouping.

      @ebay/skin/star-rating

      DS v1

      This is a non-interactive, display-only star rating pattern. For an interactive user-selectable star rating selection pattern, please refer to Star Rating Select .

      Method 1: Combined Stars

      This is the simplest method for displaying star rating. To have more flexibility over individual stars, consider using Method 2 - Independent Stars.

      Each non-interactive star-rating is available as an SVG symbol.

      • 0
      • 0-5
      • 1
      • 1-5
      • 2
      • 2-5
      • 3
      • 3-5
      • 4
      • 4-5
      • 5

      Below is the code example for how to use the "star-rating-2-5" symbol. Please refer to the icon section for full guidance on how to include and use SVG symbols.

      Method 2: Independent Stars

      This is built using fine-grained pieces (individual stars) for optimal flexibility and for allowing potential independant star treatments (i.e. animations).

      • 0
      • 0-5
      • 1
      • 1-5
      • 2
      • 2-5
      • 3
      • 3-5
      • 4
      • 4-5
      • 5

      @ebay/skin/svg

      The SVG module imports an external SVG source containing all symbol definitions.

      @ebay/skin/switch

      DS v2.1

      A switch behaves a bit like a checkbox - it can be on or off (i.e checked or unchecked). The key difference is that a switch is not a true form control. It typically executes JavaScript on the client when toggled (i.e. without a full page reload) rather than storing form data to be sent to the server.

      Whereas checkboxes are often used to allow multi-selection from a group of choices, switches are more often used in isolation or as a series of unrelated options.

      A switch requires the switch role and aria-checked attribute for assistive technology.

      REMEMBER: every switch requires a visible, programmatic label to indicate its purpose.

      Default Switch

      The default version of the switch requires JavaScript to maintain the aria-checked state when clicked.

      The switch__control child element requires a tabindex value of 0 (zero) to be keyboard focusable.

      Disabled Switch

      To disable a switch, apply the aria-disabled attribute.

      The tabindex property must be set to -1 (negative one) to prevent keyboard focus.

      Checkbox Switch

      This version of the switch uses a checkbox under the hood. It should be used if you require the switch to store data inside of a form. As mentioned above however, this is not the intended purpose of a switch. You may wish to consider using an actual checkbox instead.

      Disabled Checkbox Switch

      To disable a checkbox switch, apply the disabled attribute.

      Custom Properties of Switch EXPERIMENTAL

      The following custom properties (aka CSS Variables) are available for system color-scheme appearance (i.e. light-mode & dark-mode) and other general theming purposes:

      • --switch-unchecked-background-color
      • --switch-checked-background-color
      • --switch-disabled-background-color
      • --switch-foreground-color
      • --switch-unchecked-hover-background-color
      • --switch-checked-hover-background-color

      @ebay/skin/tableALPHA

      DS v0.1

      A table represents tabular data—that is, information presented in a two-dimensional table comprised of rows and columns of cells containing data.

      To allow scrolling of the table via a keyboard interface, the root element must be added to the page's tab sequence. This in turn requires the root element to have an accessible role and label.

      Basic Default Table

      A basic table is a static table with no additional features.

      SellerItemStatusList PriceQuantity AvailableOrdersWatchersProtectionShippingDelivery
      Nintendo
      Nintendo Switch
      Nintendo Switch Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$287.9630095$17.99FREE4/1 - 4/5
      Nintendo
      Nintendo SNES
      Nintendo SNES Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$89.8545
      200
      5$18.95FREE4/11 - 4/15
      Microsoft
      Microsoft XBOX 360
      Microsoft XBOX 360 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Backorder$499.99345
      100
      205$17.99FREE4/17 - 4/25
      Microsoft
      Microsoft XBOX One
      Microsoft XBOX One Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Preparing$499.99399
      100
      407$27.99FREE4/9 - 4/11
      Sony
      Sony Playstation 5
      Sony Playstation 5 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Restocking$519.99205
      100
      265$29.99FREE4/11 - 4/15

      Compact Density Table

      A compact density table is a table with reduced spacing to allow for more rows to be displayed in a smaller space. You can make tables more compact by adding the table--density-compact modifier class to module.

      SellerItemStatusList PriceQuantity AvailableOrdersWatchersProtectionShippingDelivery
      Nintendo
      Nintendo Switch
      Nintendo Switch Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$287.9630095$17.99FREE4/1 - 4/5
      Nintendo
      Nintendo SNES
      Nintendo SNES Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$89.8545
      200
      5$18.95FREE4/11 - 4/15
      Microsoft
      Microsoft XBOX 360
      Microsoft XBOX 360 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Backorder$499.99345
      100
      205$17.99FREE4/17 - 4/25
      Microsoft
      Microsoft XBOX One
      Microsoft XBOX One Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Preparing$499.99399
      100
      407$27.99FREE4/9 - 4/11
      Sony
      Sony Playstation 5
      Sony Playstation 5 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Restocking$519.99205
      100
      265$29.99FREE4/11 - 4/15

      Relaxed Density Table

      A relaxed density table is a table with increased spacing to allow for larger rows. You can make tables relaxed density by adding the table--density-relaxed modifier class to module.

      SellerItemStatusList PriceQuantity AvailableOrdersWatchersProtectionShippingDelivery
      Nintendo
      Nintendo Switch
      Nintendo Switch Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$287.9630095$17.99FREE4/1 - 4/5
      Nintendo
      Nintendo SNES
      Nintendo SNES Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$89.8545
      200
      5$18.95FREE4/11 - 4/15
      Microsoft
      Microsoft XBOX 360
      Microsoft XBOX 360 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Backorder$499.99345
      100
      205$17.99FREE4/17 - 4/25
      Microsoft
      Microsoft XBOX One
      Microsoft XBOX One Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Preparing$499.99399
      100
      407$27.99FREE4/9 - 4/11
      Sony
      Sony Playstation 5
      Sony Playstation 5 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Restocking$519.99205
      100
      265$29.99FREE4/11 - 4/15

      Table with a Frozen Header

      A table with a frozen header allows the header row to persist in a sticky manner while scrolling vertically through the table. You can make headers frozen by adding the table--frozen-header modifier class to module.

      SellerItemStatusList CountList PriceQuantity AvailableOrdersWatchersProtectionShippingDelivery
      Nintendo
      Nintendo Switch
      Nintendo Switch Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship
      Option 1
      Option 2
      Option 3
      $287.9630095$17.99FREE4/1 - 4/5
      Nintendo
      Nintendo SNES
      Nintendo SNES Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship
      Option 1
      Option 2
      Option 3
      $89.8545
      200
      5$18.95FREE4/11 - 4/15
      Microsoft
      Microsoft XBOX 360
      Microsoft XBOX 360 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Backorder
      Option 1
      Option 2
      Option 3
      $499.99345
      100
      205$17.99FREE4/17 - 4/25
      Microsoft
      Microsoft XBOX One
      Microsoft XBOX One Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Preparing
      Option 1
      Option 2
      Option 3
      $499.99399
      100
      407$27.99FREE4/9 - 4/11
      Sony
      Sony Playstation 5
      Sony Playstation 5 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Restocking
      Option 1
      Option 2
      Option 3
      $519.99205
      100
      265$29.99FREE4/11 - 4/15

      Table with Constrained Height

      You may constrain the height of the table, which will constrain the table to a percentage of the viewport height as opposed to allowing the full table contents to be fully visible. This is typically used in a table with a frozen header. To do so, add a table--constrained-height modifier class to module.

      SellerItemStatusList PriceQuantity AvailableOrdersWatchersProtectionShippingDelivery
      Nintendo
      Microsoft XBOX 360
      Nintendo Switch Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$287.9630095$17.99FREE4/1 - 4/5
      Nintendo
      Nintendo SNES
      Nintendo SNES Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$89.8545
      200
      5$18.95FREE4/11 - 4/15
      Microsoft
      Microsoft XBOX 360
      Microsoft XBOX 360 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Backorder$499.99345
      100
      205$17.99FREE4/17 - 4/25
      Microsoft
      Microsoft XBOX One
      Microsoft XBOX One Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Preparing$499.99399
      100
      407$27.99FREE4/9 - 4/11
      Sony
      Sony Playstation 5
      Sony Playstation 5 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Restocking$519.99205
      100
      265$29.99FREE4/11 - 4/15

      Table with a Frozen Column

      You may freeze any one of the first three column so it is always present when scrolling by adding table--freeze-column-x modifier class to module, where x is the column you'd like to freeze.

      SellerItemStatusList PriceQuantity AvailableOrdersWatchersProtectionShippingDelivery
      Nintendo
      Nintendo Switch
      Nintendo Switch Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$287.9630095$17.99FREE4/1 - 4/5
      Nintendo
      Nintendo SNES
      Nintendo SNES Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$89.8545
      200
      5$18.95FREE4/11 - 4/15
      Microsoft
      Microsoft XBOX 360
      Microsoft XBOX 360 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Backorder$499.99345
      100
      205$17.99FREE4/17 - 4/25
      Microsoft
      Microsoft XBOX One
      Microsoft XBOX One Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Preparing$499.99399
      100
      407$27.99FREE4/9 - 4/11
      Sony
      Sony Playstation 5
      Sony Playstation 5 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Restocking$519.99205
      100
      265$29.99FREE4/11 - 4/15

      Sortable Table

      A sortable table is a table that allows users to sort the data in the table by clicking on the column headers. You can make tables sortable by using sort buttons in <thead> > <th>. Additionally, for accessibility purposes, aria-sort="ascending" or aria-sort="descending" should be added respectively to the <th> to reflect the current sort order.

      If using buttons to sort the table, the aria-pressed="true" attribute should be added to the button to indicate the current sort order. The aria-pressed attribute should be toggled between true and false when the button is clicked.

      If using anchors to sort the table with a page refresh, you would forgo the pressed state and just do <a href="my-url">Seller...</a>. Additionally, you'd need to change the aria-sort attribute to match the sort order after the page refresh.

      Nintendo
      Nintendo Switch
      Nintendo Switch Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$287.9630095$17.99FREE4/1 - 4/5
      Nintendo
      Nintendo SNES
      Nintendo SNES Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Ready to Ship$89.8545
      200
      5$18.95FREE4/11 - 4/15
      Microsoft
      Microsoft XBOX 360
      Microsoft XBOX 360 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Backorder$499.99345
      100
      205$17.99FREE4/17 - 4/25
      Microsoft
      Microsoft XBOX One
      Microsoft XBOX One Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Preparing$499.99399
      100
      407$27.99FREE4/9 - 4/11
      Sony
      Sony Playstation 5
      Sony Playstation 5 Brand New Gaming System with Four Controllers
      SKU : A43BTR5678 • Quantity : 1
      Restocking$519.99205
      100
      265$29.99FREE4/11 - 4/15

      Table in Selection Mode

      A table can be put into 'selection mode' by adding the class table--mode-selection to the component parent. This will make slight spacing accommodations for the layout.

      A table in selection mode allows users to select rows within a table. This is useful when users need to perform actions on selected rows.

      The first column of the table will contain a checkbox that allows users to select the row. The first row of the table will contain a checkbox that allows users to select all rows. The checkbox in the table header should have an aria-label of something like, "Select all rows" while all other checkboxes should have an aria-label of something like, "Select row".

      Each row should have one column that is its unique idenitifier. That column should typically be the first static column in the row. That column should be indicated using <th scope="row"> element, which affords various accessibility benefits.

      NintendoSwitch$287.9630020795$17.99FREE4/1 - 4/5
      NintendoSNES$89.8545175$18.95FREE4/11 - 4/15
      MicrosoftXBOX 360$499.99345455205$17.99FREE4/17 - 4/25
      MicrosoftXBOX One$499.99399407305$27.99FREE4/9 - 4/11
      SonyPlaystation 5$519.99205265199$29.99FREE4/11 - 4/15

      Table with Actions

      A table can have actions inside for performing various tasks for each row.

      ConditionMultiple ActionsActions Plus
      NintendoSwitch$287.9630020795$17.99FREE4/1 - 4/5
      NintendoSNES$89.8545175$18.95FREE4/11 - 4/15
      MicrosoftXBOX 360$499.99345455205$17.99FREE4/17 - 4/25
      MicrosoftXBOX One$499.99399407305$27.99FREE4/9 - 4/11
      SonyPlaystation 5$519.99205265199$29.99FREE4/11 - 4/15

      Table with Field Inputs

      A table can have field inputs for quick data modification for each row.

      30020795$17.994/1 - 4/5
      45175$18.954/11 - 4/15
      345455205$17.994/17 - 4/25
      399407305$27.994/9 - 4/11
      205265199$29.994/11 - 4/15

      @ebay/skin/tabs

      DS v2.1

      Tabs allow the user to switch between multiple panels of content. By decluttering the user-interface in this way, we say that tabs follow the principal of progressive disclosure .

      Selecting a tab should update the visible panel without a full page reload. If a full page load is required instead (i.e. acting like a link), please see the fake tab section below for more details.

      Default Tabs

      When a tab is selected, the aria-selected state of all tabs in the list must be updated in order for the CSS to reflect the change. Only one tab can be selected and in the tab order at any moment in time. Likewise, only one tabpanel can be visible at any time, and it must correspond to the currently selected tab.

      Use child element modifier tabs__items--large to opt into larger font-size for tabs.

      NOTE: JavaScript is required to handle tab selection state, panel visibility, focus management and arrow-key navigation. For detailed behaviour requirements, please visit the eBay MIND Pattern for Tabs .

      Panel 1 Content

      Lorem ipsum dolor sit amet, consectetur adipisicing elit. Amet assumenda culpa est nisi porro quae quidem ratione repellendus, temporibus. Assumenda atque dolor dolorem eligendi eveniet ipsam modi necessitatibus quos ut?

      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.

      Fake Tabs

      A fake tab looks like a normal tab, but is actually a hyperlink to a new page. Therefore a set of fake tabs behaves more like a simple navigational widget, rather than a dynamic user interface control.

      A valid HREF attribute is required for all anchor tags. A value of "javascript" (or any such variant) is not a valid URL!

      The aria-current attribute is used to programmatically denote the current page state and current link.

      Use child element modifier fake-tabs__items--large to opt into larger font-size for fake tabs.

      Lorem ipsum dolor sit amet, consectetur adipisicing elit. Amet assumenda culpa est nisi porro quae quidem ratione repellendus, temporibus. Assumenda atque dolor dolorem eligendi eveniet ipsam modi necessitatibus quos ut?

      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.

      @ebay/skin/textbox

      DS v2.2

      A textbox (also known as an input ) allows the user to enter data.

      The purpose of a textbox is to collect form data. Therefore, textbox should always be used in conjunction with a form, label and submit button.

      IMPORTANT:The examples below show the textbox in isolation, without any label. Remember: every textbox requires a label!

      Single-Line Textbox

      Use an input tag for a single-line textbox.

      Readonly Textbox

      Use the readonly attribute to prevent any modification of the value.

      Disabled Textbox

      Use the disabled attribute to completely disable the input and any value.

      Error-State Textbox

      Use the aria-invalid attribute to highlight any input with error.

      Multi-line Textbox

      Use the textarea tag for a multi-line textbox.

      A multi-line textbox allows line breaks and has a minimum height of 200px.

      Fluid Textbox

      Apply the textbox--fluid modifier (or fluid utility class) to fill the width of the parent element.

      Textbox with Icon

      Single-line textboxes can be augmented with any SVG icon .

      To display the icon at the end of the control, position the svg tag after the input.

      NOTE: The icon is presentational, and therefore hidden from assistive technology using aria-hidden . Remember, the purpose of the field must be conveyed using a label.

      Textbox with Icon Button

      Single-line textboxes also support an icon button in the end position.

      An icon button in the end position can also be teamed up with a static icon in the start position.

      Large Textbox

      Use textbox--large modifier to style the textbox to be large size

      Textbox Prefix

      Add a span containing text before the input to show it as a prefix text.

      $

      Textbox Postfix

      Add a span containing text after the input to show it as a postfix text.

      in.

      Mixed icons and static text

      Postfix/prefix icons can be mixed with static text in the textbox.

      $

      @ebay/skin/toast-dialog

      DS v2.2

      A toast is a non-modal dialog that appears in response to a system-level action.

      The display of the toast should be toggled using the hidden property. Please refer to the Dialog Transitions section for information on how to correctly trigger a CSS transition from a hidden state. With the correct JavaScript in place, applying the toast-dialog--transition modifier class will opt into a transition that slides in on show, and fades out on hide.

      NOTE : A toast is non-modal and therefore should not capture or trap keyboard focus when opened. Keyboard users require a way to quickly access the actions within the toast. This is achieved via the accesskey attribute.

      Default Toast

      The default toast displays a single, primary call-to-action.

      Toast Secondary Action

      A secondary action is also supported.

      @ebay/skin/toggle-button-group

      DS v1

      The Toggle Button Group is a group of single or multi-select toggle buttons providing a visual emphasis on the available selectable choices.

      Intended Use of Toggle Button Group

      Toggle Buttons inside Toggle Button Group are intended to be input controls. They are ment to be used for users to make selection(s) that can be used for additional actions. For example, they can be used to storing the selection(s) and using JavaScript to include the information in a form submission.

      Toggle Buttons are NOT to be used for the purposes of navigation.

      The component allows for single or multiple selections based on need. However, when using Skin by itself you will need to have your own JavaScript to establish those rules based on the specific needs for each implementation context.

      Effort was taken in these docs to provide a good amount of helpful information. Since this component has an atomic piece ( Toggle Button ), there may be some information crossover. Though efforts were taken to isolate the documentation for this parent component, at various touchpoints between the two components, there may be some redundancy. In other portions, where immediate information appears to be missing here, that information may reside in its child component. Please refer to Toggle Button docs in these situations.

      Accessibility

      The preferred implementation for accessibility includes an on-screen heading and the list associated with the heading (a). The second option is an off-screen heading with the same association (b). The third is to use the label directly on the list element (c).

      On-screen Heading with Associated List (a - preferred)

      Select Shoe Size

      Off-screen Heading with Associated List (b)

      This implementation is identical to option (a), except the heading is off-screen using the clipped class.

      Select Shoe Size

      Interaction Variations of Toggle Button Groups

      There are three different types of toggle button groups that may be utilized based on interaction need.

      1. Multi-select: this is a freeform implementations in which the user can toggle and untoggle any button.
      2. Single-select Optional: only one button can be toggled on at any given time and the user CAN untoggle that one button.
      3. Single-select Required: only one button can be toggled on at any given time and the user CANNOT untoggle that one button.

      If you're using Skin outside of a JavaScript framework, you will need to write your own js code to accomplish these interactivity cases.

      It's generally good practice to use delegated event handlers that allow you to set up a a single event handler for the group of buttons instead of on every button.

      The following examples use an HTML attribute to disitnguish the interaction variations. Using data-selection-type . For the associated js please see /docs/src/js/main.js (TOGGLE-BUTTON-GROUP section) for an example on how the implementation may be accomplished.

      Multi-select

      The Multi-select variation is the default so nothing additional needs to be specified in the markup.

      Select Multiple Sizes

      Single-select Optional

      In this example of the Single-select Optional variation, data-selection-type="single-optional" is used to split off the variation interactivity. This option allows for only one selection, so toggling additional buttons will simply switch the toggled button and retain only one toggled button.

      Select Sizes

      Single-select Required

      In this example of the Single-select Optional variation, data-selection-type="single-required" is used to split off the variation interactivity. This option allows for only one selection. However, unlike the single-select optional variation, this variation enforces the required single selection so the toggled button cannot be untoggled.

      Select Sizes

      Responsive Out of the Box

      Toggle Button Group is responsive out of the box. The buttons will responsively shrink and stretch the specific type of buttons inside and attempt to fit the buttons nicely within the container at any and all screen sizes.

      We use display: grid to create a predefined allotted number of button slots per breakpoint. We also use container queries to modify how many slots should be available per breakpoint. This allows buttons to shrink/stretch the predefined number of buttons at each breakpoint with a fallback to media queries for unsupported browsers.

      The responsive rules around how many toggle buttons appear on a single line before wrapping into a new line have all been predefined and baked into the component, so developers don't need to provide anything else to have an optimal responsive toggle button layout at various screen sizes.

      In the demo below, drag the range to see the responsive rules in action and how the fluid Toggle Buttons work.

      320

      Select Sizes

      Exception Cases for Preferred Number of Toggle Buttons Per Line

      The buttons inside the Toggle Button Group are automatically responsive and have predefined rules around how many Toggle Buttons will display on a line before wrapping to the next line. However, on some rare occasions, developers may need to revise those rules based on how a Toggle Button Group works in their specific use case. For example, when the number of buttons is deterministic and known. In those instances, using various attributes mapped to each breakpoint will allow the rules to be honored by the component. At those specific breakpoints, the number of buttons specificed will be displayed.

      Here's a specific example. Suppose we know we're going to have 6 buttons total and we'd like to have perfect visual balance in the UI. We may add the following html attributes/modifiers to .toggle-button-group to achieve that:

      • data-columns-xs="2" to force 2 toggle buttons on the same line so we'd have 3 balanced lines of buttons at the XS breakpoint or at 320px + width.
      • data-columns-sm="3" to force 3 toggle buttons on the same line so we'd have 2 balanced lines of buttons at the SM breakpoint or at 512px + width.
      • data-columns-md="6" to force all 6 toggle buttons on the same line at the MD breakpoint or at 768px + width.
      • data-columns-xl="8" to force all 8 toggle buttons on the same line at the XL breakpoint or at 1280px + width.

      Here's that use case in action. Drag the range to see the effects of the attribute settings at various container widths.

      320

      Select Sizes

      Layouts

      There are various layouts that can be used based on the specific needs at implementation. The implied theme (needs no modifier), is the minimal layout. For more information about types of layouts, refer to the Toggle Button component. The examples below will highlight various layouts.

      A toggle button group can have one of three different layouts: minimal (default), list or gallery.

      Layout Modifiers

      Toggle Button Group has top-level modifiers that will apply to the Toggle Buttons inside. When using Toggle Buttons inside Toggle Button Group make sure you do NOT specify each Toggle Button layout modifier. Instead, top-level layout modifiers will be sufficient to create the layout you want.

      Minimal Layout (default)

      The default, minimal toggle button should be used when the contents are single-line and very short, as in shoe sizing, for example. This layout is geared more towards allowing the display of many more options and maximizing screen real estate.

      NOTE: All toggle button examples utilize JavaScript to toggle the aria-pressed state of the button.

      In this example, the container housing the Toggle Button Group is artificially limited to 500px to demonstrate how the buttons will wrap after the specific columns (in this case, 3). Feel free to reduce/expand the container width in dev console to see how the columns will react.

      Select Sizes

      List Layout

      List layout should be used when it's desired to have wider horizontal buttons. These are more easily stackable on narrower screens.

      You may use this layout by adding the toggle-button-group--list-layout modifier to the toggle button group.

      List Layout Toggle Button Group with Title

      Text Options

      List Layout Toggle Button Group with Subtitles (multiple buttons toggled on)

      Text Options

      List Layout Toggle Button Group with Icons

      Select Payment Option

      List Layout Toggle Button Group with Images

      To add an image to a toggle button, you can use the toggle-button__image-container block using an <img> or as a css background image.

      Select Payment Option

      List Layout Toggle Button Group with CSS Images

      Select Payment Option

      Gallery Layout

      Gallery layout should be used when there will be fewer buttons (as larger buttons take up more screen real estate) and it's desired to have a more vertical/square implementations with more emphasis on graphical elements (images/icons). As such, since the purpose of gallery layout buttons is to exentuate graphical elements, a graphical element (icon or image) is typically required in gallery layout buttons.

      You may use this layout by adding the toggle-button-group--gallery-layout modifier to the toggle button group.

      Gallery Layout Toggle Button Group with Images

      The image used in these buttons will shrink/grow responsively in width and height based on the overall button width being respectful of their boundary limitations. Where those boundaries are in danger of being crossed, the layout will wrap accordingly.

      Selection Options

      Gallery Layout Toggle Button Group with CSS Images

      Besides using an <img> , you may also use CSS images that can provide more flexibility in filling more of the space reserved for images.

      These images will change in size responsively both horizontally and vertically based on the size of the button itself, available space allowed by the container and their minimum and maximum size limitations.

      The examples below have various different implementations of CSS images. The first is a CSS Profile Image button with background-size: contain that will display the image as is and fit the entire image in the container. The second is a CSS Profile Image button with background-size: cover that will display the image to fill as much of the space of the container as possible clipping out the remaining portions of the image that fall outside. With that method, you can also provide guidance for fine-tuning the image positioning to move the focal point into the center of the container. In that example, background-position: center 15%; is used to move the focal point (person with camera) into the center of the frame.

      Selection Options

      Gallery Layout Toggle Button Group with Icons

      Typically, one would use either all image buttons or all icon buttons in a Toggle Button Group.

      To add an icon to a toggle button, you can use the toggle-button__icon block.

      Selection Options

      @ebay/skin/toggle-button

      DS v1.0.3

      A toggle button is a special type of button that conveys a pressed or non-pressed state; this state is conveyed programmatically via the aria-pressed attribute. They can be used in single-select or multi-select groups.

      These buttons, like all buttons, should NOT contain structural elements, such as headings or lists.

      A toggle button can have one of three different layouts: minimal (default), list or gallery.

      Minimal Layout

      The default, minimal toggle button should be used when the contents are single-line and very short, as in shoe sizing, for example. This layout is geared more towards allowing the display of many more options and maximizing screen real estate.

      NOTE: All toggle button examples utilize JavaScript to toggle the aria-pressed state of the button.

      List Layout

      List layout should be used when it's desired to have wider horizontal buttons. These are more easily stackable on narrower screens.

      You may use this layout by adding the toggle-button--list-layout modifier to the toggle button.

      List Toggle Button with Title

      List Toggle Button with Title and Subtitle

      A subtitle can be added via toggle-button__subtitle block.

      List Toggle Button with Title and Multi-line Subtitle

      To have a multi-line subtitle, you may use a single <p> tag that has longer text or a maximum of two separate <p> tags with shorter text inside the toggle-button__subtitle block.

      List Toggle Button with Icon, Title, and Subtitle

      To add an icon to a toggle button, you can use the toggle-button__icon block.

      List Toggle Button with Image, Title, and Subtitle

      To add an image to a toggle button, you can use the toggle-button__image-container block using an <img> or as a css background image.

      Using an Image Element
      Using a Contained CSS Background Image
      Using a Covered CSS Background Image

      Gallery layout should be used when there will be fewer buttons (as larger buttons take up more screen real estate) and it's desired to have a more vertical/square implementations with more emphasis on graphical elements (images/icons). As such, since the purpose of gallery layout buttons is to exentuate graphical elements, a graphical element (icon or image) is typically required in gallery layout buttons.

      You may use this layout by adding the toggle-button--gallery-layout modifier to the toggle button.

      Gallery Toggle Button with Image

      To add an image to a toggle button, you can use the toggle-button__image-container block.

      Gallery Toggle Button Responsive Adjustments

      Toggle buttons have a mininum and maximum width and are meant to be fluid between those boundaries. If using these buttons separately, you will need to set up their combined high-level layouts on your own. In these examples, their widths are artificially/manually set to various widths to demonstrate how the buttons undergo responsive adjustments.

      The image used in these buttons will shrink/grow responsively in width and height based on the overall button width.

      Resonsive Images Using Image Element

      Responsive Images Using CSS Background-Image

      These buttons use background-size: contain; for background image scaling/filling.

      These buttons use background-size: cover; for background image filling the alloted space. The following buttons have the background image positioning using background-position-y: 20%; . Depending on your specific image, you may also need to adjust the background positioning along the x and y axis to ensure the main focal point remains visible and centered in your implementation.

      Gallery Toggle Button with Icon

      To add an icon to a toggle button, you can use the toggle-button__icon block.

      Disabled Toggle Button

      Toggle buttons may be disabled with disabled or aria-disabled="true" .

      @ebay/skin/tokens

      DS v

      Contains all custom properties necessary to correctly render the Evo Design System, in accordance with the token system.

      Core, light and dark token sets are individually exposed via the following submodules:

      @ebay/skin/tokens/evo-core
      eBay default primitives
      @ebay/skin/tokens/evo-light
      eBay semantic aliases for light mode
      @ebay/skin/tokens/evo-dark*
      eBay semantic aliases for dark mode

      *This sub-module will not be included automatically by it's parent module; it must be explicitly included by any page that is itself dark-mode compatible.

      Semantic Color Tokens

      • color-background-primary
      • color-background-secondary
      • color-background-disabled
      • color-background-inverse
      • color-background-attention
      • color-background-confirmation
      • color-background-information
      • color-background-accent
      • color-background-invalid
      • color-foreground-primary
      • color-foreground-secondary
      • color-foreground-disabled
      • color-foreground-attention
      • color-foreground-confirmation
      • color-foreground-information
      • color-foreground-accent
      • color-foreground-visited
      • color-foreground-on-primary
      • color-foreground-on-secondary
      • color-foreground-on-disabled
      • color-foreground-on-inverse
      • color-foreground-on-accent
      • color-foreground-on-attention
      • color-foreground-on-confirmation
      • color-foreground-on-information
      • color-stroke-default
      • color-stroke-accent
      • color-stroke-attention
      • color-stroke-confirmation
      • color-stroke-information
      • color-stroke-disabled
      • color-stroke-strong
      • color-stroke-subtle
      • color-state-visited
      • color-state-primary-hover
      • color-state-primary-active
      • color-state-secondary-hover
      • color-state-secondary-active
      • color-state-inverse-hover
      • color-state-inverse-active
      • color-state-accent-hover
      • color-state-accent-active
      • color-state-attention-hover
      • color-state-attention-active
      • color-scrim-image
      • color-scrim-background
      • color-ai-gradient-full-spectrum
      • color-ai-gradient-green-strong
      • color-ai-gradient-blue-strong
      • color-ai-gradient-purple-strong
      • color-ai-gradient-green-subtle
      • color-ai-gradient-blue-subtle
      • color-ai-gradient-purple-subtle

      Primitive Color Tokens

      NOTE: Primitive tokens are not intended to be used by the application; instead, they are utilized by the semantic tokens.

      • color-avocado-100
      • color-avocado-200
      • color-avocado-300
      • color-avocado-400
      • color-avocado-500
      • color-avocado-600
      • color-avocado-700
      • color-marigold-100
      • color-marigold-200
      • color-marigold-300
      • color-marigold-400
      • color-marigold-500
      • color-marigold-600
      • color-marigold-700
      • color-blue-100
      • color-blue-200
      • color-blue-300
      • color-blue-400
      • color-blue-500
      • color-blue-600
      • color-blue-700
      • color-coral-100
      • color-coral-200
      • color-coral-300
      • color-coral-400
      • color-coral-500
      • color-coral-600
      • color-coral-700
      • color-orange-100
      • color-orange-200
      • color-orange-300
      • color-orange-400
      • color-orange-500
      • color-orange-600
      • color-orange-700
      • color-dijon-100
      • color-dijon-200
      • color-dijon-300
      • color-dijon-400
      • color-dijon-500
      • color-dijon-600
      • color-dijon-700
      • color-pink-100
      • color-pink-200
      • color-pink-300
      • color-pink-400
      • color-pink-500
      • color-pink-600
      • color-pink-700
      • color-green-100
      • color-green-200
      • color-green-300
      • color-green-400
      • color-green-500
      • color-green-600
      • color-green-700
      • color-red-100
      • color-red-200
      • color-red-300
      • color-red-400
      • color-red-500
      • color-red-600
      • color-red-700
      • color-indigo-100
      • color-indigo-200
      • color-indigo-300
      • color-indigo-400
      • color-indigo-500
      • color-indigo-600
      • color-indigo-700
      • color-teal-100
      • color-teal-200
      • color-teal-300
      • color-teal-400
      • color-teal-500
      • color-teal-600
      • color-teal-700
      • color-jade-100
      • color-jade-200
      • color-jade-300
      • color-jade-400
      • color-jade-500
      • color-jade-600
      • color-jade-700
      • color-yellow-100
      • color-yellow-200
      • color-yellow-300
      • color-yellow-400
      • color-yellow-500
      • color-yellow-600
      • color-yellow-700
      • color-kiwi-100
      • color-kiwi-200
      • color-kiwi-300
      • color-kiwi-400
      • color-kiwi-500
      • color-kiwi-600
      • color-kiwi-700
      • color-violet-100
      • color-violet-200
      • color-violet-300
      • color-violet-400
      • color-violet-500
      • color-violet-600
      • color-violet-700
      • color-lilac-100
      • color-lilac-200
      • color-lilac-300
      • color-lilac-400
      • color-lilac-500
      • color-lilac-600
      • color-lilac-700
      • color-neutral-100
      • color-neutral-200
      • color-neutral-300
      • color-neutral-400
      • color-neutral-500
      • color-neutral-600
      • color-neutral-700
      • color-neutral-900

      @ebay/skin/tooltip

      DS v2

      A tooltip gives additional information about an interactive element - typically a button. The tooltip activates on mouse hover or keyboard focus of the button.

      The tooltip must be programmatically associated with the button by using the aria-describedby property and tooltip role.

      Toggle the aria-expanded state of the button to expand or collapse its associated tooltip.

      By default, the position of the overlay and its pointer will remain static. For these following examples, we are using floating-ui to help position the tooltip and the pointer dynamically.

      In order to get this to work with floating-ui, you need to remove pointer position tooltip__pointer--top-left and remove any style positioning

      @ebay/skin/tourtip

      DS v2

      A tourtip points out a new feature or section of the page. A tourtip is open by default and must be explcitly closed using its close button. Once closed, it cannot be reopened.

      Toggle the tourtip--expanded modifier to expand or collapse the tourtip.

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      Tourtip

      Here's something new to help you be successful at your task.

      By default, the position of the overlay and its pointer will remain static. For these following examples, we are using floating-ui to help position the tooltip and the pointer dynamically.

      In order to get this to work with floating-ui, you need to remove pointer position tourtip__pointer--top-left and remove any style positioning

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      Tourtip

      Here's something new to help you be successful at your task.

      With footer

      Tourtip also supports having a footer as well as an index in the case there are multiple tourtips on the page

      Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

      Tourtip

      Here's something new to help you be successful at your task.

      @ebay/skin/typography

      DS v1.1

      Static sites without access to the LESS preprocessor can leverage the Skin type ramp via the typography module.

      Giant text and large text are always bold. Other entries in the type ramp can be set to bold-text or secondary-text using the relevant class.

      • .giant-text-3
      • .giant-text-2
      • .giant-text-1
      • .large-text-2
      • .large-text-1
      • .medium-text
      • .regular-text
      • .small-text

      Product Titles

      Product titles are regular font weight, use the Market Sans font and are responsive based on a small or large screen size.

      • .giant-product-title
      • .large-product-title
      • .medium-product-title
      • .small-product-title

      Section Titles

      Section titles are bold font weight, use the Market Sans font and are responsive based on a small or large screen size.

      • .giant-section-title
      • .large-section-title
      • .medium-section-title
      • .small-section-title

      @ebay/skin/ utility

      The utility module provides a small set of common, utility classes. It is not intended as an exhaustive library of utility classes or functions (i.e. it is not Funcssion !).

      Utility Classes
      ClassProperties
      .clearfixClear floated elements
      .clippedElement visible to screen reader only
      .clipped--stealthClipped element becomes visible on focus (modifier)
      .image-treatmentApplied on an image container. Will apply a grey background to the image inside container.
      .image-stretchImage will stretch up and down
      .image-centerVertically and horizontally center an image
      .image-scaleImage will scale up and down
      .image-disabledImage will appear disabled.
      .scrollbars-permanentDisplay permanent scrollbars on containers as a progressive enhancement.
      .text-truncateTruncate single-line text

      Utility Notes

      Utility Notes
      ItemNotes
      will-changeThere are known performance issues using this approach to indicate imminent element style changes for browsers. It's recommended to use this sparingly and only to remedy known performance issues and not anticipate them.