Extension:TemplateStylesExtender/ru

Category:GPL licensed extensions/ru
Справка по расширениям MediaWiki
TemplateStylesExtender
Статус релиза: стабильноCategory:Stable extensions/ru
Реализация Расширение парсера Category:Parser extensions/ru
Описание Extends Extension:TemplateStyles with new selectors
Автор(ы) Octfxобсуждение
Последняя версия 2.0.0 (2025-06-02)
MediaWiki 1.43+Category:Extensions with manual MediaWiki version/ru
PHP >=8.0
Composer octfx/template-styles-extenderCategory:Extensions supporting Composer/ru
Лицензия GNU General Public License 2.0 или позднее
Скачать

GitHub:

Note:
No localisation updates are
provided by translatewiki.net .

Category:Extensions in GitHub version control/ru
Параметры
  • $wgTemplateStylesExtenderCustomPropertiesDeclaration
  • $wgTemplateStylesExtenderExtendCustomPropertiesValues
  • $wgTemplateStylesExtenderEnableUnscopingSupport
  • $wgTemplateStylesExtenderUnscopingPermission
Используемые хуки
Category:All extensions/ru

The TemplateStylesExtender extension extends Расширение:TemplateStyles with new selectors and matchers. TemplateStylesExtender is developed based on css-sanitizer 5.5.0, which is being used by MediaWiki 1.43.

Features

  • Declare CSS custom properties/variables
  • Use CSS custom properties/variables in most properties
  • Implement additional properties and values as listed below
Module Changes Upstream task
Basic User Interface Module Level 4 Added property: pointer-events T342271
Box Sizing Module Level 4 Backported for css-sanitizer 5.5.0 T375344
Cascading and Inheritance Level 5 Added value: revert-layer -
Color Module Level 4 Added: Alpha HEX notation T265675
Color Module Level 5 Added: Relative color, color() -
Containment Module Level 3 Added properties: contain, content-visibility -
Filter Effects Module Level 2 Added property: backdrop-filter -
Fonts Module Level 4 Added properties: font-optical-sizing, font-variation-settings, ascent-override, descent-override, font-display, line-gap-override -
Fonts Module Level 5 Added property: size-adjust -
Masking Module Level 1 Added property: -webkit-mask-image -
Ruby Annotation Layout Module Level 1 Added properties: ruby-align, ruby-position T277755
Scroll Snap Module Level 1 Added properties: scroll-margin, scroll-padding, scroll-snap-align, scroll-snap-stop, scroll-snap-type T271598
Values and Units Module Level 4 Added function: clamp() T394619

Установка

  • Download и распакуйте файл(ы) в папку с названием TemplateStylesExtender в вашей папке extensions/.
  • Добавьте следующий код в конце вашего файла LocalSettings.php : 
    wfLoadExtension( 'TemplateStyles' );
wfLoadExtension( 'TemplateStylesExtender' );
  • Configure as required.
  • Yes Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Настройка

Configuration Описание По умолчанию
$wgTemplateStylesExtenderCustomPropertiesDeclaration Allow CSS custom properties (CSS variables) to be declared as properties true
$wgTemplateStylesExtenderExtendCustomPropertiesValues Allow the CSS custom properties (CSS variables) to be used as values in all properties true
$wgTemplateStylesExtenderEnableUnscopingSupport Allows users with unscope permissions to unscope CSS by setting a wrapclass attribute. false
$wgTemplateStylesExtenderUnscopingPermission Specify a permission group that is allowed to unscope CSS. editinterface

Note CSS Vars

Currently using :root selectors won't work due to template styles prepending .mw-parser-output.

One possible fix is to wrap the entire content into a 'div' element and adding the declarations to this, e.g.

div#content-wrap {
   --padding: 10px
}

.content {
   padding: var( --padding )
}

Викитекст

<div id="content-wrap">
   <div class="content">
      The WikiText...
   </div>
</div>

Unscoping of CSS

Example: <templatestyles src="Foo/style.css" wrapclass="mediawiki" /> results in the CSS being scoped to .mediawiki instead of .mw-parser-output.

Including such a call in a page essentially limits editing to users with the editinterface right. You can alternatively include a call to a template that includes the styles.

См. также

Category:All extensions/ru Category:Extensions in GitHub version control/ru Category:Extensions included in Canasta/ru Category:Extensions included in Miraheze/ru Category:Extensions included in MyWikis/ru Category:Extensions included in WikiForge/ru Category:Extensions included in wiki.gg/ru Category:Extensions supporting Composer/ru Category:Extensions with manual MediaWiki version/ru Category:GPL licensed extensions/ru Category:ParserFirstCallInit extensions/ru Category:Parser extensions/ru Category:Stable extensions/ru Category:TemplateStylesPropertySanitizer extensions/ru Category:TemplateStylesStylesheetSanitizer extensions/ru