LLWiki正在建设中,欢迎
加入我们
!
查看“MediaWiki:Gadget-site-lib.js”的源代码
←
MediaWiki:Gadget-site-lib.js
跳转到导航
跳转到搜索
因为以下原因,您没有权限编辑本页:
您请求的操作仅限属于该用户组的用户执行:
用户
该页提供此wiki软件的界面文字,它已被保护以防止恶意修改。您可以点击右侧按钮在讨论页提出编辑请求,让管理人员代为编辑:
提出编辑请求
您无权编辑此JavaScript页面,因为编辑此页面可能会影响所有访问者。
您可以查看和复制此页面的源代码。
//<nowiki> // 由ResourceLoader直接调用,不可使用ES6语法 /** * @Description: LLWiki定义的常用函数,桌面版、手机版均可用,部分函数可能需要额外的JS库 * @Functions: 1. 繁简转换函数(wgULS, wgUCS) * 2. 杂项(pagenamee, addMobileLinks, apiFailure) * 4. API标准方法(timedQuery, timedParse, standardQuery, sectionQuery, safeEdit, safeRedirect) * 5. OOUI标准方法(confirm, prompt, dialog, tipsy) * 6. moment标准方法(convertTimezone) * @Document: [[LLWiki:管理员技术手册]] * @Author: 无特殊说明时均为[[User:Bhsd]] */ "use strict"; /*global OO, moment, wgULS*/ // 用于触发依赖jQuery的小部件,请勿改动 window.dispatchEvent( new Event('jquery') ); const pagename = mw.config.get('wgPageName'), revid = mw.config.get( 'wgRevisionId' ), wgUL = mw.config.get( 'wgUserLanguage' ), // 界面语言 wgUC = mw.config.get( 'wgUserVariant' ); // 内容语言 /** * @Function: 根据界面语言或内容语言手动繁简转换 * @Source: [[moegirl:mediawiki:gadget-site-lib.js]] * @Param {String} hans, 简体文字内容 * @Param {String} hant, 繁体文字内容(可选) * @Return {String} 转换后的文字 */ function wgUXS(wg, hans, hant) { return ['zh-hant', 'zh-tw', 'zh-hk', 'zh-mo'].includes(wg) ? hant || hans : hans; } window.wgULS = function(hans, hant) { return wgUXS(wgUL, hans, hant); }; window.wgUCS = function(hans, hant) { return wgUXS(wgUC == 'zh' ? wgUL : wgUC, hans, hant); }; mw.messages.set( wgULS({ 'gadget-lib-fail': '无法获得$1!错误信息:$2', 'gadget-lib-force': '获取历史版本的段落Wikitext必需force参数!', 'gadget-lib-page': '页面', 'gadget-lib-latest': '最新修订', 'gadget-lib-createFail': '创建失败!错误原因:$1', 'gadget-lib-conflict1': '编辑冲突!编辑内容已自动备份,请刷新页面后加载备份并重试。', 'gadget-lib-exist': '页面是否存在', 'gadget-lib-conflict2': '编辑冲突!请备份您的编辑内容后刷新页面重试。', 'gadget-lib-createSuccess': '创建成功!', 'gadget-lib-editFail': '编辑失败!错误信息:$1' }, { 'gadget-lib-fail': '無法獲得$1!錯誤信息:$2', 'gadget-lib-force': '獲取歷史版本的段落Wikitext必需force參數!', 'gadget-lib-page': '頁面', 'gadget-lib-latest': '最新修訂', 'gadget-lib-createFail': '創建失敗!錯誤原因:$1', 'gadget-lib-conflict1': '編輯衝突!編輯內容已自動備份,請刷新頁面後加載備份並重試。', 'gadget-lib-exist': '頁面是否存在', 'gadget-lib-conflict2': '編輯衝突!請備份您的編輯內容後刷新頁面重試。', 'gadget-lib-createSuccess': '創建成功!', 'gadget-lib-editFail': '編輯失敗!錯誤信息:$1' }) ); /** * @Function: 当前页面标题转义 * @Dependencies: mediawiki.util * @Return {String} 转义后的标题 */ mw.pagenamee = function() { return mw.util.wikiUrlencode( pagename ); }; /** * @Function: 添加手机版菜单项 * @Param {Object[]} 形如{icon, text, href, attr}或{icon, msg, href, attr}的对象 * @Param {String} FontAwesome图标名称icon(仅限fas类) * @Param {String} 文字text(需手动繁简转换) * @Param {String} mw.messages的键值msg * @Param {String} 目标地址href * @Param {Object} 外层<li>元素的属性 * @Return {HTML[]} 一组<li>元素 */ mw.addMobileLinks = function(links) { return links.map(function(ele) { return $('<a>', {href: ele.href, html: [ $('<i>', {class: "fa fa-" + (ele.icon || 'arrow-circle-right')}), $('<span>', {text: ele.text || mw.msg( ele.msg )}) ]}).wrap( '<li>' ).parent().attr( ele.attr || {} )[0]; }); }; /** * @Function: API请求失败时通知错误信息 * @Param {String} API返回的错误信息reason * @Param {String} API请求的内容topic(需手动繁简转换) */ mw.apiFailure = function(reason, topic) { mw.notify( mw.msg('gadget-lib-fail', topic, reason), {type: 'error', autoHideSeconds: 'long', tag: 'apiFailure'} ); }; /** * @Function: 提交一个API查询请求并计时,以方便评估表现 * @Dependencies: mediawiki.api * @Param {mw.Api} mw.Api对象api * @Param {Object} API参数对象params * @Param {String} API请求内容topic(需手动繁简转换) * @Return {Promise} Promise对象,且在请求成功时记录用时,失败时通知错误信息 */ mw.timedQuery = function(api, params, topic) { console.log('API request: 查询' + topic); const now = mw.now(); return api.get( $.extend({action: 'query', formatversion: 2}, params) ).then(function(data) { console.log('End API request: 已获得' + topic + ',用时 ' + (mw.now() - now) + ' ms'); return data; }, function(reason) { mw.apiFailure(reason, topic); throw reason; }); }; /** * @Function: 類似mw.timedQuery,但改用POST,適合用於預覽 * @Dependencies: mediawiki.api * @Param {mw.Api} mw.Api对象api * @Param {Object} API参数对象params * @Param {String} API请求内容topic(需手动繁简转换) * @Return {Promise} Promise对象,且在请求成功时记录用时,失败时通知错误信息 */ mw.timedParse = function(api, params, topic) { console.log('API request: 解析' + topic); const now = mw.now(); return api.post( $.extend({action: 'parse', prop: 'text', disablelimitreport: 1, disableeditsection: 1, title: pagename, pst: 1, formatversion: 2}, params) ).then(function(data) { console.log('End API request: 已获得' + topic + ',用时 ' + (mw.now() - now) + ' ms'); return data; }, function(reason) { mw.apiFailure(reason, topic); throw reason; }); }; /** * @Function: 提交一个标准API请求以获得当前版本的Wikitext,这是在多个小工具中广泛使用的请求 * @Dependencies: mediawiki.api * @Param {mw.Api} mw.Api对象api * @Return {Promise} Promise对象,且在请求成功时记录用时,失败时通知错误信息 */ mw.standardQuery = function(api) { mw.request = mw.request || mw.timedQuery(api, {revids: revid, prop: 'revisions', rvprop: 'content'}, mw.msg('gadget-lib-page') + 'Wikitext'); return mw.request; }; /** * @Function: 提交一个标准API请求以获得当前版本的段落Wikitext,一般不可用于历史版本 * @Dependencies: mediawiki.api * @Param {mw.Api} mw.Api对象api * @Param {Number} 段落编号section * @Param {Boolean} 强制历史版本force(可选) * @Return {Promise} Promise对象,且在请求成功时记录用时,失败时通知错误信息 */ mw.sectionQuery = function(api, section, force) { if (!force && revid < mw.config.get('wgCurRevisionId')) { mw.notify( mw.msg('gadget-lib-force'), {type: 'warn', autoHideSeconds: 'long', tag: 'historySection'}); return Promise.reject( 'historySection' ); } mw.sections = mw.sections || []; mw.sections[section] = mw.sections[section] || mw.timedQuery(api, {action: 'parse', oldid: revid, prop: 'wikitext|sections', section: section}, '段落Wikitext'); return mw.sections[section]; }; /** * @Function: 检查编辑冲突后提交编辑 * @Dependencies: mediawiki.api * @Param {mw.Api} mw.Api对象api * @Param {Number} 最新修订编号curRevid * @Param {Object} API参数对象params * @Param {Boolean} 是否启用自动备份flag(可选) * @Return {Promise} Promise对象,API请求失败时抛出revisionQueryFailure或editFailure,编辑冲突时抛出editConflict */ mw.safeEdit = function(api, curRevid, params, flag) { return mw.timedQuery(api, {prop: 'info', titles: params.title, pageids: params.pageid}, mw.msg('gadget-lib-latest')).then(function(data) { // 未创建的页面lastrevid返回undefined,因此下式同样为false if (data.query.pages[0].lastrevid > curRevid) { mw.notify( mw.msg('gadget-lib-conflict' + (flag + 1)), {type: 'error', autoHideSeconds: 'long', tag: 'editConflict'} ); throw 'editConflict'; } console.log('API request: 开始提交编辑'); const now = mw.now(); return api.postWithEditToken( $.extend({action: 'edit'}, params) ).then(function() { console.log('End API request: 编辑成功!用时 ' + (mw.now() - now) + ' ms'); }, function(reason) { mw.notify( mw.msg('gadget-lib-editFail', reason), {type: 'error', autoHideSeconds: 'long', tag: 'apiFailure'} ); throw 'editFailure'; }); }, function() { throw 'revisionQueryFailure'; }); // mw.timedQuery已通知错误信息 }; /** * @Function: 检查页面是否存在后新建重定向 * @Dependencies: mediawiki.api * @Param {mw.Api} mw.Api对象api * @Param {String} 重定向页标题title * @Param {String} 重定向目标target * @Param {String} 编辑摘要summary(可选) * @Return {Promise} Promise对象,API请求失败时抛出queryFailure或createFailure,页面已存在时抛出pageExists */ mw.safeRedirect = function(api, title, target, summary) { return mw.timedQuery(api, {titles: title, converttitles: 1}, mw.msg('gadget-lib-exist')).then(function(x) { const converted = x.query.pages[0], ctitle = converted.title; if (!converted.missing) { mw.notify([ mw.msg('gadget-lib-page'), // 这个href会出现在地址栏,因此手动填入短地址'/zh'而非使用mw.util.getUrl $('<a>', {text: ctitle, href: '/zh?redirect=no&title=' + mw.util.wikiUrlencode( ctitle )}), '已存在!' ], {type: 'error', autoHideSeconds: 'long'}); throw 'pageExists'; } console.log('API request: 开始新建重定向'); const now = mw.now(); api.create(title, summary ? {summary: summary} : {}, '#重定向 [[' + target + ']]').then(function() { console.log('End API request: 成功新建重定向,用时 ' + (mw.now() - now) + ' ms'); mw.notify( mw.msg('gadget-lib-createSuccess'), {type: 'success'} ); }, function(reason) { mw.notify( mw.msg('gadget-lib-createFail', reason), {type: 'error', autoHideSeconds: 'long', tag: 'apiFailure'} ); throw 'createFailure'; }); }, function() { throw 'queryFailure'; }); // mw.timedQuery已通知错误信息 }; /** * @Function: 生成标准化的确认对话框 * @Dependencies: oojs-ui-windows * @Param {String} 文字提示text * @Param {String[]} 确认按钮样式flags * @Return {Promise} Promise对象 */ mw.confirm = function(text, flags) { return OO.ui.confirm(text, {actions: [{label: "否"}, {label: "是", flags: flags, action: 'accept'}]}); }; /** * @Function: 生成标准化的prompt对话框 * @Dependencies: oojs-ui-windows * @Param {String} 文字提示text * @Param {String[]} 确认按钮样式flags * @Param {Object} 文本框设置config * @Return {Promise} Promise对象 */ mw.prompt = function(text, flags, config) { return OO.ui.prompt(text, {actions: [ {label: mw.msg('ooui-dialog-message-reject')}, {label: mw.msg('ooui-dialog-message-accept'), flags: flags, action: 'accept'} ], textInput: config}); }; /** * @Function: 生成标准化的对话框 * @Dependencies: oojs-ui-windows * @Param {OO.ui.MessageDialog} OO.ui.MessageDialog对象dialog * @Param {Object[]} 按钮actions * @Param {jQuery} 文字$message * @Param {jQuery} 标题$title(可选) * @Return {Promise} Promise对象 */ mw.dialog = function(dialog, actions, $message, $title) { // 一个WindowManager只能打开一个MessageDialog if (!dialog.getManager()) { const windowManager = new OO.ui.WindowManager(); windowManager.$element.appendTo( 'body' ); windowManager.addWindows( [dialog] ); } dialog.message.$label.html( $message ); // undefined不更新message dialog.title.$label.html( $title ); // undefined不更新title return dialog.open({actions: actions}).opening.then(function() { // 使href生效 dialog.attachedActions.forEach(function(ele) { ele.$button.off( 'click' ).click(function() { dialog.close(); }); }); }); }; /** * @Function: 生成兼容手机版的tooltip * @Dependencies: oojs-ui-core * @Param {jQuery} 容器$container * @Param {String} 目标选择器target * @Param {Object} 参数params(可选) * @Param {jQuery} 标签对象$content(可选) */ mw.tipsy = function($container, target, params, $content) { const $label = $('<span>'), // 这里不用PopupWidget自带的autoClose功能,因为效果很奇怪;默认样式见[[mediawiki:gadget-site-styles.css]] popup = new OO.ui.PopupWidget( $.extend({$content: $content || $label, padded: true, width: null, classes: ['mw-tipsy']}, params) ); if ($content) { $content.append( $label ); } // 没有title时,$label没有效果 popup.$element.appendTo( 'body' ); $container.on('mouseenter focus', target, function() { const $this = $(this); var title = this.title; // 不能寫成$this.data('title', title) if (title) { $this.attr('data-title', title).removeAttr( 'title' ); } else { title = $this.data('title'); } if (!title) { return; } // 不能写成this.tabIndex = -1 if (this.tabIndex === undefined) { $this.attr('tabindex', -1); } $label.text(title); popup.toggle( true ).setFloatableContainer( $this ); }).on('mouseleave blur', target, function() { popup.toggle( false ); }); }; /** * @Function: 更改moment对象的时区 * @Dependencies: moment * @Param {moment} 原始moment对象 * @Param {String} 符合IANA标准的时区名称或UTC偏移量 * @Return {moment} 更改时区后的moment对象。注意这不是一个真实存在的时间,只能用于输出,不能用于进一步计算。 * @Return {String} 以en-us记法表示的时区或UTC偏移量 */ mw.convertTimezone = function(then, timezone) { if (timezone === '') { timezone = undefined; } if (isNaN( timezone )) { // 时区名称 const date = new Date(then); return [ moment(date.toLocaleString('ia', {timeZone: timezone}), 'DD-MM-YYYY HH:mm'), date.toLocaleString('en-us', {timeZone: timezone, year: '2-digit', timeZoneName: 'short'}).slice(4) ]; } else { // UTC偏移量 return [ moment.utc( then ).add(timezone, 'hour'), 'UTC' + (timezone == '0' ? '' : (timezone > 0 ? '+' : '') + timezone)]; } }; //</nowiki> // [[category:作为模块的小工具]] [[category:系统工具]] [[category:不可关闭的小工具]] [[category:桌面版小工具]] [[category:手机版小工具]] // {{DEFAULTSORT:site-lib.js}}
返回
MediaWiki:Gadget-site-lib.js
。
导航菜单
个人工具
创建账号
登录
命名空间
系统消息
讨论
变体
查看
阅读
查看源代码
查看历史
更多
搜索
导航
首页
随机页面
最近更改
沙盒
互助客栈
方针与指引
帮助
工具
链入页面
相关更改
特殊页面
页面信息