.. _gs3_notifications:

Сервис уведомлений
==============================

.. versionadded:: AS 1.8

Назначение
----------------

Показ пользователю сообщений, не перекрывающих рабочую область

Пользовательский интерфейс
------------------------------

Типы уведомлений по взаимодействию
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* С обратной связью
* Без обратной связи

Типы уведомлений по назачению
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* **Info** - информационное сообщение
* **Warning** - предупреждение
* **Error** - ошибка

Типы уведомлений по отображению
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. _system_notifications:

Системные уведомления
''''''''''''''''''''''''''

Сообщения пользователю показываются средствами :term:`ОС` или браузера. Для их отображения необходимо: 

1. Выдать разрешение браузеру 
#. Подключаться к серверу по протоколу `https <https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts>`__

.. seealso:: 
    `Настройки разрешений в Google Chrome <https://support.google.com/chrome/answer/114662?hl=en&co=GENIE.Platform%3DDesktop>`__

    `Настройки разрешений в Firefox <https://support.mozilla.org/en-US/kb/firefox-page-info-window#w_permissions>`__

    `Notifications API <https://developer.mozilla.org/en-US/docs/Web/API/Notifications_API>`__

Уведомления внутри приложения
'''''''''''''''''''''''''''''''''

Всплывающие сообщения в браузерном окне в углу страницы. Они автоматически закрываются по истечению 10 секунд или самостоятельно пользователем:

    * Любое уведомления можно закрыть кнопкой с крестиком в правом верхнем углу уведомления
    * Уведомления с обратной связью закрываются после клика по ним.

Элементы управления
``````````````````````

.. |disabled| image:: notification_disabled.png
.. |enabled| image:: notification_enabled.png

1. Окно уведомлений: в нём отображаются все пришедшие не скрытые пользователем самостоятельно уведомления. Открывается по нажатию кнопки с колокольчиком.
#. Кнопка с колокольчиком |disabled|/|enabled|: расположена в нижнем правом углу экрана, справа от всех вкладок приложения. Отражаемые состояния:
    
    * Есть непрочитанные уведомления |enabled| / все уведомления прочитаны |disabled|. При открытии окна уведомлений все уведомления в нём становятся прочитанными.
    * Справа от иконки отображается количество сообщений, которые пользователь не закрыл самостоятельно


Процесс отображения уведомлений
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Отображается уведомление в приложении на странице в окне браузера. Кнопка с колокольчиком загорается |enabled|
#. Отображается системное уведомление, если удовлетворены :ref:`условия <system_notifications>` для их показа


API
~~~~~~~~~~~~~~~~~

1. :ref:`Pascal API <gs3_notifications_pascal_api>`
#. :java:type:`Scala API<ru.bitec.gtk.core.gl.notifications.CoreNotificationManager>`