TextboxBuilder.php

Go to the documentation of this file.

<?php
namespace MediaWiki\EditPage;

use MediaWiki\MediaWikiServices;
use Sanitizer;
use Title;
use User;

class TextboxBuilder {

    public function addNewLineAtEnd( $wikitext ) {
        if ( strval( $wikitext ) !== '' ) {
            // Ensure there's a newline at the end, otherwise adding lines
            // is awkward.
            // But don't add a newline if the text is empty, or Firefox in XHTML
            // mode will show an extra newline. A bit annoying.
            $wikitext .= "\n";
            return $wikitext;
        }
        return $wikitext;
    }

    public function mergeClassesIntoAttributes( array $classes, array $attribs ) {
        if ( $classes === [] ) {
            return $attribs;
        }

        return Sanitizer::mergeAttributes(
            $attribs,
            [ 'class' => implode( ' ', $classes ) ]
        );
    }

    public function getTextboxProtectionCSSClasses( Title $title ) {
        $classes = []; // Textarea CSS
        if ( $title->isProtected( 'edit' ) &&
            MediaWikiServices::getInstance()->getPermissionManager()
                ->getNamespaceRestrictionLevels( $title->getNamespace() ) !== [ '' ]
        ) {
            # Is the title semi-protected?
            if ( $title->isSemiProtected() ) {
                $classes[] = 'mw-textarea-sprotected';
            } else {
                # Then it must be protected based on static groups (regular)
                $classes[] = 'mw-textarea-protected';
            }
            # Is the title cascade-protected?
            if ( $title->isCascadeProtected() ) {
                $classes[] = 'mw-textarea-cprotected';
            }
        }

        return $classes;
    }

    public function buildTextboxAttribs( $name, array $customAttribs, User $user, Title $title ) {
        $attribs = $customAttribs + [
                'accesskey' => ',',
                'id' => $name,
                'cols' => 80,
                'rows' => 25,
                // Avoid PHP notices when appending preferences
                // (appending allows customAttribs['style'] to still work).
                'style' => ''
            ];

        // The following classes can be used here:
        // * mw-editfont-monospace
        // * mw-editfont-sans-serif
        // * mw-editfont-serif
        $class = 'mw-editfont-' . $user->getOption( 'editfont' );

        if ( isset( $attribs['class'] ) ) {
            if ( is_string( $attribs['class'] ) ) {
                $attribs['class'] .= ' ' . $class;
            } elseif ( is_array( $attribs['class'] ) ) {
                $attribs['class'][] = $class;
            }
        } else {
            $attribs['class'] = $class;
        }

        $pageLang = $title->getPageLanguage();
        $attribs['lang'] = $pageLang->getHtmlCode();
        $attribs['dir'] = $pageLang->getDir();

        return $attribs;
    }

}