Система тостов
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;
}