MediaWiki master
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
MediaWiki\Widget\DateInputWidget Class Reference

Date input widget. More...

Inherits TextInputWidget.

Collaboration diagram for MediaWiki\Widget\DateInputWidget:
Collaboration graph
[legend]

Public Member Functions

 __construct (array $config=[])
 
 getConfig (&$config)
 
 getInputElement ( $config)
 

Protected Member Functions

 getJavaScriptClassName ()
 

Protected Attributes

string null $displayFormat = null
 
string null $inputFormat = null
 
string null false $longDisplayFormat = null
 
string null $mustBeAfter = null
 
string null $mustBeBefore = null
 
string null $placeholderDateFormat = null
 
string null $placeholderLabel = null
 
string null $precision = null
 

Detailed Description

Date input widget.

Since
1.29
Note
2016 MediaWiki Widgets Team and others; see AUTHORS.txt
MIT

Definition at line 15 of file DateInputWidget.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Widget\DateInputWidget::__construct ( array $config = [])
Parameters
array$configConfiguration options
  • string $config['inputFormat'] Date format string to use for the textual input field. Displayed while the widget is active, and the user can type in a date in this format. Should be short and easy to type. (default: 'YYYY-MM-DD' or 'YYYY-MM', depending on precision)
  • string $config['displayFormat'] Date format string to use for the clickable label. while the widget is inactive. Should be as unambiguous as possible (for example, prefer to spell out the month, rather than rely on the order), even if that makes it longer. Applicable only if the widget is infused. (default: language-specific)
  • string $config['longDisplayFormat'] If a custom displayFormat is not specified, use unabbreviated day of the week and month names in the default language-specific displayFormat. (default: false)
  • string $config['placeholderLabel'] Placeholder text shown when the widget is not selected. Applicable only if the widget is infused. (default: taken from message mw-widgets-dateinput-no-date)
  • string $config['placeholderDateFormat'] User-visible date format string displayed in the textual input field when it's empty. Should be the same as inputFormat, but translated to the user's language. (default: 'YYYY-MM-DD' or 'YYYY-MM', depending on precision)
  • string $config['precision'] Date precision to use, 'day' or 'month' (default: 'day')
  • string $config['min'] Validates the date to be no earlier than this. In the 'YYYY-MM-DD' or 'YYYY-MM' format, depending on precision.
  • string $config['mustBeAfter'] Validates the date to be after this. Overrides 'min'. In the 'YYYY-MM-DD' or 'YYYY-MM' format, depending on precision.
  • string $config['max'] Validates the date to be no later than this. In the 'YYYY-MM-DD' or 'YYYY-MM' format, depending on precision.
  • string $config['mustBeBefore'] Validates the date to be before this. Overrides 'max'. In the 'YYYY-MM-DD' or 'YYYY-MM' format, depending on precision.

Definition at line 64 of file DateInputWidget.php.

References MediaWiki\Widget\DateInputWidget\$placeholderDateFormat, and wfMessage().

Member Function Documentation

◆ getConfig()

MediaWiki\Widget\DateInputWidget::getConfig ( & $config)

Definition at line 138 of file DateInputWidget.php.

References MediaWiki\Widget\DateInputWidget\$displayFormat, MediaWiki\Widget\DateInputWidget\$inputFormat, MediaWiki\Widget\DateInputWidget\$longDisplayFormat, MediaWiki\Widget\DateInputWidget\$mustBeAfter, MediaWiki\Widget\DateInputWidget\$mustBeBefore, MediaWiki\Widget\DateInputWidget\$placeholderDateFormat, MediaWiki\Widget\DateInputWidget\$placeholderLabel, and MediaWiki\Widget\DateInputWidget\$precision.

◆ getInputElement()

MediaWiki\Widget\DateInputWidget::getInputElement ( $config)

Definition at line 168 of file DateInputWidget.php.

◆ getJavaScriptClassName()

MediaWiki\Widget\DateInputWidget::getJavaScriptClassName ( )
protected

Definition at line 133 of file DateInputWidget.php.

Member Data Documentation

◆ $displayFormat

string null MediaWiki\Widget\DateInputWidget::$displayFormat = null
protected

Definition at line 20 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\getConfig().

◆ $inputFormat

string null MediaWiki\Widget\DateInputWidget::$inputFormat = null
protected

Definition at line 18 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\getConfig().

◆ $longDisplayFormat

string null false MediaWiki\Widget\DateInputWidget::$longDisplayFormat = null
protected

Definition at line 22 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\getConfig().

◆ $mustBeAfter

string null MediaWiki\Widget\DateInputWidget::$mustBeAfter = null
protected

Definition at line 30 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\getConfig().

◆ $mustBeBefore

string null MediaWiki\Widget\DateInputWidget::$mustBeBefore = null
protected

Definition at line 32 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\getConfig().

◆ $placeholderDateFormat

string null MediaWiki\Widget\DateInputWidget::$placeholderDateFormat = null
protected

Definition at line 26 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\__construct(), and MediaWiki\Widget\DateInputWidget\getConfig().

◆ $placeholderLabel

string null MediaWiki\Widget\DateInputWidget::$placeholderLabel = null
protected

Definition at line 24 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\getConfig().

◆ $precision

string null MediaWiki\Widget\DateInputWidget::$precision = null
protected

Definition at line 28 of file DateInputWidget.php.

Referenced by MediaWiki\Widget\DateInputWidget\getConfig().

The documentation for this class was generated from the following file: