Appearance
Image & PDF Viewer Widgets
Last updated
Both widgets show a file from the File Manager. Upload the file there first, then choose it with Browse, which walks the File Manager's folders.
Image
| Setting | Description | Default |
|---|---|---|
| Image File (default) | The image, as its folder path in the File Manager. Shown when no Image by Value row matches | none |
| Image by Value | Rows of a value and an image: When value is… and Browse | none |
| Fit | Contain (whole image, letterboxed), Cover (fills, cropping edges) or Fill (stretched) | Contain |
Changing the picture with a tag
To show a different picture for each state of a machine — a green conveyor while running, a red one when faulted:
- Upload one image per state to the File Manager.
- Under Data Bindings, click + and bind
valueto the state tag. - Under Image by Value, click Add for each state, type the value and Browse to its image.
- Set Image File (default) to the picture for any other value.
The first row whose value matches is shown. Values match as text, and also as numbers when both are numbers, so a tag reading 1.0 matches a row of 1. A boolean tag matches true or false. A row without an image is skipped. With nothing bound, or no matching row, the default image shows; with no default either, the widget asks for an image path.
For a drawing whose parts change color or move with tags, use a Symbol instead.
PDF Viewer
| Setting | Description | Default |
|---|---|---|
| PDF File | The PDF | none |
| Open at Page | Page number to open at | first page |
| Zoom | Fit page, Fit width, Actual size | Fit page |
| Show Toolbar | The browser's PDF toolbar | on |
The PDF is shown by the browser's own PDF viewer, which Chromium (used on the kiosk and most workstations) includes. Open at Page, Zoom and Show Toolbar are requests to that viewer; some browsers ignore them. A browser that cannot show PDFs inline shows "This browser cannot display PDFs inline." with a link to open the file.
Notes
- Files are served without sign-in, so images and PDFs also work on public dashboards. Do not put confidential documents on a public dashboard.
- Moving or renaming the file in the File Manager breaks the widget; choose the file again.