ElementTest.php

<?php

/**
 * This file is part of PHPWord - A pure PHP library for reading and writing
 * word processing documents.
 *
 * PHPWord is free software distributed under the terms of the GNU Lesser
 * General Public License version 3 as published by the Free Software Foundation.
 *
 * For the full copyright and license information, please read the LICENSE
 * file that was distributed with this source code. For the full list of
 * contributors, visit https://github.com/PHPOffice/PHPWord/contributors.
 *
 * @see         https://github.com/PHPOffice/PHPWord
 *
 * @license     http://www.gnu.org/licenses/lgpl.txt LGPL version 3
 */

namespace PhpOffice\PhpWordTests\Writer\Word2007;

use DateTime;
use PhpOffice\PhpWord\ComplexType\RubyProperties;
use PhpOffice\PhpWord\Element\Comment;
use PhpOffice\PhpWord\Element\Ruby;
use PhpOffice\PhpWord\Element\TextRun;
use PhpOffice\PhpWord\Element\TrackChange;
use PhpOffice\PhpWord\PhpWord;
use PhpOffice\PhpWord\Shared\XMLWriter;
use PhpOffice\PhpWordTests\TestHelperDOCX;

/**
 * Test class for PhpOffice\PhpWord\Writer\Word2007\Element subnamespace.
 */
class ElementTest extends \PHPUnit\Framework\TestCase
{
    /**
     * Executed before each method of the class.
     */
    protected function tearDown(): void
    {
        TestHelperDOCX::clear();
    }

    /**
     * Test unmatched element.
     */
    public function testUnmatchedElements(): void
    {
        $elements = [
            'CheckBox', 'Container', 'Footnote', 'Image', 'Link', 'ListItem', 'ListItemRun',
            'OLEObject', 'PreserveText', 'Table', 'Text', 'TextBox', 'TextBreak', 'Title', 'TOC',
            'Field', 'Line', 'Shape', 'Chart', 'FormField', 'SDT', 'Bookmark',
        ];
        foreach ($elements as $element) {
            $objectClass = 'PhpOffice\\PhpWord\\Writer\\Word2007\\Element\\' . $element;
            $xmlWriter = new XMLWriter();
            $newElement = new \PhpOffice\PhpWord\Element\PageBreak();
            $object = new $objectClass($xmlWriter, $newElement);
            $object->write();

            self::assertEquals('', $xmlWriter->getData());
        }
    }

    /**
     * Test line element.
     */
    public function testLineElement(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $section->addLine(['width' => 1000, 'height' => 1000, 'positioning' => 'absolute', 'flip' => true]);
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p/w:r/w:pict/v:shapetype';
        self::assertTrue($doc->elementExists($element));
    }

    /**
     * Test bookmark element.
     */
    public function testBookmark(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $section->addBookmark('test_bookmark');
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:bookmarkStart';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals('test_bookmark', $doc->getElementAttribute($element, 'w:name'));

        $element = '/w:document/w:body/w:bookmarkEnd';
        self::assertTrue($doc->elementExists($element));
    }

    /**
     * Test link element.
     */
    public function testLinkElement(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $section->addLink('https://github.com/PHPOffice/PHPWord');
        $section->addLink('internal_link', null, null, null, true);
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p[1]/w:hyperlink/w:r/w:t';
        self::assertTrue($doc->elementExists($element));

        $element = '/w:document/w:body/w:p[2]/w:hyperlink/w:r/w:t';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals('internal_link', $doc->getElementAttribute('/w:document/w:body/w:p[2]/w:hyperlink', 'w:anchor'));
    }

    /**
     * Basic test for table element.
     */
    public function testTableElements(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $table = $section->addTable(['alignment' => \PhpOffice\PhpWord\SimpleType\JcTable::CENTER]);
        $table->addRow(900);
        $table->addCell(2000)->addText('Row 1');
        $table->addCell(2000)->addText('Row 2');
        $table->addCell(2000)->addText('Row 3');
        $table->addCell(2000)->addText('Row 4');

        $doc = TestHelperDOCX::getDocument($phpWord);

        $tableRootElement = '/w:document/w:body/w:tbl';
        self::assertTrue($doc->elementExists($tableRootElement . '/w:tblGrid/w:gridCol'));
        self::assertTrue($doc->elementExists($tableRootElement . '/w:tblPr/w:jc'));
        self::assertEquals('center', $doc->getElementAttribute($tableRootElement . '/w:tblPr/w:jc', 'w:val'));
    }

