gtpwebdev-drop-down-list v1.2.0

gtpwebdev-drop-down-list

A configurable Dropdown component alternative

This library is currently private.

Installation

npm install gtpwebdev-drop-down-list --save

Usage

import createDropDown from 'gtpwebdev-drop-down-list';

const newDropDown = createDropDown();

Configuration

setOptions()

Add the options available to the user - a display text and stored value for each option

newDropDown.setList([
	{
		text: 'List item number 1',
		value: 1,
	},
	{
		text: 'List item number 2',
		value: 2,
	},
]);

setBarBackground()

Set the background colour of the top selection bar. All standard CSS color formats can be used.

newDropDown.setBarBackground('#ffdb4f');
newDropDown.setBarBackground('rgb(90, 147, 197)');
newDropDown.setBarBackground('hsl(0, 100%, 50%)');

setFontSize()

Set the text size for all elements of the drop down list. Note, all CSS standard font-size units can be used. The default is "20px"

newDropDown.setFontSize('2rem');
newDropDown.setFontSize('16px');
newDropDown.setFontSize('1.5em');

setBarFontColor()

Set the font color of the top selection bar. All standard CSS color formats can be used.

newDropDown.setBarFontColor('2rem');
newDropDown.setBarFontColor('16px');
newDropDown.setBarFontColor('1.5em');

setOptionBackgroundColor()

Set the background colour of the drop down options. All standard CSS color formats can be used.

newDropDown.setOptionBackgroundColor('#ffdb4f');
newDropDown.setOptionBackgroundColor('rgb(90, 147, 197)');
newDropDown.setOptionBackgroundColor('hsl(0, 100%, 50%)');

setOptionFontColor()

Set the font color of the drop down options. All standard CSS color formats can be used.

newDropDown.setOptionFontColor('#f8f1e4');
newDropDown.setOptionFontColor('rgb(90, 147, 197)');
newDropDown.setOptionFontColor('hsl(0, 100%, 50%)');

generateDOM()

Add the DOM node to a parent node

const newDOM = newDropDown.generateDOM();
parentNode.appendChild(newDOM);

getSelectedOption()

Get an object containing the selected option text and value

const { text, value } = newDropDown.getSelectedOption();

Collecting the text and value of the selection option

A "change" event is dispatched when an item on the drop down list is selected.

newDOM.addEventListener('change', () => {
	const { text, value } = newDropDown.getSelectedOption();
});

An example

import createDropDown from "gtpwebdev-dropdown-list4";

onst newDropDown = createDropDown();
newDropDown.setList(
  [
    {
      text: "First option",
      value: 1
    },
    {
      text: "A second option",
      value: 2
    },
    {
      text: "Another option",
      value: 5
    },
  ]
);
newDropDown.setBarBackground("#ffdb4f");
const newDOM = newDropDown.generateDOM();

selectProjContainer.appendChild(newDOM);

Event listener:

newDOM.addEventListener('change', () => {
	const { text, value } = newDropDown.getSelectedOption();
});