1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
|
/**
* Mixin for adding descriptive ARIA support to elements.
*
* @class
* @abstract
*
* @constructor
* @param {Object} [config] Configuration options
* @param {jQuery} [config.$ariaDescribedBy]
* @param {string} [config.ariaLabel]
* @param {jQuery} [config.$describedElement]
*/
ve.ui.MWAriaDescribe = function VeUiMWAriaDescribe( config ) {
this.$describedElement = config.$describedElement || this.$element;
if ( config.$ariaDescribedBy ) {
this.setAriaDescribedBy( config.$ariaDescribedBy );
}
if ( config.ariaLabel ) {
this.setAriaLabel( config.ariaLabel );
}
};
/* Setup */
OO.initClass( ve.ui.MWAriaDescribe );
/**
* @param {jQuery} [$description]
* @chainable
* @return {OO.ui.Element} The element, for chaining
*/
ve.ui.MWAriaDescribe.prototype.setAriaDescribedBy = function ( $description ) {
if ( !$description ) {
this.$describedElement.removeAttr( 'aria-describedby' );
return this;
}
if ( !$description.attr( 'id' ) ) {
$description.attr( 'id', OO.ui.generateElementId() );
}
this.$describedElement.attr( 'aria-describedby', $description.attr( 'id' ) );
return this;
};
/**
* @param {string} label
* @chainable
* @return {OO.ui.Element} The element, for chaining
*/
ve.ui.MWAriaDescribe.prototype.setAriaLabel = function ( label ) {
this.$describedElement.attr( 'aria-label', label );
return this;
};
|