` to `

` node, or a `

` node wrapping it. // In the future `

` will be required (T13555). if ( DOMCompat::getClassList( $node )->contains( 'mw-heading' ) ) { $node = DOMCompat::querySelector( $node, implode( ',', $this->topHeadingTags ) ); if ( !( $node instanceof DOMElement ) ) { return false; } } return $node->tagName; } /** * Actually splits splits the body of the document into sections * * @param DOMDocument $doc representing the HTML of the current article. In the HTML the sections * should not be wrapped. * @param DOMElement[] $headingWrappers The headings (or wrappers) returned by getTopHeadings(): * `

` to `

` nodes, or `

` nodes wrapping them. * In the future `

` will be required (T13555). * @return DOMDocument */ private function makeSections( DOMDocument $doc, array $headingWrappers ) { $xpath = new DOMXpath( $doc ); $containers = $xpath->query( 'body/div[@class="mw-parser-output"][1]' ); // Return if no parser output is found if ( !$containers->length || $containers->item( 0 ) === null ) { return $doc; } $container = $containers->item( 0 ); $containerChild = $container->firstChild; $firstHeading = reset( $headingWrappers ); $firstHeadingName = $this->getHeadingName( $firstHeading ); $sectionNumber = 0; $sectionBody = $this->createSectionBodyElement( $doc, $sectionNumber ); while ( $containerChild ) { $node = $containerChild; $containerChild = $containerChild->nextSibling; // If we've found a top level heading, insert the previous section if // necessary and clear the container div. if ( $firstHeadingName && $this->getHeadingName( $node ) === $firstHeadingName ) { // The heading we are transforming is always 1 section ahead of the // section we are currently processing /** @phan-suppress-next-line PhanTypeMismatchArgument DOMNode vs. DOMElement */ $this->prepareHeading( $doc, $node, $sectionNumber + 1 ); // Insert the previous section body and reset it for the new section $container->insertBefore( $sectionBody, $node ); ++$sectionNumber; $sectionBody = $this->createSectionBodyElement( $doc, $sectionNumber ); continue; } // If it is not a top level heading, keep appending the nodes to the // section body container. $sectionBody->appendChild( $node ); } // Append the last section body. $container->appendChild( $sectionBody ); return $doc; } /** * Prepare section headings, add required classes * * @param DOMDocument $doc * @param DOMElement $heading * @param int $sectionNumber */ private function prepareHeading( DOMDocument $doc, DOMElement $heading, $sectionNumber ) { $className = $heading->hasAttribute( 'class' ) ? $heading->getAttribute( 'class' ) . ' ' : ''; $heading->setAttribute( 'class', $className . 'section-heading' ); // prepend indicator - this avoids a reflow by creating a placeholder for a toggling indicator $indicator = $doc->createElement( 'span' ); $indicator->setAttribute( 'class', 'section-indicator citizen-ui-icon mw-ui-icon-wikimedia-collapse' ); $heading->insertBefore( $indicator, $heading->firstChild ); } /** * Creates a Section body element * * @param DOMDocument $doc * @param int $sectionNumber * * @return DOMElement */ private function createSectionBodyElement( DOMDocument $doc, $sectionNumber ) { $sectionBody = $doc->createElement( 'section' ); $sectionBody->setAttribute( 'class', self::STYLE_COLLAPSIBLE_SECTION_CLASS ); $sectionBody->setAttribute( 'id', 'section-collapsible-' . $sectionNumber ); return $sectionBody; } /** * Gets top headings in the document. * * @param DOMDocument $doc * @return array An array first is the highest rank headings */ private function getTopHeadings( DOMDocument $doc ): array { $headings = []; foreach ( $this->topHeadingTags as $tagName ) { $allTags = DOMCompat::querySelectorAll( $doc, $tagName ); foreach ( $allTags as $el ) { $parent = $el->parentNode; if ( !( $parent instanceof DOMElement ) ) { continue; } // Use the `

` wrapper if it is present. When they are required // (T13555), the querySelectorAll() above can use the class and this can be removed. if ( DOMCompat::getClassList( $parent )->contains( 'mw-heading' ) ) { $el = $parent; } // This check can be removed too when we require the wrappers. if ( $parent->getAttribute( 'class' ) !== 'toctitle' ) { $headings[] = $el; } } if ( $headings ) { return $headings; } } return $headings; } /** * Marks the subheadings for the approiate styles by adding * the section-subheading class to each of them, if it * hasn't already been added. * * @param DOMElement[] $headings Heading elements */ protected function markSubHeadings( array $headings ) { foreach ( $headings as $heading ) { $class = $heading->getAttribute( 'class' ); if ( strpos( $class, 'section-subheading' ) === false ) { $heading->setAttribute( 'class', ltrim( $class . ' section-subheading' ) ); } } } /** * Gets all subheadings in the document in rank order. * * @param DOMDocument $doc * @return DOMElement[] */ private function getSubHeadings( DOMDocument $doc ): array { $found = false; $subheadings = []; foreach ( $this->topHeadingTags as $tagName ) { $allTags = DOMCompat::querySelectorAll( $doc, $tagName ); $elements = []; foreach ( $allTags as $el ) { if ( $el->parentNode->getAttribute( 'class' ) !== 'toctitle' ) { $elements[] = $el; } } if ( $elements ) { if ( !$found ) { $found = true; } else { $subheadings = array_merge( $subheadings, $elements ); } } } return $subheadings; } }