Шаблон:Установить пользовательский скрипт

importScript ( '{{{1}}}' ); // Обратная ссылка: [[{{{1}}}]]

Документация по шаблону [ просмотр ] [ правка ] [ история ] [ очистка ]

Ярлык

{{ iusc }}

Этот шаблон используется для установки пользовательских скриптов , которые находятся в английской Википедии. Он должен использоваться в первую очередь на Special:MyPage/common.js или Special:MyPage/skin.js . Он добавляет необходимую importScriptстроку вместе с обратной ссылкой .

Использование

Чтобы установить пользовательский скрипт для вашей учетной записи Википедии, добавьте следующую строку в Special:MyPage/common.js или Special:MyPage/skin.js :

{{subst:iusc|script_path}}

Замените script_pathна полное имя страницы .js пользовательского скрипта, который необходимо установить.
Шаблон необходимо заменить (subst: ), иначе он не будет работать .
Обойдите кэш после сохранения страницы.

Пример

{{subst:iusc|User:TheDJ/sharebox.js}}

Производит: importScript( 'User:TheDJ/sharebox.js' ); // Backlink: [[User:TheDJ/sharebox.js]]

importScript() не устарел

Есть некоторая путаница относительно того, устарел ли importScript(). Ответ в том, что он не устарел.

В 2015 году importScript() был объявлен устаревшим на одну неделю, а затем действие было отменено. В 2022 году была исправлена ошибка, из-за которой importScript() не работал для мобильных пользователей. По состоянию на 2022 год последнее заявление инженеров-программистов об устаревании — phab:T27845#8135189, в котором говорится: Для локального импорта вызовите importScript(). Это не является и никогда не было устаревшим. Для кросс-вики и других менее тривиальных случаев использования вызовите mw.loader.load().

В заключение, importScript() не устарел, и редакторы могут свободно его использовать. Его не нужно систематически заменять на mw.loader.load(), а {{ iusc }} не нужно заменять на {{ lusc }} .

importScript() против mw.loader.load()

{{ Установка пользовательского скрипта }} использует importScript(), а {{ Загрузка пользовательского скрипта }} использует mw.loader.load().

importScript():

Менее подробный, требует только строку загружаемой страницы.
Является более ограничительным, разрешая загрузку страниц Википедии только в пользовательском пространстве имен или пространстве имен MediaWiki.
Можно загрузить из других вики Wikimedia, используя префикс, например, "c" для "commons". Например,importScript('c:User:YourName/test.js');
- Однако такое использование не рекомендуется, поскольку оно подразумевает дополнительный цикл. mw.loader.load быстрее для загрузок между вики.
Делает ваш файл common.js более читабельным, поскольку он менее многословен.

mw.loader.load():

Более многословен, требует длинной строки URL. Обратите внимание, что строка URL должна быть правильно экранирована.
Менее ограничительный. Загрузит любой URL из любой точки мира. Например, хорошо подходит для загрузки из локальной среды разработки, такой как localhost.
Можно загрузить из других вики-проектов Wikimedia, изменив URL.
Делает ваш файл common.js менее читабельным, поскольку он более подробен.

Смотрите также

{{ Загрузить пользовательский скрипт }} ( {{ Lusc }} ) – Версия этого скрипта, использующая mw.loader.load()метод.

Вышеуказанная документация включена из Template:Install user script/doc . ( edit | history ) Редакторы могут экспериментировать на страницах sandbox ( edit | diff) и testcases ( edit ) этого шаблона . Добавьте категории на подстраницу /doc . Подстраницы этого шаблона .