chromium/third_party/google-closure-library/closure/goog/ui/buttonrenderer_test.js

/**
 * @license
 * Copyright The Closure Library Authors.
 * SPDX-License-Identifier: Apache-2.0
 */

goog.module('goog.ui.ButtonRendererTest');
goog.setTestOnly();

const Button = goog.require('goog.ui.Button');
const ButtonRenderer = goog.require('goog.ui.ButtonRenderer');
const ButtonSide = goog.require('goog.ui.ButtonSide');
const Component = goog.require('goog.ui.Component');
const ControlRenderer = goog.require('goog.ui.ControlRenderer');
const ExpectedFailures = goog.require('goog.testing.ExpectedFailures');
const Role = goog.require('goog.a11y.aria.Role');
const State = goog.require('goog.a11y.aria.State');
const TagName = goog.require('goog.dom.TagName');
const aria = goog.require('goog.a11y.aria');
const classlist = goog.require('goog.dom.classlist');
const dom = goog.require('goog.dom');
const rendererasserts = goog.require('goog.testing.ui.rendererasserts');
const testSuite = goog.require('goog.testing.testSuite');

let button;
let buttonRenderer;
let testRenderer;
let sandbox;
let expectedFailures;

/**
 * A subclass of ButtonRenderer that overrides
 * `getStructuralCssClass` for testing purposes.
 */
class TestRenderer extends ButtonRenderer {
  constructor() {
    super();
    ButtonRenderer.call(this);
  }

  /** @override */
  getStructuralCssClass() {
    return 'goog-base';
  }
}

goog.addSingletonGetter(TestRenderer);

