====== Multiple Value List Description ======

This is the Need4Viz Wiki page for the Multiple Value List from Navigation Elements.

**Since Need4Viz 12.1**

===== Render =====

{{url>https://www.need4viz.com/dataviz/list_multi.html}}

===== Description =====

  * Display a list of single/multiple choices to be able to dynamically filter elements of the report.
  * Add optional dimensions to add filters and help finding values in the list.
  * A search bar is available to search dynamically in the list.

===== Parameters =====

  * //Dimension 1// : Dimension 1
  * //Dimension 2// : [optional] Dimension 2 (Filter)
  * //Dimension 3// : [optional] Dimension 3 (Filter)
  * //Dimension 4// : [optional] Dimension 4 (Filter)

===== Using =====

  * Create an Input Control (multiple values kind, with a uniq name in all the document) and affect it to the blocs of your report (except the navigation component)
  * Build the Multiple list navigation component
  * Declare the Input Control (through the global settings of the custom element) to affect the selected values.
  * <color #ed1c24>Do not use the Webi linking element to link this element with another element. Use only the Input Control settings to set the interaction.</color>

===== Settings =====

Here you can find instructions for accessing settings for Need4viz graphics: [[Format Custom Element]].

For the multi value list, the available parameters are :

  * **Extended parameters**
    * **Global**
      * //Title of the list// : this common parameter is described here -> [[format_title | Chart title]]
      * //Background color// : This setting allows you to choose the type of colorization for the background of the graph. Several styles and colors are available.

    * **Options**
     * //List properties// : Define here the number of lines to display in the liste textbox, the kind of choice (simple/multiple) and the position of the list in the bloc.
     * //List font// : Change here the font/color of the list items
     * //First value of the list// : Hide here the 'Description value' item at the top of the list or not. You can also change it's label.
     * //Search options// : Define the minimum number of chars to enter in the search zone to start the search. For huge list of values, it is recommended to start at 3 (for example).
     * //Buttons// : Set here colors of the buttons
     * //Always selected values// : You can add here some values that will be always added to the selected values (even they are not manualy selected by the user). Use ";" as separator in case of multiple values to add.

   * **Controls**
     * //List item control// :This setting allows you to assign an input control or a Webi vriable to feed with the selected values of the list
     * //Input controls reset option// :This setting allows you to reset or not all the input control during the selection. It also allows you to choose the input controls to exclude from the reinit.
     * //Variables reset option// : This setting allows you to reset a list of Webi variable (set with **#N4V_ALL** content)

  * **Export Sharepoint** :This common setting is described here-> [[format_export_sharepoint | Export Sharepoint]]
  * **Export HTML** :This common setting is described here -> [[format export_html | Export HTML]]
  * **Export FTP** :This common setting is described here -> [[format export_ftp | Export FTP]]