docx
    Preparing search index...

    Class SimpleField

    Represents a simple field in a WordprocessingML document.

    A simple field (fldSimple) contains both the field code and the optional cached value in a single element, unlike complex fields which use separate begin/end markers. Simple fields are typically used for fields that don't require complex nesting.

    Reference: http://www.datypic.com/sc/ooxml/e-w_fldSimple-1.html

    <xsd:complexType name="CT_SimpleField">
    <xsd:sequence>
    <xsd:group ref="EG_PContent" minOccurs="0" maxOccurs="unbounded"/>
    </xsd:sequence>
    <xsd:attribute name="instr" type="s:ST_String" use="required"/>
    <xsd:attribute name="fldLock" type="s:ST_OnOff"/>
    <xsd:attribute name="dirty" type="s:ST_OnOff"/>
    </xsd:complexType>
    // Simple field with instruction
    new SimpleField("DATE");

    // Simple field with cached value
    new SimpleField("DATE", "2024-01-01");

    Hierarchy (View Summary)

    Index

    Constructors

    Methods

    • Prepares this component and its children for XML serialization.

      This method is called by the Formatter to convert the component tree into an object structure compatible with the xml library (https://www.npmjs.com/package/xml). It recursively processes all children and handles special cases like attribute-only elements and empty elements.

      The method can be overridden by subclasses to customize XML representation or execute side effects during serialization (e.g., creating relationships).

      Parameters

      • context: IContext

        The serialization context containing document state

      Returns IXmlableObject | undefined

      The XML-serializable object, or undefined to exclude from output

      // Override to add custom serialization logic
      prepForXml(context: IContext): IXmlableObject | undefined {
      // Custom logic here
      return super.prepForXml(context);
      }