benmanu/silverstripe-autocomplete

Autocomplete field that can be used as a SilverStripe form field

3.3 2018-04-04 00:33 UTC

Requires

• silverstripe/cms: ~3.1
• silverstripe/framework: ~3.1

BSD-3-Clause

• Ben Manu
• Tim Kung

• form
• autocomplete
• silverstripe
• field

README

Overview

This is a basic autocomplete field that can be used as a SilverStripe form field which provides a suggestion list based on the current text that has been entered into the field.

It uses a custom component built in VueJS to handle the autocomplete. The custom component depends on the https://github.com/paliari/v-autocomplete npm module.

Installation

You can install this via:

composer require benmanu/silverstripe-autocompletefield

Javascript Development

This module has https://github.com/JeffreyWay/laravel-mix as an npm dependency which makes it easy to do future javascript development for the module.

To get everything setup you just need to run:

yarn install

Once all the npm packages have been installed you can start javascript development using either:

yarn run dev: which will start a watch task that rebundles the src files when files in the javascript/src/ folder are updated.

yarn run prod: which you will want to run when finished to produce a production ready build of the javascript src files.

TODO

There are a bunch of enhancements that will eventually be added such as:

• Ability to suggest based on an AJAX response
• Ability to customise more options such (e.g. min length of characters before suggesting) when creating the PHP field
• Ability to pass in a DataList and have it automatically turn that into suggestion data