content/examples/sdk/powershell/01-hello.ps1
|
# 01-hello.ps1 - the smallest complete NativeHTMLKit app: a greeting form. # # Teaches: the script lifecycle (Start-NativeHTMLKitScript -> window -> document -> # events -> Set-NativeHTMLKitReady -> Wait-NativeHTMLKit -> Close-NativeHTMLKit), reading # an input value and writing untrusted text safely with Set-NativeHTMLKitDocumentText. # # Run: pwsh -File ./01-hello.ps1 # powershell.exe -NoProfile -File .\01-hello.ps1 (Windows PowerShell 5.1) # -SelfTest drives the app through the public API and quits (used by tests/Examples.Tests.ps1). param([switch]$SelfTest) $ErrorActionPreference = 'Stop' Import-Module NativeHTMLKit # Start-NativeHTMLKitScript runs this script a second time as the host's backend. # Everything above this line runs twice; keep side effects below it. $app = Start-NativeHTMLKitScript -Name 'Hello NativeHTMLKit' try { $window = New-NativeHTMLKitWindow -Application $app -Title 'Hello' -Width 520 -Height 300 $doc = Open-NativeHTMLKitHtml -Window $window -Html @' <!doctype html> <html><head><style> body { font-family: system-ui, sans-serif; margin: 32px; } input { padding: 6px 8px; font-size: 15px; } button { padding: 6px 14px; font-size: 15px; } #greeting { margin-top: 18px; font-size: 20px; } </style></head> <body> <label for="name">Your name</label> <input id="name" autofocus> <button id="greet">Greet</button> <p id="greeting">Type a name and press Greet.</p> </body></html> '@ function Update-Greeting { $name = (Get-NativeHTMLKitValue -Document $doc -Element name).Trim() if (-not $name) { $name = 'world' } # Text is never parsed as HTML: '<b>' typed by the user stays visible as '<b>'. Set-NativeHTMLKitDocumentText -Document $doc -Element greeting -Text "Hello, $name!" } $null = Register-NativeHTMLKitDocumentEvent -Document $doc -Type click -Element greet -Callback { Update-Greeting } Set-NativeHTMLKitReady -Application $app if ($SelfTest) { Set-NativeHTMLKitDocumentValue -Document $doc -Element name -Value ' <b>Ada</b> ' Update-Greeting $shown = Get-NativeHTMLKitDocumentText -Document $doc -Element greeting if ($shown -ne 'Hello, <b>Ada</b>!') { throw "unexpected greeting: $shown" } [Console]::Out.WriteLine('SELFTEST PASS 01-hello') $null = Request-NativeHTMLKitQuit -Application $app } # Runs callbacks on this runspace until the user closes the last window. Wait-NativeHTMLKit -Application $app -UntilShutdown } finally { Close-NativeHTMLKit -Application $app } |