Struct FormTree 

pub struct FormTree {
    pub nodes: Vec<FormNode>,
    pub metadata: Vec<FormNodeMeta>,
    pub node_ids: HashMap<String, FormNodeId>,
    pub variables_scripts: Vec<(Option<String>, String, String)>,
    pub any_data_bound: bool,
}

The form tree: a node-based representation of the merged template+data.

Fields

nodes: Vec<FormNode>

Nodes in the form tree.

metadata: Vec<FormNodeMeta>

Per-node metadata (parallel to nodes).

node_ids: HashMap<String, FormNodeId>

Lookup table: XFA id attribute -> FormNodeId.

variables_scripts: Vec<(Option<String>, String, String)>

XFA 3.3 §5.5 <variables> <script name="X">…</script> blocks gathered at merge time. Each entry is (subform_scope, name, body). subform_scope is None for root-level scripts (globally accessible) and Some(subform_name) for scripts scoped to a named subform (accessible as subform.variables.scriptName). Empty in default mode.

any_data_bound: bool

True when the merger bound at least one field value from the DataDom. False for forms whose datasets contain only server-infrastructure metadata with no template-field bindings. Used by the flatten pipeline to gate data-empty page suppression: pages must not be suppressed when no data binding has occurred (all field values come from template defaults).

Implementations

impl FormTree

pub fn new() -> Self

Create a new form tree.

pub fn add_node(&mut self, node: FormNode) -> FormNodeId

Add a node to the form tree.

pub fn add_node_with_meta( &mut self, node: FormNode, meta: FormNodeMeta, ) -> FormNodeId

Add a node together with its metadata. If the meta has an xfa_id, it is registered in the node_ids lookup table.

pub fn get(&self, id: FormNodeId) -> &FormNode

Get a node by ID.

pub fn get_mut(&mut self, id: FormNodeId) -> &mut FormNode

Get a mutable reference to a node by ID.

pub fn meta(&self, id: FormNodeId) -> &FormNodeMeta

Access the metadata for a node.

pub fn meta_mut(&mut self, id: FormNodeId) -> &mut FormNodeMeta

Mutably access the metadata for a node.

pub fn find_by_xfa_id(&self, id: &str) -> Option<FormNodeId>

Look up a node by its XFA id attribute.

Trait Implementations

impl Debug for FormTree

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FormTree

fn default() -> Self

Returns the “default value” for a type.