Spectrum Table
******************

The widget displays a table based on spectrum attributes and allows users to plot these attributes directly within the table. 

Widget setting 
===============

The following image shows an example of a widget setting.

\ |IMG1|\

It is possible to customize the widget settings from the inspector panel (in edit mode), as shown below: 

+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Input value                |Description                                                                                                                                  |
+===========================+=============================================================================================================================================+
|Device                     |Type in a device name (or * to list all)                                                                                                     |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Attribute                  |Once a device is selected, type in an attribute name (or * to list all available attributes)                                                 |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Show Value at Index        |Show value at specified index                                                                                                                |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Precision                  |Defines the precision displayed for each value in the table                                                                                  |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Layout                     |Sets the table layout: horizontal or vertical                                                                                                |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Show Device                |Displays the device name when enabled                                                                                                        |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Show Tango Database Name   |Displays the tango database name when enabled                                                                                                |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Attribute Display          |Select the Label, Name, or None for the attribute                                                                                            |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Show Index                 |Displays the index when enabled                                                                                                              |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Show Labels                |Displays the labels of the index when enabled                                                                                                |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Font Size (in units)       |1 corresponds to 1em text size                                                                                                               |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
|Custom CSS                 |Write custom CSS for the widget container. The syntax is the same as standard CSS used in HTML files                                         |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+


Widget design 
===============

Once plotted, the result is like the following image:

\ |IMG2|\ 

*Note: The text field in the widget is disabled for read only spectrum attributes and the same is enabled for ReadWrite spectrum attributes.*

Writing value to spectrum
-------------------------

\ |IMG3|\

The user can use the text field to enter a value to write to the spectrum attribute.
The text field displays an error icon if an invalid value is entered. The user can ``hover over the text field`` to see information about the correct input value.
Once the user enters a correct value, the text input field turns green. Press enter to write the value to the spectrum attribute.
Once the value is written, the text field is cleared as below:

\ |IMG4|\

.. bottom of content

.. |IMG1| image:: _static/img/spectrum_table_inspector.png
.. |IMG2| image:: _static/img/spectrum_table_view.png
.. |IMG3| image:: _static/img/spectrum_table_input.png
.. |IMG4| image:: _static/img/spectrum_table_input_cleared.png