kaiwyvern.notes
← Заметки

Система тостов

plugins/module/push/main.js

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

Старт: подписка и прогрев кэша

Сначала заполняется кэш скинов: тосту нужны имя и изображение в момент события. И только потом модуль подписывается на PartyPushEvent.

async start() {
    await this.loadSkinsData();          // skins.json -> Map<id, {name, splashPath}>

    this.coreWs.subscribe(this.subscriberId, {
        message: (data) => this.handleMessage(data)
    });

    this.setupDebugApi();                // window.SYNC.push
}

Фильтр события

В канале летает не только про скины, поэтому обработчик проверяет тип и терпит три разных написания одних и тех же полей: данные приходят из внешнего сервиса, имена не стабильны.

handleMessage(data) {
    if (!data || data.type !== 'skin_update') return;

    const payload = data.payload || {};
    const skinId = payload.skin_id || payload.skinId;
    if (!skinId) return;

    const playerName = payload.player_name || payload.player || payload.playerName || 'Player';
    const skinInfo = this.getSkinInfo(skinId);

    this.showToast(playerName, skinInfo.name, skinInfo.splashPath);
}

Сборка узла

Всё создаётся через document.createElement и textContent, без HTML-строк: имя игрока приходит снаружи и не должно разбираться как разметка.

createToast(playerName, skinName, splashPath) {
    const toast = document.createElement('div');
    toast.className = 'toast-notification';

    if (splashPath) {                      // фоновая картинка скина
        const bg = document.createElement('div');
        bg.className = 'toast-bg';
        bg.style.backgroundImage = `url('${splashPath}')`;
        toast.appendChild(bg);
    }

    // ... имя игрока + имя скина ...

    document.body.appendChild(toast);
    this.activeToasts.push(toast);
    this.updateToastPositions();           // пересчёт стопки
    toast.style.animation = 'toastSlideIn 0.3s ease-out';

    return toast;
}

Стопка

Источник правды — массив активных тостов. После добавления или удаления updateToastPositions() проходит по нему и выставляет bottom каждому: складывает высоты и фиксированный зазор. Поэтому тост может исчезнуть из середины, а остальные сдвинутся и закроют дыру.

updateToastPositions() {
    let offset = CONFIG.TOAST_OFFSET_BOTTOM;

    for (const toast of this.activeToasts) {
        toast.style.bottom = offset + 'px';
        offset += toast.offsetHeight + CONFIG.TOAST_GAP;
    }
}

Отладочный хук

Ждать настоящую очередь во время разработки неудобно, поэтому модуль отдаёт window.SYNC.push(name, skinId). Удаляется он в stop() и только если это всё ещё та же функция — другой плагин мог её заменить.

window.SYNC.push = push;

// позже, в stop():
if (window.SYNC && window.SYNC.push === this._pushFn) {
    delete window.SYNC.push;
}