StringTune-3D/Docs

Concepts

DOM To Scene Mapping

How string-id, nesting, and string-3d type selection become a live 3D scene graph.

DOM To Scene Mapping

The DOM remains the authoring surface. StringTune-3D maps elements to scene nodes based on string-3d.

Type selection

The runtime reads the mapped 3d property from string-3d and dispatches to a scene factory:

  • group
  • box
  • sphere
  • plane
  • cylinder
  • model
  • particles
  • text
  • svg
  • light types

Identity

Each object still belongs to the StringTune object model, so string-id remains the stable identity anchor.

Parent-child nesting

Nested groups are discovered through the nearest parent matching:

HTML
<div string="3d" string-id="root" string-3d="group">
  <div string="3d" string-id="child" string-3d="box"></div>
</div>

When the parent is a group and has string-id, the child object stores that parent id and is attached below it in the scene graph.

Practical rule

  • use group when you need hierarchical transforms
  • use regular object types when you need visible geometry or light sources
  • keep string-id stable if outside code references the object