Fandom Developers Wiki

BackToTopButton дадае кнопку ў правы кут на панэлі прылад, якая вяртае чытача ў верхнюю частку старонкі пры націску.

Installation[]

Налада[]

Калі вы хочаце наладзіць хуткасць прагорткі ўгару ці даўжыню прагорткі ўніз, пасля якой з'яўляецца кнопка, а таксама мноства іншых параметраў, дадайце наступныя радкі перад імпартам скрыпту (для global.js) ці на старонку MediaWiki:Wikia.js ці MediaWiki:Common.js вашай вікі.

Modernization[]

The button has two variants, a modern one and the old one. The old one is shown by default, but if you want to enable the modern behavior you can use:

window.BackToTopModern = true;

Arrow icon[]

If you want to use the old variant of the button but display an arrow instead of a button, you can use:

window.BackToTopArrow = true;

Тэкст кнопкі[]

Тэкст кнопкі будзе аўтаматычна адлюстроўвацца на мове наведніка. Аднак, калі вы хочаце змяніць тэкст, вы можаце зрабіць гэта, уставіўшы наступны радок.

window.BackToTopText = "новы тэкст";

Хуткасць прагорткі[]

Каб наладзіць хуткасць прагорткі, дадайце наступны радок:

window.BackToTopSpeed = number;

дзе number – гэты час у мілісекундах. Больш высокія значэнні прыводзяць да павальнейшай прагорткі, а меншыя – да хутчэйшай. Значэнне па змаўчанні – 600.

Выгляд кнопкі[]

Каб адрэгуляваць «глыбіню», вы павінны паказаць адлегласць для з'яўлення/знікненні кнопкі:

window.BackToTopStart = number;

дзе number – гэта адлегласць уніз па старонцы ў пікселях да з'яўлення кнопкі. Больш высокія значэнні прымусяць наведніка пракручваць старонку ніжэй да з'яўлення кнопкі. Значэнне па змаўчанні – 800.

Афармленне кнопкі[]

Вы таксама можаце аформіць кнопку на сваё меркаванне, скарыстаючы CSS. Прыкладам:

/* Афармленне кнопкі «Наверх» */
#BackToTopBtn div {
    opacity: 0.7;
    transition: .5s;
}
#BackToTopBtn div:hover {
    opacity: 1;
}

Гэты CSS прымусіць кнопку выглядаць як простая спасылка.

/* Афармленне кнопкі «Наверх» */
#backtotop button{
    background: none;
    background-color: transparent;
    color: white;
    border: none;
}
#backtotop button:hover {
    text-decoration: underline;
}

The above CSS rules will make the button look like a simple link. This works only on the old variant of the button.

Адключыць эфект з'яўлення/знікненні кнопкі[]

Каб адключыць эфект знікнення, дадайце наступны радок:

window.BackToTopFade = 0;

Using configuration options with Fandom Developers Wiki scripts

The instructions on this page describe how to use configuration options with a script. Here on the Fandom Developers Wiki, many scripts provide optional configuration settings as a mean to alter or enhance the default behavior of the script. When installing configuration options in your JavaScript file, please note that they need to go above the import statement in order to work — unless the directions say otherwise. In case MediaWiki:ImportJS is used to load the scripts, it will be executed last.

Configuration options load too late, don't work
// 1. AjaxRC import statement
importArticles({
    type: 'script',
    articles: [
        'u:dev:MediaWiki:AjaxRC.js'
    ]
});

// 2. AjaxRC configuration option
window.ajaxRefresh = 30000;
Proper placement of configuration options
// 1. AjaxRC configuration option
window.ajaxRefresh = 30000;

// 2. AjaxRC import statement
importArticles({
    type: 'script',
    articles: [
        'u:dev:MediaWiki:AjaxRC.js'
    ]
});

Каб ізноў уключыць эфект, проста выдаліце гэты радок са сваёй JS-старонкі. Эфект з'яўлення/знікненні кнопкі улучаны па змаўчанні.