Object-Oriented User Interface
No Matches
OOUI\ButtonWidget Class Reference

Generic widget for buttons. More...

+ Inheritance diagram for OOUI\ButtonWidget:
+ Collaboration diagram for OOUI\ButtonWidget:

Public Member Functions

 __construct (array $config=[])
 getHref ()
 Get hyperlink location.
 getTarget ()
 Get hyperlink target.
 getNoFollow ()
 Get search engine traversal hint.
 getRel ()
 Get the relationship attribute of the hyperlink.
 setHref ( $href)
 Set hyperlink location.
 updateHref ()
 Update the href attribute, in case of changes to href or disabled state.
 setTarget ( $target)
 Set hyperlink target.
 setNoFollow ( $noFollow)
 Set search engine traversal hint.
 setRel ( $rel)
 Set the relationship attribute of the hyperlink.
 setActive ( $active=null)
 Toggle active state.
 isActive ()
 Check if button is active.
 getConfig (&$config)
- Public Member Functions inherited from OOUI\Widget
 isDisabled ()
 Check if the widget is disabled.
 setDisabled ( $disabled)
 Set the disabled state of the widget.
 getInputId ()
 Get an ID of a labelable node which is part of this widget, if any, to be used for <label for> value.
 setLabelledBy ( $id)
 Set the element with the given ID as a label for this widget.
- Public Member Functions inherited from OOUI\Element
 getTagName ()
 Get the HTML tag name.
 toggle ( $show=null)
 Toggle visibility of an element.
 getData ()
 Get element data.
 setData ( $data)
 Set element data.
 supports ( $methods)
 Check if element supports one or more methods.
 registerConfigCallback (callable $func)
 Register an additional function to call when building the config.
 toString ()
 Render element into HTML.
- Public Member Functions inherited from OOUI\Tag
 __construct ( $tag='div')
 Create element.
 hasClass ( $class)
 Check for CSS class.
 addClasses (array $classes)
 Add CSS classes.
 removeClasses (array $classes)
 Remove CSS classes.
 toggleClasses (array $classes, $toggle=null)
 Toggle CSS classes.
 getTag ()
 getAttribute ( $key)
 Get HTML attribute value.
 setAttributes (array $attributes)
 Add HTML attributes.
 setValue ( $value)
 Set value of input element ('value' attribute for most, element content for textarea).
 removeAttributes (array $keys)
 Remove HTML attributes.
 removeContent (... $content)
 Remove any items that match by reference.
 appendContent (... $content)
 Add content to the end.
 prependContent (... $content)
 Add content to the beginning.
 clearContent ()
 Remove all content.
 getElementGroup ()
 Get group element is in.
 setElementGroup ( $group)
 Set group element is in.
 setInfusable ( $infusable)
 Enable widget for client-side infusion.
 isInfusable ()
 Get client-side infusability.
 ensureInfusableId ()
 Ensure that this given Tag is infusable and has a unique id attribute.
 __toString ()
 Magic method implementation.

Static Public Attributes

static string $tagName = 'span'
- Static Public Attributes inherited from OOUI\Element
static string $tagName = 'div'
 HTML tag name.
static string $defaultDir = 'ltr'
 Default text direction, used for some layout calculations.

Protected Attributes

bool $active = false
 Whether button is active.
string $href = null
 Hyperlink to visit when clicked.
string $target = null
 Target to open hyperlink in.
bool $noFollow = true
 Search engine traversal hint.
string[] $rel = []
 Relationship attributes, such as the noFollow field above, or noopener for the hyperlink.
- Protected Attributes inherited from OOUI\Widget
bool $disabled = false
- Protected Attributes inherited from OOUI\Element
mixed $data = null
 Element data.
bool $visible = true
array $ownClasses = []
 Strings of the CSS classes explicitly configured for this element (as opposed to #$classes, which contains all classes for this element).
callable[] $configCallbacks = []
- Protected Attributes inherited from OOUI\Tag
string $tag = ''
 Tag name for this instance.
array $attributes = []
array $classes = []
array $content = []
GroupElement null $elementGroup = null
bool $infusable = false
 Infusion support.

Additional Inherited Members

- Static Public Member Functions inherited from OOUI\Element
static warnDeprecation ( $message='')
 Emits a deprecation warning with provided message.
static getDir (Tag $element)
 Get the direction of the user interface for a given element.
static setDefaultDir ( $dir)
 Set the default direction of the user interface.
static configFromHtmlAttributes (array $attrs)
 A helper method to massage an array of HTML attributes into a format that is more likely to work with an OOUI PHP element, camel-casing attribute names and setting values of boolean ones to true.
- Static Public Member Functions inherited from OOUI\Tag
static generateElementId ()
 Generate a unique ID for element.
static resetElementId ()
 Reset the unique ID, for consistent test output.
static isSafeUrl ( $url)
 Check whether user-supplied URL is safe, that is, whether outputting it will not result in XSS vulnerability.
- Protected Member Functions inherited from OOUI\Element
 getJavaScriptClassName ()
 The class name of the JavaScript version of this widget.
 getGeneratedAttributes ()

Detailed Description

Generic widget for buttons.

Constructor & Destructor Documentation

◆ __construct()

OOUI\ButtonWidget::__construct ( array $config = [])
array$configConfiguration options
  • bool $config['active'] Whether button should be shown as active (default: false)
  • string $config['href'] Hyperlink to visit when clicked
  • string $config['target'] Target to open hyperlink in
  • bool $config['noFollow'] Search engine traversal hint (default: true)
  • string|string[] $config['rel'] Relationship attributes for the hyperlink

Reimplemented from OOUI\Widget.

Member Function Documentation

◆ getConfig()

OOUI\ButtonWidget::getConfig ( & $config)


Reimplemented from OOUI\Widget.

◆ getHref()

OOUI\ButtonWidget::getHref ( )

Get hyperlink location.

string Hyperlink location

◆ getNoFollow()

OOUI\ButtonWidget::getNoFollow ( )

Get search engine traversal hint.

bool Whether search engines should avoid traversing this hyperlink

◆ getRel()

OOUI\ButtonWidget::getRel ( )

Get the relationship attribute of the hyperlink.

string[] Relationship attributes that apply to the hyperlink

◆ getTarget()

OOUI\ButtonWidget::getTarget ( )

Get hyperlink target.

string Hyperlink target

◆ isActive()

OOUI\ButtonWidget::isActive ( )

Check if button is active.

bool Button is active

◆ setActive()

OOUI\ButtonWidget::setActive ( $active = null)

Toggle active state.

A button should be marked as active when clicking it would only refresh the page.

bool | null$activeMake button active

◆ setHref()

OOUI\ButtonWidget::setHref ( $href)

Set hyperlink location.

string | null$hrefHyperlink location, null to remove

◆ setNoFollow()

OOUI\ButtonWidget::setNoFollow ( $noFollow)

Set search engine traversal hint.

bool$noFollowTrue if search engines should avoid traversing this hyperlink

◆ setRel()

OOUI\ButtonWidget::setRel ( $rel)

Set the relationship attribute of the hyperlink.

string | string[]$relRelationship attributes for the hyperlink

◆ setTarget()

OOUI\ButtonWidget::setTarget ( $target)

Set hyperlink target.

string | null$targetHyperlink target, null to remove

◆ updateHref()

OOUI\ButtonWidget::updateHref ( )

Update the href attribute, in case of changes to href or disabled state.


Member Data Documentation

◆ $noFollow

bool OOUI\ButtonWidget::$noFollow = true

Search engine traversal hint.

True if search engines should avoid following this hyperlink.

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