Skip to content

Latest commit

 

History

History
150 lines (129 loc) · 5.71 KB

README.md

File metadata and controls

150 lines (129 loc) · 5.71 KB

My image

🔥 Powershell Web Framework

Full documentation online

❗ Compatibility

All web browsers are compatible with

❔ Install

  1. Install module with commands below.
Install-Module -Name POSHTML5

🚀 What to know ?

The framework has been optimized to be easily used. All the functions are commented. All arguments for each of them are explained. The most interesting is that (almost) all functions are concatainable. All functions were having a Content argument can contain some other functions and code.

$MyReport = New-PWFPage -Title "MY FIRST TEST" -Charset UTF8 -Container -DarkTheme -Content {
    New-PWFCardHeader -BackgroundColor "#fff" -Centered -Content {
        New-PWFTitles -TitleText "Hi, I'm generated on a Windows PC with a Powershell script." -Size 1
    }
    New-PWFRow -Content {
        New-PWFColumn -Content {
            New-PWFCard -Content {
                New-PWFTitles -Size 2 -TitleText "This HTML skin is based on $(New-PWFTextFormat -Bold "PicoCSS framework") and $(New-PWFTextFormat -Bold "Charts.JS") for the $(New-PWFTextFormat -ColorHexa "#BF0413" -Highlight "charts")."
            }
        }
        New-PWFColumn -Content {
            New-PWFCard -Content {
                New-PWFTitles -Size 2 -TitleText "Progress bar"
                New-PWFProgressBar -CurrentValue ((((get-volume -DriveLetter C).Size)/1GB)-((get-volume -DriveLetter C).SizeRemaining)/1GB) -MaxValue (((get-volume -DriveLetter C).Size)/1GB)
            }
        }
    }
}

Save your New-PWFPage in a variable, next you just have to export it in an HTML file to save your most beautiful report.

$MyReport | Out-File -Encoding UTF8 -FilePath "C:\Windows\Temp\Test.html"

📃 Create a new HTML Page

That's the base:

New-PWFPage -Title "MY FIRST TEST" -Content {
...some code...
}

A dark theme switch can be used. A container switch can be used to center the content and limit the width size. A charset option can be used to specify your charset. Default: UTF8

📌 Add a Header

New-PWFHeader -BackgroundColor "#fff" -Centered -Content {
    ...some code...
}

#️⃣ Grid system

Like a web page, grid system is used. With the New-PWFRow you create a new row of a grid. With the New-PWFColumn you create a new object, autosized, on the row. More column you have, less larger they are. If you have two, they will do 50/50 of the total width. Like:

New-PWFRow {
  New-PWFColumn {
    ...some code...
  }
  New-PWFColumn {
    ...some code...
  }
}

💎 Card system

Cards can now contains what you want. No limit. A table ? A chart ? No prob.

New-PWFCard -Content {
    ...some code...
}

💎 Title !

To create a title:

New-PWFTitles -TitleText "Hi, I'm generated on a Windows PC with a Powershell script." -Size 1

🔡 Simple text

New-PWFText -YourText "Lorem ipsum dolor sit amet, consectetur adipiscing elit.

🔡 ⭐ Colored and/or specificaly formated text

$(New-PWFTextFormat -ColorHexa "#BF0413" -Highlight "WITH A COLOR")
$(New-PWFTextFormat -Highlight -YourText "You could highlight a text")
$(New-PWFTextFormat -ColorHexa "#BF0413" -Highlight -Bold -YourText "Multiple options")

📷 Add an Image and (optional) define a size

New-PWFImage -ImageURL "https://cdn.britannica.com/71/103171-050-BD1B685A/Bill-Gates-Microsoft-Corporation-operating-system-press-2001.jpg" -WidthInPercent 30

💎 Create a table and (optional) add a search bar to find specific text

New-PWFTable -ToTable (Get-Process | Select-Object Name, Handle -First 10) -SelectProperties @("Name","Handle")
New-PWFTable -ToTable (Get-Process | Select-Object Name, Handle -First 10) -SelectProperties @("Name","Handle") -EnableFilter

Use -EnableFilter to add a search input bar. Use -ExportButtons to add XLSX export button. This will convert your HTML table to XLSX file and download it.

💹 Create a custom chart !

Create a chart automaticaly, function will count each same value of the PropertyFilter property and create a chart with count values.

New-PWFChart -AutomaticObject (Get-Process | Select-Object -first 15) -PropertyFilter Name -ChartType doughnut

Create a custom chart. Define which columns the function will use for Labels and which one for Values.

New-PWFChart -Object (Get-Disk | Select-Object FriendlyName,@{Name='Size in GB'; Expression={[math]::Round(($_.Size/1GB),2)}}) -LabelProperty "FriendlyName" -ValueProperty "Size in GB" -ChartType bar -ChartName "DiskSpaceinGB"

Create a load bar

Create an horizontal loading bar.

New-PWFProgressBar -CurrentValue ((((get-volume -DriveLetter C).Size)/1GB)-((get-volume -DriveLetter C).SizeRemaining)/1GB) -MaxValue (((get-volume -DriveLetter C).Size)/1GB)

EXAMPLE AT THE END OF FILE !

You have the screenshoted example at the end of the script. This will let you starting use and create your own.

My image

LATEST UPDATES

  • New-PWFTitles deprecated, replaced by New-PWFTitle as recommanded by Invoke-ScriptAnalyzer.
  • Project now available on PowershellGallery

POSHTML5.

Like My Work? Buy Me a Coffee!

  • 3DNRNqQk7VS7nFjVxJpXEriZPS8ZeCTEje
  • 0x9e79b5D816d8F0C52FFa1bBD657AdaB86f6F77dd