2017 © Pedro Peláez
 

silverstripe-module select2

A set of silverstripe form fields based on http://ivaynberg.github.com/select2/s

image

silverstripe/select2

A set of silverstripe form fields based on http://ivaynberg.github.com/select2/s

  • Thursday, February 15, 2018
  • by sheadawson
  • Repository
  • 6 Watchers
  • 17 Stars
  • 15,691 Installations
  • JavaScript
  • 2 Dependents
  • 0 Suggesters
  • 13 Forks
  • 6 Open issues
  • 5 Versions
  • 9 % Grown

The README.md

silverstripe-select2

Four silverstripe form fields based on http://ivaynberg.github.com/select2/., (*1)

Requirements

SilverStripe framework ^4, (*2)

Maintainer Contact

Select2Field

A basic dropdown field with enhanced Select2 UI, (*3)

MultiSelect2Field

A multiple select dropdown field with Select2 UI, (*4)

GroupedDropdownField

Extends SilverStripes GroupedDropdownField to add the Select2 UI, (*5)

AjaxSelect2Field

The AjaxSelect2Field is a dropdown field that makes use of the ajax result loading and infinite scroll features of select2. This is really useful when you need to offer users a way of choosing an object from a list of hundreds or thousands of records that would either break or make standard dropdown/select fields slow and heavy to load. Note that this does not currently work with multiple selection. PR welcome ;), (*6)

Usage

A basic implementation will use configuration defaults to provide a dropdown list of SiteTree objects, suitable for searching for and selecting a page., (*7)

$field = AjaxSelect2Field::create('PageID');

Configuration

You can configure your instance of AjaxSelect2Field with the following api. The setConfig() method is chainable, too., (*8)

Examples

// Set a class to search for. Defaults to SiteTree
$field->setConfig('classToSearch', 'MyCustomObject');

// Set a list of fields to search on. Default is Title 
$field->setConfig('searchFields', array('Title', 'ID'));

// Limit the number of results loaded per page (scroll set). Default is 200
$field->setConfig('resultsLimit', 100);

// The number of characters typed before search results are displayed. Default is 2.
$field->setConfig('minimumInputLength', 3);

// Configure how items should be displayed in the results list. The value gets parsed by the template parser
// You can use HTML too. Default is '$Title'.
$field->setConfig('resultsFormat', '<strong>$Title</strong><br />$AbsuluteLink');

// Configure how the currently selected item should be displayed. Default is '$Title'.
$field->setConfig('selectionFormat', '$Title ($ClassName)');

// Configure the text displayed when no item is selected. Default is 'Search...'
$field->setConfig('placeholder', 'Search for a Page...');

// Allow selection of multiple results. NOTE - you must handle the selected IDs (comma separated list) in code
$field->setConfig('multiple', true);

The Versions

15/02 2018

1.0.x-dev

1.0.9999999.9999999-dev http://github.com/sheadawson/silverstripe-select2

A set of silverstripe form fields based on http://ivaynberg.github.com/select2/s

  Sources   Download

The Requires

 

by Shea Dawson

ajax silverstripe forms

05/01 2017

dev-master

9999999-dev http://github.com/sheadawson/silverstripe-select2

A set of silverstripe form fields based on http://ivaynberg.github.com/select2/s

  Sources   Download

The Requires

 

by Shea Dawson

ajax silverstripe forms

25/01 2016

1.0.1

1.0.1.0 http://github.com/sheadawson/silverstripe-select2

A set of silverstripe form fields based on http://ivaynberg.github.com/select2/s

  Sources   Download

The Requires

 

by Shea Dawson

ajax silverstripe forms

23/07 2015

2.0.x-dev

2.0.9999999.9999999-dev http://github.com/sheadawson/silverstripe-select2

A set of silverstripe form fields based on http://ivaynberg.github.com/select2/s

  Sources   Download

The Requires

 

by Shea Dawson

ajax silverstripe forms

28/11 2014

1.0.0

1.0.0.0 http://github.com/sheadawson/silverstripe-select2

A set of silverstripe form fields based on http://ivaynberg.github.com/select2/s

  Sources   Download

The Requires

 

by Shea Dawson

ajax silverstripe forms