content/examples/sdk/powershell/02-counter.ps1
|
# 02-counter.ps1 - a counter with a step selector, limits and a change history. # # Teaches: script-scoped state shared by callbacks ($script:), one click handler for # several buttons (event delegation through the event's element id), reading a <select>, # and atomic multi-element updates with Invoke-NativeHTMLKitBatch. # # Run: pwsh -File ./02-counter.ps1 (or powershell.exe -NoProfile -File .\02-counter.ps1) # -SelfTest drives the app through the public API and quits. param([switch]$SelfTest) $ErrorActionPreference = 'Stop' Import-Module NativeHTMLKit $app = Start-NativeHTMLKitScript -Name 'Counter' try { $window = New-NativeHTMLKitWindow -Application $app -Title 'Counter' -Width 460 -Height 420 -MinWidth 360 -MinHeight 320 $doc = Open-NativeHTMLKitHtml -Window $window -Html @' <!doctype html> <html><head><style> body { font-family: system-ui, sans-serif; margin: 28px; } #value { font-size: 56px; font-weight: 600; margin: 8px 0 16px; } #value.negative { color: #b3261e; } #value.at-limit { text-decoration: underline; } .row { display: flex; gap: 8px; align-items: center; } button { min-width: 44px; padding: 6px 12px; font-size: 16px; } #history { color: #555; font-size: 13px; } </style></head> <body> <div id="value" aria-live="polite">0</div> <div class="row" id="buttons"> <button id="dec" aria-label="Decrease">-</button> <button id="inc" aria-label="Increase">+</button> <button id="reset">Reset</button> <label for="step">Step</label> <select id="step"><option>1</option><option>5</option><option>10</option></select> </div> <p id="limits">Range -50 to 50.</p> <ol id="history" reversed></ol> </body></html> '@ $script:count = 0 $script:minimum = -50 $script:maximum = 50 function Set-Count([int]$Value, [string]$Reason) { $Value = [Math]::Max($script:minimum, [Math]::Min($script:maximum, $Value)) $script:count = $Value $negativeOp = 'remove_class' if ($Value -lt 0) { $negativeOp = 'add_class' } $limitOp = 'remove_class' if ($Value -eq $script:minimum -or $Value -eq $script:maximum) { $limitOp = 'add_class' } # One transaction: the value, its classes and the history entry change together. Invoke-NativeHTMLKitBatch -Document $doc -Operations @( @{ op = 'set_text'; element = 'value'; text = [string]$Value } @{ op = $negativeOp; element = 'value'; name = 'negative' } @{ op = $limitOp; element = 'value'; name = 'at-limit' } @{ op = 'insert_html'; element = 'history'; position = 'afterbegin' html = '<li>' + [Net.WebUtility]::HtmlEncode("$Reason -> $Value") + '</li>' } @{ op = 'trim_children'; element = 'history'; keep = 8; from = 'end' } ) } # One handler on the button row: $evt.element is the id of the clicked element. $null = Register-NativeHTMLKitDocumentEvent -Document $doc -Type click -Element buttons -Callback { param($evt) $step = [int](Get-NativeHTMLKitValue -Document $doc -Element step) switch ($evt.element) { 'inc' { Set-Count ($script:count + $step) "+$step" } 'dec' { Set-Count ($script:count - $step) "-$step" } 'reset' { Set-Count 0 'reset' } } } Set-NativeHTMLKitReady -Application $app if ($SelfTest) { Set-NativeHTMLKitSelectedValues -Document $doc -Element step -Values @('10') $step = [int](Get-NativeHTMLKitValue -Document $doc -Element step) for ($i = 0; $i -lt 7; $i++) { Set-Count ($script:count - $step) "-$step" } if ((Get-NativeHTMLKitDocumentText -Document $doc -Element value) -ne '-50') { throw 'value was not clamped to -50' } $classes = (Invoke-NativeHTMLKitDocumentCommand -Document $doc -Operation get_attribute -Parameters @{ element = 'value'; name = 'class' }).value if ($classes -notmatch 'negative' -or $classes -notmatch 'at-limit') { throw "unexpected classes: $classes" } $items = (Find-NativeHTMLKitElement -Document $doc -Selector '#history li').matched_nodes if ($items -ne 7) { throw "expected 7 history entries, found $items" } Set-Count 0 'reset' Set-Count 3 '+3' if ((Find-NativeHTMLKitElement -Document $doc -Selector '#history li').matched_nodes -ne 8) { throw 'history was not trimmed to 8' } $newest = Get-NativeHTMLKitNodes -Document $doc -Selector '#history li' -Limit 1 $first = Invoke-NativeHTMLKitDocumentCommand -Document $doc -Operation get_html -Parameters @{ node = $newest.nodes[0].node } if ($first.html -ne '+3 -> 3') { throw "newest entry should be first: $($first.html)" } [Console]::Out.WriteLine('SELFTEST PASS 02-counter') $null = Request-NativeHTMLKitQuit -Application $app } Wait-NativeHTMLKit -Application $app -UntilShutdown } finally { Close-NativeHTMLKit -Application $app } |