closure 1.2.701 → 1.3.0

data/closure-library/closure/goog/ui/button.js

@@ -1,208 +0,0 @@
-// Copyright 2007 The Closure Library Authors. All Rights Reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS-IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/**
- * @fileoverview A button control. This implementation extends {@link
- * goog.ui.Control}.
- *
- * @see ../demos/button.html
- */
-
-goog.provide('goog.ui.Button');
-goog.provide('goog.ui.Button.Side');
-
-goog.require('goog.events.KeyCodes');
-goog.require('goog.ui.ButtonRenderer');
-goog.require('goog.ui.ButtonSide');
-goog.require('goog.ui.Control');
-goog.require('goog.ui.ControlContent');
-goog.require('goog.ui.NativeButtonRenderer');
-
-
-
-/**
- * A button control, rendered as a native browser button by default.
- *
- * @param {goog.ui.ControlContent} content Text caption or existing DOM
- *     structure to display as the button's caption.
- * @param {goog.ui.ButtonRenderer=} opt_renderer Renderer used to render or
- *     decorate the button; defaults to {@link goog.ui.NativeButtonRenderer}.
- * @param {goog.dom.DomHelper=} opt_domHelper Optional DOM hepler, used for
- *     document interaction.
- * @constructor
- * @extends {goog.ui.Control}
- */
-goog.ui.Button = function(content, opt_renderer, opt_domHelper) {
-  goog.ui.Control.call(this, content, opt_renderer ||
-      goog.ui.NativeButtonRenderer.getInstance(), opt_domHelper);
-};
-goog.inherits(goog.ui.Button, goog.ui.Control);
-
-
-/**
- * Constants for button sides, see {@link goog.ui.Button.prototype.setCollapsed}
- * for details. Aliased from goog.ui.ButtonSide to support legacy users without
- * creating a circular dependency in {@link goog.ui.ButtonRenderer}.
- * @enum {number}
- * @deprecated use {@link goog.ui.ButtonSide} instead.
- */
-goog.ui.Button.Side = goog.ui.ButtonSide;
-
-
-/**
- * Value associated with the button.
- * @type {*}
- * @private
- */
-goog.ui.Button.prototype.value_;
-
-
-/**
- * Tooltip text for the button, displayed on hover.
- * @type {string|undefined}
- * @private
- */
-goog.ui.Button.prototype.tooltip_;
-
-
-// goog.ui.Button API implementation.
-
-
-/**
- * Returns the value associated with the button.
- * @return {*} Button value (undefined if none).
- */
-goog.ui.Button.prototype.getValue = function() {
-  return this.value_;
-};
-
-
-/**
- * Sets the value associated with the button, and updates its DOM.
- * @param {*} value New button value.
- */
-goog.ui.Button.prototype.setValue = function(value) {
-  this.value_ = value;
-  this.getRenderer().setValue(this.getElement(), value);
-};
-
-
-/**
- * Sets the value associated with the button.  Unlike {@link #setValue},
- * doesn't update the button's DOM.  Considered protected; to be called only
- * by renderer code during element decoration.
- * @param {*} value New button value.
- * @protected
- */
-goog.ui.Button.prototype.setValueInternal = function(value) {
-  this.value_ = value;
-};
-
-
-/**
- * Returns the tooltip for the button.
- * @return {string|undefined} Tooltip text (undefined if none).
- */
-goog.ui.Button.prototype.getTooltip = function() {
-  return this.tooltip_;
-};
-
-
-/**
- * Sets the tooltip for the button, and updates its DOM.
- * @param {string} tooltip New tooltip text.
- */
-goog.ui.Button.prototype.setTooltip = function(tooltip) {
-  this.tooltip_ = tooltip;
-  this.getRenderer().setTooltip(this. getElement(), tooltip);
-};
-
-
-/**
- * Sets the tooltip for the button.  Unlike {@link #setTooltip}, doesn't update
- * the button's DOM.  Considered protected; to be called only by renderer code
- * during element decoration.
- * @param {string} tooltip New tooltip text.
- * @protected
- */
-goog.ui.Button.prototype.setTooltipInternal = function(tooltip) {
-  this.tooltip_ = tooltip;
-};
-
-
-/**
- * Collapses the border on one or both sides of the button, allowing it to be
- * combined with the adjancent button(s), forming a single UI componenet with
- * multiple targets.
- * @param {number} sides Bitmap of one or more {@link goog.ui.ButtonSide}s for
- *     which borders should be collapsed.
- */
-goog.ui.Button.prototype.setCollapsed = function(sides) {
-  this.getRenderer().setCollapsed(this, sides);
-};
-
-
-// goog.ui.Control & goog.ui.Component API implementation.
-
-
-/** @inheritDoc */
-goog.ui.Button.prototype.disposeInternal = function() {
-  goog.ui.Button.superClass_.disposeInternal.call(this);
-  delete this.value_;
-  delete this.tooltip_;
-};
-
-
-/** @inheritDoc */
-goog.ui.Button.prototype.enterDocument = function() {
-  goog.ui.Button.superClass_.enterDocument.call(this);
-  if (this.isSupportedState(goog.ui.Component.State.FOCUSED)) {
-    var keyTarget = this.getKeyEventTarget();
-    if (keyTarget) {
-      this.getHandler().listen(keyTarget, goog.events.EventType.KEYUP,
-          this.handleKeyEventInternal);
-    }
-  }
-};
-
-
-/**
- * Attempts to handle a keyboard event; returns true if the event was handled,
- * false otherwise.  If the button is enabled and the Enter/Space key was
- * pressed, handles the event by dispatching an {@code ACTION} event,
- * and returns true. Overrides {@link goog.ui.Control#handleKeyEventInternal}.
- * @param {goog.events.KeyEvent} e Key event to handle.
- * @return {boolean} Whether the key event was handled.
- * @protected
- * @override
- */
-goog.ui.Button.prototype.handleKeyEventInternal = function(e) {
-  if (e.keyCode == goog.events.KeyCodes.ENTER &&
-      e.type == goog.events.KeyHandler.EventType.KEY ||
-      e.keyCode == goog.events.KeyCodes.SPACE &&
-      e.type == goog.events.EventType.KEYUP) {
-    return this.performActionInternal(e);
-  }
-  // Return true for space keypress (even though the event is handled on keyup)
-  // as preventDefault needs to be called up keypress to take effect in IE and
-  // WebKit.
-  return e.keyCode == goog.events.KeyCodes.SPACE;
-};
-
-
-// Register a decorator factory function for goog.ui.Buttons.
-goog.ui.registry.setDecoratorByClassName(goog.ui.ButtonRenderer.CSS_CLASS,
-    function() {
-      return new goog.ui.Button(null);
-    });

