Package com.studentgui.apppages

Class DigitalLiteracy

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

com.studentgui.apppages.DigitalLiteracy

All Implemented Interfaces:

DateChangeListener, StudentChangeListener, ImageObserver, MenuContainer, Serializable, Accessible

public class DigitalLiteracy
extends JPanel
implements DateChangeListener, StudentChangeListener

Digital literacy and computer skills assessment page.

Evaluates foundational technology competencies required for academic and professional success in digital environments. Covers 27 skills organized into 5 progressive competency domains:

• Phase 1 (P1_1–P1_9): Device Basics and Navigation
  • Powering devices on/off, accessibility feature activation (VoiceOver/TalkBack/Narrator)
  • Touch/mouse gestures for app launching and navigation
  • Home screen organization, icon identification, and app launching
  • Document creation, saving, and retrieval workflows
  • Online resource access (web portals, learning management systems)
  • Basic keyboarding (home row, touch typing fundamentals)
  • UI element interaction (buttons, menus, text fields, sliders)
  • System-level navigation (Control Center, App Switcher, Task Manager, Dock)
• Phase 2 (P2_1–P2_6): Word Processing Fundamentals
  • Creating, editing, and saving text documents
  • Reading and navigating documents using assistive technology or visual scanning
  • Menu bar and toolbar interaction for formatting and commands
  • Text selection, highlighting, copy/paste workflows
  • Image insertion and manipulation (copy, paste, resize, position)
  • Proofreading strategies and editing for clarity/correctness
• Phase 3 (P3_1–P3_3): Spreadsheet Fundamentals
  • Describing spreadsheet structure (rows, columns, cells, sheets)
  • Spreadsheet terminology (cell references, formulas, functions, ranges)
  • Data entry and editing (typing, autofill, formula entry)
• Phase 4 (P4_1–P4_5): Presentation Software
  • Presentation tool concepts (slides, layouts, templates)
  • Creating structured presentations (title, content, transitions)
  • Editing slides (text, formatting, reordering)
  • Presenting slides effectively (presenter view, navigation, notes)
  • Sharing presentations (export, cloud upload, email)
• Phase 5 (P5_1–P5_5): Digital Citizenship and Ethics
  • Acceptable Use Policies (school/workplace technology guidelines)
  • Digital citizenship principles (respectful communication, netiquette)
  • Internet safety (phishing, malware, safe browsing)
  • Copyright awareness (fair use, attribution, Creative Commons)
  • Plagiarism recognition and avoidance (paraphrasing, citations, originality)

Data Persistence and Report Generation:

• Scores captured via PhaseScoreField (integer 0–4 typical)
• Persisted to normalized schema via Database.insertAssessmentResults(int, int, java.lang.String[], int[])
• JSON export: StudentDataFiles/<student>/Sessions/DigitalLiteracy/DigitalLiteracy-<sessionId>-<timestamp>.json
• Phase-grouped time-series plots: plots/DigitalLiteracy-<sessionId>-<date>-P<N>.png (5 phase groups)
• Markdown and HTML reports with embedded plots and color-coded legends

The shared JLineGraph visualizes recent session trends grouped by phase prefix. Implements DateChangeListener and StudentChangeListener for dynamic updates when global selections change.

Note: Skill codes and phases intentionally overlap with IOS to allow cross-platform skill mapping. Some assessment items are device-agnostic and track the same underlying competencies across iOS, Windows, macOS, and ChromeOS environments.

See Also:

• Database
• JLineGraph
• PhaseScoreField
• IOS
• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
DigitalLiteracy(String studentName, LocalDate date, JLineGraph lineGraph)	Construct the Digital Literacy page for the given student and date.

Method Summary

Modifier and Type	Method	Description
void	dateChanged(LocalDate newDate)	Called when the application date has been changed by the user.
void	studentChanged(String newStudent)	Called when the application selected student has changed.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

DigitalLiteracy

public DigitalLiteracy(String studentName,
 LocalDate date,
 JLineGraph lineGraph)

Construct the Digital Literacy page for the given student and date.

Parameters:

studentName - display name of the selected student (may be null)

date - session date to associate with persisted progress

lineGraph - shared graph component used to display recent results

Method Details

dateChanged

public void dateChanged(LocalDate newDate)

Description copied from interface: DateChangeListener

Called when the application date has been changed by the user.

Specified by:

dateChanged in interface DateChangeListener

Parameters:

newDate - the newly selected date

studentChanged

public void studentChanged(String newStudent)

Description copied from interface: StudentChangeListener

Called when the application selected student has changed.

Specified by:

studentChanged in interface StudentChangeListener

Parameters:

newStudent - the newly selected student's display name (may be null)