// ----- Начало файла: ./js\db.js ----- // db.js - Отвечает за инициализацию и…
- User
// ----- Начало файла: ./js\db.js ----- // db.js - Отвечает за инициализацию и взаимодействие с IndexedDB.
import { languageData } from './data/languageData.js'; import { typeData } from './data/typeData.js'; import { colorData } from './data/colorData.js'; import { categoryData } from './data/categoryData.js'; import { flagNameData } from './data/flagNameData.js'; import { flagData } from './data/flagData.js'; import { flagSubdivisionsData } from './data/flagSubdivisionsData.js'; import { flagSubdivisionNamesData } from './data/flagSubdivisionNamesData.js';
const dataMapping = { languages: { data: languageData, storeName: "languages", keyPath: "id", fields: ["id", "ru_name", "en_name", "zh_name"] }, types: { data: typeData, storeName: "types", keyPath: "id", fields: ["id", "ru_name", "en_name", "zh_name"] }, colors: { data: colorData, storeName: "colors", keyPath: "id", fields: ["id", "ru_name", "en_name", "zh_name", "hex"] }, categories: { data: categoryData, storeName: "categories", keyPath: "id", fields: ["id", "ru_name", "en_name", "zh_name"] }, flagNames: { data: flagNameData, storeName: "flagNames", keyPath: ["flag_id", "language_id"], // Составной ключ fields: ["flag_id", "language_id", "short_name", "long_name"] }, flags: { data: flagData, storeName: "flags", keyPath: "id", fields: ["id", "is_index_ISO", "resolution", "resolution_ratio", "colors", "types", "originalNames", "parent_flag_id"] }, flagSubdivisions: { data: flagSubdivisionsData, storeName: "flagSubdivisions", keyPath: "id", fields: ["category_id", "id", "parent_flag_id"] }, flagSubdivisionNames: { data: flagSubdivisionNamesData, storeName: "flagSubdivisionNames", keyPath: "id", fields: ["id", "originalNames", "en_name", "ru_name", "zh_name"] }, // Добавьте больше соответствий при необходимости };
/**
-
Инициализирует IndexedDB и загружает данные при необходимости
-
@returns {Promise} */ export function initDB() { return new Promise((resolve, reject) => { const request = indexedDB.open("FlagsDatabase", 1);
request.onupgradeneeded = function(event) { const db = event.target.result; // Создаём объектные хранилища и индексы Object.values(dataMapping).forEach(config => { if (!db.objectStoreNames.contains(config.storeName)) { if (Array.isArray(config.keyPath)) { const store = db.createObjectStore(config.storeName, { keyPath: config.keyPath }); // Создаём индексы, если необходимо if (config.storeName === "flagNames") { store.createIndex("flag_id", "flag_id", { unique: false }); store.createIndex("language_id", "language_id", { unique: false }); } // Добавьте другие индексы при необходимости } else { const store = db.createObjectStore(config.storeName, { keyPath: config.keyPath }); // Создаём индексы if (config.storeName === "languages") { store.createIndex("en_name", "en_name", { unique: false }); store.createIndex("ru_name", "ru_name", { unique: false }); store.createIndex("zh_name", "zh_name", { unique: false }); } else if (config.storeName === "flags") { store.createIndex("types", "types", { unique: false, multiEntry: true }); store.createIndex("colors", "colors", { unique: false, multiEntry: true }); store.createIndex("parent_flag_id", "parent_flag_id", { unique: false }); } else if (config.storeName === "flagSubdivisions") { store.createIndex("parent_flag_id", "parent_flag_id", { unique: false }); } // Добавьте другие индексы для других хранилищ при необходимости } } }); }; request.onsuccess = function(event) { const db = event.target.result; console.log("База данных успешно открыта"); resolve(db); }; request.onerror = function(event) { console.error("Не удалось открыть базу данных", event.target.error); reject(event.target.error); };}); }
/**
-
Добавляет данные в указанное объектное хранилище
-
@param {IDBDatabase} db - Открытая база данных
-
@param {string} storeName - Имя объектного хранилища
-
@param {Array} dataArray - Массив данных для добавления
-
@param {string|Array} keyPath - Ключевое поле или составной ключ
-
@returns {Promise} */ export function addData(db, storeName, dataArray, keyPath) { return new Promise((resolve, reject) => { const transaction = db.transaction([storeName], "readwrite"); const store = transaction.objectStore(storeName);
transaction.oncomplete = function() { console.log(`Все данные добавлены в ${storeName}`); resolve(); }; transaction.onerror = function(event) { console.error(`Ошибка при добавлении данных в ${storeName}:`, event.target.error); reject(event.target.error); }; dataArray.forEach(item => store.put(item));}); }
/**
-
Получает количество записей в указанном объектном хранилище
-
@param {IDBDatabase} db - Открытая база данных
-
@param {string} storeName - Имя объектного хранилища
-
@returns {Promise} */ export function getCount(db, storeName) { return new Promise((resolve, reject) => { const transaction = db.transaction([storeName], "readonly"); const store = transaction.objectStore(storeName); const request = store.count();
request.onsuccess = function(event) { resolve(event.target.result); }; request.onerror = function(event) { console.error(`Ошибка при подсчёте записей в ${storeName}:`, event.target.error); reject(event.target.error); };}); }
/**
-
Загружает все данные в IndexedDB при необходимости
-
Данные загружаются только при первом создании базы данных
-
@param {IDBDatabase} db - Открытая база данных
-
@returns {Promise} */ export async function loadData(db) { try { // Проверяем, пусто ли объектное хранилище "languages" const countLanguages = await getCount(db, "languages"); console.log(
Количество записей в 'languages': ${countLanguages});if (countLanguages === 0) { for (const [key, config] of Object.entries(dataMapping)) { console.log(`Добавление данных в хранилище: ${config.storeName}`); await addData(db, config.storeName, config.data, config.keyPath); console.log(`Данные добавлены в хранилище: ${config.storeName}`); } console.log("Все данные успешно загружены в IndexedDB."); } else { console.log("Данные уже существуют в базе данных. Загрузка не требуется."); }} catch (error) { console.error("Произошла ошибка при загрузке данных. Пожалуйста, попробуйте позже.", error); } }
/**
-
Получает все записи из указанного объектного хранилища
-
@param {IDBDatabase} db - Открытая IndexedDB база данных
-
@param {string} storeName - Имя объектного хранилища
-
@returns {Promise} */ export function getAllRecords(db, storeName) { return new Promise((resolve, reject) => { const transaction = db.transaction([storeName], "readonly"); const store = transaction.objectStore(storeName); const request = store.getAll();
request.onsuccess = function(event) { resolve(event.target.result); }; request.onerror = function(event) { console.error(`Ошибка при получении данных из ${storeName}:`, event.target.error); reject(event.target.error); };}); }
// ----- Начало файла: ./js\events.js ----- // events.js - Содержит все обработчики событий и назначение слушателей. import { selectedFilters, paginationState } from './state.js'; import { handleViewData, viewFlagsAsCards } from './main.js'; import { debounce } from './utils.js';
/**
-
Добавляет обработчики событий для фильтров */ export function addFilterEventListeners() { // Фильтр по цветам const colorCheckboxes = document.querySelectorAll("#color-filters input[type='checkbox']"); colorCheckboxes.forEach(checkbox => { checkbox.addEventListener("change", (event) => { if (event.target.checked) { selectedFilters.colors.add(event.target.value); } else { selectedFilters.colors.delete(event.target.value); } handleViewData(); }); });
// Фильтр по типам const typeCheckboxes = document.querySelectorAll("#type-filters input[type='checkbox']"); typeCheckboxes.forEach(checkbox => { checkbox.addEventListener("change", (event) => { if (event.target.checked) { selectedFilters.types.add(event.target.value); } else { selectedFilters.types.delete(event.target.value); } handleViewData(); }); });
// Фильтр по языкам const languageCheckboxes = document.querySelectorAll("#language-filters input[type='checkbox']"); languageCheckboxes.forEach(checkbox => { checkbox.addEventListener("change", (event) => { if (event.target.checked) { selectedFilters.languages.add(event.target.value); } else { selectedFilters.languages.delete(event.target.value); } handleViewData(); }); }); }
/**
-
Добавляет обработчики событий для различных кнопок и элементов */ export function setupEventListeners() { // Кнопка Поиска document.getElementById("search-button").addEventListener("click", async () => { handleViewData(); });
// Кнопка Очистки Поиска document.getElementById("clear-search").addEventListener("click", async () => { document.getElementById("search-input").value = ""; handleViewData(); });
// Кнопка Применения Фильтров document.getElementById("apply-filters").addEventListener("click", async () => { handleViewData(); });
// Кнопка Очистки Фильтров document.getElementById("clear-filters").addEventListener("click", async () => { // Снимаем все чекбоксы const allCheckboxes = document.querySelectorAll("#filters input[type='checkbox']"); allCheckboxes.forEach(checkbox => { checkbox.checked = false; });
// Очищаем выбранные фильтры selectedFilters.colors.clear(); selectedFilters.types.clear(); selectedFilters.languages.clear(); handleViewData();}); }
/**
-
Настраивает реализацию фильтрации в реальном времени
-
@param {IDBDatabase} db - Открытая база данных */ export function setupRealTimeFiltering(db) { const searchInput = document.getElementById("search-input");
searchInput.addEventListener("input", debounce(() => { // Сброс состояния пагинации paginationState.currentPage = 1; paginationState.hasMore = true; handleViewData(db); }, 300)); }
/**
-
Добавляет обработчик для кнопки переключения фильтров */ export function setupFilterToggle() { const toggleButton = document.getElementById("toggle-filters"); const filtersPanel = document.getElementById("filters-panel");
toggleButton.addEventListener("click", () => { filtersPanel.classList.toggle("hidden"); }); }
/**
-
Обработчик события прокрутки для Infinite Scrolling с debounce */ export function setupInfiniteScroll() { window.addEventListener("scroll", debounce(async () => { if (paginationState.isLoading || !paginationState.hasMore) return;
const { filteredFlags, currentPage, pageSize } = paginationState; if ((currentPage * pageSize) >= filteredFlags.length) { paginationState.hasMore = false; return; } if (window.innerHeight + window.scrollY >= document.body.offsetHeight - 500) { paginationState.isLoading = true; paginationState.currentPage += 1; await viewFlagsAsCards(filteredFlags, paginationState.currentPage, pageSize); paginationState.isLoading = false; if ((paginationState.currentPage * pageSize) >= filteredFlags.length) { paginationState.hasMore = false; } }}, 200), { passive: true }); }
// ----- Начало файла: ./js\main.js ----- // main.js - Точка входа приложения, которая связывает все модули и инициализирует приложение. import { initDB, loadData, getAllRecords } from './db.js'; import { updateContent } from './uiUpdater.js'; import { populateAllFilters, languagesMap } from './ui.js'; import { addFilterEventListeners, setupEventListeners, setupRealTimeFiltering, setupFilterToggle, setupInfiniteScroll } from './events.js'; import { showLoading, hideLoading, showError } from './utils.js'; import { selectedFilters, paginationState } from './state.js';
import i18next from 'https://cdn.skypack.dev/i18next@21.6.16'; import HttpBackend from 'https://cdn.skypack.dev/i18next-http-backend@1.4.0';
// Обработчик выбора языка document.addEventListener('DOMContentLoaded', () => { const languageSelect = document.getElementById('language-select');
// Установка текущего языка в селектор languageSelect.value = i18next.language || 'en'; languageSelect.addEventListener('change', function (e) { const selectedLang = e.target.value; i18next.changeLanguage(selectedLang); });});
let dbInstance; // экземпляр БД
// Обработчик изменения языка i18next.on('languageChanged', () => { updateContent(); if (dbInstance) { handleViewData(dbInstance); } });
/**
-
Инициализирует и загружает приложение */ export async function initializeApp() { try { // Инициализация i18next await i18next .use(HttpBackend) .init({ fallbackLng: 'en', debug: true, backend: { loadPath: '../locales/{{lng}}/translations.json' } });
updateContent(); // Инициализация БД const dbInstance = await initDB(); await loadData(dbInstance); // Заполнение фильтров и установка событий await populateAllFilters(dbInstance); addFilterEventListeners(); setupEventListeners(); setupRealTimeFiltering(dbInstance); setupFilterToggle(); setupInfiniteScroll(dbInstance); console.log("Приложение инициализировано успешно."); handleViewData(dbInstance);} catch (error) { console.error("Произошла ошибка при инициализации приложения.", error); } }
/**
-
Показывает/обновляет данные в зависимости от выбранного типа данных и применённых фильтров
-
@param {IDBDatabase} db - Открытая база данных */ export async function handleViewData(db) { const searchQuery = document.getElementById("search-input").value.trim();
// Сброс состояния пагинации paginationState.currentPage = 1; paginationState.hasMore = true;
// Получение и фильтрация флагов const {filteredFlags, flagNamesMap} = await getFilteredFlags(db, searchQuery, selectedFilters); paginationState.filteredFlags = filteredFlags;
// Рендер первой страницы await viewFlagsAsCards(filteredFlags, flagNamesMap, paginationState.currentPage, paginationState.pageSize, db); }
/**
-
Получает все флаги, соответствующие запросу поиска и фильтрам
-
@param {IDBDatabase} db - Открытая база данных
-
@param {string} searchQuery - Запрос поиска
-
@param {object} filters - Выбранные фильтры
-
@returns {Promise} - Массив флагов */ export async function getFilteredFlags(db, searchQuery, filters) { // Получаем все флаги const flags = await getAllRecords(db, "flags"); const flagNames = await getAllRecords(db, "flagNames");
// Создаём карты для быстрого доступа const flagNamesMap = flagNames.reduce((map, name) => { if (!map[name.flag_id]) { map[name.flag_id] = []; } map[name.flag_id].push(name); return map; }, {});
// Дополняем карту оригинальными именами flags.forEach(flag => { if (flag.originalNames && Array.isArray(flag.originalNames)) { if (!flagNamesMap[flag.id]) { flagNamesMap[flag.id] = []; } flag.originalNames.forEach(originalName => { flagNamesMap[flag.id].push({ flag_id: flag.id, language_id: originalName.language_id, original_name: originalName.original_name, }); }); } });
// Фильтруем флаги по запросу поиска и выбранным фильтрам let filteredFlags = flags.filter(flag => { // Поиск let matchesSearch = true; if (searchQuery) { const lowerSearch = searchQuery.toLowerCase();
// Проверка по ID флага const flagMatches = flag.id.toLowerCase().includes(lowerSearch); // Проверка по названиям флага const flagNamesForFlag = flagNamesMap[flag.id] || []; const namesMatch = flagNamesForFlag.some(nameObj => { const shortName = (nameObj.short_name || "").toLowerCase(); const longName = (nameObj.long_name || "").toLowerCase(); const originalName = (nameObj.original_name || "").toLowerCase(); return shortName.includes(lowerSearch) || longName.includes(lowerSearch) || originalName.includes(lowerSearch); }); matchesSearch = flagMatches || namesMatch; } if (!matchesSearch) return false; // **Фильтрация по Цветам** if (filters.colors.size > 0) { const flagColors = new Set(flag.colors); const commonColors = [...filters.colors].some(color => flagColors.has(color)); if (!commonColors) return false; } // **Фильтрация по Типам** if (filters.types.size > 0) { const flagTypes = new Set(flag.types); const commonTypes = [...filters.types].some(type => flagTypes.has(type)); if (!commonTypes) return false; } // **Фильтрация по Языкам** if (filters.languages.size > 0) { const namesForFlag = flagNamesMap[flag.id] || []; const hasMatchingLanguage = namesForFlag.some(nameObj => filters.languages.has(nameObj.language_id)); if (!hasMatchingLanguage) return false; } return true;});
return {filteredFlags, flagNamesMap}; }
/**
-
Показывает/обновляет данные в виде карточек с учётом фильтров и поиска с поддержкой пагинации
-
@param {number} page - Номер текущей страницы
-
@param {number} pageSize - Количество флагов на страницу
-
@returns {Promise} */ export async function viewFlagsAsCards(filteredFlags, flagNamesMap, page = 1, pageSize = 36, db) { try { if (page === 1) { showLoading(); // Показываем спиннер только при первой загрузке }
// Определяем часть данных для отображения const startIndex = (page - 1) * pageSize; const endIndex = startIndex + pageSize; const flagsToDisplay = filteredFlags.slice(startIndex, endIndex); // Обработка сценария отсутствия данных const output = document.getElementById("output"); if (page === 1) { output.innerHTML = ""; } if (page === 1 && flagsToDisplay.length === 0) { output.innerHTML = "<p>Нет флагов, соответствующих выбранным фильтрам.</p>"; hideLoading(); return; } // Создаем DocumentFragment для оптимизации манипуляций с DOM const fragment = document.createDocumentFragment(); for (const flag of flagsToDisplay) { const card = await createFlagCard(flag, flagNamesMap, languagesMap, db); fragment.appendChild(card); } output.appendChild(fragment); hideLoading(); // Инициализируем ленивую загрузку изображений initLazyLoadImages();} catch (error) { console.log(error); showError("errorLoadingFlags"); hideLoading(); } }
/**
-
Асинхронно создает элемент карточки флага. */ async function createFlagCard(flag, flagNamesMap, languagesMap, db) { const currentLang = i18next.language || 'en'; // Создаём элемент карточки const card = document.createElement("div"); card.className = "flag_card";
// Индекс флага const flagIndex = document.createElement("span"); flagIndex.className = "flag_index"; flagIndex.textContent = flag.id; card.appendChild(flagIndex);
// Изображение флага const flagImgDiv = document.createElement("div"); flagImgDiv.className = "flag_img"; const img = document.createElement("img"); img.setAttribute("data-src", flag.parent_flag_id ?
flags/PNG-1200/PNG-0.5/${flag.parent_flag_id}-0.5-1200.png:flags/PNG-1200/PNG-0.5/${flag.id}-0.5-1200.png); img.alt = flag.parent_flag_id ?Флаг ${flag.parent_flag_id}:Флаг ${flag.id}; img.classList.add("lazy-image"); img.src = 'https://placehold.co/400'; // Заглушка до загрузкиflagImgDiv.appendChild(img); card.appendChild(flagImgDiv);
// Краткое название флага const shortName = document.createElement("div"); shortName.className = "flag_shortname";
const namesObj = flagNamesMap[flag.id]?.find(fn => fn.language_id === currentLang); shortName.textContent = namesObj ? namesObj.short_name : ""; card.appendChild(shortName);
// Полное название флага на текущем языке const longName = document.createElement("div"); longName.className = "flag_longname";
longName.textContent = namesObj.long_name ? namesObj.long_name : ""; card.appendChild(longName);
const namesForFlag = flagNamesMap[flag.id] || [];
for (const nameObj of namesForFlag) { // Названия флага на разных языках const namesContainer = document.createElement("div"); namesContainer.className = "flag_names_container";
const langSpan = document.createElement("span"); langSpan.className = "flag_original_lang"; // Получаем название языка из предзагруженной карты языков const languageTitle = languagesMap[nameObj.language_id]; langSpan.title = languageTitle || "Неизвестный язык"; // Всплывающая подсказка с названием языка langSpan.textContent = nameObj.language_id; namesContainer.appendChild(langSpan); const nameSpan = document.createElement("span"); nameSpan.textContent = nameObj.short_name || nameObj.long_name || nameObj.original_name || "N/A"; namesContainer.appendChild(nameSpan); card.appendChild(namesContainer);}
// Цвета флага const colorsContainer = document.createElement("div"); colorsContainer.className = "flag_colors_container";
for (const colorId of flag.colors) { const colorDiv = document.createElement("div"); colorDiv.className = "flag_color"; colorDiv.title = colorId.en_name; // Всплывающая подсказка с названием цвета colorDiv.style.backgroundColor = colorId.hex; colorsContainer.appendChild(colorDiv); }
card.appendChild(colorsContainer);
// Добавляем информацию о подразделениях const subdivisionsInfo = await getFlagSubdivisions(db, flag.id); if (subdivisionsInfo.length > 0) { const subdivisionsContainer = await createSubdivisionsContainer(subdivisionsInfo);
card.appendChild(subdivisionsContainer);} return card; }
/**
-
Создаётся контейнер для subdivisions и передаётся в карточку */ async function createSubdivisionsContainer(subdivisionsInfo) { const subdivisionsContainer = document.createElement("div"); subdivisionsContainer.className = "flag_subdivisions_container hidden";
const subdivisionsTitle = document.createElement("h4"); subdivisionsTitle.textContent = i18next.t('subdivisions'); subdivisionsContainer.appendChild(subdivisionsTitle);
const toggleSubsBtn = document.createElement("button"); toggleSubsBtn.textContent = i18next.t('showSubdivisions'); toggleSubsBtn.className = "toggle-subs-btn";
toggleSubsBtn.addEventListener("click", () => { subdivisionsContainer.classList.toggle("hidden"); const isHidden = subdivisionsContainer.classList.contains("hidden"); toggleSubsBtn.textContent = isHidden ? i18next.t('showSubdivisions') : i18next.t('hideSubdivisions'); });
// Добавление названий подразделений subdivisionsInfo.forEach(subdivision => { const subdivisionDiv = document.createElement("div"); subdivisionDiv.textContent = subdivision.original_name; subdivisionsContainer.appendChild(subdivisionDiv); });
subdivisionsContainer.appendChild(toggleSubsBtn);
return subdivisionsContainer; }
/**
-
Инициализирует ленивую загрузку изображений с использованием Intersection Observer */ function initLazyLoadImages() { const lazyImages = document.querySelectorAll("img.lazy-image");
if ("IntersectionObserver" in window) { const imageObserver = new IntersectionObserver((entries, observer) => { entries.forEach(entry => { if (entry.isIntersecting) { const img = entry.target; const realSrc = img.getAttribute("data-src"); if (realSrc) { img.src = realSrc; img.onload = () => img.classList.add('loaded'); // Добавляем класс после загрузки img.onerror = () => img.src = 'https://placehold.co/400/ff0000'; // Запасной вариант при ошибке img.removeAttribute("data-src"); } imageObserver.unobserve(img); } }); }, { rootMargin: "200px 0px", // Предзагрузка изображений заранее threshold: 0.01 });
lazyImages.forEach(img => { imageObserver.observe(img); });} else { // Запасной вариант для браузеров без поддержки IntersectionObserver lazyImages.forEach(img => { const realSrc = img.getAttribute("data-src"); if (realSrc) { img.src = realSrc; img.classList.add('loaded'); img.removeAttribute("data-src"); } }); } }
/**
-
Получает подразделения флага
-
@param {IDBDatabase} db - Открытая база данных
-
@param {string} flagId - ID флага
-
@returns {Promise} - Массив подразделений с названиями */ export async function getFlagSubdivisions(db, flagId) { try { // Получаем все подразделения для данного флага const subdivisions = await new Promise((resolve, reject) => { const transaction = db.transaction(["flagSubdivisions"], "readonly"); const store = transaction.objectStore("flagSubdivisions"); const index = store.index("parent_flag_id"); const request = index.getAll(IDBKeyRange.only(flagId));
request.onsuccess = function(event) { resolve(event.target.result); }; request.onerror = function(event) { console.error(`Ошибка при получении подразделений для флага "${flagId}":`, event.target.error); resolve([]); // Возвращаем пустой массив в случае ошибки }; }); if (subdivisions.length === 0) { return []; } // Получаем названия подразделений const subdivisionIds = subdivisions.map(sub => sub.id); const subdivisionNames = await new Promise((resolve, reject) => { const transaction = db.transaction(["flagSubdivisionNames"], "readonly"); const store = transaction.objectStore("flagSubdivisionNames"); const request = store.getAll(); // Получаем все и фильтруем в коде request.onsuccess = function(event) { const allNames = event.target.result; const matchedNames = allNames.filter(name => subdivisionIds.includes(name.id)); resolve(matchedNames); }; request.onerror = function(event) { console.error(`Ошибка при получении названий подразделений для флага "${flagId}":`, event.target.error); resolve([]); // Возвращаем пустой массив в случае ошибки }; }); return subdivisionNames;} catch (error) { console.error("Ошибка при получении подразделений флага:", error); return []; } }
document.addEventListener("DOMContentLoaded", initializeApp);
// ----- Начало файла: ./js\state.js ----- export const selectedFilters = { colors: new Set(), types: new Set(), languages: new Set() };
export const paginationState = { currentPage: 1, pageSize: 36, isLoading: false, hasMore: true, filteredFlags: [] };
// ----- Начало файла: ./js\ui.js ----- // ui.js - Управляет всеми функциями, связанными с изменением интерфейса пользователя, такими как отображение фильтров и карточек флагов. import { updateContent } from './uiUpdater.js'; import { getAllRecords } from './db.js'; import i18next from 'https://cdn.skypack.dev/i18next@21.6.16';
// Объявление необходимых переменных и карт export let colorsMap = {}; export let languagesMap = {};
/**
- Заполняет фильтры на основе данных из базы
- @param {IDBDatabase} db - Открытая база данных
- @returns {Promise} */ export async function populateAllFilters(db) { await populateColorFilters(db); await populateTypeFilters(db); await populateLanguageFilters(db); }
/**
-
Заполняет фильтр по цветам
-
@param {IDBDatabase} db - Открытая база данных
-
@returns {Promise} */ export async function populateColorFilters(db) { const colors = await getAllRecords(db, "colors"); const colorFiltersDiv = document.getElementById("color-filters");
colorsMap = colors.reduce((map, color) => { map[color.id] = color; return map; }, {});
colors.forEach(color => { const label = document.createElement("label"); label.classList.add("filter-option"); label.style.display = "flex"; label.style.alignItems = "center";
const checkbox = document.createElement("input"); checkbox.type = "checkbox"; checkbox.value = color.id; const colorSquare = document.createElement("div"); colorSquare.style.width = "15px"; colorSquare.style.height = "15px"; colorSquare.style.backgroundColor = color.hex; colorSquare.style.margin = "0 5px"; colorSquare.style.border = "1px solid #000"; const colorName = document.createElement("span"); colorName.textContent = color.en_name; label.appendChild(checkbox); label.appendChild(colorSquare); label.appendChild(colorName); colorFiltersDiv.appendChild(label);}); }
/**
-
Заполняет фильтр по типам
-
@param {IDBDatabase} db - Открытая база данных
-
@returns {Promise} */ export async function populateTypeFilters(db) { const types = await getAllRecords(db, "types"); const typeFiltersDiv = document.getElementById("type-filters");
types.forEach(type => { const label = document.createElement("label"); label.classList.add("filter-option"); label.innerHTML =
<input type="checkbox" value="${type.id}" /> ${i18next.t(type.{type.id}`)} `; // Предполагается, что ключ для перевода — это `type.{type.id}или подобное label.querySelector('input').setAttribute('data-i18n',type.${type.id}`); typeFiltersDiv.appendChild(label); });// После заполнения фильтров обновляем переводы updateContent(); }
/**
-
Заполняет фильтр по языкам
-
@param {IDBDatabase} db - Открытая база данных
-
@returns {Promise} */ export async function populateLanguageFilters(db) { const languages = await getAllRecords(db, "languages"); const languageFiltersDiv = document.getElementById("language-filters");
languagesMap = languages.reduce((map, language) => { map[language.id] = language.en_name || "Unknown Language"; return map; }, {});
languages.forEach(language => { const label = document.createElement("label"); label.classList.add("filter-option"); label.innerHTML =
<input type="checkbox" value="${language.id}" /> ${language.en_name}; languageFiltersDiv.appendChild(label); }); }
/**
-
Отображает данные в виде таблицы (не меняется)
-
@param {Array} data - Массив данных
-
@param {Array} fields - Поля для отображения */ export function displayData(data, fields) { const output = document.getElementById("output"); output.innerHTML = ""; // Очищаем предыдущий вывод
if (data.length === 0) { output.innerHTML = "No data found."; return; }
const table = document.createElement("table"); const thead = document.createElement("thead"); const tbody = document.createElement("tbody");
// Создаём заголовок таблицы const headerRow = document.createElement("tr"); fields.forEach(field => { const th = document.createElement("th"); th.textContent = field; headerRow.appendChild(th); }); thead.appendChild(headerRow);
// Создаём строки данных data.forEach(item => { const row = document.createElement("tr"); fields.forEach(field => { const td = document.createElement("td"); let value = item[field]; if (Array.isArray(value)) { value = value.join(", "); } else if (typeof value === 'object' && value !== null) { value = JSON.stringify(value); } td.textContent = value || "-"; row.appendChild(td); }); tbody.appendChild(row); });
table.appendChild(thead); table.appendChild(tbody); output.appendChild(table); }
// ----- Начало файла: ./js\uiUpdater.js ----- // Функция для обновления содержимого страницы export function updateContent() { document.querySelectorAll('[data-i18n]').forEach(function (element) { const key = element.getAttribute('data-i18n'); if (key.includes('[placeholder]')) { const [, placeholderKey] = key.split(']'); element.setAttribute('placeholder', i18next.t(placeholderKey)); } else { element.textContent = i18next.t(key); } }); }
// ----- Начало файла: ./js\utils.js ----- // utils.js - Включает вспомогательные функции, такие как debounce и lazy loading. import i18next from 'https://cdn.skypack.dev/i18next@21.6.16';
/**
- Показывает ошибку на экране
- @param {string} messageKey - Ключ перевода сообщения об ошибке / export function showError(messageKey) { const output = document.getElementById("output"); const errorDiv = document.createElement("div"); errorDiv.className = "error-message"; errorDiv.textContent = i18next.t(messageKey); output.innerHTML = ""; // Очищаем предыдущий контент output.appendChild(errorDiv); } /*
- Функция debounce, которая ограничивает частоту вызовов функции
- @param {Function} func - Функция для обертки
- @param {number} delay - Задержка в миллисекундах */ export function debounce(func, delay) { let timeout; return function (...args) { clearTimeout(timeout); timeout = setTimeout(() => func.apply(this, args), delay); }; }
/**
- Показывает загрузочный спиннер */ export function showLoading() { const spinner = document.getElementById("loading-spinner"); if (spinner) { spinner.style.display = "block"; } }
/**
- Скрывает загрузочный спиннер */ export function hideLoading() { const spinner = document.getElementById("loading-spinner"); if (spinner) { spinner.style.display = "none"; } }
-
- Assistant
Ваш код демонстрирует хорошо структурированное и модульное приложение, использующее IndexedDB для хранения данных о флагах, i18next для интернационализации и различные современные подходы для управления состоянием и взаимодействием с пользователем. Ниже приведены некоторые замечания, рекомендации и возможные улучшения, которые могут повысить качество и эффективность вашего приложения.
Общая Структура
Ваше приложение разделено на несколько модулей, каждый из которых отвечает за конкретную функциональность:
db.js: Инициализация и взаимодействие с IndexedDB.events.js: Обработчики событий и назначение слушателей.main.js: Точка входа приложения, интеграция модулей и инициализация.state.js: Управление состоянием приложения.ui.js: Управление интерфейсом пользователя, заполнение фильтров.uiUpdater.js: Обновление контента страницы на основе переводов.utils.js: Вспомогательные функции, такие какdebounceи управление загрузкой.
Такое разделение облегчает поддержку и масштабирование приложения.
Детальный Анализ и Рекомендации
1. Проблемы с Переменной
dbInstanceОписание Проблемы: В
main.jsвы объявляете глобальную переменнуюlet dbInstance;, однако внутри функцииinitializeAppвы используетеconst dbInstance = await initDB();, создавая локальную копию, которая не присваивается глобальной переменной. В результате глобальнаяdbInstanceостаётсяundefined, что может привести к тому, что обработчики событий, такие какlanguageChanged, не смогут работать корректно.Решение: Удалите
constвнутриinitializeApp, чтобы присвоить результат глобальной переменной.// main.js let dbInstance; // Глобальная переменная export async function initializeApp() { try { // ... другие шаги инициализации // Присваиваем глобальной переменной dbInstance = await initDB(); await loadData(dbInstance); // ... остальная инициализация } catch (error) { console.error("Произошла ошибка при инициализации приложения.", error); } }2. Эффективность Загрузки Данных в
loadDataОписание Проблема: В текущей реализации функция
loadDataзагружает данные последовательно, что может быть медленно при большом объёме данных.Решение: Используйте транзакции для параллельной загрузки данных. Это может значительно ускорить процесс инициализации базы данных.
// db.js export async function loadData(db) { try { const countLanguages = await getCount(db, "languages"); console.log(`Количество записей в 'languages': ${countLanguages}`); if (countLanguages === 0) { const transaction = db.transaction(Object.keys(dataMapping).map(key => dataMapping[key].storeName), "readwrite"); Object.values(dataMapping).forEach(config => { config.data.forEach(item => transaction.objectStore(config.storeName).put(item)); }); await new Promise((resolve, reject) => { transaction.oncomplete = () => { console.log("Все данные успешно загружены в IndexedDB."); resolve(); }; transaction.onerror = (event) => { console.error("Ошибка при загрузке данных:", event.target.error); reject(event.target.error); }; }); } else { console.log("Данные уже существуют в базе данных. Загрузка не требуется."); } } catch (error) { console.error("Произошла ошибка при загрузке данных. Пожалуйста, попробуйте позже.", error); } }3. Оптимизация Фильтрации в
getFilteredFlagsОписание Проблема: Функция
getFilteredFlagsзагружает все флаги и их имена из базы данных и выполняет фильтрацию на стороне клиента. При большом объёме данных это может привести к низкой производительности и высоким затратам памяти.Решение: Используйте возможности IndexedDB для фильтрации данных непосредственно в базе данных, используя индексы. Например, можно комбинировать несколько запросов по индексам и обрабатывать их на уровне IndexedDB.
Пример:
// main.js export async function getFilteredFlags(db, searchQuery, filters) { const flagsStore = db.transaction("flags").objectStore("flags"); // Создаём диапазон для поиска let range = null; if (searchQuery) { const lowerSearch = searchQuery.toLowerCase(); range = IDBKeyRange.bound(lowerSearch, lowerSearch + '\uffff'); } // Используем индекс для поиска по ID или другим полям const request = flagsStore.index("id").openCursor(range); const filteredFlags = []; const flagNamesMap = {}; return new Promise((resolve, reject) => { request.onsuccess = async function(event) { const cursor = event.target.result; if (cursor) { const flag = cursor.value; // Применяем дополнительные фильтры let include = true; // Фильтрация по цветам if (filters.colors.size > 0) { const flagColors = new Set(flag.colors); include = [...filters.colors].some(color => flagColors.has(color)); } // Фильтрация по типам if (include && filters.types.size > 0) { const flagTypes = new Set(flag.types); include = [...filters.types].some(type => flagTypes.has(type)); } // Фильтрация по языкам if (include && filters.languages.size > 0) { const namesForFlag = flagNamesMap[flag.id] || []; include = namesForFlag.some(nameObj => filters.languages.has(nameObj.language_id)); } if (include) { filteredFlags.push(flag); } cursor.continue(); } else { // Фильтрация завершена resolve({ filteredFlags, flagNamesMap }); } }; request.onerror = function(event) { console.error("Ошибка при фильтрации флагов:", event.target.error); reject(event.target.error); }; }); }Пояснение: Этот подход позволяет использовать индексы для предварительной фильтрации, что значительно снижает нагрузку на клиентскую часть.
4. Удаление Неиспользуемых Функций
Описание Проблема: Функция
displayDataвui.jsне используется в текущей реализации, так как вывод осуществляется в виде карточек.Решение: Если функция действительно не нужна, её можно удалить для улучшения читаемости и поддерживаемости кода.
// ui.js // Удалите или отметьте функцию как неиспользуемую // export function displayData(data, fields) { ... }5. Улучшение Обработки i18n
Описание Проблема: Убедитесь, что все ключи для переводов соответствуют тем, что используются в коде. Например, в
populateTypeFiltersиспользуется шаблонный ключtype.${type.id}. Необходимо убедиться, что файлы перевода содержат такие ключи.Рекомендация: Структурируйте ваши файлы переводов, например:
// locales/en/translations.json { "type": { "type1": "Type 1", "type2": "Type 2" // и т.д. }, "subdivisions": "Subdivisions", "showSubdivisions": "Show Subdivisions", "hideSubdivisions": "Hide Subdivisions", // другие переводы }6. Повышение Удобства Пользователя при Ошибках
Описание Проблема: Хотя ошибки логируются в консоль и отображаются пользователю через
showError, вы можете улучшить UX, предоставляя более информативные и контекстуальные сообщения об ошибках.Решение: Добавьте модальные окна или уведомления для отображения ошибок, чтобы они были более заметными и удобными для взаимодействия.
// utils.js export function showError(messageKey) { const output = document.getElementById("output"); const errorDiv = document.createElement("div"); errorDiv.className = "error-message"; errorDiv.textContent = i18next.t(messageKey); // Добавляем стилизацию для ошибки errorDiv.style.color = "red"; errorDiv.style.backgroundColor = "#ffe6e6"; errorDiv.style.padding = "10px"; errorDiv.style.border = "1px solid red"; errorDiv.style.borderRadius = "5px"; output.innerHTML = ""; // Очищаем предыдущий контент output.appendChild(errorDiv); }7. Проверка Пути к Изображениям
Описание Проблема: В функции
createFlagCardпути к изображениям формируются динамически. Убедитесь, что структура директорий и имена файлов соответствуют этим путям.Рекомендация: Добавьте проверку существования файлов или предусмотреть запасные варианты при ошибке загрузки.
// main.js img.onerror = () => { img.src = 'https://placehold.co/400/ff0000'; img.alt = 'Изображение не найдено'; };8. Улучшение Производительности с Lazy Loading
Описание Проблема: Использование
IntersectionObserverдля ленивой загрузки изображений — отличный подход. Однако, убедитесь, что большие страницы с множеством изображений не приводят к избыточному использованию памяти.Решение: Очистите наблюдателей после загрузки изображений и убедитесь, что элементы удаляются из DOM при необходимости.
9. Управление Версией базы данных
Описание Проблема: Ваша база данных IndexedDB имеет версию
1. В будущем, если потребуется изменение структуры базы данных, необходимо корректно управлять версиями, избегая потери данных.Решение: При изменении структуры базы данных увеличивайте версию и обрабатывайте миграции данных в
onupgradeNeeded.// db.js const request = indexedDB.open("FlagsDatabase", newVersionNumber); request.onupgradeneeded = function(event) { const db = event.target.result; const oldVersion = event.oldVersion; if (oldVersion < 1) { // Создание начальных хранилищ } if (oldVersion < 2) { // Добавление новых хранилищ или индексов } // И т.д. };10. Улучшение Стилизации и Доступности
Описание Проблема: Для улучшения пользовательского опыта и доступности убедитесь, что все интерактивные элементы имеют соответствующие атрибуты и стили.
Рекомендация:
- Используйте семантические HTML-элементы.
- Добавьте
ariaатрибуты для улучшения доступности. - Обеспечьте достаточный контраст для текста и элементов управления.
// Пример добавления ARIA атрибутов checkbox.setAttribute('aria-label', color.en_name);11. Асинхронные Функции и Обработка Ошибок
Описание Проблема: Хотя многие функции правильно используют
try-catchблоки, убедитесь, что все асинхронные функции корректно обрабатывают ошибки, предотвращая возможные утечки или неожиданные состояния приложения.Решение: Используйте
try-catchвнутри всехasyncфункций и обрабатывайте ошибки централизованно, если возможно.// main.js export async function handleViewData(db) { try { // Весь код внутри handleViewData } catch (error) { console.error("Ошибка при обработке данных для отображения:", error); showError("errorLoadingFlags"); } }Заключение
Ваше приложение имеет прочный фундамент и использует современные подходы к разработке. Следуя приведённым рекомендациям, вы можете повысить его эффективность, улучшить пользовательский опыт и обеспечить более надёжную работу. Не забывайте регулярно проводить тестирование и профилирование приложения, чтобы своевременно обнаруживать и устранять возможные узкие места.
Если у вас есть конкретные вопросы или вы столкнулись с определёнными проблемами в вашем коде, пожалуйста, предоставьте дополнительную информацию, и я с радостью помогу вам более детально!