VolkerE has uploaded a new change for review. (
https://gerrit.wikimedia.org/r/403836 )
Change subject: docs: Replace “OOjs UI” with “OOUI” in code comments
......................................................................
docs: Replace “OOjs UI” with “OOUI” in code comments
Replacing “OOjs UI” with “OOUI” in code comments.
Also fixing two links and one typo.
Bug: T182360
Change-Id: I7bab58e4c57c36dc60d1f5012383cd74af5fbeea
---
M php/Element.php
M php/Tag.php
M php/widgets/TextInputWidget.php
M src/ActionSet.js
M src/Dialog.js
M src/Element.js
M src/Error.js
M src/Tool.js
M src/ToolFactory.js
M src/ToolGroup.js
M src/ToolGroupFactory.js
M src/Toolbar.js
M src/Widget.js
M src/Window.js
M src/WindowInstance.js
M src/WindowManager.js
M src/core.js
M src/dialogs/MessageDialog.js
M src/dialogs/ProcessDialog.js
M src/layouts/FieldLayout.js
M src/layouts/FieldsetLayout.js
M src/layouts/FormLayout.js
M src/mixin.js
M src/mixins/ButtonElement.js
M src/mixins/FlaggedElement.js
M src/mixins/GroupElement.js
M src/mixins/IconElement.js
M src/mixins/IndicatorElement.js
M src/mixins/LabelElement.js
M src/mixins/LookupElement.js
M src/toolgroups/BarToolGroup.js
M src/toolgroups/ListToolGroup.js
M src/toolgroups/MenuToolGroup.js
M src/tools/PopupTool.js
M src/tools/ToolGroupTool.js
M src/widgets/ActionWidget.js
M src/widgets/ButtonInputWidget.js
M src/widgets/ButtonOptionWidget.js
M src/widgets/ButtonSelectWidget.js
M src/widgets/ButtonWidget.js
M src/widgets/CapsuleMultiselectWidget.js
M src/widgets/CheckboxInputWidget.js
M src/widgets/CheckboxMultioptionWidget.js
M src/widgets/CheckboxMultiselectInputWidget.js
M src/widgets/CheckboxMultiselectWidget.js
M src/widgets/ComboBoxInputWidget.js
M src/widgets/DecoratedOptionWidget.js
M src/widgets/DropdownInputWidget.js
M src/widgets/DropdownWidget.js
M src/widgets/IconWidget.js
M src/widgets/IndicatorWidget.js
M src/widgets/InputWidget.js
M src/widgets/MenuOptionWidget.js
M src/widgets/MenuSelectWidget.js
M src/widgets/MenuTagMultiselectWidget.js
M src/widgets/MultioptionWidget.js
M src/widgets/MultiselectWidget.js
M src/widgets/OptionWidget.js
M src/widgets/PopupButtonWidget.js
M src/widgets/PopupTagMultiselectWidget.js
M src/widgets/PopupWidget.js
M src/widgets/RadioInputWidget.js
M src/widgets/RadioOptionWidget.js
M src/widgets/RadioSelectInputWidget.js
M src/widgets/RadioSelectWidget.js
M src/widgets/SearchWidget.js
M src/widgets/SelectFileWidget.js
M src/widgets/SelectWidget.js
M src/widgets/TagMultiselectWidget.js
M src/widgets/TextInputWidget.js
M src/widgets/ToggleButtonWidget.js
71 files changed, 191 insertions(+), 202 deletions(-)
git pull ssh://gerrit.wikimedia.org:29418/oojs/ui refs/changes/36/403836/1
diff --git a/php/Element.php b/php/Element.php
index 2c0a871..c46861f 100644
--- a/php/Element.php
+++ b/php/Element.php
@@ -268,12 +268,12 @@
/**
* A helper method to massage an array of HTML attributes into a format
that is more likely to
- * work with an OOjs UI PHP element, camel-casing attribute names and
setting values of boolean
+ * work with an OOUI PHP element, camel-casing attribute names and
setting values of boolean
* ones to true. Intended as a convenience to be used when refactoring
legacy systems using HTML
- * to use OOjs UI.
+ * to use OOUI.
*
* @param array $attrs HTML attributes, e.g. `[ 'disabled' => '',
'accesskey' => 'k' ]`
- * @return array OOjs UI PHP element config, e.g. `[ 'disabled' =>
true, 'accessKey' => 'k' ]`
+ * @return array OOUI PHP element config, e.g. `[ 'disabled' => true,
'accessKey' => 'k' ]`
*/
public static function configFromHtmlAttributes( array $attrs ) {
$booleanAttrs = [
diff --git a/php/Tag.php b/php/Tag.php
index 1c308bd..e35fcd2 100644
--- a/php/Tag.php
+++ b/php/Tag.php
@@ -409,7 +409,7 @@
}
// Note that this is not a complete list of HTML
attributes that need this validation.
- // We only check for the ones that are generated by
built-in OOjs UI PHP elements.
+ // We only check for the ones that are generated by
built-in OOUI PHP elements.
if ( $key === 'href' || $key === 'action' ) {
if ( !self::isSafeUrl( $value ) ) {
// We can't tell for sure whether this
URL is safe (although it might be). The only safe
diff --git a/php/widgets/TextInputWidget.php b/php/widgets/TextInputWidget.php
index 9b84d8e..a576f6a 100644
--- a/php/widgets/TextInputWidget.php
+++ b/php/widgets/TextInputWidget.php
@@ -76,7 +76,7 @@
if ( $this->multiline && !( $this instanceof
MultilineTextInputWidget ) ) {
Element::warnDeprecation(
- 'The TextInputWidget "multiline" option is
deprecated as of OOjs UI v0.22.2. ' .
+ 'The TextInputWidget "multiline" option is
deprecated as of OOUI v0.22.2. ' .
'Use MultilineTextInputWidget instead.'
);
}
diff --git a/src/ActionSet.js b/src/ActionSet.js
index fa9723a..bb7ea5a 100644
--- a/src/ActionSet.js
+++ b/src/ActionSet.js
@@ -9,7 +9,7 @@
* - Special: Special actions are the first visible actions with special
flags, such as 'safe' and 'primary', the default special flags. Additional
special flags can be configured in subclasses with the static #specialFlags
property.
* - Other: Other actions include all non-special visible actions.
*
- * Please see the [OOjs UI documentation on MediaWiki][1] for more information.
+ * See the [OOUI documentation on MediaWiki][1] for more information.
*
* @example
* // Example: An action set used in a process dialog
@@ -70,7 +70,7 @@
* windowManager.addWindows( [ dialog ] );
* windowManager.openWindow( dialog );
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Windows/Process_Dialogs#Action_sets
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows/Process_Dialogs#Action_sets
*
* @abstract
* @class
@@ -111,9 +111,9 @@
/**
* Symbolic name of the flags used to identify special actions. Special
actions are displayed in the
* header of a {@link OO.ui.ProcessDialog process dialog}.
- * See the [OOjs UI documentation on MediaWiki][2] for more information and
examples.
+ * See the [OOUI documentation on MediaWiki][2] for more information and
examples.
*
- * [2]:https://www.mediawiki.org/wiki/OOjs_UI/Windows/Process_Dialogs
+ * [2]:https://www.mediawiki.org/wiki/OOUI/Windows/Process_Dialogs
*
* @abstract
* @static
diff --git a/src/Dialog.js b/src/Dialog.js
index 445f372..7ef81f8 100644
--- a/src/Dialog.js
+++ b/src/Dialog.js
@@ -3,7 +3,7 @@
* Unless extended to include controls, the rendered dialog box is a simple
window
* that users can close by hitting the ‘Esc’ key. Dialog windows are used with
OO.ui.WindowManager,
* which opens, closes, and controls the presentation of the window. See the
- * [OOjs UI documentation on MediaWiki] [1] for more information.
+ * [OOUI documentation on MediaWiki] [1] for more information.
*
* @example
* // A simple dialog window.
@@ -31,7 +31,7 @@
* // Open the window!
* windowManager.openWindow( myDialog );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Windows/Dialogs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows/Dialogs
*
* @abstract
* @class
@@ -77,9 +77,9 @@
* Symbolic name of dialog.
*
* The dialog class must have a symbolic name in order to be registered with
OO.Factory.
- * Please see the [OOjs UI documentation on MediaWiki] [3] for more
information.
+ * Please see the [OOUI documentation on MediaWiki] [3] for more information.
*
- * [3]: https://www.mediawiki.org/wiki/OOjs_UI/Windows/Window_managers
+ * [3]: https://www.mediawiki.org/wiki/OOUI/Windows/Window_managers
*
* @abstract
* @static
@@ -108,7 +108,7 @@
* Actions can also be specified with data passed to the constructor (see
#getSetupProcess). In this case, the static
* value will be overridden.
*
- * [2]:
https://www.mediawiki.org/wiki/OOjs_UI/Windows/Process_Dialogs#Action_sets
+ * [2]: https://www.mediawiki.org/wiki/OOUI/Windows/Process_Dialogs#Action_sets
*
* @static
* @inheritable
diff --git a/src/Element.js b/src/Element.js
index db95c03..abb91dc 100644
--- a/src/Element.js
+++ b/src/Element.js
@@ -9,9 +9,9 @@
* @constructor
* @param {Object} [config] Configuration options
* @cfg {string[]} [classes] The names of the CSS classes to apply to the
element. CSS styles are added
- * to the top level (e.g., the outermost div) of the element. See the [OOjs
UI documentation on MediaWiki][2]
+ * to the top level (e.g., the outermost div) of the element. See the [OOUI
documentation on MediaWiki][2]
* for an example.
- * [2]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Buttons_and_Switches#cssExample
+ * [2]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Buttons_and_Switches#cssExample
* @cfg {string} [id] The HTML id attribute used in the rendered tag.
* @cfg {string} [text] Text to insert
* @cfg {Array} [content] An array of content elements to append (after #text).
diff --git a/src/Error.js b/src/Error.js
index af87b72..7b085cd 100644
--- a/src/Error.js
+++ b/src/Error.js
@@ -10,9 +10,9 @@
* If the error is a warning, the error interface will include a 'Dismiss' and
a 'Continue' button, which will try the
* process again.
*
- * For an example of error interfaces, please see the [OOjs UI documentation
on MediaWiki][1].
+ * For an example of error interfaces, please see the [OOUI documentation on
MediaWiki][1].
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Windows/Process_Dialogs#Processes_and_errors
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Windows/Process_Dialogs#Processes_and_errors
*
* @class
*
diff --git a/src/Tool.js b/src/Tool.js
index ab9af2f..be7d727 100644
--- a/src/Tool.js
+++ b/src/Tool.js
@@ -13,8 +13,8 @@
* {@link OO.ui.BarToolGroup BarToolGroup}, or {@link OO.ui.MenuToolGroup
MenuToolGroup}), which determine how
* the tool is displayed in the toolbar. See {@link OO.ui.Toolbar toolbars}
for an example.
*
- * For more information, please see the [OOjs UI documentation on
MediaWiki][1].
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * For more information, please see the [OOUI documentation on MediaWiki][1].
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @abstract
* @class
diff --git a/src/ToolFactory.js b/src/ToolFactory.js
index c5dd93f..08e5e47 100644
--- a/src/ToolFactory.js
+++ b/src/ToolFactory.js
@@ -3,9 +3,9 @@
* and {@link OO.ui.ToolGroupTool ToolGroupTools}) must be registered with a
tool factory. Tools are
* registered by their symbolic name. See {@link OO.ui.Toolbar toolbars} for
an example.
*
- * For more information about toolbars in general, please see the [OOjs UI
documentation on MediaWiki][1].
+ * For more information about toolbars in general, please see the [OOUI
documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @class
* @extends OO.Factory
diff --git a/src/ToolGroup.js b/src/ToolGroup.js
index fe866d2..6947162 100644
--- a/src/ToolGroup.js
+++ b/src/ToolGroup.js
@@ -9,9 +9,9 @@
* The options `exclude`, `promote`, and `demote` support the same formats.
*
* See {@link OO.ui.Toolbar toolbars} for a full example. For more information
about toolbars in general,
- * please see the [OOjs UI documentation on MediaWiki][1].
+ * please see the [OOUI documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @abstract
* @class
@@ -103,7 +103,7 @@
/**
* Show acceleration labels in tooltips.
*
- * Note: The OOjs UI library does not include an accelerator system, but does
contain
+ * Note: The OOUI library does not include an accelerator system, but does
contain
* a hook for one. To use an accelerator system, subclass the {@link
OO.ui.Toolbar toolbar} and
* override the {@link OO.ui.Toolbar#getToolAccelerator getToolAccelerator}
method, which is
* meant to return a label that describes the accelerator keys for a given
tool (e.g., 'Ctrl + M').
diff --git a/src/ToolGroupFactory.js b/src/ToolGroupFactory.js
index 6cb5a48..a929a8f 100644
--- a/src/ToolGroupFactory.js
+++ b/src/ToolGroupFactory.js
@@ -9,9 +9,9 @@
*
* See {@link OO.ui.Toolbar toolbars} for an example.
*
- * For more information about toolbars in general, please see the [OOjs UI
documentation on MediaWiki][1].
+ * For more information about toolbars in general, please see the [OOUI
documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @class
* @extends OO.Factory
diff --git a/src/Toolbar.js b/src/Toolbar.js
index d7016f5..7720b5d 100644
--- a/src/Toolbar.js
+++ b/src/Toolbar.js
@@ -520,7 +520,7 @@
/**
* Get accelerator label for tool.
*
- * The OOjs UI library does not contain an accelerator system, but this is the
hook for one. To
+ * The OOUI library does not contain an accelerator system, but this is the
hook for one. To
* use an accelerator system, subclass the toolbar and override this method,
which is meant to return a label
* that describes the accelerator keys for the tool passed (by symbolic name)
to the method.
*
diff --git a/src/Widget.js b/src/Widget.js
index cb2a65a..5220a35 100644
--- a/src/Widget.js
+++ b/src/Widget.js
@@ -1,5 +1,5 @@
/**
- * Widgets are compositions of one or more OOjs UI elements that users can
both view
+ * Widgets are compositions of one or more OOUI elements that users can both
view
* and interact with. All widgets can be configured and modified via a
standard API,
* and their state can change dynamically according to a model.
*
diff --git a/src/Window.js b/src/Window.js
index e3c97dd..19e3535 100644
--- a/src/Window.js
+++ b/src/Window.js
@@ -29,9 +29,9 @@
* methods. Note that each {@link OO.ui.Process process} is executed in
series, so asynchronous
* processing can complete. Always assume window processes are executed
asynchronously.
*
- * For more information, please see the [OOjs UI documentation on MediaWiki]
[1].
+ * For more information, please see the [OOUI documentation on MediaWiki] [1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Windows
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows
*
* @abstract
* @class
@@ -60,7 +60,7 @@
/**
* Overlay element to use for the `$overlay` configuration option of
widgets that support it.
* Things put inside of it are overlaid on top of the window and are
not bound to its dimensions.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
*
* MyDialog.prototype.initialize = function () {
* ...
diff --git a/src/WindowInstance.js b/src/WindowInstance.js
index 0e900be..67b5eef 100644
--- a/src/WindowInstance.js
+++ b/src/WindowInstance.js
@@ -5,9 +5,9 @@
* While OO.ui.WindowManager will reuse OO.ui.Window objects, each time a
window is
* opened, a new lifecycle starts.
*
- * For more information, please see the [OOjs UI documentation on MediaWiki]
[1].
+ * For more information, please see the [OOUI documentation on MediaWiki] [1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Windows
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows
*
* @class
*
diff --git a/src/WindowManager.js b/src/WindowManager.js
index e713f37..517ca45 100644
--- a/src/WindowManager.js
+++ b/src/WindowManager.js
@@ -37,9 +37,9 @@
* - a `teardown` progress notification is emitted from the `closing` promise
* - the `closing` promise is resolved. The window is now closed
*
- * See the [OOjs UI documentation on MediaWiki][1] for more information.
+ * See the [OOUI documentation on MediaWiki][1] for more information.
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Windows/Window_managers
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows/Window_managers
*
* @class
* @extends OO.ui.Element
@@ -287,9 +287,9 @@
* Get a window by its symbolic name.
*
* If the window is not yet instantiated and its symbolic name is recognized
by a factory, it will be
- * instantiated and added to the window manager automatically. Please see the
[OOjs UI documentation on MediaWiki][3]
+ * instantiated and added to the window manager automatically. Please see the
[OOUI documentation on MediaWiki][3]
* for more information about using factories.
- * [3]: https://www.mediawiki.org/wiki/OOjs_UI/Windows/Window_managers
+ * [3]: https://www.mediawiki.org/wiki/OOUI/Windows/Window_managers
*
* @param {string} name Symbolic name of the window
* @return {jQuery.Promise} Promise resolved with matching window, or rejected
with an OO.ui.Error
@@ -541,8 +541,8 @@
* Add windows to the window manager.
*
* Windows can be added by reference, symbolic name, or explicitly defined
symbolic names.
- * See the [OOjs ui documentation on MediaWiki] [2] for examples.
- * [2]: https://www.mediawiki.org/wiki/OOjs_UI/Windows/Window_managers
+ * See the [OOUI documentation on MediaWiki] [2] for examples.
+ * [2]: https://www.mediawiki.org/wiki/OOUI/Windows/Window_managers
*
* This function can be called in two manners:
*
diff --git a/src/core.js b/src/core.js
index 1dbc5c4..3a0bac4 100644
--- a/src/core.js
+++ b/src/core.js
@@ -397,7 +397,7 @@
*
* $.i18n().load( languageMap ).done( function() {
* // Replace the built-in `msg` only once we've loaded the
internationalization.
- * // OOjs UI uses `OO.ui.deferMsg` for all initially-loaded
messages. So long as
+ * // OOUI uses `OO.ui.deferMsg` for all initially-loaded
messages. So long as
* // you put off creating any widgets until this promise is
complete, no English
* // will be displayed.
* OO.ui.msg = $.i18n;
@@ -540,18 +540,4 @@
bottom: 0,
left: 0
};
-};
-
-/**
- * Get the default overlay, which is used by various widgets when they are
passed `$overlay: true`.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
- *
- * @return {jQuery} Default overlay node
- */
-OO.ui.getDefaultOverlay = function () {
- if ( !OO.ui.$defaultOverlay ) {
- OO.ui.$defaultOverlay = $( '<div>' ).addClass(
'oo-ui-defaultOverlay' );
- $( 'body' ).append( OO.ui.$defaultOverlay );
- }
- return OO.ui.$defaultOverlay;
};
diff --git a/src/dialogs/MessageDialog.js b/src/dialogs/MessageDialog.js
index 88c73c0..a2de6a1 100644
--- a/src/dialogs/MessageDialog.js
+++ b/src/dialogs/MessageDialog.js
@@ -15,7 +15,7 @@
* action (e.g., ‘ok’) and ‘reject,’ the safe action (e.g., ‘cancel’). Both
will close the window,
* passing along the selected action.
*
- * For more information and examples, please see the [OOjs UI documentation on
MediaWiki][1].
+ * For more information and examples, please see the [OOUI documentation on
MediaWiki][1].
*
* @example
* // Example: Creating and opening a message dialog window.
@@ -31,7 +31,7 @@
* message: 'This is the message'
* } );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Windows/Message_Dialogs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows/Message_Dialogs
*
* @class
* @extends OO.ui.Dialog
diff --git a/src/dialogs/ProcessDialog.js b/src/dialogs/ProcessDialog.js
index e5b853e..363f8c7 100644
--- a/src/dialogs/ProcessDialog.js
+++ b/src/dialogs/ProcessDialog.js
@@ -11,7 +11,7 @@
* a ‘primary’ action on the right (e.g., ‘Done’).
*
* Like other windows, the process dialog is managed by a {@link
OO.ui.WindowManager window manager}.
- * Please see the [OOjs UI documentation on MediaWiki][1] for more information
and examples.
+ * Please see the [OOUI documentation on MediaWiki][1] for more information
and examples.
*
* @example
* // Example: Creating and opening a process dialog window.
@@ -50,7 +50,7 @@
* windowManager.addWindows( [ dialog ] );
* windowManager.openWindow( dialog );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Windows/Process_Dialogs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows/Process_Dialogs
*
* @abstract
* @class
diff --git a/src/layouts/FieldLayout.js b/src/layouts/FieldLayout.js
index 502416f..7c42cde 100644
--- a/src/layouts/FieldLayout.js
+++ b/src/layouts/FieldLayout.js
@@ -15,9 +15,9 @@
* An inline-alignment is best used with checkboxes or radio buttons.
*
* Help text is accessed via a help icon that appears in the upper right
corner of the rendered field layout.
- * Please see the [OOjs UI documentation on MediaWiki] [1] for examples and
more information.
+ * Please see the [OOUI documentation on MediaWiki] [1] for examples and more
information.
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Layouts/Fields_and_Fieldsets
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Layouts/Fields_and_Fieldsets
*
* @class
* @extends OO.ui.Layout
@@ -36,7 +36,7 @@
* in the upper-right corner of the rendered field; clicking it will display
the text in a popup.
* For important messages, you are advised to use `notices`, as they are
always shown.
* @cfg {jQuery} [$overlay] Passed to OO.ui.PopupButtonWidget for help popup,
if `help` is given.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
*
* @throws {Error} An error is thrown if no widget is specified
*/
diff --git a/src/layouts/FieldsetLayout.js b/src/layouts/FieldsetLayout.js
index f57887d..1016516 100644
--- a/src/layouts/FieldsetLayout.js
+++ b/src/layouts/FieldsetLayout.js
@@ -2,7 +2,7 @@
* FieldsetLayouts are composed of one or more {@link OO.ui.FieldLayout
FieldLayouts},
* which each contain an individual widget and, optionally, a label. Each
Fieldset can be
* configured with a label as well. For more information and examples,
- * please see the [OOjs UI documentation on MediaWiki][1].
+ * please see the [OOUI documentation on MediaWiki][1].
*
* @example
* // Example of a fieldset layout
@@ -28,7 +28,7 @@
* ] );
* $( 'body' ).append( fieldset.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Layouts/Fields_and_Fieldsets
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Layouts/Fields_and_Fieldsets
*
* @class
* @extends OO.ui.Layout
@@ -43,7 +43,7 @@
* in the upper-right corner of the rendered field; clicking it will display
the text in a popup.
* For important messages, you are advised to use `notices`, as they are
always shown.
* @cfg {jQuery} [$overlay] Passed to OO.ui.PopupButtonWidget for help popup,
if `help` is given.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
*/
OO.ui.FieldsetLayout = function OoUiFieldsetLayout( config ) {
// Configuration initialization
diff --git a/src/layouts/FormLayout.js b/src/layouts/FormLayout.js
index 6bbf056..20d24ca 100644
--- a/src/layouts/FormLayout.js
+++ b/src/layouts/FormLayout.js
@@ -2,7 +2,7 @@
* FormLayouts are used to wrap {@link OO.ui.FieldsetLayout FieldsetLayouts}
when you intend to use browser-based
* form submission for the fields instead of handling them in JavaScript. Form
layouts can be configured with an
* HTML form action, an encoding type, and a method using the #action,
#enctype, and #method configs, respectively.
- * See the [OOjs UI documentation on MediaWiki] [1] for more information and
examples.
+ * See the [OOUI documentation on MediaWiki] [1] for more information and
examples.
*
* Only widgets from the {@link OO.ui.InputWidget InputWidget} family support
form submission. It
* includes standard form elements like {@link OO.ui.CheckboxInputWidget
checkboxes}, {@link
@@ -10,10 +10,10 @@
* some fancier controls. Some controls have both regular and InputWidget
variants, for example
* OO.ui.DropdownWidget and OO.ui.DropdownInputWidget – only the latter
support form submission and
* often have simplified APIs to match the capabilities of HTML forms.
- * See the [OOjs UI Inputs documentation on MediaWiki] [2] for more
information about InputWidgets.
+ * See the [OOUI documentation on MediaWiki] [2] for more information about
InputWidgets.
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Layouts/Forms
- * [2]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Layouts/Forms
+ * [2]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @example
* // Example of a form layout that wraps a fieldset layout
diff --git a/src/mixin.js b/src/mixin.js
index 2e30503..d477a4b 100644
--- a/src/mixin.js
+++ b/src/mixin.js
@@ -3,7 +3,7 @@
*/
/**
- * Namespace for OOjs UI mixins.
+ * Namespace for OOUI mixins.
*
* Mixins are named according to the type of object they are intended to
* be mixed in to. For example, OO.ui.mixin.GroupElement is intended to be
diff --git a/src/mixins/ButtonElement.js b/src/mixins/ButtonElement.js
index feb423d..40e3c01 100644
--- a/src/mixins/ButtonElement.js
+++ b/src/mixins/ButtonElement.js
@@ -1,9 +1,9 @@
/**
* ButtonElement is often mixed into other classes to generate a button, which
is a clickable
* interface element that can be configured with access keys for accessibility.
- * See the [OOjs UI documentation on MediaWiki] [1] for examples.
+ * See the [OOUI documentation on MediaWiki] [1] for examples.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Buttons_and_Switches#Buttons
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Buttons_and_Switches#Buttons
*
* @abstract
* @class
diff --git a/src/mixins/FlaggedElement.js b/src/mixins/FlaggedElement.js
index c2028c9..b6391d6 100644
--- a/src/mixins/FlaggedElement.js
+++ b/src/mixins/FlaggedElement.js
@@ -25,9 +25,9 @@
* $( 'body' ).append( button1.$element, button2.$element );
*
* {@link OO.ui.ActionWidget ActionWidgets}, which are a special kind of
button that execute an action, use these flags: **primary** and **safe**.
- * Please see the [OOjs UI documentation on MediaWiki] [1] for more
information.
+ * Please see the [OOUI documentation on MediaWiki] [1] for more information.
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Elements/Flagged
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Elements/Flagged
*
* @abstract
* @class
@@ -35,8 +35,8 @@
* @constructor
* @param {Object} [config] Configuration options
* @cfg {string|string[]} [flags] The name or names of the flags (e.g.,
'progressive' or 'primary') to apply.
- * Please see the [OOjs UI documentation on MediaWiki] [2] for more
information about available flags.
- * [2]: https://www.mediawiki.org/wiki/OOjs_UI/Elements/Flagged
+ * Please see the [OOUI documentation on MediaWiki] [2] for more information
about available flags.
+ * [2]: https://www.mediawiki.org/wiki/OOUI/Elements/Flagged
* @cfg {jQuery} [$flagged] The flagged element. By default,
* the flagged functionality is applied to the element created by the class
($element).
* If a different element is specified, the flagged functionality will be
applied to it instead.
diff --git a/src/mixins/GroupElement.js b/src/mixins/GroupElement.js
index 43ddf17..0b78574 100644
--- a/src/mixins/GroupElement.js
+++ b/src/mixins/GroupElement.js
@@ -1,10 +1,10 @@
/**
- * Any OOjs UI widget that contains other widgets (such as {@link
OO.ui.ButtonWidget buttons} or
+ * Any OOUI widget that contains other widgets (such as {@link
OO.ui.ButtonWidget buttons} or
* {@link OO.ui.OptionWidget options}) mixes in GroupElement. Adding,
removing, and clearing
* items from the group is done through the interface the class provides.
- * For more information, please see the [OOjs UI documentation on MediaWiki]
[1].
+ * For more information, please see the [OOUI documentation on MediaWiki] [1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Elements/Groups
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Elements/Groups
*
* @abstract
* @mixins OO.EmitterList
diff --git a/src/mixins/IconElement.js b/src/mixins/IconElement.js
index c969de9..dd6c697 100644
--- a/src/mixins/IconElement.js
+++ b/src/mixins/IconElement.js
@@ -2,10 +2,10 @@
* IconElement is often mixed into other classes to generate an icon.
* Icons are graphics, about the size of normal text. They are used to aid the
user
* in locating a control or to convey information in a space-efficient way.
See the
- * [OOjs UI documentation on MediaWiki] [1] for a list of icons
+ * [OOUI documentation on MediaWiki] [1] for a list of icons
* included in the library.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Icons
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Icons
*
* @abstract
* @class
@@ -31,8 +31,8 @@
* Example of an i18n map:
*
* { default: 'bold-a', en: 'bold-b', de: 'bold-f' }
- * See the [OOjs UI documentation on MediaWiki] [2] for a list of icons
included in the library.
- * [2]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Icons
+ * See the [OOUI documentation on MediaWiki] [2] for a list of icons included
in the library.
+ * [2]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Icons
* @cfg {string|Function} [iconTitle] A text string used as the icon title, or
a function that returns title
* text. The icon title is displayed when users move the mouse over the icon.
*/
diff --git a/src/mixins/IndicatorElement.js b/src/mixins/IndicatorElement.js
index 9fd2bcf..c29ee25 100644
--- a/src/mixins/IndicatorElement.js
+++ b/src/mixins/IndicatorElement.js
@@ -8,9 +8,9 @@
* that opens a menu instead of performing an action directly, for example).
*
* For a list of indicators included in the library, please see the
- * [OOjs UI documentation on MediaWiki] [1].
+ * [OOUI documentation on MediaWiki] [1].
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Indicators
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Indicators
*
* @abstract
* @class
@@ -20,9 +20,9 @@
* @cfg {jQuery} [$indicator] The indicator element created by the class. If
this
* configuration is omitted, the indicator element will use a generated
`<span>`.
* @cfg {string} [indicator] Symbolic name of the indicator (e.g., ‘alert’ or
‘down’).
- * See the [OOjs UI documentation on MediaWiki][2] for a list of indicators
included
+ * See the [OOUI documentation on MediaWiki][2] for a list of indicators
included
* in the library.
- * [2]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Indicators
+ * [2]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Indicators
* @cfg {string|Function} [indicatorTitle] A text string used as the indicator
title,
* or a function that returns title text. The indicator title is displayed
when users move
* the mouse over the indicator.
diff --git a/src/mixins/LabelElement.js b/src/mixins/LabelElement.js
index 4b23f08..384f971 100644
--- a/src/mixins/LabelElement.js
+++ b/src/mixins/LabelElement.js
@@ -1,9 +1,9 @@
/**
* LabelElement is often mixed into other classes to generate a label, which
* helps identify the function of an interface element.
- * See the [OOjs UI documentation on MediaWiki] [1] for more information.
+ * See the [OOUI documentation on MediaWiki] [1] for more information.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Labels
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Labels
*
* @abstract
* @class
@@ -14,8 +14,8 @@
* configuration is omitted, the label element will use a generated `<span>`.
* @cfg {jQuery|string|Function|OO.ui.HtmlSnippet} [label] The label text. The
label can be specified
* as a plaintext string, a jQuery selection of elements, or a function that
will produce a string
- * in the future. See the [OOjs UI documentation on MediaWiki] [2] for
examples.
- * [2]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Labels
+ * in the future. See the [OOUI documentation on MediaWiki] [2] for examples.
+ * [2]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Labels
*/
OO.ui.mixin.LabelElement = function OoUiMixinLabelElement( config ) {
// Configuration initialization
diff --git a/src/mixins/LookupElement.js b/src/mixins/LookupElement.js
index 3b0771e..1041911 100644
--- a/src/mixins/LookupElement.js
+++ b/src/mixins/LookupElement.js
@@ -8,9 +8,9 @@
* not the desired behavior, disable lookup menus with the #setLookupsDisabled
method, then set the value, then
* re-enable lookups.
*
- * See the [OOjs UI demos][1] for an example.
+ * See the [OOUI demos][1] for an example.
*
- * [1]:
https://tools.wmflabs.org/oojs-ui/oojs-ui/demos/index.html#widgets-apex-vector-ltr
+ * [1]:
https://doc.wikimedia.org/oojs-ui/master/demos/#LookupElement-try-inputting-an-integer
*
* @class
* @abstract
@@ -19,7 +19,7 @@
* @constructor
* @param {Object} [config] Configuration options
* @cfg {jQuery} [$overlay] Overlay for the lookup menu; defaults to relative
positioning.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
* @cfg {jQuery} [$container=this.$element] The container element. The lookup
menu is rendered beneath the specified element.
* @cfg {boolean} [allowSuggestionsWhenEmpty=false] Request and display a
lookup menu when the text input is empty.
* By default, the lookup menu is not generated and displayed until the user
begins to type.
diff --git a/src/toolgroups/BarToolGroup.js b/src/toolgroups/BarToolGroup.js
index f302546..45d0352 100644
--- a/src/toolgroups/BarToolGroup.js
+++ b/src/toolgroups/BarToolGroup.js
@@ -85,9 +85,9 @@
* toolbar.initialize();
*
* For more information about how to add tools to a bar tool group, please see
{@link OO.ui.ToolGroup toolgroup}.
- * For more information about toolbars in general, please see the [OOjs UI
documentation on MediaWiki][1].
+ * For more information about toolbars in general, please see the [OOUI
documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @class
* @extends OO.ui.ToolGroup
diff --git a/src/toolgroups/ListToolGroup.js b/src/toolgroups/ListToolGroup.js
index 26eeb35..778130c 100644
--- a/src/toolgroups/ListToolGroup.js
+++ b/src/toolgroups/ListToolGroup.js
@@ -70,9 +70,9 @@
* // Build the toolbar. This must be done after the toolbar has been
appended to the document.
* toolbar.initialize();
*
- * For more information about toolbars in general, please see the [OOjs UI
documentation on MediaWiki][1].
+ * For more information about toolbars in general, please see the [OOUI
documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @class
* @extends OO.ui.PopupToolGroup
diff --git a/src/toolgroups/MenuToolGroup.js b/src/toolgroups/MenuToolGroup.js
index 57bb038..45d047d 100644
--- a/src/toolgroups/MenuToolGroup.js
+++ b/src/toolgroups/MenuToolGroup.js
@@ -90,9 +90,9 @@
* toolbar.emit( 'updateState' );
*
* For more information about how to add tools to a MenuToolGroup, please see
{@link OO.ui.ToolGroup toolgroup}.
- * For more information about toolbars in general, please see the [OOjs UI
documentation on MediaWiki] [1].
+ * For more information about toolbars in general, please see the [OOUI
documentation on MediaWiki] [1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @class
* @extends OO.ui.PopupToolGroup
diff --git a/src/tools/PopupTool.js b/src/tools/PopupTool.js
index 30db9ad..8717051 100644
--- a/src/tools/PopupTool.js
+++ b/src/tools/PopupTool.js
@@ -20,9 +20,9 @@
* toolFactory.register( HelpTool );
*
* For an example of a toolbar that contains a popup tool, see {@link
OO.ui.Toolbar toolbars}. For more information about
- * toolbars in genreral, please see the [OOjs UI documentation on
MediaWiki][1].
+ * toolbars in general, please see the [OOUI documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars
*
* @abstract
* @class
diff --git a/src/tools/ToolGroupTool.js b/src/tools/ToolGroupTool.js
index 7e722de..4d74998 100644
--- a/src/tools/ToolGroupTool.js
+++ b/src/tools/ToolGroupTool.js
@@ -20,11 +20,11 @@
* };
* toolFactory.register( SettingsTool );
*
- * For more information, please see the [OOjs UI documentation on
MediaWiki][1].
+ * For more information, please see the [OOUI documentation on MediaWiki][1].
*
* Please note that this implementation is subject to change per [T74159] [2].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Toolbars#ToolGroupTool
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Toolbars#ToolGroupTool
* [2]: https://phabricator.wikimedia.org/T74159
*
* @abstract
diff --git a/src/widgets/ActionWidget.js b/src/widgets/ActionWidget.js
index 4095efd..bd21623 100644
--- a/src/widgets/ActionWidget.js
+++ b/src/widgets/ActionWidget.js
@@ -4,10 +4,10 @@
* of the actions.
*
* Both actions and action sets are primarily used with {@link OO.ui.Dialog
Dialogs}.
- * Please see the [OOjs UI documentation on MediaWiki] [1] for more information
+ * Please see the [OOUI documentation on MediaWiki] [1] for more information
* and examples.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Windows/Process_Dialogs#Action_sets
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Windows/Process_Dialogs#Action_sets
*
* @class
* @extends OO.ui.ButtonWidget
diff --git a/src/widgets/ButtonInputWidget.js b/src/widgets/ButtonInputWidget.js
index 31b478b..6619ed8 100644
--- a/src/widgets/ButtonInputWidget.js
+++ b/src/widgets/ButtonInputWidget.js
@@ -3,7 +3,7 @@
* a OO.ui.FormLayout. If you do not need the button to work with HTML forms,
you probably
* want to use OO.ui.ButtonWidget instead. Button input widgets can be
rendered as either an
* HTML `<button>` (the default) or an HTML `<input>` tags. See the
- * [OOjs UI documentation on MediaWiki] [1] for more information.
+ * [OOUI documentation on MediaWiki] [1] for more information.
*
* @example
* // A ButtonInputWidget rendered as an HTML button, the default.
@@ -14,7 +14,7 @@
* } );
* $( 'body' ).append( button.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs#Button_inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs#Button_inputs
*
* @class
* @extends OO.ui.InputWidget
diff --git a/src/widgets/ButtonOptionWidget.js
b/src/widgets/ButtonOptionWidget.js
index 3d295b9..9bf0249 100644
--- a/src/widgets/ButtonOptionWidget.js
+++ b/src/widgets/ButtonOptionWidget.js
@@ -2,9 +2,9 @@
* ButtonOptionWidget is a special type of {@link OO.ui.mixin.ButtonElement
button element} that
* can be selected and configured with data. The class is
* used with OO.ui.ButtonSelectWidget to create a selection of button options.
Please see the
- * [OOjs UI documentation on MediaWiki] [1] for more information.
+ * [OOUI documentation on MediaWiki] [1] for more information.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Button_selects_and_options
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Button_selects_and_options
*
* @class
* @extends OO.ui.OptionWidget
diff --git a/src/widgets/ButtonSelectWidget.js
b/src/widgets/ButtonSelectWidget.js
index b738a58..4e007c7 100644
--- a/src/widgets/ButtonSelectWidget.js
+++ b/src/widgets/ButtonSelectWidget.js
@@ -3,7 +3,7 @@
* button options and is used together with
* OO.ui.ButtonOptionWidget. The ButtonSelectWidget provides an interface for
* highlighting, choosing, and selecting mutually exclusive options. Please see
- * the [OOjs UI documentation on MediaWiki] [1] for more information.
+ * the [OOUI documentation on MediaWiki] [1] for more information.
*
* @example
* // Example: A ButtonSelectWidget that contains three ButtonOptionWidgets
@@ -30,7 +30,7 @@
* } );
* $( 'body' ).append( buttonSelect.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*
* @class
* @extends OO.ui.SelectWidget
diff --git a/src/widgets/ButtonWidget.js b/src/widgets/ButtonWidget.js
index c0cd9a4..20eedaf 100644
--- a/src/widgets/ButtonWidget.js
+++ b/src/widgets/ButtonWidget.js
@@ -1,10 +1,10 @@
/**
* ButtonWidget is a generic widget for buttons. A wide variety of looks,
* feels, and functionality can be customized via the class’s configuration
options
- * and methods. Please see the [OOjs UI documentation on MediaWiki] [1] for
more information
+ * and methods. Please see the [OOUI documentation on MediaWiki] [1] for more
information
* and examples.
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Buttons_and_Switches
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Buttons_and_Switches
*
* @example
* // A button widget
diff --git a/src/widgets/CapsuleMultiselectWidget.js
b/src/widgets/CapsuleMultiselectWidget.js
index eb4c747..f1ae151 100644
--- a/src/widgets/CapsuleMultiselectWidget.js
+++ b/src/widgets/CapsuleMultiselectWidget.js
@@ -2,7 +2,7 @@
* CapsuleMultiselectWidgets are something like a {@link
OO.ui.ComboBoxInputWidget combo box widget}
* that allows for selecting multiple values.
*
- * For more information about menus and options, please see the [OOjs UI
documentation on MediaWiki][1].
+ * For more information about menus and options, please see the [OOUI
documentation on MediaWiki][1].
*
* @example
* // Example: A CapsuleMultiselectWidget.
@@ -36,7 +36,7 @@
* } );
* $( 'body' ).append( capsule.$element );
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Menu_selects_and_options
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Menu_selects_and_options
*
* @class
* @extends OO.ui.Widget
@@ -64,7 +64,7 @@
* its containing `<div>`. The specified overlay layer is usually on top of
* the containing `<div>` and has a larger area. By default, the menu uses
* relative positioning.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
*/
OO.ui.CapsuleMultiselectWidget = function OoUiCapsuleMultiselectWidget( config
) {
var $tabFocus;
diff --git a/src/widgets/CheckboxInputWidget.js
b/src/widgets/CheckboxInputWidget.js
index ba0cf4e..46e29c2 100644
--- a/src/widgets/CheckboxInputWidget.js
+++ b/src/widgets/CheckboxInputWidget.js
@@ -2,7 +2,7 @@
* CheckboxInputWidgets, like HTML checkboxes, can be selected and/or
configured with a value.
* Note that these {@link OO.ui.InputWidget input widgets} are best laid out
* in {@link OO.ui.FieldLayout field layouts} that use the {@link
OO.ui.FieldLayout#align inline}
- * alignment. For more information, please see the [OOjs UI documentation on
MediaWiki][1].
+ * alignment. For more information, please see the [OOUI documentation on
MediaWiki][1].
*
* This widget can be used inside an HTML form, such as a OO.ui.FormLayout.
*
@@ -30,7 +30,7 @@
* ] );
* $( 'body' ).append( fieldset.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @class
* @extends OO.ui.InputWidget
diff --git a/src/widgets/CheckboxMultioptionWidget.js
b/src/widgets/CheckboxMultioptionWidget.js
index 0ff2d22..fda8a39 100644
--- a/src/widgets/CheckboxMultioptionWidget.js
+++ b/src/widgets/CheckboxMultioptionWidget.js
@@ -1,9 +1,9 @@
/**
* CheckboxMultioptionWidget is an option widget that looks like a checkbox.
* The class is used with OO.ui.CheckboxMultiselectWidget to create a
selection of checkbox options.
- * Please see the [OOjs UI documentation on MediaWiki] [1] for more
information.
+ * Please see the [OOUI documentation on MediaWiki] [1] for more information.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Button_selects_and_option
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Button_selects_and_option
*
* @class
* @extends OO.ui.MultioptionWidget
diff --git a/src/widgets/CheckboxMultiselectInputWidget.js
b/src/widgets/CheckboxMultiselectInputWidget.js
index d923451..9efe27d 100644
--- a/src/widgets/CheckboxMultiselectInputWidget.js
+++ b/src/widgets/CheckboxMultiselectInputWidget.js
@@ -2,7 +2,7 @@
* CheckboxMultiselectInputWidget is a
* {@link OO.ui.CheckboxMultiselectWidget CheckboxMultiselectWidget} intended
to be used within a
* HTML form, such as a OO.ui.FormLayout. The selected values are synchronized
with the value of
- * HTML `<input type=checkbox>` tags. Please see the [OOjs UI documentation on
MediaWiki][1] for
+ * HTML `<input type=checkbox>` tags. Please see the [OOUI documentation on
MediaWiki][1] for
* more information about input widgets.
*
* @example
@@ -16,7 +16,7 @@
* } );
* $( 'body' ).append( multiselectInput.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @class
* @extends OO.ui.InputWidget
diff --git a/src/widgets/CheckboxMultiselectWidget.js
b/src/widgets/CheckboxMultiselectWidget.js
index 9e3f48c..a8918b0 100644
--- a/src/widgets/CheckboxMultiselectWidget.js
+++ b/src/widgets/CheckboxMultiselectWidget.js
@@ -2,7 +2,7 @@
* CheckboxMultiselectWidget is a {@link OO.ui.MultiselectWidget multiselect
widget} that contains
* checkboxes and is used together with OO.ui.CheckboxMultioptionWidget. The
* CheckboxMultiselectWidget provides an interface for adding, removing and
selecting options.
- * Please see the [OOjs UI documentation on MediaWiki][1] for more information.
+ * Please see the [OOUI documentation on MediaWiki][1] for more information.
*
* If you want to use this within an HTML form, such as a OO.ui.FormLayout, use
* OO.ui.CheckboxMultiselectInputWidget instead.
@@ -26,7 +26,7 @@
*
* $( 'body' ).append( multiselect.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*
* @class
* @extends OO.ui.MultiselectWidget
diff --git a/src/widgets/ComboBoxInputWidget.js
b/src/widgets/ComboBoxInputWidget.js
index c0fafd8..7e2b81f 100644
--- a/src/widgets/ComboBoxInputWidget.js
+++ b/src/widgets/ComboBoxInputWidget.js
@@ -14,7 +14,7 @@
*
* This widget can be used inside an HTML form, such as a OO.ui.FormLayout.
*
- * For more information about menus and options, please see the [OOjs UI
documentation on MediaWiki][1].
+ * For more information about menus and options, please see the [OOUI
documentation on MediaWiki][1].
*
* @example
* // Example: A ComboBoxInputWidget.
@@ -49,7 +49,7 @@
* } );
* $( 'body' ).append( comboBox.$element );
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Menu_selects_and_options
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Menu_selects_and_options
*
* @class
* @extends OO.ui.TextInputWidget
@@ -61,7 +61,7 @@
* @cfg {jQuery} [$overlay] Render the menu into a separate layer. This
configuration is useful in cases where
* the expanded menu is larger than its containing `<div>`. The specified
overlay layer is usually on top of the
* containing `<div>` and has a larger area. By default, the menu uses
relative positioning.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
*/
OO.ui.ComboBoxInputWidget = function OoUiComboBoxInputWidget( config ) {
// Configuration initialization
@@ -81,7 +81,7 @@
OO.ui.ComboBoxInputWidget.parent.call( this, config );
// Properties
- this.$overlay = ( config.$overlay === true ? OO.ui.getDefaultOverlay()
: config.$overlay ) || this.$element;
+ this.$overlay = config.$overlay || this.$element;
this.dropdownButton = new OO.ui.ButtonWidget( {
classes: [ 'oo-ui-comboBoxInputWidget-dropdownButton' ],
indicator: 'down',
@@ -163,7 +163,7 @@
* @param {string} value New value
*/
OO.ui.ComboBoxInputWidget.prototype.onInputChange = function ( value ) {
- var match = this.menu.findItemFromData( value );
+ var match = this.menu.getItemFromData( value );
this.menu.selectItem( match );
if ( this.menu.findHighlightedItem() ) {
@@ -212,7 +212,7 @@
* @private
*/
OO.ui.ComboBoxInputWidget.prototype.onMenuItemsChange = function () {
- var match = this.menu.findItemFromData( this.getValue() );
+ var match = this.menu.getItemFromData( this.getValue() );
this.menu.selectItem( match );
if ( this.menu.findHighlightedItem() ) {
this.menu.highlightItem( match );
diff --git a/src/widgets/DecoratedOptionWidget.js
b/src/widgets/DecoratedOptionWidget.js
index feba99b..1c4e6cd 100644
--- a/src/widgets/DecoratedOptionWidget.js
+++ b/src/widgets/DecoratedOptionWidget.js
@@ -3,7 +3,7 @@
* with an {@link OO.ui.mixin.IconElement icon} and/or {@link
OO.ui.mixin.IndicatorElement indicator}.
* This class is used with OO.ui.SelectWidget to create a selection of
mutually exclusive
* options. For more information about options and selects, please see the
- * [OOjs UI documentation on MediaWiki][1].
+ * [OOUI documentation on MediaWiki][1].
*
* @example
* // Decorated options in a select widget
@@ -23,7 +23,7 @@
* } );
* $( 'body' ).append( select.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*
* @class
* @extends OO.ui.OptionWidget
diff --git a/src/widgets/DropdownInputWidget.js
b/src/widgets/DropdownInputWidget.js
index c976cf0..0f83f0c 100644
--- a/src/widgets/DropdownInputWidget.js
+++ b/src/widgets/DropdownInputWidget.js
@@ -1,7 +1,7 @@
/**
* DropdownInputWidget is a {@link OO.ui.DropdownWidget DropdownWidget}
intended to be used
* within an HTML form, such as a OO.ui.FormLayout. The selected value is
synchronized with the value
- * of a hidden HTML `input` tag. Please see the [OOjs UI documentation on
MediaWiki][1] for
+ * of a hidden HTML `input` tag. Please see the [OOUI documentation on
MediaWiki][1] for
* more information about input widgets.
*
* A DropdownInputWidget always has a value (one of the options is always
selected), unless there
@@ -21,7 +21,7 @@
* } );
* $( 'body' ).append( dropdownInput.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @class
* @extends OO.ui.InputWidget
diff --git a/src/widgets/DropdownWidget.js b/src/widgets/DropdownWidget.js
index 2ff930e..4dcd934 100644
--- a/src/widgets/DropdownWidget.js
+++ b/src/widgets/DropdownWidget.js
@@ -34,9 +34,9 @@
*
* dropDown.getMenu().getSelectedItem().getData(); // returns 'b'
*
- * For more information, please see the [OOjs UI documentation on MediaWiki]
[1].
+ * For more information, please see the [OOUI documentation on MediaWiki] [1].
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Menu_selects_and_options
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Menu_selects_and_options
*
* @class
* @extends OO.ui.Widget
@@ -52,7 +52,7 @@
* @cfg {jQuery} [$overlay] Render the menu into a separate layer. This
configuration is useful in cases where
* the expanded menu is larger than its containing `<div>`. The specified
overlay layer is usually on top of the
* containing `<div>` and has a larger area. By default, the menu uses
relative positioning.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
*/
OO.ui.DropdownWidget = function OoUiDropdownWidget( config ) {
// Configuration initialization
@@ -63,7 +63,7 @@
// Properties (must be set before TabIndexedElement constructor call)
this.$handle = $( '<span>' );
- this.$overlay = ( config.$overlay === true ? OO.ui.getDefaultOverlay()
: config.$overlay ) || this.$element;
+ this.$overlay = config.$overlay || this.$element;
// Mixin constructors
OO.ui.mixin.IconElement.call( this, config );
diff --git a/src/widgets/IconWidget.js b/src/widgets/IconWidget.js
index 458ee0f..de85b55 100644
--- a/src/widgets/IconWidget.js
+++ b/src/widgets/IconWidget.js
@@ -1,6 +1,6 @@
/**
* IconWidget is a generic widget for {@link OO.ui.mixin.IconElement icons}.
In general, IconWidgets should be used with OO.ui.LabelWidget,
- * which creates a label that identifies the icon’s function. See the [OOjs UI
documentation on MediaWiki] [1]
+ * which creates a label that identifies the icon’s function. See the [OOUI
documentation on MediaWiki] [1]
* for a list of icons included in the library.
*
* @example
@@ -15,7 +15,7 @@
* } );
* $( 'body' ).append( myIcon.$element, iconLabel.$element );
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Icons
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Icons
*
* @class
* @extends OO.ui.Widget
diff --git a/src/widgets/IndicatorWidget.js b/src/widgets/IndicatorWidget.js
index cfe5b7e..20b88c6 100644
--- a/src/widgets/IndicatorWidget.js
+++ b/src/widgets/IndicatorWidget.js
@@ -1,7 +1,7 @@
/**
* IndicatorWidgets create indicators, which are small graphics that are
generally used to draw
* attention to the status of an item or to clarify the function of a control.
For a list of
- * indicators included in the library, please see the [OOjs UI documentation
on MediaWiki][1].
+ * indicators included in the library, please see the [OOUI documentation on
MediaWiki][1].
*
* @example
* // Example of an indicator widget
@@ -16,7 +16,7 @@
* ] );
* $( 'body' ).append( fieldset.$element );
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Icons,_Indicators,_and_Labels#Indicators
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Icons,_Indicators,_and_Labels#Indicators
*
* @class
* @extends OO.ui.Widget
diff --git a/src/widgets/InputWidget.js b/src/widgets/InputWidget.js
index a3b8f09..dea9a20 100644
--- a/src/widgets/InputWidget.js
+++ b/src/widgets/InputWidget.js
@@ -2,9 +2,9 @@
* InputWidget is the base class for all input widgets, which
* include {@link OO.ui.TextInputWidget text inputs}, {@link
OO.ui.CheckboxInputWidget checkbox inputs},
* {@link OO.ui.RadioInputWidget radio inputs}, and {@link
OO.ui.ButtonInputWidget button inputs}.
- * See the [OOjs UI documentation on MediaWiki] [1] for more information and
examples.
+ * See the [OOUI documentation on MediaWiki] [1] for more information and
examples.
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @abstract
* @class
diff --git a/src/widgets/MenuOptionWidget.js b/src/widgets/MenuOptionWidget.js
index a9d5009..77b0871 100644
--- a/src/widgets/MenuOptionWidget.js
+++ b/src/widgets/MenuOptionWidget.js
@@ -1,9 +1,9 @@
/**
* MenuOptionWidget is an option widget that looks like a menu item. The class
is used with
* OO.ui.MenuSelectWidget to create a menu of mutually exclusive options.
Please see
- * the [OOjs UI documentation on MediaWiki] [1] for more information.
+ * the [OOUI documentation on MediaWiki] [1] for more information.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Menu_selects_and_options
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Menu_selects_and_options
*
* @class
* @extends OO.ui.DecoratedOptionWidget
diff --git a/src/widgets/MenuSelectWidget.js b/src/widgets/MenuSelectWidget.js
index 5beb7b0..2a87f8b 100644
--- a/src/widgets/MenuSelectWidget.js
+++ b/src/widgets/MenuSelectWidget.js
@@ -18,8 +18,8 @@
*
* Unlike most widgets, MenuSelectWidget is initially hidden and must be shown
by calling #toggle.
*
- * Please see the [OOjs UI documentation on MediaWiki][1] for more information.
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * Please see the [OOUI documentation on MediaWiki][1] for more information.
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*
* @class
* @extends OO.ui.SelectWidget
@@ -357,11 +357,11 @@
this.togglePositioning( !!this.$floatableContainer );
this.toggleClipping( true );
- if ( this.isClippedVertically() ||
this.isFloatableOutOfView() ) {
+ if ( this.isClippedVertically() ) {
// If opening the menu downwards causes it to
be clipped, flip it to open upwards instead
belowHeight = this.$element.height();
this.setVerticalPosition( 'above' );
- if ( this.isClippedVertically() ||
this.isFloatableOutOfView() ) {
+ if ( this.isClippedVertically() ) {
// If opening upwards also causes it to
be clipped, flip it to open in whichever direction
// we have more space
aboveHeight = this.$element.height();
diff --git a/src/widgets/MenuTagMultiselectWidget.js
b/src/widgets/MenuTagMultiselectWidget.js
index 97b4e2b..e729f0f 100644
--- a/src/widgets/MenuTagMultiselectWidget.js
+++ b/src/widgets/MenuTagMultiselectWidget.js
@@ -2,6 +2,8 @@
* MenuTagMultiselectWidget is a {@link OO.ui.TagMultiselectWidget
OO.ui.TagMultiselectWidget} intended
* to use a menu of selectable options.
*
+ * For more information about menus and options, please see the [OOUI
documentation on MediaWiki][1].
+ *
* @example
* // Example: A basic MenuTagMultiselectWidget.
* var widget = new OO.ui.MenuTagMultiselectWidget( {
@@ -15,6 +17,8 @@
* } );
* $( 'body' ).append( widget.$element );
*
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Menu_selects_and_options
+ *
* @class
* @extends OO.ui.TagMultiselectWidget
*
@@ -22,7 +26,7 @@
* @param {Object} [config] Configuration object
* @cfg {Object} [menu] Configuration object for the menu widget
* @cfg {jQuery} [$overlay] An overlay for the menu.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
* @cfg {Object[]} [options=[]] Array of menu options in the format `{ data:
…, label: … }`
*/
OO.ui.MenuTagMultiselectWidget = function OoUiMenuTagMultiselectWidget( config
) {
@@ -31,7 +35,7 @@
// Parent constructor
OO.ui.MenuTagMultiselectWidget.parent.call( this, config );
- this.$overlay = ( config.$overlay === true ? OO.ui.getDefaultOverlay()
: config.$overlay ) || this.$element;
+ this.$overlay = config.$overlay || this.$element;
this.menu = this.createMenuWidget( $.extend( {
widget: this,
@@ -39,7 +43,7 @@
$input: this.hasInput ? this.input.$input : null,
filterFromInput: !!this.hasInput,
$autoCloseIgnore: this.hasInput ?
- this.input.$element : $( [] ),
+ this.input.$element.add( this.$overlay ) :
this.$overlay,
$floatableContainer: this.hasInput && this.inputPosition ===
'outline' ?
this.input.$element : this.$element,
$overlay: this.$overlay,
@@ -126,16 +130,11 @@
* @inheritdoc
*/
OO.ui.MenuTagMultiselectWidget.prototype.onTagSelect = function ( tagItem ) {
- var menuItem = this.menu.findItemFromData( tagItem.getData() );
+ var menuItem = this.menu.getItemFromData( tagItem.getData() );
// Override the base behavior from TagMultiselectWidget; the base
behavior
// in TagMultiselectWidget is to remove the tag to edit it in the input,
// but in our case, we want to utilize the menu selection behavior, and
// definitely not remove the item.
-
- // If there is an input that is used for filtering, erase the value so
we don't filter
- if ( this.hasInput && this.menu.filterFromInput ) {
- this.input.setValue( '' );
- }
// Select the menu item
this.menu.selectItem( menuItem );
@@ -150,7 +149,7 @@
var inputValue = this.input.getValue(),
validated = false,
highlightedItem = this.menu.findHighlightedItem(),
- item = this.menu.findItemFromData( inputValue );
+ item = this.menu.getItemFromData( inputValue );
// Override the parent method so we add from the menu
// rather than directly from the input
diff --git a/src/widgets/MultioptionWidget.js b/src/widgets/MultioptionWidget.js
index 646dc75..995e03d 100644
--- a/src/widgets/MultioptionWidget.js
+++ b/src/widgets/MultioptionWidget.js
@@ -2,9 +2,9 @@
* MultioptionWidgets are special elements that can be selected and configured
with data. The
* data is often unique for each option, but it does not have to be.
MultioptionWidgets are used
* with OO.ui.SelectWidget to create a selection of mutually exclusive
options. For more information
- * and examples, please see the [OOjs UI documentation on MediaWiki][1].
+ * and examples, please see the [OOUI documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Multioptions
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Multioptions
*
* @class
* @extends OO.ui.Widget
diff --git a/src/widgets/MultiselectWidget.js b/src/widgets/MultiselectWidget.js
index f985b7a..4080653 100644
--- a/src/widgets/MultiselectWidget.js
+++ b/src/widgets/MultiselectWidget.js
@@ -1,9 +1,9 @@
/**
* MultiselectWidget allows selecting multiple options from a list.
*
- * For more information about menus and options, please see the [OOjs UI
documentation on MediaWiki][1].
+ * For more information about menus and options, please see the [OOUI
documentation on MediaWiki][1].
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Menu_selects_and_options
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Menu_selects_and_options
*
* @class
* @abstract
diff --git a/src/widgets/OptionWidget.js b/src/widgets/OptionWidget.js
index 5c73578..38b1eea 100644
--- a/src/widgets/OptionWidget.js
+++ b/src/widgets/OptionWidget.js
@@ -2,9 +2,9 @@
* OptionWidgets are special elements that can be selected and configured with
data. The
* data is often unique for each option, but it does not have to be.
OptionWidgets are used
* with OO.ui.SelectWidget to create a selection of mutually exclusive
options. For more information
- * and examples, please see the [OOjs UI documentation on MediaWiki][1].
+ * and examples, please see the [OOUI documentation on MediaWiki][1].
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*
* @class
* @extends OO.ui.Widget
diff --git a/src/widgets/PopupButtonWidget.js b/src/widgets/PopupButtonWidget.js
index ba9e65a..bf15ece 100644
--- a/src/widgets/PopupButtonWidget.js
+++ b/src/widgets/PopupButtonWidget.js
@@ -25,7 +25,7 @@
* @cfg {jQuery} [$overlay] Render the popup into a separate layer. This
configuration is useful in cases where
* the expanded popup is larger than its containing `<div>`. The specified
overlay layer is usually on top of the
* containing `<div>` and has a larger area. By default, the popup uses
relative positioning.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
*/
OO.ui.PopupButtonWidget = function OoUiPopupButtonWidget( config ) {
// Configuration initialization
diff --git a/src/widgets/PopupTagMultiselectWidget.js
b/src/widgets/PopupTagMultiselectWidget.js
index 8bd61a7..84c8880 100644
--- a/src/widgets/PopupTagMultiselectWidget.js
+++ b/src/widgets/PopupTagMultiselectWidget.js
@@ -23,7 +23,7 @@
*
* @param {Object} config Configuration object
* @cfg {jQuery} [$overlay] An overlay for the popup.
- * See <https://www.mediawiki.org/wiki/OOjs_UI/Concepts#Overlays>.
+ * See <https://www.mediawiki.org/wiki/OOUI/Concepts#Overlays>.
* @cfg {Object} [popup] Configuration options for the popup
* @cfg {OO.ui.InputWidget} [popupInput] An input widget inside the popup that
will be
* focused when the popup is opened and will be used as replacement for the
diff --git a/src/widgets/PopupWidget.js b/src/widgets/PopupWidget.js
index 6711cbc..998b7c6 100644
--- a/src/widgets/PopupWidget.js
+++ b/src/widgets/PopupWidget.js
@@ -1,7 +1,7 @@
/**
* PopupWidget is a container for content. The popup is overlaid and
positioned absolutely.
* By default, each popup has an anchor that points toward its origin.
- * Please see the [OOjs UI documentation on Mediawiki] [1] for more
information and examples.
+ * Please see the [OOUI documentation on Mediawiki] [1] for more information
and examples.
*
* Unlike most widgets, PopupWidget is initially hidden and must be shown by
calling #toggle.
*
@@ -17,7 +17,7 @@
* // To display the popup, toggle the visibility to 'true'.
* popup.toggle( true );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Popups
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Popups
*
* @class
* @extends OO.ui.Widget
@@ -54,16 +54,16 @@
* 'above' and 'below', or between 'before' and 'after', if there is not
enough space in the
* desired direction to display the popup without clipping
* @cfg {jQuery} [$container] Constrain the popup to the boundaries of the
specified container.
- * See the [OOjs UI docs on MediaWiki][3] for an example.
- * [3]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Popups#containerExample
+ * See the [OOUI docs on MediaWiki][3] for an example.
+ * [3]: https://www.mediawiki.org/wiki/OOUI/Widgets/Popups#containerExample
* @cfg {number} [containerPadding=10] Padding between the popup and its
container, specified as a number of pixels.
* @cfg {jQuery} [$content] Content to append to the popup's body
* @cfg {jQuery} [$footer] Content to append to the popup's footer
* @cfg {boolean} [autoClose=false] Automatically close the popup when it
loses focus.
* @cfg {jQuery} [$autoCloseIgnore] Elements that will not close the popup
when clicked.
- * This config option is only relevant if #autoClose is set to `true`. See
the [OOjs UI docs on MediaWiki][2]
+ * This config option is only relevant if #autoClose is set to `true`. See
the [OOUI docs on MediaWiki][2]
* for an example.
- * [2]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Popups#autocloseExample
+ * [2]: https://www.mediawiki.org/wiki/OOUI/Widgets/Popups#autocloseExample
* @cfg {boolean} [head=false] Show a popup header that contains a #label (if
specified) and close
* button.
* @cfg {boolean} [padded=false] Add padding to the popup's body
@@ -340,13 +340,13 @@
if ( this.autoFlip ) {
if ( this.popupPosition === 'above' ||
this.popupPosition === 'below' ) {
- if ( this.isClippedVertically() ||
this.isFloatableOutOfView() ) {
+ if ( this.isClippedVertically() ) {
// If opening the popup in the
normal direction causes it to be clipped, open
// in the opposite one instead
normalHeight =
this.$element.height();
this.isAutoFlipped =
!this.isAutoFlipped;
this.position();
- if ( this.isClippedVertically()
|| this.isFloatableOutOfView() ) {
+ if ( this.isClippedVertically()
) {
// If that also causes
it to be clipped, open in whichever direction
// we have more space
oppositeHeight =
this.$element.height();
@@ -358,7 +358,7 @@
}
}
if ( this.popupPosition === 'before' ||
this.popupPosition === 'after' ) {
- if ( this.isClippedHorizontally() ||
this.isFloatableOutOfView() ) {
+ if ( this.isClippedHorizontally() ) {
// If opening the popup in the
normal direction causes it to be clipped, open
// in the opposite one instead
normalWidth =
this.$element.width();
@@ -368,7 +368,7 @@
this.toggleClipping( false );
this.position();
this.toggleClipping( true );
- if (
this.isClippedHorizontally() || this.isFloatableOutOfView() ) {
+ if (
this.isClippedHorizontally() ) {
// If that also causes
it to be clipped, open in whichever direction
// we have more space
oppositeWidth =
this.$element.width();
diff --git a/src/widgets/RadioInputWidget.js b/src/widgets/RadioInputWidget.js
index 0b5f19d..1790128 100644
--- a/src/widgets/RadioInputWidget.js
+++ b/src/widgets/RadioInputWidget.js
@@ -2,7 +2,7 @@
* RadioInputWidget creates a single radio button. Because radio buttons are
usually used as a set,
* in most cases you will want to use a {@link OO.ui.RadioSelectWidget radio
select}
* with {@link OO.ui.RadioOptionWidget radio options} instead of this class.
For more information,
- * please see the [OOjs UI documentation on MediaWiki][1].
+ * please see the [OOUI documentation on MediaWiki][1].
*
* This widget can be used inside an HTML form, such as a OO.ui.FormLayout.
*
@@ -30,7 +30,7 @@
* ] );
* $( 'body' ).append( fieldset.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @class
* @extends OO.ui.InputWidget
diff --git a/src/widgets/RadioOptionWidget.js b/src/widgets/RadioOptionWidget.js
index da1bb30..f1fd498 100644
--- a/src/widgets/RadioOptionWidget.js
+++ b/src/widgets/RadioOptionWidget.js
@@ -1,9 +1,9 @@
/**
* RadioOptionWidget is an option widget that looks like a radio button.
* The class is used with OO.ui.RadioSelectWidget to create a selection of
radio options.
- * Please see the [OOjs UI documentation on MediaWiki] [1] for more
information.
+ * Please see the [OOUI documentation on MediaWiki] [1] for more information.
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options#Button_selects_and_option
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Button_selects_and_option
*
* @class
* @extends OO.ui.OptionWidget
diff --git a/src/widgets/RadioSelectInputWidget.js
b/src/widgets/RadioSelectInputWidget.js
index 8cf6adb..953ec75 100644
--- a/src/widgets/RadioSelectInputWidget.js
+++ b/src/widgets/RadioSelectInputWidget.js
@@ -1,7 +1,7 @@
/**
* RadioSelectInputWidget is a {@link OO.ui.RadioSelectWidget
RadioSelectWidget} intended to be used
* within an HTML form, such as a OO.ui.FormLayout. The selected value is
synchronized with the value
- * of a hidden HTML `input` tag. Please see the [OOjs UI documentation on
MediaWiki][1] for
+ * of a hidden HTML `input` tag. Please see the [OOUI documentation on
MediaWiki][1] for
* more information about input widgets.
*
* This and OO.ui.DropdownInputWidget support the same configuration options.
@@ -17,7 +17,7 @@
* } );
* $( 'body' ).append( radioSelectInput.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @class
* @extends OO.ui.InputWidget
diff --git a/src/widgets/RadioSelectWidget.js b/src/widgets/RadioSelectWidget.js
index 444a5c2..7c8a4eb 100644
--- a/src/widgets/RadioSelectWidget.js
+++ b/src/widgets/RadioSelectWidget.js
@@ -2,7 +2,7 @@
* RadioSelectWidget is a {@link OO.ui.SelectWidget select widget} that
contains radio
* options and is used together with OO.ui.RadioOptionWidget. The
RadioSelectWidget provides
* an interface for adding, removing and selecting options.
- * Please see the [OOjs UI documentation on MediaWiki][1] for more information.
+ * Please see the [OOUI documentation on MediaWiki][1] for more information.
*
* If you want to use this within an HTML form, such as a OO.ui.FormLayout, use
* OO.ui.RadioSelectInputWidget instead.
@@ -28,7 +28,7 @@
*
* $( 'body' ).append( radioSelect.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*
* @class
diff --git a/src/widgets/SearchWidget.js b/src/widgets/SearchWidget.js
index 050dcfe..c30b5c4 100644
--- a/src/widgets/SearchWidget.js
+++ b/src/widgets/SearchWidget.js
@@ -6,9 +6,9 @@
* In general, search widgets are used inside a separate {@link OO.ui.Dialog
dialog} window.
*
* Each time the query is changed, the search result menu is cleared and
repopulated. Please see
- * the [OOjs UI demos][1] for an example.
+ * the [OOUI demos][1] for an example.
*
- * [1]:
https://tools.wmflabs.org/oojs-ui/oojs-ui/demos/#dialogs-mediawiki-vector-ltr
+ * [1]:
https://doc.wikimedia.org/oojs-ui/master/demos/#SearchInputWidget-type-search
*
* @class
* @extends OO.ui.Widget
diff --git a/src/widgets/SelectFileWidget.js b/src/widgets/SelectFileWidget.js
index 30160b8..69cd656 100644
--- a/src/widgets/SelectFileWidget.js
+++ b/src/widgets/SelectFileWidget.js
@@ -2,14 +2,14 @@
* SelectFileWidgets allow for selecting files, using the HTML5 File API. These
* widgets can be configured with {@link OO.ui.mixin.IconElement icons} and
{@link
* OO.ui.mixin.IndicatorElement indicators}.
- * Please see the [OOjs UI documentation on MediaWiki] [1] for more
information and examples.
+ * Please see the [OOUI documentation on MediaWiki] [1] for more information
and examples.
*
* @example
* // Example of a file select widget
* var selectFile = new OO.ui.SelectFileWidget();
* $( 'body' ).append( selectFile.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets
*
* @class
* @extends OO.ui.Widget
diff --git a/src/widgets/SelectWidget.js b/src/widgets/SelectWidget.js
index 1f9621d..6e2a54e 100644
--- a/src/widgets/SelectWidget.js
+++ b/src/widgets/SelectWidget.js
@@ -1,11 +1,11 @@
/**
- * A SelectWidget is of a generic selection of options. The OOjs UI library
contains several types of
+ * A SelectWidget is of a generic selection of options. The OOUI library
contains several types of
* select widgets, including {@link OO.ui.ButtonSelectWidget button selects},
* {@link OO.ui.RadioSelectWidget radio selects}, and {@link
OO.ui.MenuSelectWidget
* menu selects}.
*
* This class should be used together with OO.ui.OptionWidget or
OO.ui.DecoratedOptionWidget. For more
- * information, please see the [OOjs UI documentation on MediaWiki][1].
+ * information, please see the [OOUI documentation on MediaWiki][1].
*
* @example
* // Example of a select widget with three options
@@ -27,7 +27,7 @@
* } );
* $( 'body' ).append( select.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*
* @abstract
* @class
@@ -38,8 +38,8 @@
* @param {Object} [config] Configuration options
* @cfg {OO.ui.OptionWidget[]} [items] An array of options to add to the
select.
* Options are created with {@link OO.ui.OptionWidget OptionWidget} classes.
See
- * the [OOjs UI documentation on MediaWiki] [2] for examples.
- * [2]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Selects_and_Options
+ * the [OOUI documentation on MediaWiki] [2] for examples.
+ * [2]: https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options
*/
OO.ui.SelectWidget = function OoUiSelectWidget( config ) {
// Configuration initialization
diff --git a/src/widgets/TagMultiselectWidget.js
b/src/widgets/TagMultiselectWidget.js
index b7d35d0..940eb88 100644
--- a/src/widgets/TagMultiselectWidget.js
+++ b/src/widgets/TagMultiselectWidget.js
@@ -2,6 +2,8 @@
* A basic tag multiselect widget, similar in concept to {@link
OO.ui.ComboBoxInputWidget combo box widget}
* that allows the user to add multiple values that are displayed in a tag
area.
*
+ * For more information about menus and options, please see the [OOUI
documentation on MediaWiki][1].
+ *
* This widget is a base widget; see {@link OO.ui.MenuTagMultiselectWidget
MenuTagMultiselectWidget} and
* {@link OO.ui.PopupTagMultiselectWidget PopupTagMultiselectWidget} for the
implementations that use
* a menu and a popup respectively.
@@ -14,6 +16,8 @@
* selected: [ 'Option 1' ]
* } );
* $( 'body' ).append( widget.$element );
+ *
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Selects_and_Options#Menu_selects_and_options
*
* @class
* @extends OO.ui.Widget
@@ -482,7 +486,7 @@
* @return {boolean} Value is duplicate
*/
OO.ui.TagMultiselectWidget.prototype.isDuplicateData = function ( data ) {
- return !!this.findItemFromData( data );
+ return !!this.getItemFromData( data );
};
/**
@@ -607,7 +611,7 @@
* @param {string|Object} data Tag data
*/
OO.ui.TagMultiselectWidget.prototype.removeTagByData = function ( data ) {
- var item = this.findItemFromData( data );
+ var item = this.getItemFromData( data );
this.removeItems( [ item ] );
};
diff --git a/src/widgets/TextInputWidget.js b/src/widgets/TextInputWidget.js
index 08b2bb3..0032013 100644
--- a/src/widgets/TextInputWidget.js
+++ b/src/widgets/TextInputWidget.js
@@ -4,7 +4,7 @@
* with {@link OO.ui.mixin.IconElement icons}, {@link
OO.ui.mixin.IndicatorElement indicators}, an optional
* validation-pattern (used to determine if an input value is valid or not)
and an input filter,
* which modifies incoming values rather than validating them.
- * Please see the [OOjs UI documentation on MediaWiki] [1] for more
information and examples.
+ * Please see the [OOUI documentation on MediaWiki] [1] for more information
and examples.
*
* This widget can be used inside an HTML form, such as a OO.ui.FormLayout.
*
@@ -15,7 +15,7 @@
* } )
* $( 'body' ).append( textInput.$element );
*
- * [1]: https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Inputs
+ * [1]: https://www.mediawiki.org/wiki/OOUI/Widgets/Inputs
*
* @class
* @extends OO.ui.InputWidget
diff --git a/src/widgets/ToggleButtonWidget.js
b/src/widgets/ToggleButtonWidget.js
index 5ddf573..4f9adbf 100644
--- a/src/widgets/ToggleButtonWidget.js
+++ b/src/widgets/ToggleButtonWidget.js
@@ -4,7 +4,7 @@
* configured with {@link OO.ui.mixin.IconElement icons}, {@link
OO.ui.mixin.IndicatorElement indicators},
* {@link OO.ui.mixin.TitledElement titles}, {@link OO.ui.mixin.FlaggedElement
styling flags},
* and {@link OO.ui.mixin.LabelElement labels}. Please see
- * the [OOjs UI documentation][1] on MediaWiki for more information.
+ * the [OOUI documentation][1] on MediaWiki for more information.
*
* @example
* // Toggle buttons in the 'off' and 'on' state.
@@ -18,7 +18,7 @@
* // Append the buttons to the DOM.
* $( 'body' ).append( toggleButton1.$element, toggleButton2.$element );
*
- * [1]:
https://www.mediawiki.org/wiki/OOjs_UI/Widgets/Buttons_and_Switches#Toggle_buttons
+ * [1]:
https://www.mediawiki.org/wiki/OOUI/Widgets/Buttons_and_Switches#Toggle_buttons
*
* @class
* @extends OO.ui.ToggleWidget
--
To view, visit https://gerrit.wikimedia.org/r/403836
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings
Gerrit-MessageType: newchange
Gerrit-Change-Id: I7bab58e4c57c36dc60d1f5012383cd74af5fbeea
Gerrit-PatchSet: 1
Gerrit-Project: oojs/ui
Gerrit-Branch: master
Gerrit-Owner: VolkerE <[email protected]>
_______________________________________________
MediaWiki-commits mailing list
[email protected]
https://lists.wikimedia.org/mailman/listinfo/mediawiki-commits