data/closure-library/closure/goog/ui/button_test.html

@@ -1,257 +0,0 @@
-<!DOCTYPE html>
-<html>
-<!--
-Copyright 2008 The Closure Library Authors. All Rights Reserved.
-
-Use of this source code is governed by the Apache License, Version 2.0.
-See the COPYING file for details.
--->
-<!--
-Author: nicksantos@google.com (Nick Santos)
-Author: attila@google.com (Attila Bodis)
--->
-<head>
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-  <title>Closure Unit Tests - goog.ui.Button</title>
-  <script src="../base.js"></script>
-  <script>
-    goog.require('goog.dom');
-    goog.require('goog.events');
-    goog.require('goog.testing.events');
-    goog.require('goog.testing.jsunit');
-    goog.require('goog.ui.Button');
-    goog.require('goog.ui.ButtonSide');
-    goog.require('goog.ui.ButtonRenderer');
-    goog.require('goog.ui.NativeButtonRenderer');
-  </script>
-</head>
-<body>
-  <p>Here's a button defined in markup:</p>
-  <button id="demoButton">Foo</button>
-  <div id="sandbox"></div>
-  <script>
-    var sandbox = goog.dom.getElement('sandbox');
-    var button;
-    var clonedButtonDom;
-    var demoButtonElement;
-
-    function setUp() {
-      button = new goog.ui.Button();
-      demoButtonElement = goog.dom.getElement('demoButton');
-      clonedButtonDom = demoButtonElement.cloneNode(true);
-    }
-
-    function tearDown() {
-      button.dispose();
-      demoButtonElement.parentNode.replaceChild(clonedButtonDom,
-          demoButtonElement);
-      goog.dom.removeChildren(sandbox);
-    }
-
-    function testConstructor() {
-      assertNotNull('Button must not be null', button);
-      assertEquals('Renderer must default to expected value',
-          goog.ui.NativeButtonRenderer.getInstance(), button.getRenderer());
-
-      var fakeDomHelper = {};
-      var testButton = new goog.ui.Button('Hello',
-          goog.ui.ButtonRenderer.getInstance(), fakeDomHelper);
-      assertEquals('Content must have expected value', 'Hello',
-          testButton.getContent());
-      assertEquals('Renderer must have expected value',
-          goog.ui.ButtonRenderer.getInstance(), testButton.getRenderer());
-      assertEquals('DOM helper must have expected value', fakeDomHelper,
-          testButton.getDomHelper());
-      testButton.dispose();
-    }
-
-    function testGetSetValue() {
-      assertUndefined('Button\'s value must default to undefined',
-          button.getValue());
-      button.setValue(17);
-      assertEquals('Button must have expected value', 17, button.getValue());
-      button.render(sandbox);
-      assertEquals('Button element must have expected value', '17',
-          button.getElement().value);
-      button.setValue('foo');
-      assertEquals('Button element must have updated value', 'foo',
-          button.getElement().value);
-      button.setValueInternal('bar');
-      assertEquals('Button must have new internal value', 'bar',
-          button.getValue());
-      assertEquals('Button element must be unchanged', 'foo',
-          button.getElement().value);
-    }
-
-    function testGetSetTooltip() {
-      assertUndefined('Button\'s tooltip must default to undefined',
-          button.getTooltip());
-      button.setTooltip('Hello');
-      assertEquals('Button must have expected tooltip', 'Hello',
-          button.getTooltip());
-      button.render(sandbox);
-      assertEquals('Button element must have expected title', 'Hello',
-          button.getElement().title);
-      button.setTooltip('Goodbye');
-      assertEquals('Button element must have updated title', 'Goodbye',
-          button.getElement().title);
-      button.setTooltipInternal('World');
-      assertEquals('Button must have new internal tooltip', 'World',
-          button.getTooltip());
-      assertEquals('Button element must be unchanged', 'Goodbye',
-          button.getElement().title);
-    }
-
-    function testSetCollapsed() {
-      assertNull('Button must not have any collapsed styling by default',
-          button.getExtraClassNames());
-      button.setCollapsed(goog.ui.ButtonSide.START);
-      assertSameElements('Button must have the start side collapsed',
-          ['goog-button-collapse-left'], button.getExtraClassNames());
-      button.render(sandbox);
-      assertSameElements('Button element must have the start side collapsed',
-          ['goog-button', 'goog-button-collapse-left'],
-          goog.dom.classes.get(button.getElement()));
-      button.setCollapsed(goog.ui.ButtonSide.BOTH);
-      assertSameElements('Button must have both sides collapsed',
-          ['goog-button-collapse-left', 'goog-button-collapse-right'],
-          button.getExtraClassNames());
-      assertSameElements('Button element must have both sides collapsed', [
-        'goog-button',
-        'goog-button-collapse-left',
-        'goog-button-collapse-right'
-      ], goog.dom.classes.get(button.getElement()));
-    }
-
-    function testDispose() {
-      assertFalse('Button must not have been disposed of', button.isDisposed());
-      button.render(sandbox);
-      button.setValue('foo');
-      button.setTooltip('bar');
-      button.dispose();
-      assertTrue('Button must have been disposed of', button.isDisposed());
-      assertUndefined('Button\'s value must have been deleted',
-          button.getValue());
-      assertUndefined('Button\'s tooltip must have been deleted',
-          button.getTooltip());
-    }
-
-    function testBasicButtonBehavior() {
-      var dispatchedActionCount = 0;
-      var handleAction = function() {
-        dispatchedActionCount++;
-      };
-      goog.events.listen(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-
-      button.decorate(demoButtonElement);
-      goog.testing.events.fireClickSequence(demoButtonElement);
-      assertEquals('Button must have dispatched ACTION on click', 1,
-          dispatchedActionCount);
-
-      dispatchedActionCount = 0;
-      var e = new goog.events.Event(goog.events.KeyHandler.EventType.KEY,
-          button);
-      e.keyCode = goog.events.KeyCodes.ENTER;
-      button.handleKeyEvent(e);
-      assertEquals('Enabled button must have dispatched ACTION on Enter key', 1,
-          dispatchedActionCount);
-
-      dispatchedActionCount = 0;
-      e = new goog.events.Event(goog.events.EventType.KEYUP, button);
-      e.keyCode = goog.events.KeyCodes.SPACE;
-      button.handleKeyEvent(e);
-      assertEquals('Enabled button must have dispatched ACTION on Space key', 1,
-          dispatchedActionCount);
-
-      goog.events.unlisten(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-    }
-
-    function testDisabledButtonBehavior() {
-      var dispatchedActionCount = 0;
-      var handleAction = function() {
-        dispatchedActionCount++;
-      };
-      goog.events.listen(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-
-      button.setEnabled(false);
-
-      dispatchedActionCount = 0;
-      button.handleKeyEvent({keyCode: goog.events.KeyCodes.ENTER});
-      assertEquals('Disabled button must have dispatched ACTION on Enter key',
-          0, dispatchedActionCount);
-
-      dispatchedActionCount = 0;
-      button.handleKeyEvent({
-        keyCode: goog.events.KeyCodes.SPACE,
-        type: goog.events.EventType.KEYUP
-      });
-      assertEquals('Disabled button must not have dispatched ACTION on Space',
-          0, dispatchedActionCount);
-
-      goog.events.unlisten(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-    }
-
-    function testSpaceFireActionOnKeyUp() {
-      var dispatchedActionCount = 0;
-      var handleAction = function() {
-        dispatchedActionCount++;
-      };
-      goog.events.listen(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-
-      dispatchedActionCount = 0;
-      e = new goog.events.Event(goog.events.KeyHandler.EventType.KEY, button);
-      e.keyCode = goog.events.KeyCodes.SPACE;
-      button.handleKeyEvent(e);
-      assertEquals('Button must not have dispatched ACTION on Space keypress',
-          0, dispatchedActionCount);
-      assertEquals('The default action (scrolling) must have been prevented ' +
-                   'for Space keypress',
-                   false,
-                   e.returnValue_);
-
-
-      dispatchedActionCount = 0;
-      e = new goog.events.Event(goog.events.EventType.KEYUP, button);
-      e.keyCode = goog.events.KeyCodes.SPACE;
-      button.handleKeyEvent(e);
-      assertEquals('Button must have dispatched ACTION on Space keyup',
-          1, dispatchedActionCount);
-
-      goog.events.unlisten(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-    }
-
-    function testEnterFireActionOnKeyPress() {
-      var dispatchedActionCount = 0;
-      var handleAction = function() {
-        dispatchedActionCount++;
-      };
-      goog.events.listen(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-
-      dispatchedActionCount = 0;
-      e = new goog.events.Event(goog.events.KeyHandler.EventType.KEY, button);
-      e.keyCode = goog.events.KeyCodes.ENTER;
-      button.handleKeyEvent(e);
-      assertEquals('Button must have dispatched ACTION on Enter keypress',
-          1, dispatchedActionCount);
-
-      dispatchedActionCount = 0;
-      e = new goog.events.Event(goog.events.EventType.KEYUP, button);
-      e.keyCode = goog.events.KeyCodes.ENTER;
-      button.handleKeyEvent(e);
-      assertEquals('Button must not have dispatched ACTION on Enter keyup',
-          0, dispatchedActionCount);
-
-      goog.events.unlisten(button, goog.ui.Component.EventType.ACTION,
-          handleAction);
-    }
-
-  </script>
-</body>
-</html>

data/closure-library/closure/goog/ui/buttonrenderer.js

@@ -1,205 +0,0 @@
-// Copyright 2008 The Closure Library Authors. All Rights Reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//      http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS-IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-/**
- * @fileoverview Default renderer for {@link goog.ui.Button}s.
- *
- */
-
-goog.provide('goog.ui.ButtonRenderer');
-
-goog.require('goog.dom.a11y');
-goog.require('goog.dom.a11y.Role');
-goog.require('goog.dom.a11y.State');
-goog.require('goog.ui.ButtonSide');
-goog.require('goog.ui.Component.State');
-goog.require('goog.ui.ControlRenderer');
-
-
-
-/**
- * Default renderer for {@link goog.ui.Button}s.  Extends the superclass with
- * the following button-specific API methods:
- * <ul>
- *   <li>{@code getValue} - returns the button element's value
- *   <li>{@code setValue} - updates the button element to reflect its new value
- *   <li>{@code getTooltip} - returns the button element's tooltip text
- *   <li>{@code setTooltip} - updates the button element's tooltip text
- *   <li>{@code setCollapsed} - removes one or both of the button element's
- *       borders
- * </ul>
- * For alternate renderers, see {@link goog.ui.NativeButtonRenderer},
- * {@link goog.ui.CustomButtonRenderer}, and {@link goog.ui.FlatButtonRenderer}.
- * @constructor
- * @extends {goog.ui.ControlRenderer}
- */
-goog.ui.ButtonRenderer = function() {
-  goog.ui.ControlRenderer.call(this);
-};
-goog.inherits(goog.ui.ButtonRenderer, goog.ui.ControlRenderer);
-goog.addSingletonGetter(goog.ui.ButtonRenderer);
-
-
-/**
- * Default CSS class to be applied to the root element of components rendered
- * by this renderer.
- * @type {string}
- */
-goog.ui.ButtonRenderer.CSS_CLASS = goog.getCssName('goog-button');
-
-
-/**
- * Returns the ARIA role to be applied to buttons.
- * @return {goog.dom.a11y.Role|undefined} ARIA role.
- * @override
- */
-goog.ui.ButtonRenderer.prototype.getAriaRole = function() {
-  return goog.dom.a11y.Role.BUTTON;
-};
-
-
-/**
- * Updates the button's ARIA (accessibility) state if the button is being
- * treated as a checkbox.
- * @param {Element} element Element whose ARIA state is to be updated.
- * @param {goog.ui.Component.State} state Component state being enabled or
- *     disabled.
- * @param {boolean} enable Whether the state is being enabled or disabled.
- * @protected
- * @override
- */
-goog.ui.ButtonRenderer.prototype.updateAriaState = function(element, state,
-    enable) {
-  // If button has CHECKED state, assign ARIA atrribute aria-pressed
-  if (state == goog.ui.Component.State.CHECKED) {
-    goog.dom.a11y.setState(element, goog.dom.a11y.State.PRESSED, enable);
-  } else {
-    goog.ui.ButtonRenderer.superClass_.updateAriaState.call(this, element,
-        state, enable);
-  }
-};
-
-
-/** @inheritDoc */
-goog.ui.ButtonRenderer.prototype.createDom = function(button) {
-  var element = goog.ui.ButtonRenderer.superClass_.createDom.call(this, button);
-
-  var tooltip = button.getTooltip();
-  if (tooltip) {
-    this.setTooltip(element, tooltip);
-  }
-
-  var value = button.getValue();
-  if (value) {
-    this.setValue(element, value);
-  }
-
-  // Set aria-pressed to false initially.
-  if (button.isSupportedState(goog.ui.Component.State.CHECKED)) {
-    this.updateAriaState(element, goog.ui.Component.State.CHECKED, false);
-  }
-
-  return element;
-};
-
-
-/** @inheritDoc */
-goog.ui.ButtonRenderer.prototype.decorate = function(button, element) {
-  // The superclass implementation takes care of common attributes; we only
-  // need to set the value and the tooltip.
-  element = goog.ui.ButtonRenderer.superClass_.decorate.call(this, button,
-      element);
-
-  button.setValueInternal(this.getValue(element));
-  button.setTooltipInternal(this.getTooltip(element));
-
-  // Set aria-pressed to false initially.
-  if (button.isSupportedState(goog.ui.Component.State.CHECKED)) {
-    this.updateAriaState(element, goog.ui.Component.State.CHECKED, false);
-  }
-
-  return element;
-};
-
-
-/**
- * Takes a button's root element, and returns the value associated with it.
- * No-op in the base class.
- * @param {Element} element The button's root element.
- * @return {string|undefined} The button's value (undefined if none).
- */
-goog.ui.ButtonRenderer.prototype.getValue = goog.nullFunction;
-
-
-/**
- * Takes a button's root element and a value, and updates the element to reflect
- * the new value.  No-op in the base class.
- * @param {Element} element The button's root element.
- * @param {string} value New value.
- * @protected
- */
-goog.ui.ButtonRenderer.prototype.setValue = goog.nullFunction;
-
-
-/**
- * Takes a button's root element, and returns its tooltip text.
- * @param {Element} element The button's root element.
- * @return {string|undefined} The tooltip text.
- */
-goog.ui.ButtonRenderer.prototype.getTooltip = function(element) {
-  return element.title;
-};
-
-
-/**
- * Takes a button's root element and a tooltip string, and updates the element
- * with the new tooltip.
- * @param {Element} element The button's root element.
- * @param {string} tooltip New tooltip text.
- * @protected
- */
-goog.ui.ButtonRenderer.prototype.setTooltip = function(element, tooltip) {
-  if (element) {
-    element.title = tooltip || '';
-  }
-};
-
-
-/**
- * Collapses the border on one or both sides of the button, allowing it to be
- * combined with the adjacent button(s), forming a single UI componenet with
- * multiple targets.
- * @param {goog.ui.Button} button Button to update.
- * @param {number} sides Bitmap of one or more {@link goog.ui.ButtonSide}s for
- *     which borders should be collapsed.
- * @protected
- */
-goog.ui.ButtonRenderer.prototype.setCollapsed = function(button, sides) {
-  var isRtl = button.isRightToLeft();
-  var collapseLeftClassName =
-      goog.getCssName(this.getStructuralCssClass(), 'collapse-left');
-  var collapseRightClassName =
-      goog.getCssName(this.getStructuralCssClass(), 'collapse-right');
-
-  button.enableClassName(isRtl ? collapseRightClassName : collapseLeftClassName,
-      !!(sides & goog.ui.ButtonSide.START));
-  button.enableClassName(isRtl ? collapseLeftClassName : collapseRightClassName,
-      !!(sides & goog.ui.ButtonSide.END));
-};
-
-
-/** @inheritDoc */
-goog.ui.ButtonRenderer.prototype.getCssClass = function() {
-  return goog.ui.ButtonRenderer.CSS_CLASS;
-};