什么是Javascript

JavaScript,简称JS,一种直译式脚本语言,是一种动态类型、弱类型、基于原型的语言,内置支持类型。它的解释器被称为JavaScript引擎,为浏览器的一部分,广泛用于客户端的脚本语言,在HTML网页上使用,用来给HTML网页增加动态功能。

Javascript和灰机wiki

权限变动

在灰机2.1.X版本中,将只有拥有开发者权限的用户可以修改Javascript。站点管理员仍可使用零件功能管理站点的Javascript。

在灰机,所有管理员以上级别的用户可以在一定条件下自定义站点Javascript。具体方法是将站点需要使用的js文件添加到所在站点的Mediawiki:Common.js页面。

在修改Javascript的过程中,您需要注意以下问题:

  • 请不要使用js修改属于灰机wiki的皮肤区域,包括但不限于头部、页脚、侧边栏、广告等。请确保您的编辑符合用户协议的约定。
  • 请不要过度修改js,以免造成读者阅读困难或网页卡顿。(比如过度使用alert命令。)
  • 修改js后,测试时应在url后加上?debug=1来绕过服务器缓存。
  • 修改js后,应尽可能在更多的浏览器上测试(其表现可能完全不同),并且需要照顾手机浏览器。
  • 请不要加载不明外部脚本,他们可能具有侵害性。
  • 请注意代码的可读性,撰写必要的注释和文档。

外部库

为了您的方便,下列外部库已经全局加载,可以直接使用。

  • MediaWiki
    • 如果你要认真的写一段javascript, 这个库是必看的。它提供了众多MediaWiki相关API的封装,没有必要重新发明轮子。
  • jQuery
  • Fontawesome 4.7
  • Bootstrap 3.2

可选库

  • OOjs — 一套面向对象的JS库,有Wikimedia设计。另有OOjs-UI,可视化编辑器中使用的UI系统。

模块化

MediaWiki:Common.js中的Javascript代码将会全局加载。但是当开发者试图编写一套复杂的JS代码时,单页显然是不够的。请参阅帮助:零件学习如何编写高扩展性的前端模块。

avatar