gtpwebdev-drop-down-list
v1.2.0
Published
Drop down list
Downloads
8
Readme
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();
});