MediaWiki:Gadget-RightToolbar.js:修订间差异

删除的内容 添加的内容
XP-jia​(留言 | 贡献)
小 简化提示
Maintenance script​(留言 | 贡献)
小 优化 RightToolbar:移动端禁用并降低空闲开销
 
(未显示同一用户的4个中间版本)
第1行:
/* MediaWiki Gadget: RightToolbar */
/* ================================================================
( function () {
MediaWiki Gadget: Localized Clock Bar (增强版)
'use strict';
功能:
- 显示浏览器本地时间和 UTC 时间
- 使用 MediaWiki 用户语言格式
- 动态响应语言切换,无需刷新
- 深色模式适配 + 滑入动画
作者:你自己
================================================================= */
 
mw.loader.using( [ 'mediawiki.util' ], ).then( function () {
var toolbar;
var topButton;
var bottomButton;
var clockTimer = 0;
var ticking = false;
var mobileQuery = window.matchMedia( '(max-width: 768px)' );
 
function isMobileView() {
// 工具栏主函数
return mobileQuery.matches ||
function initClockBar() {
document.documentElement.classList.contains( 'skin-minerva' ) ||
var isMobile = window.innerWidth <= 768;
new URLSearchParams( window.location.search ).get( 'mobileaction' ) === 'toggle_view_mobile';
}
 
function msg( key ) {
// ---------- 深色模式检测 ----------
var lang = ( mw.config.get( 'wgUserLanguage' ) || mw.config.get( 'wgContentLanguage' ) || 'zh-cn' ).toLowerCase();
const isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
var en = lang.indexOf( 'en' ) === 0;
const bg = isDark ? 'rgba(40,40,40,0.85)' : 'rgba(255,255,255,0.85)';
var messages = {
const border = isDark ? '#555' : '#aaa';
top: en ? 'Top' : '顶部',
const color = isDark ? '#eee' : '#333';
bottom: en ? 'Bottom' : '底部',
topTitle: en ? 'Back to top' : '回到顶部',
bottomTitle: en ? 'Back to bottom' : '回到底部',
loading: en ? 'Loading...' : '加载中...'
};
return messages[ key ];
}
 
function createButton( id, text, tooltip, clickHandler ) {
// ---------- 创建工具栏容器 ----------
var button = document.createElement( 'button' );
var $container = $('#mw-custom-tools');
button.id = id;
if (!$container.length) {
button.className = 'mw-rt-button';
$container = $('<div id="mw-custom-tools"></div>').css({
button.title = tooltip;
position: 'fixed',
button.type = 'button';
bottom: '120px',
button.textContent = text;
right: '50px',
button.setAttribute( 'aria-label', tooltip );
display: 'flex',
button.addEventListener( 'click', clickHandler );
flexDirection: 'column',
return button;
alignItems: 'flex-end',
}
gap: '5px',
zIndex: 9999,
opacity: 0,
transform: 'translateY(20px)', // 初始位置
}).appendTo('body');
}
 
function formatParts( date, zone ) {
// ---------- 按钮生成函数 ----------
var userLang = mw.config.get( 'wgUserLanguage' ) || 'zh-cn';
function createButton(id, text, tooltip, clickHandler) {
var parts = new Intl.DateTimeFormat( userLang, {
return $('<div></div>', { id: id, title: tooltip, text: text }).css({
year: 'numeric',
padding: '5px 10px',
month: '2-digit',
fontSize: '12px',
day: '2-digit',
background: bg,
hour: '2-digit',
border: '1px solid ' + border,
minute: '2-digit',
borderRadius: '4px',
second: '2-digit',
boxShadow: '0 1px 3px rgba(0,0,0,0.2)',
hour12: false,
color: color,
timeZone: zone
cursor: 'pointer',
} ).formatToParts( date );
textAlign: 'center',
opacity: 0.7,
transition: 'background 0.3s, opacity 0.3s, transform 0.3s',
backdropFilter: 'blur(4px)'
}).hover(
function () { $(this).css({ background: isDark ? '#555' : '#ddd', opacity: 1 }); },
function () { $(this).css({ background: bg, opacity: 0.7 }); }
).click(clickHandler);
}
 
function partValue( type ) {
// ---------- 创建按钮 ----------
var part = parts.find( function ( item ) {
var $topButton = $('#mw-scroll-top');
return item.type === type;
if (!$topButton.length) {
} );
$topButton = createButton('mw-scroll-top', '▲', '回到顶部', function () {
return part ? part.value : '';
$('html, body').animate({ scrollTop: 0 }, { duration: 500, easing: 'swing' });
}
});
$container.append($topButton);
}
 
return {
var $bottomButton = $('#mw-scroll-bottom');
date: partValue( 'year' ) + '-' + partValue( 'month' ) + '-' + partValue( 'day' ),
if (!$bottomButton.length) {
time: partValue( 'hour' ) + ':' + partValue( 'minute' ) + ':' + partValue( 'second' )
$bottomButton = createButton('mw-scroll-bottom', '▼', '回到底部', function () {
};
$('html, body').animate({ scrollTop: $(document).height() }, { duration: 500, easing: 'swing' });
}
});
$container.append($bottomButton);
}
 
function renderClock() {
// ---------- 时钟容器(桌面端) ----------
var now = new Date();
var $clockDiv = $('#current-clock');
var timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
if (!isMobile && !$clockDiv.length) {
var local = formatParts( now, timeZone );
$clockDiv = $('<div id="current-clock"></div>').css({
var utc = formatParts( now, 'UTC' );
padding: '6px 12px',
var localDateEl = document.getElementById( 'mw-local-date' );
fontSize: '12px',
var localTimeEl = document.getElementById( 'mw-local-time' );
background: bg,
var utcTimeEl = document.getElementById( 'mw-utc-time' );
border: '1px solid ' + border,
borderRadius: '4px',
boxShadow: '0 1px 3px rgba(0,0,0,0.2)',
color: color,
textAlign: 'center',
lineHeight: '1.4',
backdropFilter: 'blur(4px)'
}).append(
$('<div id="local-date">加载中...</div>'),
$('<div id="local-time"></div>'),
$('<div id="utc-time"></div>')
);
$container.append($clockDiv);
}
 
if ( localDateEl ) {
// ---------- 滚动动态显示 ----------
localDateEl.textContent = local.date;
$topButton.hide(); // 初始隐藏
}
$(window).on('scroll', function () {
if ( localTimeEl ) {
var scrollTop = $(this).scrollTop();
localTimeEl.textContent = local.time;
if (scrollTop > 200) $topButton.fadeIn(); else $topButton.fadeOut();
}
});
if ( utcTimeEl ) {
utcTimeEl.textContent = 'UTC ' + utc.date + ' ' + utc.time;
}
}
 
function updateTopButton() {
// ---------- 初始动画 ----------
var scrollTop = window.pageYOffset || document.documentElement.scrollTop || 0;
$container.animate({ opacity: 1, transform: 'translateY(0)' }, 600);
topButton.hidden = scrollTop <= 240;
bottomButton.hidden = document.documentElement.scrollHeight - window.innerHeight - scrollTop <= 240;
}
 
function onScroll() {
// ---------- 渲染时钟函数 ----------
if ( ticking ) {
function renderClock() {
return;
var now = new Date();
}
ticking = true;
window.requestAnimationFrame( function () {
updateTopButton();
ticking = false;
} );
}
 
function stopClock() {
// 获取 MediaWiki 用户语言(wgUserLanguage)
if ( clockTimer ) {
var userLang = mw.config.get('wgUserLanguage') || 'en';
window.clearInterval( clockTimer );
clockTimer = 0;
}
}
 
function teardownToolbar() {
// 本地时间
stopClock();
var localFormatter = new Intl.DateTimeFormat(userLang, {
window.removeEventListener( 'scroll', onScroll );
year: 'numeric', month: 'long', day: 'numeric',
if ( toolbar ) {
hour: '2-digit', minute: '2-digit', second: '2-digit',
toolbar.remove();
hour12: false,
}
timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone
toolbar = null;
});
topButton = null;
var localParts = localFormatter.formatToParts(now);
bottomButton = null;
var localDateStr = localParts.filter(p => p.type === 'year' || p.type === 'month' || p.type === 'day')
}
.map(p => p.value).join(' ');
var localTimeStr = localParts.filter(p => p.type === 'hour' || p.type === 'minute' || p.type === 'second')
.map(p => p.value).join(':');
$('#local-date').text(localDateStr);
$('#local-time').text(localTimeStr);
 
function initToolbar() {
// UTC 时间
var clockDiv;
var utcFormatter = new Intl.DateTimeFormat(userLang, {
year: 'numeric', month: 'long', day: 'numeric',
hour: '2-digit', minute: '2-digit', second: '2-digit',
hour12: false,
timeZone: 'UTC'
});
var utcParts = utcFormatter.formatToParts(now);
var utcDateStr = utcParts.filter(p => p.type === 'year' || p.type === 'month' || p.type === 'day')
.map(p => p.value).join(' ');
var utcTimeStr = utcParts.filter(p => p.type === 'hour' || p.type === 'minute' || p.type === 'second')
.map(p => p.value).join(':');
$('#utc-time').text('UTC: ' + utcDateStr + ' ' + utcTimeStr);
}
 
if ( isMobileView() ) {
// ---------- 定时刷新 ----------
teardownToolbar();
setInterval(renderClock, 1000);
return;
renderClock(); // 启动立即渲染
}
if ( toolbar ) {
return;
}
 
toolbar = document.createElement( 'div' );
// ---------- 语言切换动态刷新 ----------
toolbar.id = 'mw-right-toolbar';
// MediaWiki 用户语言修改后触发 user.languageChange hook
toolbar.className = 'mw-right-toolbar';
mw.hook('user.languageChange').add(renderClock);
}
 
topButton = createButton( 'mw-scroll-top', msg( 'top' ), msg( 'topTitle' ), function () {
// 初始化工具条
window.scrollTo( { top: 0, behavior: 'smooth' } );
$(initClockBar);
} );
bottomButton = createButton( 'mw-scroll-bottom', msg( 'bottom' ), msg( 'bottomTitle' ), function () {
window.scrollTo( {
top: Math.max( document.body.scrollHeight, document.documentElement.scrollHeight ),
behavior: 'smooth'
} );
} );
 
clockDiv = document.createElement( 'div' );
clockDiv.id = 'mw-right-toolbar-clock';
clockDiv.className = 'mw-rt-clock';
clockDiv.innerHTML = '<div id="mw-local-date"></div><div id="mw-local-time"></div><div id="mw-utc-time"></div>';
clockDiv.firstChild.textContent = msg( 'loading' );
 
toolbar.appendChild( topButton );
toolbar.appendChild( bottomButton );
toolbar.appendChild( clockDiv );
document.body.appendChild( toolbar );
 
window.addEventListener( 'scroll', onScroll, { passive: true } );
updateTopButton();
renderClock();
clockTimer = window.setInterval( renderClock, 1000 );
 
window.requestAnimationFrame( function () {
if ( toolbar ) {
toolbar.classList.add( 'is-visible' );
}
} );
}
 
function refreshToolbar() {
if ( isMobileView() ) {
teardownToolbar();
return;
}
initToolbar();
}
 
if ( document.readyState === 'loading' ) {
document.addEventListener( 'DOMContentLoaded', initToolbar );
} else {
initToolbar();
}
 
mobileQuery.addEventListener( 'change', refreshToolbar );
window.addEventListener( 'orientationchange', refreshToolbar );
document.addEventListener( 'visibilitychange', function () {
if ( !toolbar ) {
return;
}
if ( document.hidden ) {
stopClock();
return;
}
renderClock();
if ( !clockTimer ) {
clockTimer = window.setInterval( renderClock, 1000 );
}
} );
} );
}() );