testSuite({
  setUpPage() {
    sandbox = dom.getElement('sandbox');
    expectedFailures = new ExpectedFailures();
  },

  setUp() {
    buttonRenderer = ButtonRenderer.getInstance();
    button = new Button('Hello', buttonRenderer);
    testRenderer = TestRenderer.getInstance();
  },

  tearDown() {
    button.dispose();
    dom.removeChildren(sandbox);
    expectedFailures.handleTearDown();
  },

  testConstructor() {
    assertNotNull(
        'ButtonRenderer singleton instance must not be null', buttonRenderer);
  },

  testGetAriaRole() {
    assertEquals(
        'ButtonRenderer\'s ARIA role must have expected value', Role.BUTTON,
        buttonRenderer.getAriaRole());
  },

  testCreateDom() {
    let element = buttonRenderer.createDom(button);
    assertNotNull('Element must not be null', element);
    assertEquals('Element must be a DIV', String(TagName.DIV), element.tagName);
    assertHTMLEquals(
        'Element must have expected structure',
        '<div class="goog-button">Hello</div>', dom.getOuterHtml(element));

    button.setTooltip('Hello, world!');
    button.setValue('foo');
    element = buttonRenderer.createDom(button);
    assertNotNull('Element must not be null', element);
    assertEquals('Element must be a DIV', 'DIV', element.tagName);
    assertSameElements(
        'Element must have expected class name', ['goog-button'],
        classlist.get(element));
    assertEquals(
        'Element must have expected title', 'Hello, world!', element.title);
    assertUndefined('Element must have no value', element.value);
    assertEquals(
        'Element must have expected contents', 'Hello', element.innerHTML);

    button.setSupportedState(Component.State.CHECKED, true);
    element = buttonRenderer.createDom(button);
    assertEquals(
        'button\'s aria-pressed attribute must be false', 'false',
        aria.getState(element, State.PRESSED));
  },

  testSetTooltip() {
    button.createDom();
    button.setTooltip('tooltip');
    assertEquals('tooltip', button.getElement().title);
    button.setTooltip('');
    assertEquals('', button.getElement().title);
    // IE7 doesn't support hasAttribute.
    if (button.getElement().hasAttribute) {
      assertFalse(button.getElement().hasAttribute('title'));
    }
  },

  testCreateDomAriaState() {
    button.setSupportedState(Component.State.CHECKED, true);
    button.setChecked(true);
    const element = buttonRenderer.createDom(button);

    assertEquals(
        'button\'s aria-pressed attribute must be true', 'true',
        aria.getState(element, State.PRESSED));
  },

  testUseAriaPressedForSelected() {
    button.setSupportedState(Component.State.SELECTED, true);
    button.setSelected(true);
    button.setRenderer(buttonRenderer);
    button.render();
    const element = button.getElement();

    assertEquals(
        'button\'s aria-pressed attribute must be true', 'true',
        aria.getState(element, State.PRESSED));
    assertEquals(
        'button\'s aria-selected attribute must be empty', '',
        aria.getState(element, State.SELECTED));
  },

  testAriaDisabled() {
    button.setEnabled(false);
    button.setRenderer(buttonRenderer);
    button.render();
    const element = button.getElement();

    assertEquals(
        'button\'s aria-disabled attribute must be true', 'true',
        aria.getState(element, State.DISABLED));
  },

  /** @suppress {checkTypes} suppression added to enable type checking */
  testDecorate() {
    sandbox.innerHTML = '<div id="foo">Foo</div>\n' +
        '<div id="bar" title="Hello, world!">Bar</div>\n' +
        '<div id="toggle">Toggle</div>';

    const foo = new Button(null, buttonRenderer);
    foo.decorate(dom.getElement('foo'));
    assertEquals(
        'foo\'s tooltip must be the empty string', '', foo.getTooltip());
    foo.dispose();

    const bar = new Button(null, buttonRenderer);
    bar.decorate(dom.getElement('bar'));
    assertEquals(
        'bar\'s tooltip must be initialized', 'Hello, world!',
        bar.getTooltip());
    bar.dispose();

    const toggle = new Button(null, buttonRenderer);
    toggle.setSupportedState(Component.State.CHECKED, true);
    const element = dom.getElement('toggle');
    assertNotNull(element);
    toggle.decorate(element);
    assertEquals(
        'toggle\'s aria-pressed attribute must be false', 'false',
        aria.getState(element, State.PRESSED));
    toggle.dispose();
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testCollapse() {
    buttonRenderer.setCollapsed(button, ButtonSide.START);
    assertSameElements(
        'Button should have class to collapse start',
        ['goog-button-collapse-left'], button.getExtraClassNames());
    buttonRenderer.setCollapsed(button, ButtonSide.END);
    assertSameElements(
        'Button should have class to collapse end',
        ['goog-button-collapse-right'], button.getExtraClassNames());
    buttonRenderer.setCollapsed(button, ButtonSide.BOTH);
    assertSameElements(
        'Button should have classes to collapse both',
        ['goog-button-collapse-left', 'goog-button-collapse-right'],
        button.getExtraClassNames());
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testCollapseRtl() {
    button.setRightToLeft(true);
    buttonRenderer.setCollapsed(button, ButtonSide.START);
    assertSameElements(
        'Button should have class to collapse start',
        ['goog-button-collapse-right'], button.getExtraClassNames());
    buttonRenderer.setCollapsed(button, ButtonSide.END);
    assertSameElements(
        'Button should have class to collapse end',
        ['goog-button-collapse-left'], button.getExtraClassNames());
    buttonRenderer.setCollapsed(button, ButtonSide.BOTH);
    assertSameElements(
        'Button should have classes to collapse both',
        ['goog-button-collapse-left', 'goog-button-collapse-right'],
        button.getExtraClassNames());
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testCollapseWithStructuralClass() {
    testRenderer.setCollapsed(button, ButtonSide.BOTH);
    assertSameElements(
        'Should use structural class for collapse classes',
        ['goog-base-collapse-left', 'goog-base-collapse-right'],
        button.getExtraClassNames());
  },

  /** @suppress {visibility} suppression added to enable type checking */
  testUpdateAriaState() {
    const element = buttonRenderer.createDom(button);
    buttonRenderer.updateAriaState(element, Component.State.CHECKED, true);
    assertEquals(
        'Button must have pressed ARIA state', 'true',
        aria.getState(element, State.PRESSED));

    // Test for updating a state other than CHECKED
    buttonRenderer.updateAriaState(element, Component.State.DISABLED, true);
    assertEquals(
        'Button must have disabled ARIA state', 'true',
        aria.getState(element, State.DISABLED));

    buttonRenderer.updateAriaState(element, Component.State.CHECKED, false);
    assertEquals(
        'Control must no longer have pressed ARIA state', 'false',
        aria.getState(element, State.PRESSED));
    buttonRenderer.updateAriaState(element, Component.State.SELECTED, true);
    assertEquals(
        'Button must have pressed ARIA state', 'true',
        aria.getState(element, State.PRESSED));
  },

  testDoesntCallGetCssClassInConstructor() {
    rendererasserts.assertNoGetCssClassCallsInConstructor(ButtonRenderer);
  },
});