Web Frame

Functional reference for WebFrameObject, including its runtime role and the supported settings available in the design environment.

Updated 2 min read
On this page (6 sections)
  1. Functional explanation
  2. Object name
  3. Settings
  4. Position / Size
  5. Border
  6. Visibility

Functional explanation

WebFrameObject embeds a page in an iframe. It is used to show external or internal web content inside the runtime page.

The object is useful when the operator needs to view a secondary web page without leaving the main process page. It is commonly used for dashboards, embedded portals, and browser-based tools.

Use it only when embedded web content is necessary. Verify that the source page is reachable in the production environment and behaves correctly inside an iframe.

Object name

Set the object name shown in the web frame decorator context.

SettingDescriptionExampleUnits
Object NameName used to identify the Web Frame object.OperatorPortalFrameText

Settings

Configure the source URL and iframe behavior for the web frame.

SettingDescriptionExampleUnits
URL (HTTPS)Target URL shown in the iframe, or the name of a variable holding it. URL (HTTPS) opens a text editor for long addresses; the variable button next to the field opens the variable list.https://intranet/portalURL or variable
Static PageEnables static page mode with a refresh interval.trueBoolean
RefreshRefresh interval used when static page mode is enabled.10Seconds
Post Message EnabledEnables postMessage integration with the embedded page.trueBoolean
Post MessageMessage payload sent to the embedded page.{"event":"refresh"}JSON

Position / Size

Configure the position and size of the Web Frame object.

SettingDescriptionExampleUnits
TopTop position of the object.100px
LeftLeft position of the object.220px
WidthWidth of the object.600px
HeightHeight of the object.400px
Z-indexLayer order of the object. Higher values appear in front of lower values.10Number

Border

Configure the border styling for the Web Frame object.

SettingDescriptionExampleUnits
Border ColorBorder color used for the frame.#CED4DAColor
Border Color StatesDynamic border color state rules JSON array.[{"state":"alarm","color":"#dc3545"}]JSON array
Border WidthBorder width used for the frame.1px
Border RadiusCorner radius of the frame border.4px
Border VisibilityExpression controlling whether the border is visible.SYSTEM.UserGroups == "Operators"Expression
Border BlinkExpression or boolean controlling border blinking.PLC1.AlarmActiveBoolean or expression
Border Blink SpeedBlink speed used for the border.500ms
Border Blink OffsetBlink offset used to stagger border blinking between objects.falseBoolean

Visibility

Configure the runtime visibility and blinking behavior for the Web Frame object.

SettingDescriptionExampleUnits
VisibilityExpression controlling whether the object is visible.PLC1.WebFrameVisibleExpression
BlinkExpression or boolean controlling frame blinking.PLC1.AlarmActiveBoolean or expression
Blink SpeedBlink speed used during runtime.500ms
Blink OffsetBlink offset used to stagger blinking between objects.falseBoolean
Something missing or wrong in this article? Contact us