dnadesign/silverstripe-advanceddropdowns

DropdownField and GroupedDropdownField that allows the use of data-attributes on each option tag

Installs: 8 669

Dependents: 0

Suggesters: 0

Stars: 15

Watchers: 9

Forks: 2

Open Issues: 0

Type:silverstripe-vendormodule

2.0.3 2018-04-26 22:44 UTC

README

Introduction

DropdownField and GroupedDropdownField that allows the use of data-attributes on each option tag. Very useful for third party dropdown styling such as (http://silviomoreto.github.io/bootstrap-select/) which rely on data-attributes on options.

Please note this module is a work in progress and has no tests.

AdvandedDropdownField

Set up your AdvandedDropdownField's as follows:

new AdvancedDropdownField('AdvancedDropdown', 'DropdownField with option attributes', array(
	'value1' => array(
		'Title' => 'Option 1',
		'Attributes' => array(
			'data-myattribute' => 'This is an attribute value'
		)
	),
	'value2' => array(
		'Title' => 'Option 2',
		'Attributes' => array(
			'data-myattribute' => 'This is an attribute value'
			'data-myattribute2' => 'This is a second attribute value'
		)
	)
));

AdvandedGroupedDropdownField

Set up your AdvandedGroupedDropdownField's as follows:

new AdvancedGroupedDropdownField('AdvancedGroupedDropdown', 'Advanced grouped dropdown', array(
	'value1' => array(
		'Title' => 'Ungrouped option',
		'Attributes' => array(
			'data-myattribute' => 'This is an attribute value'
		)
	),
	'Option group 1' => array(
		'value2' => array(
			'Title' => 'Option 2',
			'Attributes' => array(
				'data-myattribute' => 'This is an attribute value'
			)
		),
		'value3' => array(
			'Title' => 'Option 3',
			'Attributes' => array(
				'data-myattribute' => 'This is an attribute value'
			)
		)
	),
	'Option group 2' => array(
		'value4' => array(
			'Title' => 'Option 4',
			'Attributes' => array(
				'data-myattribute' => 'This is an attribute value'
			)
		),
		'value5' => array(
			'Title' => 'Option 5',
			'Attributes' => array(
				'data-myattribute' => 'This is an attribute value'
				'data-myattribute2' => 'This is a second attribute value'
			)
		)
	)
));

Maintainer Contact

* James ayers (james.ayers@dna.co.nz)

Requirements

  • SilverStripe 3.x

License

BSD-3-Clause. See LICENSE.