Provide docs and examples

[wernerkrauss]

This seems like a very useful formfield, could you please provide some more informations on how to set it up correctly?

[dhensby]

Yes, we need to do docs

Some examples of how we used it for now:

AutocompleteField::create(
    'MemberID',
    'Email address',
    array($this, 'getMembers'),
    array(
        'searchKey' => 'NiceTitle',
        'displayKey' => 'NiceTitle',
        'rawFieldKey' => 'Email',
        'rawValueFieldClass' => 'EmailField',
    )
)->setRecordFormatter('MemberExtension::frontend_autocomplete');

static public function frontend_autocomplete($data) {
    $data = $data->toArray();
    foreach($data as &$member) {
        $niceTitle = $member->getName() ?: 'Invited member';
        $niceTitle = call_user_func_array(
            'sprintf',
            array(
                '%s • %s',
                $niceTitle,
                $member->Email,
            )
        );
        $member = array(
            'ID' => $member->ID,
            'Email' => $member->Email ?: $member->getName(),
            'SafeName' => $member->getSafeName(),
            'NiceTitle' => $niceTitle,
        );
    }
    return $data;
}