Interactive Periodic Table

User Manual & Feature Guide
v3.0 — Graphics · Teaching · Signature Tools
⚛️ Open Periodic Table

Table of Contents

  1. What's New in v3.0
  2. Getting Started & How to Open
  3. The Periodic Table Grid
  4. Element Details Panel (Tabs)
  5. 3D Atom Model: Bohr & Orbital
  6. Electron Config & Aufbau
  7. Isotopes & Radioactive Decay
  8. Atom Builder
  9. Search, Ask & Voice
  10. Guided Lessons
  11. Periodic Trends (Animate & Sound)
  12. Temperature States Explorer
  13. Discovery Timeline
  14. Element Quiz & Review
  15. Compare Elements
  16. What's in This? (Composition)
  17. Bonding Lab
  18. Daily Element & Achievements
  19. Share Links & Save Card
  20. Legend, Dark Mode & Definitions
  21. Keyboard Shortcuts
  22. Categories & Properties Reference
01

What's New in v3.0

This release rebuilds the table from the ground up — accurate data, high‑end graphics, a full teaching engine, and a set of signature interactive tools. If you've used an older version, here's what changed.

🎨 High‑end graphics

A perceptual OKLCH color palette, depth‑lit element tiles, smooth motion, and a real WebGL 3D atom (with an electron‑cloud mode).

🎓 Teaching engine

Guided lessons, animated cause‑and‑effect trends, an Aufbau electron‑filling animation, explanatory quizzes, and more.

🧪 Signature tools

Atom Builder, Bonding Lab, "What's in this?" composition explorer, Isotope & decay explorer, and a discovery timeline.

✅ Corrected data

All 118 elements with fixed names, discoverers, units, and correct electron configurations (including anomalies like Cr and Cu).

🔗 Shareable & saveable

Every view becomes a copy‑pasteable link; download an element as an image card.

♿ Accessible

Keyboard‑operable controls, focus rings, screen‑reader labels, reduced‑motion support, and a responsive layout.

02

Getting Started & How to Open

The whole app is a single file, PT.html. There are two ways to open it, and the only difference is the 3D atom.

Option A — Just double‑click it

Double‑click PT.html and it opens in your browser. Everything works except the fancy WebGL 3D atom, which automatically falls back to a built‑in CSS atom. Great for quick use.

Option B — Run a tiny local server (full experience)

The WebGL atom + orbital‑cloud mode loads a 3D library as a browser module, which browsers block when a page is opened straight from disk. To get it, serve the folder over http://:

  1. Open PowerShell (or Command Prompt) in the Periodic Table folder.
  2. Run: python -m http.server 8765  (or npx http-server -p 8765).
  3. Open http://localhost:8765/PT.html in your browser.
  4. Leave the terminal window open while you use it; press Ctrl+C to stop.
💡
Which should I use? Double‑click for everyday use; run the server when you want the full 3D WebGL atom. All teaching tools, search, quiz, lessons, and sharing work either way.
🔄
If you updated the file and don't see changes, do a hard refresh: Ctrl+Shift+R.
03

The Periodic Table Grid

The main grid shows all 118 elements in their standard positions, with the lanthanides and actinides laid out in two rows beneath. Each tile is colored by category and shows the element's symbol and atomic number.

04

Element Details Panel (Tabs)

The left panel is organized so it never becomes a long scroll. A colored title bar always shows the current element (name, symbol, atomic number), and the content sits in two tabs:

📋 Details tab

The full property table — atomic number, mass, neutrons/protons/electrons, period, group, phase, radioactivity, type, atomic radius, electronegativity, ionization energy, density, melting/boiling points, isotopes, discoverer, year, specific heat, shells, and valence — each with proper units.

🧰 More tab

Everything else: electron configuration, ⚖ Add to Compare, ⚡ Watch it fill (Aufbau), ⚛ Isotopes & decay, 🔧 Atom Builder, the "In the real world" uses card, and the 3D atom visualization.

💡
The 3D atom model is always shown at the bottom of the More tab — just switch to that tab. The ↺ Reset button at the top closes the Definitions and Tools panels (unpressing their buttons) and returns the Tools panel to its just‑opened state.
05

3D Atom Model: Bohr & Orbital

The atom model lives at the bottom of the More tab and is always shown there — just switch to the More tab. It renders the element's exact proton, neutron, and electron counts.

Two views (toggle pill, top‑right of the atom)

Bohr

The classic shell model: a glowing nucleus orbited by electrons on tilted rings. Electrons genuinely pass behind the nucleus (true depth + bloom glow in the WebGL version).

Orbital

The scientifically accurate view: rejection‑sampled probability clouds for each occupied subshell — spherical s, dumbbell p, cloverleaf d, multi‑lobe f — colored by subshell (legend in the top‑left).