    /**
     * Tests that the style name gets added.
     */
    public function testTableWithStyleName(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $table = $section->addTable('my_predefined_style');
        $table->setWidth(75);
        $table->addRow(900);

        $doc = TestHelperDOCX::getDocument($phpWord);

        $tableRootElement = '/w:document/w:body/w:tbl';
        self::assertTrue($doc->elementExists($tableRootElement . '/w:tblPr/w:tblStyle'));
        self::assertEquals('my_predefined_style', $doc->getElementAttribute($tableRootElement . '/w:tblPr/w:tblStyle', 'w:val'));
    }

    /**
     * Test shape elements.
     */
    public function testShapeElements(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        // Arc
        $section->addShape(
            'arc',
            [
                'points' => '-90 20',
                'frame' => ['width' => 120, 'height' => 120],
                'outline' => ['color' => '#333333', 'weight' => 2, 'startArrow' => 'oval', 'endArrow' => 'open'],
            ]
        );

        // Curve
        $section->addShape(
            'curve',
            [
                'points' => '1,100 200,1 1,50 200,50', 'connector' => 'elbow',
                'outline' => [
                    'color' => '#66cc00',
                    'weight' => 2,
                    'dash' => 'dash',
                    'startArrow' => 'diamond',
                    'endArrow' => 'block',
                ],
            ]
        );

        // Line
        $section->addShape(
            'line',
            [
                'points' => '1,1 150,30',
                'outline' => [
                    'color' => '#cc00ff',
                    'line' => 'thickThin',
                    'weight' => 3,
                    'startArrow' => 'oval',
                    'endArrow' => 'classic',
                    'endCap' => 'round',
                ],
            ]
        );

        // Polyline
        $section->addShape(
            'polyline',
            [
                'points' => '1,30 20,10 55,20 75,10 100,40 115,50, 120,15 200,50',
                'outline' => [
                    'color' => '#cc6666',
                    'weight' => 2,
                    'startArrow' => 'none',
                    'endArrow' => 'classic',
                ],
            ]
        );

        // Rectangle
        $section->addShape(
            'rect',
            [
                'roundness' => 0.2,
                'frame' => ['width' => 100, 'height' => 100, 'left' => 1, 'top' => 1],
                'fill' => ['color' => '#FFCC33'],
                'outline' => ['color' => '#990000', 'weight' => 1],
                'shadow' => ['color' => '#EEEEEE', 'offset' => '3pt,3pt'],
            ]
        );

        // Oval
        $section->addShape(
            'oval',
            [
                'frame' => ['width' => 100, 'height' => 70, 'left' => 1, 'top' => 1],
                'fill' => ['color' => '#33CC99'],
                'outline' => ['color' => '#333333', 'weight' => 2],
                'extrusion' => ['type' => 'perspective', 'color' => '#EEEEEE'],
            ]
        );

        $doc = TestHelperDOCX::getDocument($phpWord);

        $elements = ['arc', 'curve', 'line', 'polyline', 'roundrect', 'oval'];
        foreach ($elements as $element) {
            $path = "/w:document/w:body/w:p/w:r/w:pict/v:{$element}";
            self::assertTrue($doc->elementExists($path));
        }
    }

    // testChartElements moved to Writer/Word2007/Element/ChartTest

