docx
    Preparing search index...

    Class EditableRangeStart

    Represents the start of an editable range: where a part of a protected document that anyone can change begins.

    It must be paired with an EditableRangeEnd with the same id, which can be in the same paragraph or a later one. The id must be different from every other editable range's. The document's protection option protects the rest.

    Reference: ISO/IEC 29500-1 17.13.7.3 (permStart)

    <xsd:complexType name="CT_PermStart">
    <xsd:complexContent>
    <xsd:extension base="CT_Perm">
    <xsd:attribute name="edGrp" type="ST_EdGrp" use="optional"/>
    <xsd:attribute name="ed" type="s:ST_String" use="optional"/>
    <xsd:attribute name="colFirst" type="ST_DecimalNumber" use="optional"/>
    <xsd:attribute name="colLast" type="ST_DecimalNumber" use="optional"/>
    </xsd:extension>
    </xsd:complexContent>
    </xsd:complexType>
    new Paragraph({
    children: [new TextRun("Name: "), new EditableRangeStart(1), new TextRun("type your name"), new EditableRangeEnd(1)],
    });

    Hierarchy (View Summary)

    Index
    • get writtenAs(): readonly BaseXmlComponent[] | undefined
      Internal

      The components written in this one's place, one after another, when it can't be written as a single element, such as a run with another run in its children. Undefined when it is written as itself.

      Returns readonly BaseXmlComponent[] | undefined

    • 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);
      }