Jump to content

Extension:FloatingUI

From mediawiki.org
MediaWiki extensions manual
FloatingUI
Release status: beta
Implementation Parser function
Description implements the FloatingUI Javascript library
Author(s) alistair3149
Latest version 0.3.1 (Continuous updates)
Compatibility policy Master maintains backward compatibility.
MediaWiki 1.39+
Composer starcitizentools/floating-ui
License GNU General Public License 3.0 or later
Download

The FloatingUI extension implements the FloatingUI Javascript library.


Installation

[edit]
  • Download and place the file(s) in a directory called FloatingUI in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'FloatingUI' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Usage

[edit]

Parser function

[edit]
{{#floatingui:reference|content}}

Loading library

[edit]

There are several ways to load the library on a given page. Once the library is loaded, it can be accessed through window.FloatingUIDOM in Javascript.

To attach the library to a wikipage, put the following wikitext onto the page:

{{#floatingui:}}

Or alternatively, you can load the ResourceLoader module in Javascript:

mw.loader.load( 'ext.floatingUI.lib' );

Defining elements

[edit]
  1. Reference element has to have the HTML class ext-floatingui-reference.
  2. Floating element has to have the HTML class ext-floatingui-content and place next to the reference element.