🖥️
The full WebGL atom needs the local‑server method (Option B in Getting Started). Opened from disk, you'll see a built‑in CSS atom instead — still showing the correct particle counts.
06

Electron Config & Aufbau Animation

The More tab shows the element's electron configuration (with noble‑gas shorthand, e.g. [Ar] 3d⁵ 4s¹). For the story behind it, press ⚡ Watch it fill (Aufbau).

07

Isotopes & Radioactive Decay

Press ⚛ Isotopes & decay in the More tab. A neutron slider rebuilds the nucleus while the proton count stays fixed — the core lesson that protons define the element, neutrons define the isotope.

08

Atom Builder

Press 🔧 Atom Builder to build any atom from scratch with +/- steppers for protons, neutrons, and electrons.

10

Guided Lessons

Click 📚 Guided Lessons (above the table) for short interactive tours that spotlight parts of the table and explain one idea at a time, each ending with a quick check question.

Use Back / Next to move through steps; exits and clears the highlights.

12

Temperature States Explorer

Open Tools → Temperature States and drag the slider (0–10,000 K) to recolor the table by each element's physical state at that temperature, with crisp outlines so every element stays distinct.

Solid
Liquid
Gas
Unknown (no data)

Live counts update beneath the slider, and preset buttons jump to notable points (Absolute Zero, water's freezing/boiling points, room temperature, the Sun's surface at 5778 K).

13

Discovery Timeline

Open Tools → Discovery Timeline and drag through history. Elements light up in the year they were discovered or synthesized, with a caption naming who found what.

14

Element Quiz & Review

Open Tools → Element Quiz, pick a difficulty, and Start.

15

Compare Elements

On the More tab, press ⚖ Add to Compare to pin the current element (up to 3). A tray appears at the bottom; press View ⚖ for a side‑by‑side table.

16

What's in This? (Composition)

Click 🔬 What's in this? (above the table) and pick an everyday thing. The table lights up the elements it's made of, with percent badges and a sorted breakdown panel.

17

Bonding Lab

Click 🔗 Bonding Lab and choose two elements. It shows how they bond:

18

Daily Element & Achievements

Click 🏆 Daily for the Element of the Day (a new one each day), plus your progress:

Progress is stored in your browser; it stays between visits.

19

Share Links & Save Card

🔗
The link uses the part after # in the address bar, so it works even from a double‑clicked file. (Copy‑to‑clipboard needs the page to be focused; otherwise the link is shown in a prompt to copy manually.)
20

Legend, Dark Mode & Definitions

Category legend (filter)

The legend above the table is laid out in two aligned rows. Click any category to dim everything else and isolate that family; click it again to clear. It's keyboard‑operable and announces what changed.

Dark Mode

The Dark Mode toggle switches themes with a smooth crossfade; your choice (and which panels are open) is remembered between visits. First‑time visitors get the system's light/dark preference.

Definitions

The Definitions toggle opens a carousel of plain‑language explanations for every category and property. Use the arrows or dots to browse. It reopens populated if you refresh with it open.

21

Keyboard Shortcuts

KeyAction
Ctrl+FJump to the search box
Enter (in search)Run a natural‑language question
EscClose any open pop‑up window; otherwise clear the search & category filter
Tab / Shift+TabMove between tiles and controls
Enter / SpaceActivate the focused tile, button, or legend filter
⌨️
Ctrl+F overrides the browser's own Find while the page is focused — click the search box's label if you'd rather use browser Find.
22

Categories & Properties Reference

Element categories

Alkali Metals (Group 1)
Alkaline Earth Metals (Group 2)
Transition Metals
Post‑Transition Metals
Metalloids
Nonmetals
Halogens (Group 17)
Noble Gases (Group 18)
Hydrogen
Lanthanides
Actinides

Properties shown for each element

PropertyUnitMeaning
Atomic NumberNumber of protons; defines the element
Atomic MassuAverage mass of the element's atoms
Neutrons / Protons / ElectronsParticle counts for the neutral atom
Period / GroupRow / column in the table
PhaseState at room temperature
Atomic RadiusÅApproximate size of the atom
ElectronegativityTendency to attract bonding electrons
First IonizationeVEnergy to remove the outermost electron
Densityg/cm³Mass per unit volume
Melting / Boiling PointKSolid→liquid / liquid→gas temperatures
IsotopesNumber of known isotopes
Discoverer / YearWho first identified it, and when
Specific HeatJ/(g·K)Energy to raise 1 g by 1 K
Shells / ValenceElectron shells / outer‑shell electrons
Configurations use the corrected ground states, including anomalies (Cr, Cu, Mo, Pd, Ag, La, Ce, Gd, Pt, Au, and the heavy actinides).