Extension:Popups/zh

弹窗（Popups）扩展显示“hovercards” − 当用户悬停在一个条目链接时，显示带有条目内容摘要的弹窗.

This is an initiative of the Design team, inspired by the popular Navigation popups gadget. Currently this feature is available as a Beta Feature on Wikimedia wikis. A description of how the extension functions and more information on its use on Wikimedia projects is available at Page Previews.

依赖性
This extension has a hard dependency on and. There are also optional dependencies on (without BetaFeatures, it loads for all users), and  and  (for instrumentation).

安装

 * 安装依赖组件.


 * 启用测试功能

内容
The popups show an image (if one is available), a small text excerpt and the timestamp of the last edit.

图片
The image comes from the Extension:PageImages which returns the single most appropriate thumbnail associated with an article. It ignores maintenance templates, stubs, flag icons etc.

文本
The text comes from the Extension:TextExtracts from which a plain-text extract is requested (see that extension for exclusions). Two sentences are requested from the intro section and a limit is put through CSS that makes sure that text doesn't overflow from the card. This is done by applying a max-height on that element. This approach would provide the same visual solution regardless of the language's script. A major con is that the text stops abruptly and ellipses can't be added.

显示/隐藏定时
The timing of the show/hide can currently be adjusted via code, which should be added to your local Special:MyPage/common.js or global.js file :

Renderers
This extensions currently has only one renderer, that is for ordinary pages. New renderers for different kind of pages, or things like references can be easily added. One needs to create a new object with the following methods:


 * init
 * createPopup
 * getOffset
 * getClasses
 * processPopup

You can see details of these methods in ext.popups.renderer.article.js or this patch that adds a renderer for references.