/** 下拉项接口 */
export interface DropdownItem {
    /** 值 */
    value: string;
    /** 显示文本 */
    text: string;
    /** 源码显示内容 */
    html?: HTMLElement
}

/** 下拉框选项接口 */
export interface DropdownOptions {
    /** 文本关键字，默认值 text */
    textKey?: string;
    /** 值关键字，默认值 value */
    valueKey?: string;
    /** 源码显示的关键字，默认值 html */
    htmlKey?: string;
    /** 最大输入长度，默认值 500 */
    maxLength?: Number;
    /** 是否允许多选 */
    multiSelect?: boolean;
    /** 选中值 */
    selected?: string;
    /** 选中的数组 */
    selectedList?: Array<string>;
    /** 是否禁用 */
    disabled?: boolean;
    /** 是否支持输入 */
    input?: boolean;
    /** 是否支持搜索 */
    search?: boolean;
    /** 搜索的关键字数组 */
    searchKeys?: Array<string>;
    /** 搜索提示文本，默认值取语言资源 <code>searchHolder</code> "Search..." */
    searchPlaceholder?: string;
    /** 焦点索引 */
    tabIndex?: Number;
    /** 输入框的提示文本 */
    placeholder?: string;
    /** 是否固定为向下展开 */
    slideFixed?: boolean;
    /** 父元素，默认添加到头元素之后 */
    wrapper?: HTMLElement;
}

/** 下拉框类 */
export class Dropdown {
    /**
     * 把父元素下的所有 <code>select</code> 元素修改为统一下拉框组件
     * @param dom 父元素
     * @returns 返回该父元素
     */
    static resolve(dom?: HTMLElement): HTMLElement;

    /**
     * 下拉框的构造函数
     * @param options 下拉框选项
     */
    constructor(options?: DropdownOptions);

    /** 根据该函数返回数据源 */
    sourceFilter: () => Array<DropdownItem | any>;
    /**
     * 选中时触发
     * @param item 选中的条目
     */
    onSelected: (item: DropdownItem | any) => void;
    /**
     * 选中多个时触发
     * @param list 选中的条目数组
     */
    onSelectedList: (list: Array<DropdownItem | any>) => void;
    /** 下拉框展开时触发 */
    onExpanded: () => void;
    /** 下拉框收缩时触发 */
    onCollapsed: () => void;

    /** 获取下拉框是否禁用 */
    get disabled(): boolean;
    /**
     * 设置下拉框禁用状态
     * @param flag 禁用状态
     */
    set disabled(flag: boolean);
    /** 获取数据源 */
    get source(): Array<DropdownItem | any>;
    /**
     * 设置数据源
     * @param list 数据源
     */
    set source(list: Array<DropdownItem | any>);

    /** 获取是否允许多选 */
    get multiSelect(): boolean;
    /** 获取选中的条目 */
    get selected(): DropdownItem | any;
    /** 获取选中的条目列表 */
    get selectedList(): Array<DropdownItem | any>;

    /**
     * 创建下拉框元素
     * @returns 返回创建的下拉框元素
     */
    create(): HTMLElement;
    /**
     * 选中某个条目
     * @param selected 选中的值
     * @param silence 是否静默选中，即不触发 {@linkcode onSelected} 事件
     */
    select(selected: string, silence?: boolean): void;
    /**
     * 选中条目列表
     * @param selectedlist 选中的值的列表
     * @param silence 是否静默选中，即不触发 {@linkcode onSelected} 事件
     */
    selectlist(selectedlist: Array<string>, silence?: boolean): void;
}