HTMLFileField.php

Go to the documentation of this file.

<?php
 
use MediaWiki\Html\Html;
use OOUI\Widget;
 
class HTMLFileField extends HTMLFormField {
    protected $mPlaceholder = '';
    protected $mAccept = null;
 
    protected $mMultiple;
 
    public function __construct( $params ) {
        if ( isset( $params['autocomplete'] ) && is_bool( $params['autocomplete'] ) ) {
            $params['autocomplete'] = $params['autocomplete'] ? 'on' : 'off';
        }
 
        parent::__construct( $params );
 
        if ( isset( $params['placeholder-message'] ) ) {
            $this->mPlaceholder = $this->getMessage( $params['placeholder-message'] )->text();
        } elseif ( isset( $params['placeholder'] ) ) {
            $this->mPlaceholder = $params['placeholder'];
        }
 
        $this->mAccept = $params['accept'] ?? null;
        $this->mMultiple = !empty( $params['multiple'] );
    }
 
    public function getInputHTML( $value ) {
        $attribs = [
            'id' => $this->mID,
            'name' => $this->mName,
            'dir' => $this->mDir,
        ] + $this->getTooltipAndAccessKey();
 
        if ( $this->mClass !== '' ) {
            $attribs['class'] = $this->mClass;
        }
        if ( $this->mAccept ) {
            $attribs['accept'] = implode( ',', $this->mAccept );
        }
        if ( $this->mMultiple ) {
            $attribs['multiple'] = '';
        }
        // Note: Placeholders are not supported by native file inputs
 
        $allowedParams = [
            'title',
            'tabindex',
            'disabled',
            'required',
            'autofocus',
            'readonly',
        ];
 
        $attribs += $this->getAttributes( $allowedParams );
 
        return Html::input( $this->mName, $value, 'file', $attribs );
    }
 
    public function getInputOOUI( $value ) {
        $attribs = $this->getTooltipAndAccessKeyOOUI();
 
        if ( $this->mClass !== '' ) {
            $attribs['classes'] = [ $this->mClass ];
        }
        if ( $this->mPlaceholder !== '' ) {
            $attribs['placeholder'] = $this->mPlaceholder;
        }
        if ( $this->mAccept ) {
            $attribs['accept'] = $this->mAccept;
        }
        if ( $this->mMultiple ) {
            $attribs['multiple'] = true;
        }
 
        # @todo Enforce pattern, step, required, readonly on the server side as
        # well
        $allowedParams = [
            'title',
            'tabindex',
            'disabled',
            'required',
            'autofocus',
            'readonly',
        ];
 
        $attribs += OOUI\Element::configFromHtmlAttributes(
            $this->getAttributes( $allowedParams )
        );
 
        return $this->getInputWidget( [
            'id' => $this->mID,
            'name' => $this->mName,
            'dir' => $this->mDir,
        ] + $attribs );
    }
 
    protected function getInputWidget( $params ) {
        return new OOUI\SelectFileInputWidget( $params );
    }
 
    protected function shouldInfuseOOUI() {
        return true;
    }
}