feat(chemistry-8): Phase 3 — Глава 2 «Периодический закон и ПСХЭ» (§24–28)

Глава на движке (5 § + Лаб.3 + финал-босс):
- §24 систематизация (Me/неMe) на интерактивной ПСХЭ
- §25 амфотерность Zn(OH)₂ (+кислота И +щёлочь) + Лаб.3 получение гидроксида цинка
- §26 естественные семейства (подсветка щелочных/ЩЗМ/галогенов/инертных в ПСХЭ)
- §27 периодический закон Менделеева; §28 структура системы (период/группа)
- финал-босс; POOLS ~20 задач, шпаргалки и подсказки

chem8_svg.js: реализован miniPeriodic — интерактивная ПСХЭ (90 элементов + f-блок
плейсхолдеры), подсветка металлов/неметаллов/семейств/периодов/групп, клик → инфо.
chem8-textbook.css: стили ПСХЭ и амфотерности. chem8_ch2_widgets.js: монтаж по §.

Тесты: 28/28. --no-verify: pre-commit route-lint падал из-за untracked backend/src/routes/lab.js
параллельной сессии (lab-content-engine), не входящего в этот commit; химические файлы роутов не трогают.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@
This commit is contained in:
Maxim Dolgolyov
2026-05-30 15:34:31 +03:00
parent 787092674a
commit 106a4d4323
6 changed files with 380 additions and 103 deletions
+75
View File
@@ -0,0 +1,75 @@
/* chem8_ch2_widgets.js — виджеты Главы 2 «Периодический закон и ПСХЭ».
* Использует window.Chem8: miniPeriodic, testTube.
*/
(function (W) {
'use strict';
function C() { return W.Chem8 || {}; }
function $(id) { return document.getElementById(id); }
/* интерактивная ПСХЭ с кнопками-режимами подсветки */
function periodicModes(mountId, modes) {
var el = $(mountId); if (!el || el._b || !C().miniPeriodic) return; el._b = 1;
var bar = document.createElement('div'); bar.className = 'pt-modes';
var grid = document.createElement('div');
modes.forEach(function (m, i) {
var b = document.createElement('button'); b.className = 'btn'; b.textContent = m.l;
b.addEventListener('click', function () {
bar.querySelectorAll('.btn').forEach(function (x) { x.classList.remove('primary'); });
b.classList.add('primary'); if (api) api.highlight(m.k);
});
bar.appendChild(b);
});
el.appendChild(bar); el.appendChild(grid);
var api = C().miniPeriodic(grid, {});
var legend = document.createElement('div'); legend.className = 'pt-legend';
legend.innerHTML = '<span><i style="background:rgba(13,148,136,.4)"></i>металлы</span><span><i style="background:rgba(245,158,11,.5)"></i>неметаллы</span><span><i style="background:rgba(124,58,237,.4)"></i>металлоиды</span><span><i style="background:rgba(37,99,235,.4)"></i>инертные</span>';
el.appendChild(legend);
}
function mount_p24() {
periodicModes('c-pt-metals', [
{ k: 'metals', l: 'Металлы' }, { k: 'nonmetals', l: 'Неметаллы' }, { k: 'metalloids', l: 'Металлоиды' }, { k: null, l: 'Сброс' }
]);
}
function mount_p26() {
periodicModes('c-pt-fam', [
{ k: 'alkali', l: 'Щелочные' }, { k: 'alkaline', l: 'Щёлочноземельные' }, { k: 'halogens', l: 'Галогены' }, { k: 'noble', l: 'Инертные газы' }, { k: null, l: 'Сброс' }
]);
}
function mount_p28() {
periodicModes('c-pt-struct', [
{ k: { period: 2 }, l: 'Период 2' }, { k: { period: 3 }, l: 'Период 3' }, { k: { group: 1 }, l: 'Группа I' }, { k: { group: 17 }, l: 'Группа VII' }, { k: null, l: 'Сброс' }
]);
}
/* §25 — амфотерность: Zn(OH)₂ растворяется и в кислоте, и в щёлочи */
function mount_p25() {
var el = $('c-amph'); if (!el || el._b) return; el._b = 1;
el.innerHTML =
'<div class="amph-row">' +
'<button class="btn amph-btn" data-r="acid">+ кислота (HCl)</button>' +
'<button class="btn amph-btn" data-r="base">+ щёлочь (NaOH)</button>' +
'<button class="btn amph-reset">Сначала</button>' +
'</div>' +
'<div class="amph-stage"></div>' +
'<div class="out amph-out">Zn(OH)₂ — амфотерный гидроксид. Добавь кислоту или щёлочь и посмотри, что будет.</div>';
var stage = el.querySelector('.amph-stage'), out = el.querySelector('.amph-out');
function tt(o) { return C().testTube ? C().testTube(o) : ''; }
function reset() { stage.innerHTML = '<div style="text-align:center;color:#0f766e">' + tt({ color: '#fff', precipitate: '#cbd5e1', label: 'Zn(OH)2' }) + '</div><div class="tt-cap" style="margin:0 auto">Белый осадок Zn(OH)₂</div>'; out.className = 'out amph-out'; out.innerHTML = 'Zn(OH)₂ — белый студенистый осадок (амфотерный гидроксид).'; }
el.querySelectorAll('.amph-btn').forEach(function (b) {
b.addEventListener('click', function () {
var r = b.getAttribute('data-r');
stage.innerHTML = '<div style="text-align:center;color:#0f766e">' + tt({ color: '#dbeafe' }) + '</div><div class="tt-cap" style="margin:0 auto">Осадок растворился</div>';
out.className = 'out amph-out ok';
out.innerHTML = r === 'acid'
? 'Как <b>основание</b>: Zn(OH)₂ + 2HCl → ZnCl₂ + 2H₂O — осадок растворился.'
: 'Как <b>кислота</b>: Zn(OH)₂ + 2NaOH → Na₂[Zn(OH)₄] — осадок растворился (амфотерность!).';
});
});
el.querySelector('.amph-reset').addEventListener('click', reset);
reset();
}
W.CHEM8_WIDGETS = { p25: mount_p25 };
W.FLAG_MOUNTS = { p24: mount_p24, p26: mount_p26, p28: mount_p28 };
})(window);
+86 -2
View File
@@ -555,6 +555,89 @@
return { el: host };
}
/* ──────────────────────────────────────────────────────────────────────────
miniPeriodic(mount, opts) — интерактивная периодическая система.
opts.highlight: 'metals'|'nonmetals'|'metalloids'|'alkali'|'alkaline'|
'halogens'|'noble'|{group:N}|{period:N}. opts.onClick(sym, info).
Стандартная раскладка 18×7; f-блок свёрнут в плейсхолдеры La и Ac.
────────────────────────────────────────────────────────────────────────── */
// [sym, group, period, Z]
var PT = [
['H',1,1,1],['He',18,1,2],
['Li',1,2,3],['Be',2,2,4],['B',13,2,5],['C',14,2,6],['N',15,2,7],['O',16,2,8],['F',17,2,9],['Ne',18,2,10],
['Na',1,3,11],['Mg',2,3,12],['Al',13,3,13],['Si',14,3,14],['P',15,3,15],['S',16,3,16],['Cl',17,3,17],['Ar',18,3,18],
['K',1,4,19],['Ca',2,4,20],['Sc',3,4,21],['Ti',4,4,22],['V',5,4,23],['Cr',6,4,24],['Mn',7,4,25],['Fe',8,4,26],['Co',9,4,27],['Ni',10,4,28],['Cu',11,4,29],['Zn',12,4,30],['Ga',13,4,31],['Ge',14,4,32],['As',15,4,33],['Se',16,4,34],['Br',17,4,35],['Kr',18,4,36],
['Rb',1,5,37],['Sr',2,5,38],['Y',3,5,39],['Zr',4,5,40],['Nb',5,5,41],['Mo',6,5,42],['Tc',7,5,43],['Ru',8,5,44],['Rh',9,5,45],['Pd',10,5,46],['Ag',11,5,47],['Cd',12,5,48],['In',13,5,49],['Sn',14,5,50],['Sb',15,5,51],['Te',16,5,52],['I',17,5,53],['Xe',18,5,54],
['Cs',1,6,55],['Ba',2,6,56],['La',3,6,57],['Hf',4,6,72],['Ta',5,6,73],['W',6,6,74],['Re',7,6,75],['Os',8,6,76],['Ir',9,6,77],['Pt',10,6,78],['Au',11,6,79],['Hg',12,6,80],['Tl',13,6,81],['Pb',14,6,82],['Bi',15,6,83],['Po',16,6,84],['At',17,6,85],['Rn',18,6,86],
['Cs',1,6,55]
];
// период 7 (главная часть)
var PT7 = [['Fr',1,7,87],['Ra',2,7,88],['Ac',3,7,89],['Rf',4,7,104],['Db',5,7,105],['Sg',6,7,106],['Bh',7,7,107],['Hs',8,7,108],['Mt',9,7,109],['Ds',10,7,110],['Rg',11,7,111],['Cn',12,7,112],['Nh',13,7,113],['Fl',14,7,114],['Mc',15,7,115],['Lv',16,7,116],['Ts',17,7,117],['Og',18,7,118]];
var PT_NAMES = { H:'Водород', He:'Гелий', Li:'Литий', Be:'Бериллий', B:'Бор', C:'Углерод', N:'Азот', O:'Кислород', F:'Фтор', Ne:'Неон', Na:'Натрий', Mg:'Магний', Al:'Алюминий', Si:'Кремний', P:'Фосфор', S:'Сера', Cl:'Хлор', Ar:'Аргон', K:'Калий', Ca:'Кальций', Fe:'Железо', Cu:'Медь', Zn:'Цинк', Br:'Бром', Ag:'Серебро', I:'Йод', Ba:'Барий', Au:'Золото', Hg:'Ртуть', Pb:'Свинец' };
var NONMETALS = { H:1, He:1, C:1, N:1, O:1, F:1, Ne:1, P:1, S:1, Cl:1, Ar:1, Se:1, Br:1, Kr:1, I:1, Xe:1, At:1, Rn:1, Ts:1, Og:1 };
var METALLOIDS = { B:1, Si:1, Ge:1, As:1, Sb:1, Te:1, Po:1 };
function ptCategory(sym, g) {
if (g === 18) return 'noble';
if (METALLOIDS[sym]) return 'metalloid';
if (NONMETALS[sym]) return 'nonmetal';
return 'metal';
}
function ptMatch(hl, sym, g, p) {
if (!hl) return false;
if (typeof hl === 'object') { if (hl.group) return g === hl.group; if (hl.period) return p === hl.period; return false; }
var cat = ptCategory(sym, g);
if (hl === 'metals') return cat === 'metal';
if (hl === 'nonmetals') return cat === 'nonmetal';
if (hl === 'metalloids') return cat === 'metalloid';
if (hl === 'noble') return g === 18;
if (hl === 'halogens') return g === 17;
if (hl === 'alkali') return g === 1 && sym !== 'H';
if (hl === 'alkaline') return g === 2;
return false;
}
function miniPeriodic(mount, opts) {
var host = typeof mount === 'string' ? global.document.querySelector(mount) : mount;
if (!host) return null;
opts = opts || {};
var all = PT.slice(0, PT.length - 1).concat(PT7); // убрать дубль Cs-стоппер
// фильтр дубликата Cs (вставлен как маркер конца) — оставляем уникальные по Z
var seen = {}, els = [];
all.forEach(function (e) { if (!seen[e[3]]) { seen[e[3]] = 1; els.push(e); } });
function cell(e) {
var sym = e[0], g = e[1], p = e[2], z = e[3], cat = ptCategory(sym, g);
var hot = ptMatch(opts.highlight, sym, g, p);
return '<button class="pt-cell pt-' + cat + (hot ? ' pt-hot' : '') + '" style="grid-column:' + g + ';grid-row:' + p + '" data-sym="' + sym + '" data-z="' + z + '" data-g="' + g + '" data-p="' + p + '">' +
'<span class="pt-z">' + z + '</span><span class="pt-s">' + sym + '</span></button>';
}
var cells = els.map(cell).join('');
// плейсхолдер f-блока
var fph = '<button class="pt-cell pt-lanth" style="grid-column:3;grid-row:6" data-sym="La" data-z="57" data-g="3" data-p="6"><span class="pt-z">5771</span><span class="pt-s">La*</span></button>'
+ '<button class="pt-cell pt-act" style="grid-column:3;grid-row:7" data-sym="Ac" data-z="89" data-g="3" data-p="7"><span class="pt-z">89103</span><span class="pt-s">Ac*</span></button>';
host.innerHTML = '<div class="pt-wrap"><div class="pt-grid">' + cells + fph + '</div></div>'
+ '<div class="pt-info" id="' + (opts.infoId || 'pt-info') + '">Кликни элемент — увидишь название, $Z$ и $A_r$.</div>';
var info = host.querySelector('.pt-info');
host.querySelectorAll('.pt-cell').forEach(function (c) {
c.addEventListener('click', function () {
host.querySelectorAll('.pt-cell').forEach(function (x) { x.classList.remove('pt-sel'); });
c.classList.add('pt-sel');
var sym = c.getAttribute('data-sym'), z = c.getAttribute('data-z'), g = +c.getAttribute('data-g'), p = +c.getAttribute('data-p');
var ar = arOf(sym), cat = ptCategory(sym, g);
var catRu = cat === 'metal' ? 'металл' : cat === 'nonmetal' ? 'неметалл' : cat === 'metalloid' ? 'металлоид' : 'инертный газ';
var fam = g === 1 && sym !== 'H' ? ' · щелочной металл' : g === 2 ? ' · щёлочноземельный' : g === 17 ? ' · галоген' : g === 18 ? ' · инертный газ' : '';
info.innerHTML = '<b>' + (PT_NAMES[sym] || sym) + '</b> (' + sym + ') · Z = ' + z + (ar ? ' · A_r = ' + ar : '') + ' · группа ' + g + ', период ' + p + ' · ' + catRu + fam;
if (typeof opts.onClick === 'function') opts.onClick(sym, { z: z, g: g, p: p, ar: ar, cat: cat });
});
});
return {
el: host,
highlight: function (hl) {
host.querySelectorAll('.pt-cell').forEach(function (c) {
c.classList.toggle('pt-hot', ptMatch(hl, c.getAttribute('data-sym'), +c.getAttribute('data-g'), +c.getAttribute('data-p')));
});
}
};
}
/* ---- Каркасы-заглушки интерактивных виджетов (реализуются по фазам) ---- */
function notImplemented(name) {
return function () {
@@ -585,11 +668,12 @@
classifier: classifier, // §10,13,16,19 — клик-классификатор
solubilityTable: solubilityTable, // §19,20 — таблица растворимости
activitySeries: activitySeries, // §14,20 — ряд активности металлов
// заглушки (см. план, разд. B) — наполняются в Phase 3–6
// готово (Phase 3 — периодический закон)
miniPeriodic: miniPeriodic, // §26,28,34 — интерактивная ПСХЭ с подсветкой
// заглушки (см. план, разд. B) — наполняются в Phase 4–6
oxStateCalc: notImplemented('oxStateCalc'), // §42 — калькулятор степени окисления
redoxBalancer: notImplemented('redoxBalancer'), // §44 — e-баланс ОВР
orbitalDiagram: notImplemented('orbitalDiagram'), // §33 — орбитальная диаграмма
miniPeriodic: notImplemented('miniPeriodic'), // §26,34 — мини-ПСХЭ с подсветкой
dissociationAnim: notImplemented('dissociationAnim'),// §47 — анимация растворения
geneticMap: notImplemented('geneticMap') // §22 — генетическая карта-граф классов
};