    public function testFieldElement(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $section->addField('INDEX', [], ['\\c "3"']);
        $section->addField('XE', [], ['Bold', 'Italic'], 'Index Entry');
        $section->addField('DATE', ['dateformat' => 'd-M-yyyy'], ['PreserveFormat', 'LastUsedFormat']);
        $section->addField('DATE', [], ['LunarCalendar']);
        $section->addField('DATE', [], ['SakaEraCalendar']);
        $section->addField('NUMPAGES', ['format' => 'roman', 'numformat' => '0,00'], ['SakaEraCalendar']);
        $section->addField('STYLEREF', ['StyleIdentifier' => 'Heading 1']);
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p/w:r/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' INDEX \\c "3" ', $doc->getElement($element)->textContent);
    }

    public function testUnstyledFieldElement(): void
    {
        $phpWord = new PhpWord();
        $phpWord->addFontStyle('h1', ['name' => 'Courier New', 'size' => 8]);
        $section = $phpWord->addSection();

        $section->addField('PAGE');
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p/w:r[2]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' PAGE ', $doc->getElement($element)->textContent);
        $sty = '/w:document/w:body/w:p/w:r[2]/w:rPr';
        self::assertFalse($doc->elementExists($sty));
    }

    public function testStyledFieldElement(): void
    {
        $phpWord = new PhpWord();
        $stnam = 'h1';
        $phpWord->addFontStyle($stnam, ['name' => 'Courier New', 'size' => 8]);
        $section = $phpWord->addSection();

        $fld = $section->addField('PAGE');
        $fld->setFontStyle($stnam);
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p/w:r[2]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' PAGE ', $doc->getElement($element)->textContent);
        $sty = '/w:document/w:body/w:p/w:r[2]/w:rPr';
        self::assertTrue($doc->elementExists($sty));
        self::assertEquals($stnam, $doc->getElementAttribute($sty . '/w:rStyle', 'w:val'));
    }

    public function testFieldElementFilename(): void
    {
        $phpWord = new PhpWord();
        $stnam = 'h1';
        $phpWord->addFontStyle($stnam, ['name' => 'Courier New', 'size' => 8]);
        $section = $phpWord->addSection();

        $fld = $section->addField('FILENAME');
        $fld->setFontStyle($stnam);
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p/w:r[2]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' FILENAME ', $doc->getElement($element)->textContent);
        $sty = '/w:document/w:body/w:p/w:r[2]/w:rPr';
        self::assertTrue($doc->elementExists($sty));
        self::assertEquals($stnam, $doc->getElementAttribute($sty . '/w:rStyle', 'w:val'));
    }

    public function testFieldElementFilenameOptionsPath(): void
    {
        $phpWord = new PhpWord();
        $stnam = 'h1';
        $phpWord->addFontStyle($stnam, ['name' => 'Courier New', 'size' => 8]);
        $section = $phpWord->addSection();

        $fld = $section->addField('FILENAME', [], ['Path']);
        $fld->setFontStyle($stnam);
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p/w:r[2]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' FILENAME \p ', $doc->getElement($element)->textContent);
        $sty = '/w:document/w:body/w:p/w:r[2]/w:rPr';
        self::assertTrue($doc->elementExists($sty));
        self::assertEquals($stnam, $doc->getElementAttribute($sty . '/w:rStyle', 'w:val'));
    }

    public function testFieldElementWithComplexText(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $text = new TextRun();
        $text->addText('test string', ['bold' => true]);

        $section->addField('XE', [], ['Bold', 'Italic'], $text);
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p/w:r[2]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' XE "', $doc->getElement($element)->textContent);

        $element = '/w:document/w:body/w:p/w:r[3]/w:rPr/w:b';
        self::assertTrue($doc->elementExists($element));

        $element = '/w:document/w:body/w:p/w:r[3]/w:t';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals('test string', $doc->getElement($element)->textContent);

        $element = '/w:document/w:body/w:p/w:r[4]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals('"\\b \\i ', $doc->getElement($element)->textContent);
    }

    /**
     * Test writing the macrobutton field.
     */
    public function testMacroButtonField(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $macroText = new TextRun();
        $macroText->addText('Double click', ['bold' => true]);
        $macroText->addText(' to ');
        $macroText->addText('zoom to 100%', ['italic' => true]);

        $section->addField('MACROBUTTON', ['macroname' => 'Zoom100'], [], $macroText);
        $section->addField('MACROBUTTON', ['macroname' => 'Zoom100'], [], 'double click to zoom');
        $doc = TestHelperDOCX::getDocument($phpWord);

        $element = '/w:document/w:body/w:p[1]/w:r[2]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' MACROBUTTON Zoom100 ', $doc->getElement($element)->textContent);

        $element = '/w:document/w:body/w:p[1]/w:r[3]/';
        self::assertTrue($doc->elementExists($element . 'w:t'));
        self::assertEquals('Double click', $doc->getElement($element . 'w:t')->textContent);
        self::assertTrue($doc->elementExists($element . 'w:rPr/w:b'));

        $element = '/w:document/w:body/w:p[2]/w:r[2]/w:instrText';
        self::assertTrue($doc->elementExists($element));
        self::assertEquals(' MACROBUTTON Zoom100 double click to zoom ', $doc->getElement($element)->textContent);
    }

    // testFormFieldElements moved to Writer/Word2007/Element/FormFieldTest

    /**
     * Test SDT elements.
     */
    public function testSDTElements(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $section->addSDT('comboBox')->setListItems(['1' => 'Choice 1', '2' => 'Choice 2'])->setValue('select value');
        $section->addSDT('dropDownList');
        $section->addSDT('date')->setAlias('date_alias')->setTag('my_tag');
        $section->addSDT('plainText');

        $doc = TestHelperDOCX::getDocument($phpWord);

        $path = '/w:document/w:body/w:p';

        self::assertTrue($doc->elementExists($path . '[1]/w:sdt/w:sdtContent/w:r/w:t'));
        self::assertEquals('select value', $doc->getElement($path . '[1]/w:sdt/w:sdtContent/w:r/w:t')->nodeValue);
        self::assertTrue($doc->elementExists($path . '[1]/w:sdt/w:sdtPr/w:comboBox'));
        self::assertTrue($doc->elementExists($path . '[1]/w:sdt/w:sdtPr/w:comboBox/w:listItem'));
        self::assertEquals('1', $doc->getElementAttribute($path . '[1]/w:sdt/w:sdtPr/w:comboBox/w:listItem[1]', 'w:value'));
        self::assertEquals('Choice 1', $doc->getElementAttribute($path . '[1]/w:sdt/w:sdtPr/w:comboBox/w:listItem[1]', 'w:displayText'));

        self::assertTrue($doc->elementExists($path . '[2]/w:sdt/w:sdtPr/w:dropDownList'));
        self::assertFalse($doc->elementExists($path . '[2]/w:sdt/w:sdtPr/w:alias'));

        self::assertTrue($doc->elementExists($path . '[3]/w:sdt/w:sdtPr/w:date'));
        self::assertTrue($doc->elementExists($path . '[3]/w:sdt/w:sdtPr/w:alias'));
        self::assertTrue($doc->elementExists($path . '[3]/w:sdt/w:sdtPr/w:tag'));

        self::assertTrue($doc->elementExists($path . '[4]/w:sdt/w:sdtPr/w:text'));
    }

    /**
     * Test Comment element.
     */
    public function testCommentWithoutEndElement(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $comment = new Comment('tester');
        $phpWord->addComment($comment);

        $element = $section->addText('this is a test');
        $element->setCommentRangeStart($comment);

        $doc = TestHelperDOCX::getDocument($phpWord);
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:commentRangeStart'));
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:commentRangeEnd'));
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:commentReference'));
    }

    /**
     * Test Comment element.
     */
    public function testCommentWithEndElement(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();

        $comment = new Comment('tester');
        $phpWord->addComment($comment);

        $element = $section->addText('this is a test');
        $element->setCommentRangeStart($comment);
        $element->setCommentRangeEnd($comment);

        $doc = TestHelperDOCX::getDocument($phpWord);
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:commentRangeStart'));
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:commentRangeEnd'));
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:commentReference'));
    }

    /**
     * Test Track changes.
     */
    public function testTrackChange(): void
    {
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();
        $text = $section->addText('my dummy text');
        $text->setChangeInfo(TrackChange::INSERTED, 'author name');
        $text2 = $section->addText('my other text');
        $text2->setTrackChange(new TrackChange(TrackChange::DELETED, 'another author', new DateTime()));

        $doc = TestHelperDOCX::getDocument($phpWord);

        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:ins/w:r'));
        self::assertEquals('author name', $doc->getElementAttribute('/w:document/w:body/w:p/w:ins', 'w:author'));
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:del/w:r/w:delText'));
    }

    /**
     * Test correct writing of text with ampersant in it.
     */
    public function testTextWithAmpersant(): void
    {
        \PhpOffice\PhpWord\Settings::setOutputEscapingEnabled(true);
        $phpWord = new PhpWord();
        $section = $phpWord->addSection();
        $section->addText('this text contains an & (ampersant)');

        $doc = TestHelperDOCX::getDocument($phpWord);
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:t'));
        self::assertEquals('this text contains an & (ampersant)', $doc->getElement('/w:document/w:body/w:p/w:r/w:t')->nodeValue);
    }

    /**
     * Test ListItemRun paragraph style writing.
     */
    public function testListItemRunStyleWriting(): void
    {
        $phpWord = new PhpWord();
        $phpWord->addParagraphStyle('MyParagraphStyle', ['spaceBefore' => 400]);

        $section = $phpWord->addSection();
        $listItemRun = $section->addListItemRun(0, null, 'MyParagraphStyle');
        $listItemRun->addText('List item');
        $listItemRun->addText(' in bold', ['bold' => true]);

        $doc = TestHelperDOCX::getDocument($phpWord);
        self::assertFalse($doc->elementExists('/w:document/w:body/w:p/w:pPr/w:pPr'));
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:pPr/w:pStyle'));
        self::assertEquals('List item', $doc->getElement('/w:document/w:body/w:p/w:r[1]/w:t')->nodeValue);
        self::assertEquals(' in bold', $doc->getElement('/w:document/w:body/w:p/w:r[2]/w:t')->nodeValue);
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r[2]/w:rPr/w:b'));
    }

    /**
     * Test Ruby writing.
     */
    public function testRubyWriting(): void
    {
        $phpWord = new PhpWord();

        $section = $phpWord->addSection();
        $properties = new RubyProperties();
        $properties->setAlignment(RubyProperties::ALIGNMENT_RIGHT_VERTICAL);
        $properties->setFontFaceSize(10);
        $properties->setFontPointsAboveBaseText(4);
        $properties->setFontSizeForBaseText(18);
        $properties->setLanguageId('ja-JP');

        $baseTextRun = new TextRun(null);
        $baseTextRun->addText('私');
        $rubyTextRun = new TextRun(null);
        $rubyTextRun->addText('わたし');
        $section->addRuby($baseTextRun, $rubyTextRun, $properties);

        $doc = TestHelperDOCX::getDocument($phpWord);
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby'));
        // check props
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr'));
        self::assertEquals(
            RubyProperties::ALIGNMENT_RIGHT_VERTICAL,
            $doc->getElementAttribute('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:rubyAlign', 'w:val')
        );
        self::assertEquals(
            10,
            $doc->getElementAttribute('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:hps', 'w:val')
        );
        self::assertEquals(
            4,
            $doc->getElementAttribute('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:hpsRaise', 'w:val')
        );
        self::assertEquals(
            18,
            $doc->getElementAttribute('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:hpsBaseText', 'w:val')
        );
        self::assertEquals(
            'ja-JP',
            $doc->getElementAttribute('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:lid', 'w:val')
        );
        // check ruby text
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby/w:rt/w:r/w:t'));
        self::assertEquals(
            'わたし',
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rt/w:r/w:t')->nodeValue
        );
        // check base text
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby/w:rubyBase/w:r/w:t'));
        self::assertEquals(
            '私',
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rubyBase/w:r/w:t')->nodeValue
        );
    }

    /**
     * Test Ruby title writing.
     */
    public function testRubyTitleWriting(): void
    {
        $phpWord = new PhpWord();
        $phpWord->addTitleStyle(1, ['name' => 'Arial', 'size' => 24, 'bold' => true, 'color' => '990000']);

        $section = $phpWord->addSection();
        $properties = new RubyProperties();
        $properties->setAlignment(RubyProperties::ALIGNMENT_RIGHT_VERTICAL);
        $properties->setFontFaceSize(10);
        $properties->setFontPointsAboveBaseText(4);
        $properties->setFontSizeForBaseText(18);
        $properties->setLanguageId('ja-JP');

        $baseTextRun = new TextRun(null);
        $baseTextRun->addText('私');
        $rubyTextRun = new TextRun(null);
        $rubyTextRun->addText('わたし');

        $textRun = new TextRun();
        $textRun->addRuby($baseTextRun, $rubyTextRun, $properties);
        $section->addTitle($textRun, 1);

        $doc = TestHelperDOCX::getDocument($phpWord);
        // make sure style made it in
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:pPr/w:pStyle'));
        self::assertEquals(
            'Heading1',
            $doc->getElement('/w:document/w:body/w:p/w:pPr/w:pStyle')->getAttribute('w:val')
        );
        // check ruby props
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby'));
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr'));
        self::assertEquals(
            RubyProperties::ALIGNMENT_RIGHT_VERTICAL,
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:rubyAlign')->getAttribute('w:val')
        );
        self::assertEquals(
            10,
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:hps')->getAttribute('w:val')
        );
        self::assertEquals(
            4,
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:hpsRaise')->getAttribute('w:val')
        );
        self::assertEquals(
            18,
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:hpsBaseText')->getAttribute('w:val')
        );
        self::assertEquals(
            'ja-JP',
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rubyPr/w:lid')->getAttribute('w:val')
        );
        // check ruby text
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby/w:rt/w:r/w:t'));
        self::assertEquals(
            'わたし',
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rt/w:r/w:t')->nodeValue
        );
        // check base text
        self::assertTrue($doc->elementExists('/w:document/w:body/w:p/w:r/w:ruby/w:rubyBase/w:r/w:t'));
        self::assertEquals(
            '私',
            $doc->getElement('/w:document/w:body/w:p/w:r/w:ruby/w:rubyBase/w:r/w:t')->nodeValue
        );
    }
}