U
    ÛZßf  ã                   @   s$   d dl mZmZ G dd„ deƒZdS )é    )Ú	ComponentÚ_explicitize_argsc                       s€   e Zd ZdZg ZdgZdZd Zee	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
e	j
f‡ fdd„	ƒZ‡  ZS )ÚSelecta@  A Select component.
Create a HTML select element with Bootstrap styles. Specify options as a
list of dictionaries with keys label, value and disabled.

Keyword arguments:

- id (string; optional):
    The ID of this component, used to identify dash components in
    callbacks. The ID needs to be unique across all of the components
    in an app.

- className (string; optional):
    **DEPRECATED** Use `class_name` instead.  Often used with CSS to
    style elements with common properties.

- class_name (string; optional):
    Often used with CSS to style elements with common properties.

- disabled (boolean; optional):
    Set to True to disable the Select.

- html_size (string; optional):
    This represents the number of rows in the select that should be
    visible at one time. It will result in the Select being rendered
    as a scrolling list box rather than a dropdown.

- invalid (boolean; optional):
    Apply invalid style to the Input for feedback purposes. This will
    cause any FormFeedback in the enclosing div with valid=False to
    display.

- key (string; optional):
    A unique identifier for the component, used to improve performance
    by React.js while rendering components See
    https://reactjs.org/docs/lists-and-keys.html for more info.

- name (string; optional):
    The name of the control, which is submitted with the form data.

- options (list of dicts; optional):
    The options to display as items in the component. This can be an
    array or a dictionary as follows:  
1. Array of options where the
    label and the value are the same thing - [string|number]  
2. An
    array of options ``` {   "label": [string|number],   "value":
    [string|number],   "disabled": [bool] (Optional),   "title":
    [string] (Optional) } ```  
3. Simpler `options` representation
    in dictionary format. The order is not guaranteed. All values and
    labels will be treated as strings. ``` {"value1": "label1",
    "value2": "label2", ... } ``` which is equal to ``` [
    {"label": "label1", "value": "value1"},   {"label":
    "label2", "value": "value2"}, ... ] ```.

    `options` is a list of string | numbers | dict | list of dicts
    with keys:

    - disabled (boolean; optional):
        If True, this checkbox is disabled and can't be clicked on.

    - label (string | number; required):
        The options's label.

    - title (string; optional):
        The HTML 'title' attribute for the option. Allows for
        information on hover. For more information on this attribute,
        see
        https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/title.

    - value (string; required):
        The value of the option. This value corresponds to the items
        specified in the `value` property.

- persisted_props (list of a value equal to: 'value's; default ['value']):
    Properties whose user interactions will persist after refreshing
    the component or the page. Since only `value` is allowed this prop
    can normally be ignored.

- persistence (boolean | string | number; optional):
    Used to allow user interactions in this component to be persisted
    when the component - or the page - is refreshed. If `persisted` is
    truthy and hasn't changed from its previous value, a `value` that
    the user has changed while using the app will keep that change, as
    long as the new `value` also matches what was given originally.
    Used in conjunction with `persistence_type`.

- persistence_type (a value equal to: 'local', 'session', 'memory'; default 'local'):
    Where persisted user changes will be stored: memory: only kept in
    memory, reset on page refresh. local: window.localStorage, data is
    kept after the browser quit. session: window.sessionStorage, data
    is cleared once the browser quit.

- placeholder (string; default ''):
    Placeholder text to display before a selection is made.

- required (a value equal to: 'required', 'REQUIRED' | boolean; optional):
    This attribute specifies that the user must fill in a value before
    submitting a form. It cannot be used when the type attribute is
    hidden, image, or a button type (submit, reset, or button). The
    :optional and :required CSS pseudo-classes will be applied to the
    field as appropriate. required is an HTML boolean attribute - it
    is enabled by a boolean or 'required'. Alternative capitalizations
    `REQUIRED` are also acccepted.

- size (string; optional):
    Set the size of the Input. Options: 'sm' (small), 'md' (medium) or
    'lg' (large). Default is 'md'.

- style (dict; optional):
    Defines CSS styles which will override styles previously set.

- valid (boolean; optional):
    Apply valid style to the Input for feedback purposes. This will
    cause any FormFeedback in the enclosing div with valid=True to
    display.

- value (string | number; default ''):
    The value of the currently selected option.ÚchildrenZdash_bootstrap_componentsc                    s¢   ddddddddd	d
ddddddddg| _ g | _ddddddddd	d
ddddddddg| _g | _| d¡}tƒ ‰ ˆ  |¡ ‡ fdd„|D ƒ}tt| ƒj	f |Ž d S )NÚidÚ	classNameÚ
class_nameÚdisabledÚ	html_sizeÚinvalidÚkeyÚnameÚoptionsÚpersisted_propsÚpersistenceÚpersistence_typeÚplaceholderÚrequiredÚsizeÚstyleÚvalidÚvalueÚ_explicit_argsc                    s   i | ]}|ˆ | “qS © r   )Ú.0Úk©Z_localsr   úP/tmp/pip-unpacked-wheel-gvynaulb/dash_bootstrap_components/_components/Select.pyÚ
<dictcomp>ˆ   s      z#Select.__init__.<locals>.<dictcomp>)
Z_prop_namesZ_valid_wildcard_attributesZavailable_propertiesZavailable_wildcard_propertiesÚpopÚlocalsÚupdateÚsuperr   Ú__init__)Úselfr   r   r   r   r   r   r   r   r	   r   r   r   r   r
   r   r   r   r   Úkwargsr   Úargs©Ú	__class__r   r   r#      s    **

zSelect.__init__)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Z_children_propsZ_base_nodesÚ
_namespaceÚ_typer   r   Ú	UNDEFINEDr#   Ú__classcell__r   r   r'   r   r      s   tr   N)Zdash.development.base_componentr   r   r   r   r   r   r   Ú<module>   s   