2.3.0 • Published 8 months ago

select-options v2.3.0

Weekly downloads
-
License
MIT
Repository
github
Last release
8 months ago

npm GitHub package version NPM Downloads

Install

yarn add select-options

Import

import SelectOptions from 'select-options';

CSS

@import "select-options/dist";

if your bundler supports SCSS

@import "select-options/src";

Usage

document.addEventListener('DOMContentLoaded', () => {
  const selectOptions = new SelectOptions();

  selectOptions.init();
});

API

NameTypeDescription
updateSelectsfunctionUpdates the state of all custom selects within the select-option-container. This method is useful in situations where the original <select> elements have been programmatically changed and the custom select UI needs to be updated to reflect these changes.

Options

OptionTypeDefaultDescription
mobileModebooleanfalseWhen set to true, the mobileMode parameter allows the default behavior of the native select element to be used on mobile devices instead of the custom dropdown functionality. This takes advantage of the native mobile dropdown interfaces, which are typically more user-friendly on touch screens.

CSS custom properties

VariableDefaultDescription
--so-color-outline-inactiveDarkGrayColor of the select border when inactive
--so-color-outline-hoverSlateGreyColor of the select border on hover
--so-color-outline-openedDodgerBlueColor of the select border when opened
--so-color-label-inactiveGrayColor of the label text when the select is inactive
--so-color-label-openedDodgerBlueColor of the label text when the select is opened
--so-color-label-selectedDarkGrayColor of the label text when an option is selected
--so-color-triggerGrayColor of the text in the select field (when an option is selected)
--so-color-list-item-inactiveGrayColor of the text for inactive list items
--so-color-list-item-selectedWhiteColor of the text for selected list items
--so-color-scrollbar-thumbSilverColor of the scrollbar thumb in normal state
--so-color-scrollbar-trackWhiteColor of the scrollbar track
--so-color-scrollbar-hoverGrayColor of the scrollbar thumb on hover
--so-background-listWhiteBackground color of the options list
--so-background-option-inactiveWhiteBackground color of inactive options
--so-background-option-hoveredWhiteSmokeBackground color of options on hover
--so-background-option-selectedDodgerBlueBackground color of selected options
--so-border-radius-select5.5pxBorder radius for the select
--so-border-radius-list5.5pxBorder radius for the options list
--so-list-shadowMaterialShadow for the dropdown menu
--select-dropdown-arrowurl( ... )Sets the image for the select dropdown arrow

License

select-options is released under MIT license

2.3.0

8 months ago

2.2.0

9 months ago

2.1.1

9 months ago

2.1.0

10 months ago

1.2.0

1 year ago

1.1.1

1 year ago

1.1.0

1 year ago

1.0.1

1 year ago

0.0.1-beta.7

1 year ago

0.0.1-beta.6

1 year ago

1.1.2

1 year ago

0.0.1-beta.3

1 year ago

0.0.1-beta.2

1 year ago

0.0.1-beta.5

1 year ago

0.0.1-beta.4

1 year ago

2.0.1

12 months ago

0.0.1-beta.1

1 year ago

2.0.0

1 year ago

0.0.1-alpha.6

1 year ago

0.0.1-alpha.5

1 year ago

0.0.1-alpha.4

1 year ago

0.0.1-alpha.3

1 year ago

0.0.1-alpha.2

1 year ago

0.0.1-alpha.1

1 year ago

1.0.0

3 years ago