LibNotify-1.0

Хочешь карту со своим ником? Оформить ❤️

Эта библиотека предоставляет простой способ показывать несколько сносные уведомления. Библиотека также предоставляет способ запомнить, видел ли пользователь уже уведомление. Типичные случаи использования:

Проверка версии — вместо рассылки спама в окне чата отправьте уведомление с помощью «NotifyOnce», указав свой номер новой версии в качестве идентификатора. Если пользователь видел уведомление о версии ранее, оно будет проигнорировано.

Список изменений аддона — вы можете предоставить таблицу уведомлений, по одному для каждого обновления аддона, о котором вы хотите сообщить пользователю. Опять же, используйте «NotifyOnce», чтобы показать его только один раз. Каждый элемент в предоставленной вами таблице проверяется индивидуально.

Другое — отправляйте спам подальше. Пользователь будет видеть только одно уведомление одновременно.

интерфейс прикладного программирования

self:Уведомлять (заголовок, сообщение/функция, значок) или self:Уведомлять (таблица)Ставит в очередь уведомление или список уведомлений для отображения.

При предоставлении таблицы для каждого элемента должны быть предоставлены одни и те же ключи. И сообщение, и значок могут быть опущены.

Если заголовок слишком длинный для окна уведомления, он будет усечен.

Сообщение может быть отформатировано в формате HTML, но обратите внимание, что возможности HTML-анализатора WoW очень ограничены.

Вместо сообщения может быть предоставлена функция. Функция будет выполнена, когда пользователь нажмет на уведомление.

self:NotifyOnce(заголовок, сообщение, значок, идентификатор) или self:Notify(таблица)Ставит в очередь уведомление или список уведомлений для отображения.

Параметр «id» используется для идентификации уведомлений. Если опущено, используется заголовок.

Хранилище должно быть сначала настроено с помощью SetNotifyStorage.

self:SetNotifyIcon(icon_path)Устанавливает используемый значок по умолчанию.

self:SetNotifyStorage(таблица)Задает хранилище, которое будет использоваться для сохранения того, какие уведомления вашего аддона были просмотрены пользователем.
Обычно это находится где-то в сохраненных переменных вашего пользователя. Технически вы, конечно, также можете использовать непостоянное хранилище, если хотите, чтобы эти уведомления, возможно, отображались в другом сеансе воспроизведения.

Примеры

Основное использование

Библиотека может использоваться автономно или встроена в дополнение Ace3.

Встроенный пример:

локальный аддон = LibStub("AceAddon-3.0"):NewAddon("MyAddon", "LibNotify-1.0")
дополнение:Уведомлять ("Привет, мир!")

Отдельный пример:

локальный libnotify = LibStub("LibNotify-1.0")
libnotify.Уведомлять (мьяддон, "Привет, мир!")

Список изменений аддона

локальный аддон = LibStub("AceAddon-3.0"):NewAddon("MyAddon", "LibNotify-1.0")
локальные seen_versions = {} - Это, вероятно, указывает на активный профиль вашего пользователя
локальные версии = {
   {
     заголовок = "MyAddon 1.1",
     сообщение = "Добавлено больше материала! Также крекеры.<br/> Исправлены предыдущие ошибки."
   },
   {
     заголовок = "MyAddon 1.0",
     сообщение = "Добавлено много материала".
   }
}

дополнение:SetNotifyIcon("Интерфейс\\Иконки\\Spell_Lightning_LightningBolt01")
дополнение:SetNotifyStorage(seen_versions)
дополнение:NotifyOnce(версии)

Уведомление о новой версии

-- узнайте номер новой версии с помощью канала связи с аддоном
-- а затем уведомить пользователя
локальная версия = "1.0.0"
дополнение:NotifyOnce("MyAddon version " + версия + "доступно!", "Обязательно ознакомьтесь с новейшей версией, в которой есть дополнительные функции и кошки. Мяу!", нулевая версия)

Одноразовое уведомление

дополнение: Оповещать ("Смурфики начеку!", "Смурфики идут, закройте двери!", "Какой-нибудь необычный значок")

Поддержка локали

Это выходит за рамки библиотеки. Вы можете просто передать таблицы уведомлений / параметры на основе языкового стандарта пользователя. В настоящее время библиотека содержит одну отдельную строку текста — инструкции во фрейме уведомления, которые переведены для большинства языков.

Похожие аддоны

EventHorizon wowUnit framework oUF Lybrial LibIsClassic