1:  2:  3:  4:  5:  6:  7:  8:  9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: 22: 23: 24: 25: 26: 27: 28: 29: 30: 31: 32: 33: 34: 35: 36: 37: 38: 39: 40: 41: 42: 43: 44: 45: 46: 47: 48: 49: 50: 51: 52: 53: 54: 55: 56: 57: 58: 59: 60: 61: 62: 63: 64: 65: 66: 

<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom Flidr (https://github.com/mvccore)
 * @license     https://mvccore.github.io/docs/mvccore/5.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Forms\Fields;

/**
 * Responsibility: define getters and setters for field property `multiple`.
 * Interface for classes:
 * - `\MvcCore\Ext\Forms\Fields\Email`
 * - `\MvcCore\Ext\Forms\Fields\File`
 * - `\MvcCore\Ext\Forms\Fields\Range`
 * - `\MvcCore\Ext\Forms\Fields\Select`
 *    - `\MvcCore\Ext\Forms\Fields\CountrySelect`
 * - `\MvcCore\Ext\Forms\Validators\Email`
 * - `\MvcCore\Ext\Forms\Validators\Files`
 * - `\MvcCore\Ext\Forms\Validators\Range`
 * - `\MvcCore\Ext\Forms\Validators\ValueInOptions`
 */
interface IMultiple {

    /**
     * If control is `<input>` with `type` as `file` or `email`,
     * this Boolean attribute indicates whether the user can enter 
     * more than one value.
     * If control is `<input>` with `type` as `range`, there are 
     * rendered two connected sliders (range controls) as one control
     * to simulate range from and range to. Result value will be array.
     * If control is `<select>`, this Boolean attribute indicates 
     * that multiple options can be selected in the list. When 
     * multiple is specified, most browsers will show a scrolling 
     * list box instead of a single line drop down.
     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-multiple
     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple
     * @return bool
     */
    public function GetMultiple ();

    /**
     * If control is `<input>` with `type` as `file` or `email`,
     * this Boolean attribute indicates whether the user can enter 
     * more than one value.
     * If control is `<input>` with `type` as `range`, there are 
     * rendered two connected sliders (range controls) as one control
     * to simulate range from and range to. Result value will be array.
     * If control is `<select>`, this Boolean attribute indicates 
     * that multiple options can be selected in the list. When 
     * multiple is specified, most browsers will show a scrolling 
     * list box instead of a single line drop down.
     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#attr-multiple
     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/select#attr-multiple
     * @param bool $multiple 
     * @return \MvcCore\Ext\Forms\Field
     */
    public function SetMultiple ($multiple = TRUE);
}