60 if ( is_array( $parameters ) ) {
61 $actualParams = $parameters + $defaults;
64 $numArgs = func_num_args();
67 'height' => $parameters,
68 'page' => ( $numArgs > 5 ) ? func_get_arg( 5 ) : false
70 $path = ( $numArgs > 4 ) ? func_get_arg( 4 ) :
false;
81 $this->width = (int)round( $actualParams[
'width'] );
82 $this->height = (int)round( $actualParams[
'height'] );
84 $this->page = $actualParams[
'page'];
85 $this->lang = $actualParams[
'lang'];
122 public function toHtml( $options = [] ) {
123 $services = MediaWikiServices::getInstance();
124 $mainConfig = $services->getMainConfig();
125 $nativeImageLazyLoading = $mainConfig->get( MainConfigNames::NativeImageLazyLoading );
126 $enableLegacyMediaDOM = $mainConfig->get( MainConfigNames::ParserEnableLegacyMediaDOM );
128 if ( func_num_args() === 2 ) {
129 throw new InvalidArgumentException( __METHOD__ .
' called in the old style' );
132 $query = $options[
'desc-query'] ??
'';
139 if ( isset( $options[
'alt'] ) ) {
140 $attribs[
'alt'] = $options[
'alt'];
146 !$enableLegacyMediaDOM &&
147 isset( $options[
'magnify-resource'] ) &&
148 !( $options[
'desc-link'] ??
false )
150 $attribs[
'resource'] = $options[
'magnify-resource'];
155 'decoding' =>
'async',
158 if ( $options[
'loading'] ?? $nativeImageLazyLoading ) {
159 $attribs[
'loading'] = $options[
'loading'] ??
'lazy';
162 if ( !empty( $options[
'custom-url-link'] ) ) {
163 $linkAttribs = [
'href' => $options[
'custom-url-link'] ];
164 if ( !empty( $options[
'title'] ) ) {
165 $linkAttribs[
'title'] = $options[
'title'];
167 if ( !empty( $options[
'custom-target-link'] ) ) {
168 $linkAttribs[
'target'] = $options[
'custom-target-link'];
169 } elseif ( !empty( $options[
'parser-extlink-target'] ) ) {
170 $linkAttribs[
'target'] = $options[
'parser-extlink-target'];
172 if ( !empty( $options[
'parser-extlink-rel'] ) ) {
173 $linkAttribs[
'rel'] = $options[
'parser-extlink-rel'];
175 } elseif ( !empty( $options[
'custom-title-link'] ) ) {
177 $title = $options[
'custom-title-link'];
179 'href' => $title->getLinkURL( $options[
'custom-title-link-query'] ??
null ),
180 'title' => empty( $options[
'title'] ) ? $title->getPrefixedText() : $options[
'title']
182 } elseif ( !empty( $options[
'desc-link'] ) ) {
184 empty( $options[
'title'] ) ?
null : $options[
'title'],
187 } elseif ( !empty( $options[
'file-link'] ) ) {
188 $linkAttribs = [
'href' => $this->file->getUrl() ];
190 $linkAttribs =
false;
191 if ( !empty( $options[
'title'] ) ) {
192 if ( $enableLegacyMediaDOM ) {
193 $attribs[
'title'] = $options[
'title'];
195 $linkAttribs = [
'title' => $options[
'title'] ];
200 if ( empty( $options[
'no-dimensions'] ) ) {
201 $attribs[
'width'] = $this->width;
202 $attribs[
'height'] = $this->height;
204 if ( !empty( $options[
'valign'] ) ) {
205 $attribs[
'style'] =
"vertical-align: {$options['valign']}";
207 if ( !empty( $options[
'img-class'] ) ) {
208 $attribs[
'class'] = $options[
'img-class'];
210 if ( isset( $options[
'override-height'] ) ) {
211 $attribs[
'height'] = $options[
'override-height'];
213 if ( isset( $options[
'override-width'] ) ) {
214 $attribs[
'width'] = $options[
'override-width'];
224 (
new HookRunner( $services->getHookContainer() ) )
225 ->onThumbnailBeforeProduceHTML( $this, $attribs, $linkAttribs );
227 return $this->
linkWrap( $linkAttribs, Xml::element(
'img', $attribs ) );