Skip to content

String.md

Latest commit

 

History

History
122 lines (88 loc) · 3.53 KB

String.md

File metadata and controls

122 lines (88 loc) · 3.53 KB

FROG logo

Default Realization — String Widgets

Default realization posture for standardized string widgets
FROG — Free Open Graphical Language

Navigation

1. Overview

This document describes the default realization posture for the standardized string widget classes:

  • frog.widgets.string_control
  • frog.widgets.string_indicator

It does not define string widget semantics. The class law belongs to Libraries/Widgets/String.md. This document describes how the default realization family can embody that law through SVG template resources, part bindings, state maps, and realization variants.

2. Label and Caption

The default string realization follows the shared widget convention:

  • label realizes the structural/logical label surface when exposed.
  • caption realizes the front-panel user-facing caption.
  • text_value realizes the current string value.
  • placeholder realizes optional placeholder text when the value is empty.

3. Published Default Variant

The default string realization publishes one initial compatible variant:

  • rectangular

The variant targets both string classes and is not a separate widget class.

4. Machine-Readable Manifest

Libraries/Realizations/Default/string.default.wfrog

That manifest declares target classes, realization records, variants, SVG resources, part bindings, state maps, property bindings, anchors, and host hints.

5. Public Parts Realized

  • root
  • label
  • caption
  • frame
  • text_region
  • text_value
  • placeholder

6. SVG Template Assets

  • assets/string/templates/string_rectangular.svg

7. Property Binding Posture

string public property
    -> realization property binding
        -> SVG template part or host-rendered surface

Representative bindings include caption.text to caption, value to text_value, placeholder.text to placeholder, style.frame.* to frame, style.text_region.* to text_region, and style.text.* to text_value.

The published String default realization keeps hover and text-region appearance on style.text_region.*. It does not publish a focus_ring part, so runtimes must not add a separate hardcoded String focus surface.