Files
shaka-player/ui/fullscreen_button.js
T
Andy(김규회) f1c0468f70 feat(UI): Improve shaka player UI accessibility (#10023)
### ARIA attributes
  - Add `aria-hidden="true"` to all decorative SVG icons (`icon.js`)
- Implement missing `aria-label` for ad controls (`skip_ad_button.js`,
`ad_info.js`)
- Add `aria-pressed` to toggle buttons (mute, fullscreen, pip, loop,
statistics, remote, stereoscopic)
- Remove incorrect `aria-pressed` from one-shot action button
(`recenter_vr.js`)
- Add `role="menu"`, `aria-haspopup`, `aria-expanded` to menus
(`overflow_menu.js`, `settings_menu.js`, `context_menu.js`)
- Add `role="menuitemradio"` and `aria-checked` to selection menus
(resolution, language, text, playback rate, etc.)
- Add `role="toolbar"` to control panel (`controls.js`)
- Add `role="heading"` to content title (`content_title.js`)
  
### Focus management
- Restore focus to trigger button when menus close
  - Maintain focus on fullscreen button after toggle     

 ### CSS
- Add `forced-colors` media query for Windows high contrast mode
  ### Other
- Add `alt=""` to seek bar thumbnail image
- Add `aria-hidden="true"` to watermark canvas
  - Add accessibility unit tests for ARIA attributes
- Remove redundant `aria-hidden` from checkmark icon (`ui_utils.js`)
  - Add ARIA terms to project spell-check dictionary  

Issue https://github.com/shaka-project/shaka-player/issues/3146
2026-04-23 14:53:23 +02:00

146 lines
3.6 KiB
JavaScript

/*! @license
* Shaka Player
* Copyright 2016 Google LLC
* SPDX-License-Identifier: Apache-2.0
*/
goog.provide('shaka.ui.FullscreenButton');
goog.require('shaka.ads.Utils');
goog.require('shaka.ui.Controls');
goog.require('shaka.ui.Element');
goog.require('shaka.ui.Enums');
goog.require('shaka.ui.Icon');
goog.require('shaka.ui.Locales');
goog.require('shaka.ui.Localization');
goog.require('shaka.util.Dom');
goog.require('shaka.util.MediaElementEvent');
/**
* @extends {shaka.ui.Element}
* @final
* @export
*/
shaka.ui.FullscreenButton = class extends shaka.ui.Element {
/**
* @param {!HTMLElement} parent
* @param {!shaka.ui.Controls} controls
*/
constructor(parent, controls) {
super(parent, controls);
/** @private {HTMLMediaElement} */
this.localVideo_ = this.controls.getLocalVideo();
/** @private {!HTMLButtonElement} */
this.button_ = shaka.util.Dom.createButton();
this.button_.classList.add('shaka-fullscreen-button');
this.button_.classList.add('shaka-tooltip');
this.button_.classList.add('shaka-no-propagation');
/** @private {shaka.ui.Icon} */
this.icon_ = new shaka.ui.Icon(this.button_,
shaka.ui.Enums.MaterialDesignSVGIcons['FULLSCREEN']);
this.checkSupport_();
this.parent.appendChild(this.button_);
this.updateAriaLabel_();
this.eventManager.listenMulti(
this.localization,
[
shaka.ui.Localization.LOCALE_UPDATED,
shaka.ui.Localization.LOCALE_CHANGED,
], () => {
this.updateAriaLabel_();
});
this.eventManager.listen(this.button_, 'click', async () => {
if (!this.controls.isOpaque()) {
return;
}
await this.controls.toggleFullScreen();
this.button_.focus();
});
this.eventManager.listen(document, 'fullscreenchange', () => {
this.updateIcon_();
this.updateAriaLabel_();
});
this.eventManager.listenMulti(
this.localVideo_,
[
shaka.util.MediaElementEvent.LOADED_METADATA,
shaka.util.MediaElementEvent.LOADED_DATA,
], () => {
this.checkSupport_();
});
this.eventManager.listenMulti(
this.adManager,
[
shaka.ads.Utils.AD_STARTED,
shaka.ads.Utils.AD_STOPPED,
], () => {
this.checkSupport_();
});
}
/**
* @private
*/
checkSupport_() {
// Don't show the button if fullscreen is not supported
if (!this.controls.isFullScreenSupported()) {
this.button_.classList.add('shaka-hidden');
} else {
this.button_.classList.remove('shaka-hidden');
}
}
/**
* @private
*/
updateAriaLabel_() {
const LocIds = shaka.ui.Locales.Ids;
const label = this.controls.isFullScreenEnabled() ?
LocIds.EXIT_FULL_SCREEN : LocIds.FULL_SCREEN;
this.button_.ariaLabel = this.localization.resolve(label);
this.button_.ariaPressed =
this.controls.isFullScreenEnabled() ? 'true' : 'false';
}
/**
* @private
*/
updateIcon_() {
this.icon_.use(this.controls.isFullScreenEnabled() ?
shaka.ui.Enums.MaterialDesignSVGIcons['EXIT_FULLSCREEN'] :
shaka.ui.Enums.MaterialDesignSVGIcons['FULLSCREEN'],
);
}
};
/**
* @implements {shaka.extern.IUIElement.Factory}
* @final
*/
shaka.ui.FullscreenButton.Factory = class {
/** @override */
create(rootElement, controls) {
return new shaka.ui.FullscreenButton(rootElement, controls);
}
};
shaka.ui.Controls.registerElement(
'fullscreen', new shaka.ui.FullscreenButton.Factory());
shaka.ui.Controls.registerBigElement(
'fullscreen', new shaka.ui.FullscreenButton.Factory());