LLWiki正在建设中,欢迎加入我们

“LLWiki:管理员技术手册”的版本间差异

跳转到导航 跳转到搜索
 
;mw.request
:这个对象储存了一个mw.standardQuery()方法返回的PromimsePromise对象,即获取当前版本全文Wikitext的API请求。
 
;mw.sections
 
;<code>mw.apiFailure(reason, topic)</code><ref name="site-lib" />
:这个方法用于输出一个API请求失败的气泡通知。reason为API返回的错误信息,一般来自状态为reject的Promise对象API请求;topic为简短的文字说明,需要手动设置繁简转换
 
;<code>mw.timedQuery(api, params, topic)</code><ref name="site-lib" />
:这个方法用于提交一个可自定义的API请求,并记录用时,失败时应用mw.apiFailure()方法生成气泡通知。api为一个mw.Api对象;params即API参数,默认已填入<code lang="js">{action: 'query', formatversion: 2}</code>,可以覆盖;topic为简短文字描述,需要手动设置繁简转换。需要mediawiki.api。
 
;<code>mw.timedParse(api, params, topic)</code><ref name="site-lib" />
:Ajax使用POST而非GET,因此适合预览大段Wikitext。params的默认设置为<code lang="js">{action: 'parse', prop: 'text', title: mw.config.get( 'wgPageName' ), disablelimitreport: 1, disableeditsection: 1, formatversion: 2}</code>,可以覆盖。需要填入page、pageid或oldid参数时请勿使用此方法,应当选用包含<code lang="js">{action: 'parse'}</code>参数的mw.timedQuery()。topic同样需要手动设置繁简转换。需要mediawiki.api。
 
;<code>mw.standardQuery(api)</code><ref name="site-lib" />
 
;<code>mw.safeEdit(api, curRevid, params, [flag])</code><ref name="site-lib" />
:检查有无编辑冲突后提交编辑。api为mw.Api对象;curRevid为当前最新版本的编号,为保险起见未赋初始值,但一般填<code lang="js">mw.config.get( 'wgCurRevisionId' )</code>即可;parmas为API参数,默认为<code lang="js">{action: 'edit'}</code>,可以覆盖,但原则上请勿使用这一方法执行其他操作;flag参数对应是否开启自动备份小工具,这会改变检测到编辑冲突的应对。检测到编辑冲突出错误<code lang="js">'editConflict'</code>,API请求失败抛出错误<code lang="js">'editFailure'</code>或<code lang="js">'revisionQueryFailure'</code>。需要mediawiki.api。
 
;<code>mw.safeRedirect(api, title, target, [summary])</code><ref name="site-lib" />
:检查繁简转换后的页面是否已经存在后创建新重定向。api为mw.Api对象;title为重定向页标题;target为重定向目标页标题;summary为可选摘要。页面已存在时抛出<code lang="js">'pageExists'</code>,API请求失败时抛出<code lang="js">'createFailure'</code>或<code lang="js">'queryFailure'</code>。需要mediawiki.api和mediawiki.util。
 
;<code>mw.confirm(text, flags)</code><ref name="site-lib" />
:借助OO.ui.confirm()方法生成一个确认对话框。text为确认提示;flags为确认键的样式数组可选元素包括<code lang="js">'primary'</code>、<code lang="js">'progressive'</code>和<code lang="js">'destructive'</code>,其中<code lang="js">'primary'</code>不能单独生效。返回值为一个状态resolve的Promise对象,值为真表示确认。需要oojs-ui-core和oojs-ui-windows。
 
;<code>mw.dialog(dialog, actions, message, [title])</code><ref name="site-lib" />