==============
filter_options
==============

.. js:attribute:: filter_options

**domain**: client 

**language**: javascript

**class** :doc:`Item class </refs/client/item_api>`

Description
===========

Use the ``filter_options`` attribute to specify parameters of the modal filter form.

``filter_options`` is an object that has the following attributes:

* ``width`` - the width of the modal form, the default value is 560 px,
* ``title`` - use it to get or set the title of the filter form,
* ``close_button`` - if true, the close button will be created in the upper-right 
  corner of the form, the default value is true,
* ``close_caption`` - if true and close_button is true, will display 'Close - [Esc]'
  near the button
* ``close_on_escape`` - if true, pressing on the Escape key will trigger the 
  :doc:`close_filter_form <m_close_filter_form>`
  method.
* ``close_focusout`` - if true, the 
  :doc:`close_filter_form <m_close_filter_form>`
  method will be called when a form loses focus
* ``template_class`` - if specified, the div with this class will be searched in 
  the task 
  :doc:`templates </refs/client/task/at_templates>` 
  attribute and used as a form html template when creating a form
  

Example
=======

.. code-block:: js

    function on_filter_form_created(item) {
        item.filter_options.width = 700;
    }

See also
========

:doc:`Forms </programming/interface/forms>`

:doc:`create_filter_form <m_create_filter_form>`

:doc:`close_filter_form <m_close_filter_form>`

