diff options
Diffstat (limited to 'contexts/data/lib/closure-library/closure/goog/ui/editor/defaulttoolbar.js')
| -rw-r--r-- | contexts/data/lib/closure-library/closure/goog/ui/editor/defaulttoolbar.js | 1064 |
1 files changed, 0 insertions, 1064 deletions
diff --git a/contexts/data/lib/closure-library/closure/goog/ui/editor/defaulttoolbar.js b/contexts/data/lib/closure-library/closure/goog/ui/editor/defaulttoolbar.js deleted file mode 100644 index 5746bba..0000000 --- a/contexts/data/lib/closure-library/closure/goog/ui/editor/defaulttoolbar.js +++ /dev/null @@ -1,1064 +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 Factory functions for creating a default editing toolbar. - * - * @author attila@google.com (Attila Bodis) - * @author jparent@google.com (Julie Parent) - * @see ../../demos/editor/editor.html - */ - -goog.provide('goog.ui.editor.DefaultToolbar'); - -goog.require('goog.dom'); -goog.require('goog.dom.TagName'); -goog.require('goog.dom.classes'); -goog.require('goog.editor.Command'); -goog.require('goog.style'); -goog.require('goog.ui.ControlContent'); -goog.require('goog.ui.editor.ToolbarFactory'); -goog.require('goog.ui.editor.messages'); - -// Font menu creation. - - -/** @desc Font menu item caption for the default sans-serif font. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_NORMAL = goog.getMsg('Normal'); - - -/** @desc Font menu item caption for the default serif font. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_NORMAL_SERIF = - goog.getMsg('Normal / serif'); - - -/** - * Common font descriptors for all locales. Each descriptor has the following - * attributes: - * <ul> - * <li>{@code caption} - Caption to show in the font menu (e.g. 'Tahoma') - * <li>{@code value} - Value for the corresponding 'font-family' CSS style - * (e.g. 'Tahoma, Arial, sans-serif') - * </ul> - * @type {!Array.<{caption:string, value:string}>} - * @private - */ -goog.ui.editor.DefaultToolbar.FONTS_ = [ - { - caption: goog.ui.editor.DefaultToolbar.MSG_FONT_NORMAL, - value: 'arial,sans-serif' - }, - { - caption: goog.ui.editor.DefaultToolbar.MSG_FONT_NORMAL_SERIF, - value: 'times new roman,serif' - }, - {caption: 'Courier New', value: 'courier new,monospace'}, - {caption: 'Georgia', value: 'georgia,serif'}, - {caption: 'Trebuchet', value: 'trebuchet ms,sans-serif'}, - {caption: 'Verdana', value: 'verdana,sans-serif'} -]; - - -/** - * Locale-specific font descriptors. The object is a map of locale strings to - * arrays of font descriptors. - * @type {!Object.<!Array.<{caption:string, value:string}>>} - * @private - */ -goog.ui.editor.DefaultToolbar.I18N_FONTS_ = { - 'ja': [{ - caption: '\uff2d\uff33 \uff30\u30b4\u30b7\u30c3\u30af', - value: 'ms pgothic,sans-serif' - }, { - caption: '\uff2d\uff33 \uff30\u660e\u671d', - value: 'ms pmincho,serif' - }, { - caption: '\uff2d\uff33 \u30b4\u30b7\u30c3\u30af', - value: 'ms gothic,monospace' - }], - 'ko': [{ - caption: '\uad74\ub9bc', - value: 'gulim,sans-serif' - }, { - caption: '\ubc14\ud0d5', - value: 'batang,serif' - }, { - caption: '\uad74\ub9bc\uccb4', - value: 'gulimche,monospace' - }], - 'zh-tw': [{ - caption: '\u65b0\u7d30\u660e\u9ad4', - value: 'pmingliu,serif' - }, { - caption: '\u7d30\u660e\u9ad4', - value: 'mingliu,serif' - }], - 'zh-cn': [{ - caption: '\u5b8b\u4f53', - value: 'simsun,serif' - }, { - caption: '\u9ed1\u4f53', - value: 'simhei,sans-serif' - }, { - caption: 'MS Song', - value: 'ms song,monospace' - }] -}; - - -/** - * Default locale for font names. - * @type {string} - * @private - */ -goog.ui.editor.DefaultToolbar.locale_ = 'en-us'; - - -/** - * Sets the locale for the font names. If not set, defaults to 'en-us'. - * Used only for default creation of font names name. Must be set - * before font name menu is created. - * @param {string} locale Locale to use for the toolbar font names. - */ -goog.ui.editor.DefaultToolbar.setLocale = function(locale) { - goog.ui.editor.DefaultToolbar.locale_ = locale; -}; - - -/** - * Initializes the given font menu button by adding default fonts to the menu. - * If goog.ui.editor.DefaultToolbar.setLocale was called to specify a locale - * for which locale-specific default fonts exist, those are added before - * common fonts. - * @param {!goog.ui.Select} button Font menu button. - */ -goog.ui.editor.DefaultToolbar.addDefaultFonts = function(button) { - // Normalize locale to lowercase, with a hyphen (see bug 1036165). - var locale = - goog.ui.editor.DefaultToolbar.locale_.replace(/_/, '-').toLowerCase(); - // Add locale-specific default fonts, if any. - var fontlist = []; - - if (locale in goog.ui.editor.DefaultToolbar.I18N_FONTS_) { - fontlist = goog.ui.editor.DefaultToolbar.I18N_FONTS_[locale]; - } - if (fontlist.length) { - goog.ui.editor.ToolbarFactory.addFonts(button, fontlist); - } - // Add locale-independent default fonts. - goog.ui.editor.ToolbarFactory.addFonts(button, - goog.ui.editor.DefaultToolbar.FONTS_); -}; - - -// Font size menu creation. - - -/** @desc Font size menu item caption for the 'Small' size. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_SMALL = goog.getMsg('Small'); - - -/** @desc Font size menu item caption for the 'Normal' size. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_NORMAL = goog.getMsg('Normal'); - - -/** @desc Font size menu item caption for the 'Large' size. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_LARGE = goog.getMsg('Large'); - - -/** @desc Font size menu item caption for the 'Huge' size. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_HUGE = goog.getMsg('Huge'); - - -/** - * Font size descriptors, each with the following attributes: - * <ul> - * <li>{@code caption} - Caption to show in the font size menu (e.g. 'Huge') - * <li>{@code value} - Value for the corresponding HTML font size (e.g. 6) - * </ul> - * @type {!Array.<{caption:string, value:number}>} - * @private - */ -goog.ui.editor.DefaultToolbar.FONT_SIZES_ = [ - {caption: goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_SMALL, value: 1}, - {caption: goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_NORMAL, value: 2}, - {caption: goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_LARGE, value: 4}, - {caption: goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_HUGE, value: 6} -]; - - -/** - * Initializes the given font size menu button by adding default font sizes to - * it. - * @param {!goog.ui.Select} button Font size menu button. - */ -goog.ui.editor.DefaultToolbar.addDefaultFontSizes = function(button) { - goog.ui.editor.ToolbarFactory.addFontSizes(button, - goog.ui.editor.DefaultToolbar.FONT_SIZES_); -}; - - -// Header format menu creation. - - -/** @desc Caption for "Heading" block format option. */ -goog.ui.editor.DefaultToolbar.MSG_FORMAT_HEADING = goog.getMsg('Heading'); - - -/** @desc Caption for "Subheading" block format option. */ -goog.ui.editor.DefaultToolbar.MSG_FORMAT_SUBHEADING = goog.getMsg('Subheading'); - - -/** @desc Caption for "Minor heading" block format option. */ -goog.ui.editor.DefaultToolbar.MSG_FORMAT_MINOR_HEADING = - goog.getMsg('Minor heading'); - - -/** @desc Caption for "Normal" block format option. */ -goog.ui.editor.DefaultToolbar.MSG_FORMAT_NORMAL = goog.getMsg('Normal'); - - -/** - * Format option descriptors, each with the following attributes: - * <ul> - * <li>{@code caption} - Caption to show in the menu (e.g. 'Minor heading') - * <li>{@code command} - Corresponding {@link goog.dom.TagName} (e.g. - * 'H4') - * </ul> - * @type {!Array.<{caption:string, command:string}>} - * @private - */ -goog.ui.editor.DefaultToolbar.FORMAT_OPTIONS_ = [ - { - caption: goog.ui.editor.DefaultToolbar.MSG_FORMAT_HEADING, - command: goog.dom.TagName.H2 - }, - { - caption: goog.ui.editor.DefaultToolbar.MSG_FORMAT_SUBHEADING, - command: goog.dom.TagName.H3 - }, - { - caption: goog.ui.editor.DefaultToolbar.MSG_FORMAT_MINOR_HEADING, - command: goog.dom.TagName.H4 - }, - { - caption: goog.ui.editor.DefaultToolbar.MSG_FORMAT_NORMAL, - command: goog.dom.TagName.P - } -]; - - -/** - * Initializes the given "Format block" menu button by adding default format - * options to the menu. - * @param {!goog.ui.Select} button "Format block" menu button. - */ -goog.ui.editor.DefaultToolbar.addDefaultFormatOptions = function(button) { - goog.ui.editor.ToolbarFactory.addFormatOptions(button, - goog.ui.editor.DefaultToolbar.FORMAT_OPTIONS_); -}; - - -/** - * Creates a {@link goog.ui.Toolbar} containing a default set of editor - * toolbar buttons, and renders it into the given parent element. - * @param {!Element} elem Toolbar parent element. - * @param {boolean=} opt_isRightToLeft Whether the editor chrome is - * right-to-left; defaults to the directionality of the toolbar parent - * element. - * @return {!goog.ui.Toolbar} Default editor toolbar, rendered into the given - * parent element. - * @see goog.ui.editor.DefaultToolbar.DEFAULT_BUTTONS - */ -goog.ui.editor.DefaultToolbar.makeDefaultToolbar = function(elem, - opt_isRightToLeft) { - var isRightToLeft = opt_isRightToLeft || goog.style.isRightToLeft(elem); - var buttons = isRightToLeft ? - goog.ui.editor.DefaultToolbar.DEFAULT_BUTTONS_RTL : - goog.ui.editor.DefaultToolbar.DEFAULT_BUTTONS; - return goog.ui.editor.DefaultToolbar.makeToolbar(buttons, elem, - opt_isRightToLeft); -}; - - -/** - * Creates a {@link goog.ui.Toolbar} containing the specified set of - * toolbar buttons, and renders it into the given parent element. Each - * item in the {@code items} array must either be a - * {@link goog.editor.Command} (to create a built-in button) or a subclass - * of {@link goog.ui.Control} (to create a custom control). - * @param {!Array.<string|goog.ui.Control>} items Toolbar items; each must - * be a {@link goog.editor.Command} or a {@link goog.ui.Control}. - * @param {!Element} elem Toolbar parent element. - * @param {boolean=} opt_isRightToLeft Whether the editor chrome is - * right-to-left; defaults to the directionality of the toolbar parent - * element. - * @return {!goog.ui.Toolbar} Editor toolbar, rendered into the given parent - * element. - */ -goog.ui.editor.DefaultToolbar.makeToolbar = function(items, elem, - opt_isRightToLeft) { - var domHelper = goog.dom.getDomHelper(elem); - var controls = []; - - for (var i = 0, button; button = items[i]; i++) { - if (goog.isString(button)) { - button = goog.ui.editor.DefaultToolbar.makeBuiltInToolbarButton(button, - domHelper); - } - if (button) { - controls.push(button); - } - } - - return goog.ui.editor.ToolbarFactory.makeToolbar(controls, elem, - opt_isRightToLeft); -}; - - -/** - * Creates an instance of a subclass of {@link goog.ui.Button} for the given - * {@link goog.editor.Command}, or null if no built-in button exists for the - * command. Note that this function is only intended to create built-in - * buttons; please don't try to hack it! - * @param {string} command Editor command ID. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {goog.ui.Button} Toolbar button (null if no built-in button exists - * for the command). - */ -goog.ui.editor.DefaultToolbar.makeBuiltInToolbarButton = function(command, - opt_domHelper) { - var button; - var descriptor = goog.ui.editor.DefaultToolbar.buttons_[command]; - if (descriptor) { - // Default the factory method to makeToggleButton, since most built-in - // toolbar buttons are toggle buttons. See also - // goog.ui.editor.DefaultToolbar.BUTTONS_. - var factory = descriptor.factory || - goog.ui.editor.ToolbarFactory.makeToggleButton; - var id = descriptor.command; - var tooltip = descriptor.tooltip; - var caption = descriptor.caption; - var classNames = descriptor.classes; - // Default the DOM helper to the one for the current document. - var domHelper = opt_domHelper || goog.dom.getDomHelper(); - // Instantiate the button based on the descriptor. - button = factory(id, tooltip, caption, classNames, null, domHelper); - // If this button's state should be queried when updating the toolbar, - // set the button object's queryable property to true. - if (descriptor.queryable) { - button.queryable = true; - } - } - return button; -}; - - -/** - * A set of built-in buttons to display in the default editor toolbar. - * @type {!Array.<string>} - */ -goog.ui.editor.DefaultToolbar.DEFAULT_BUTTONS = [ - goog.editor.Command.IMAGE, - goog.editor.Command.LINK, - goog.editor.Command.BOLD, - goog.editor.Command.ITALIC, - goog.editor.Command.UNORDERED_LIST, - goog.editor.Command.FONT_COLOR, - goog.editor.Command.FONT_FACE, - goog.editor.Command.FONT_SIZE, - goog.editor.Command.JUSTIFY_LEFT, - goog.editor.Command.JUSTIFY_CENTER, - goog.editor.Command.JUSTIFY_RIGHT, - goog.editor.Command.EDIT_HTML -]; - - -/** - * A set of built-in buttons to display in the default editor toolbar when - * the editor chrome is right-to-left (BiDi mode only). - * @type {!Array.<string>} - */ -goog.ui.editor.DefaultToolbar.DEFAULT_BUTTONS_RTL = [ - goog.editor.Command.IMAGE, - goog.editor.Command.LINK, - goog.editor.Command.BOLD, - goog.editor.Command.ITALIC, - goog.editor.Command.UNORDERED_LIST, - goog.editor.Command.FONT_COLOR, - goog.editor.Command.FONT_FACE, - goog.editor.Command.FONT_SIZE, - goog.editor.Command.JUSTIFY_RIGHT, - goog.editor.Command.JUSTIFY_CENTER, - goog.editor.Command.JUSTIFY_LEFT, - goog.editor.Command.DIR_RTL, - goog.editor.Command.DIR_LTR, - goog.editor.Command.EDIT_HTML -]; - - -/** - * Creates a toolbar button with the given ID, tooltip, and caption. Applies - * any custom CSS class names to the button's caption element. This button - * is designed to be used as the RTL button. - * @param {string} id Button ID; must equal a {@link goog.editor.Command} for - * built-in buttons, anything else for custom buttons. - * @param {string} tooltip Tooltip to be shown on hover. - * @param {goog.ui.ControlContent} caption Button caption. - * @param {string=} opt_classNames CSS class name(s) to apply to the caption - * element. - * @param {goog.ui.ButtonRenderer=} opt_renderer Button renderer; defaults to - * {@link goog.ui.ToolbarButtonRenderer} if unspecified. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {!goog.ui.Button} A toolbar button. - * @private - */ -goog.ui.editor.DefaultToolbar.rtlButtonFactory_ = function(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper) { - var button = goog.ui.editor.ToolbarFactory.makeToggleButton(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper); - button.updateFromValue = function(value) { - // Enable/disable right-to-left text editing mode in the toolbar. - var isRtl = !!value; - // Enable/disable a marker class on the toolbar's root element; the rest is - // done using CSS scoping in editortoolbar.css. This changes - // direction-senitive toolbar icons (like indent/outdent) - goog.dom.classes.enable( - button.getParent().getElement(), goog.getCssName('tr-rtl-mode'), isRtl); - button.setChecked(isRtl); - } - return button; -}; - - -/** - * Creates a toolbar button with the given ID, tooltip, and caption. Applies - * any custom CSS class names to the button's caption element. Designed to - * be used to create undo and redo buttons. - * @param {string} id Button ID; must equal a {@link goog.editor.Command} for - * built-in buttons, anything else for custom buttons. - * @param {string} tooltip Tooltip to be shown on hover. - * @param {goog.ui.ControlContent} caption Button caption. - * @param {string=} opt_classNames CSS class name(s) to apply to the caption - * element. - * @param {goog.ui.ButtonRenderer=} opt_renderer Button renderer; defaults to - * {@link goog.ui.ToolbarButtonRenderer} if unspecified. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {!goog.ui.Button} A toolbar button. - * @private - */ -goog.ui.editor.DefaultToolbar.undoRedoButtonFactory_ = function(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper) { - var button = goog.ui.editor.ToolbarFactory.makeButton(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper); - button.updateFromValue = function(value) { - button.setEnabled(value); - } - return button; -}; - - -/** - * Creates a toolbar button with the given ID, tooltip, and caption. Applies - * any custom CSS class names to the button's caption element. Used to create - * a font face button, filled with default fonts. - * @param {string} id Button ID; must equal a {@link goog.editor.Command} for - * built-in buttons, anything else for custom buttons. - * @param {string} tooltip Tooltip to be shown on hover. - * @param {goog.ui.ControlContent} caption Button caption. - * @param {string=} opt_classNames CSS class name(s) to apply to the caption - * element. - * @param {goog.ui.MenuButtonRenderer=} opt_renderer Button renderer; defaults - * to {@link goog.ui.ToolbarMenuButtonRenderer} if unspecified. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {!goog.ui.Button} A toolbar button. - * @private - */ -goog.ui.editor.DefaultToolbar.fontFaceFactory_ = function(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper) { - var button = goog.ui.editor.ToolbarFactory.makeSelectButton(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper); - goog.ui.editor.DefaultToolbar.addDefaultFonts(button); - button.setDefaultCaption(goog.ui.editor.DefaultToolbar.MSG_FONT_NORMAL); - // Font options don't have keyboard accelerators. - goog.dom.classes.add(button.getMenu().getContentElement(), - goog.getCssName('goog-menu-noaccel')); - - // How to update this button's state. - button.updateFromValue = function(value) { - // Normalize value to null or a non-empty string (sometimes we get - // the empty string, sometimes we get false...), extract the substring - // up to the first comma to get the primary font name, and normalize - // to lowercase. This allows us to map a font spec like "Arial, - // Helvetica, sans-serif" to a font menu item. - // TODO (attila): Try to make this more robust. - var item = null; - if (value && value.length > 0) { - item = /** @type {goog.ui.MenuItem} */ (button.getMenu().getChild( - goog.ui.editor.ToolbarFactory.getPrimaryFont(value))); - } - var selectedItem = button.getSelectedItem(); - if (item != selectedItem) { - button.setSelectedItem(item); - } - } - return button; -}; - - -/** - * Creates a toolbar button with the given ID, tooltip, and caption. Applies - * any custom CSS class names to the button's caption element. Use to create a - * font size button, filled with default font sizes. - * @param {string} id Button ID; must equal a {@link goog.editor.Command} for - * built-in buttons, anything else for custom buttons. - * @param {string} tooltip Tooltip to be shown on hover. - * @param {goog.ui.ControlContent} caption Button caption. - * @param {string=} opt_classNames CSS class name(s) to apply to the caption - * element. - * @param {goog.ui.MenuButtonRenderer=} opt_renderer Button renderer; defaults - * to {@link goog.ui.ToolbarMebuButtonRenderer} if unspecified. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {!goog.ui.Button} A toolbar button. - * @private - */ -goog.ui.editor.DefaultToolbar.fontSizeFactory_ = function(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper) { - var button = goog.ui.editor.ToolbarFactory.makeSelectButton(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper); - goog.ui.editor.DefaultToolbar.addDefaultFontSizes(button); - button.setDefaultCaption(goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_NORMAL); - // Font size options don't have keyboard accelerators. - goog.dom.classes.add(button.getMenu().getContentElement(), - goog.getCssName('goog-menu-noaccel')); - // How to update this button's state. - button.updateFromValue = function(value) { - // Webkit pre-534.7 returns a string like '32px' instead of the equivalent - // integer, so normalize that first. - // NOTE(user): Gecko returns "6" so can't just normalize all - // strings, only ones ending in "px". - if (goog.isString(value) && - goog.style.getLengthUnits(value) == 'px') { - value = goog.ui.editor.ToolbarFactory.getLegacySizeFromPx( - parseInt(value, 10)); - } - // Normalize value to null or a positive integer (sometimes we get - // the empty string, sometimes we get false, or -1 if the above - // normalization didn't match to a particular 0-7 size) - value = value > 0 ? value : null; - if (value != button.getValue()) { - button.setValue(value); - } - } - return button; -}; - - -/** - * Function to update the state of a color menu button. - * @param {goog.ui.ToolbarColorMenuButton} button The button to which the - * color menu is attached. - * @param {number} color Color value to update to. - * @private - */ -goog.ui.editor.DefaultToolbar.colorUpdateFromValue_ = function(button, color) { - var value = color; - /** @preserveTry */ - try { - if (goog.userAgent.IE) { - // IE returns a number that, converted to hex, is a BGR color. - // Convert from decimal to BGR to RGB. - var hex = '000000' + value.toString(16); - var bgr = hex.substr(hex.length - 6, 6); - value = '#' + bgr.substring(4, 6) + bgr.substring(2, 4) + - bgr.substring(0, 2); - } - if (value != button.getValue()) { - button.setValue(/** @type {string} */ (value)); - } - } catch (ex) { - // TODO(attila): Find out when/why this happens. - } -}; - - -/** - * Creates a toolbar button with the given ID, tooltip, and caption. Applies - * any custom CSS class names to the button's caption element. Use to create - * a font color button. - * @param {string} id Button ID; must equal a {@link goog.editor.Command} for - * built-in buttons, anything else for custom buttons. - * @param {string} tooltip Tooltip to be shown on hover. - * @param {goog.ui.ControlContent} caption Button caption. - * @param {string=} opt_classNames CSS class name(s) to apply to the caption - * element. - * @param {goog.ui.ColorMenuButtonRenderer=} opt_renderer Button renderer; - * defaults to {@link goog.ui.ToolbarColorMenuButtonRenderer} if - * unspecified. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {!goog.ui.Button} A toolbar button. - * @private - */ -goog.ui.editor.DefaultToolbar.fontColorFactory_ = function(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper) { - var button = goog.ui.editor.ToolbarFactory.makeColorMenuButton(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper); - // Initialize default foreground color. - button.setSelectedColor('#000'); - button.updateFromValue = goog.partial( - goog.ui.editor.DefaultToolbar.colorUpdateFromValue_, button); - return button; -}; - - -/** - * Creates a toolbar button with the given ID, tooltip, and caption. Applies - * any custom CSS class names to the button's caption element. Use to create - * a font background color button. - * @param {string} id Button ID; must equal a {@link goog.editor.Command} for - * built-in buttons, anything else for custom buttons. - * @param {string} tooltip Tooltip to be shown on hover. - * @param {goog.ui.ControlContent} caption Button caption. - * @param {string=} opt_classNames CSS class name(s) to apply to the caption - * element. - * @param {goog.ui.ColorMenuButtonRenderer=} opt_renderer Button renderer; - * defaults to {@link goog.ui.ToolbarColorMenuButtonRenderer} if - * unspecified. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {!goog.ui.Button} A toolbar button. - * @private - */ -goog.ui.editor.DefaultToolbar.backgroundColorFactory_ = function(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper) { - var button = goog.ui.editor.ToolbarFactory.makeColorMenuButton(id, - tooltip, caption, opt_classNames, opt_renderer, opt_domHelper); - // Initialize default background color. - button.setSelectedColor('#FFF'); - button.updateFromValue = goog.partial( - goog.ui.editor.DefaultToolbar.colorUpdateFromValue_, button); - return button; -}; - - -/** - * Creates a toolbar button with the given ID, tooltip, and caption. Applies - * any custom CSS class names to the button's caption element. Use to create - * the format menu, prefilled with default formats. - * @param {string} id Button ID; must equal a {@link goog.editor.Command} for - * built-in buttons, anything else for custom buttons. - * @param {string} tooltip Tooltip to be shown on hover. - * @param {goog.ui.ControlContent} caption Button caption. - * @param {string=} opt_classNames CSS class name(s) to apply to the caption - * element. - * @param {goog.ui.MenuButtonRenderer=} opt_renderer Button renderer; - * defaults to - * {@link goog.ui.ToolbarMenuButtonRenderer} if unspecified. - * @param {goog.dom.DomHelper=} opt_domHelper DOM helper, used for DOM - * creation; defaults to the current document if unspecified. - * @return {!goog.ui.Button} A toolbar button. - * @private - */ -goog.ui.editor.DefaultToolbar.formatBlockFactory_ = function(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper) { - var button = goog.ui.editor.ToolbarFactory.makeSelectButton(id, tooltip, - caption, opt_classNames, opt_renderer, opt_domHelper); - goog.ui.editor.DefaultToolbar.addDefaultFormatOptions(button); - button.setDefaultCaption(goog.ui.editor.DefaultToolbar.MSG_FORMAT_NORMAL); - // Format options don't have keyboard accelerators. - goog.dom.classes.add(button.getMenu().getContentElement(), - goog.getCssName('goog-menu-noaccel')); - // How to update this button. - button.updateFromValue = function(value) { - // Normalize value to null or a nonempty string (sometimes we get - // the empty string, sometimes we get false...) - value = value && value.length > 0 ? value : null; - if (value != button.getValue()) { - button.setValue(value); - } - } - return button; -}; - - -// Messages used for tooltips and captions. - - -/** @desc Format menu tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_FORMAT_BLOCK_TITLE = goog.getMsg('Format'); - - -/** @desc Format menu caption. */ -goog.ui.editor.DefaultToolbar.MSG_FORMAT_BLOCK_CAPTION = goog.getMsg('Format'); - - -/** @desc Undo button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_UNDO_TITLE = goog.getMsg('Undo'); - - -/** @desc Redo button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_REDO_TITLE = goog.getMsg('Redo'); - - -/** @desc Font menu tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_FACE_TITLE = goog.getMsg('Font'); - - -/** @desc Font size menu tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_TITLE = goog.getMsg('Font size'); - - -/** @desc Text foreground color menu tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_FONT_COLOR_TITLE = goog.getMsg('Text color'); - - -/** @desc Bold button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_BOLD_TITLE = goog.getMsg('Bold'); - - -/** @desc Italic button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_ITALIC_TITLE = goog.getMsg('Italic'); - - -/** @desc Underline button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_UNDERLINE_TITLE = goog.getMsg('Underline'); - - -/** @desc Text background color menu tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_BACKGROUND_COLOR_TITLE = - goog.getMsg('Text background color'); - - -/** @desc Link button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_LINK_TITLE = - goog.getMsg('Add or remove link'); - - -/** @desc Numbered list button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_ORDERED_LIST_TITLE = - goog.getMsg('Numbered list'); - - -/** @desc Bullet list button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_UNORDERED_LIST_TITLE = - goog.getMsg('Bullet list'); - - -/** @desc Outdent button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_OUTDENT_TITLE = - goog.getMsg('Decrease indent'); - - -/** @desc Indent button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_INDENT_TITLE = goog.getMsg('Increase indent'); - - -/** @desc Align left button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_ALIGN_LEFT_TITLE = goog.getMsg('Align left'); - - -/** @desc Align center button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_ALIGN_CENTER_TITLE = - goog.getMsg('Align center'); - - -/** @desc Align right button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_ALIGN_RIGHT_TITLE = - goog.getMsg('Align right'); - - -/** @desc Justify button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_JUSTIFY_TITLE = goog.getMsg('Justify'); - - -/** @desc Remove formatting button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_REMOVE_FORMAT_TITLE = - goog.getMsg('Remove formatting'); - - -/** @desc Insert image button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_IMAGE_TITLE = goog.getMsg('Insert image'); - - -/** @desc Strike through button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_STRIKE_THROUGH_TITLE = - goog.getMsg('Strikethrough'); - - -/** @desc Left-to-right button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_DIR_LTR_TITLE = goog.getMsg('Left-to-right'); - - -/** @desc Right-to-left button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_DIR_RTL_TITLE = goog.getMsg('Right-to-left'); - - -/** @desc Blockquote button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_BLOCKQUOTE_TITLE = goog.getMsg('Quote'); - - -/** @desc Edit HTML button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_EDIT_HTML_TITLE = - goog.getMsg('Edit HTML source'); - - -/** @desc Subscript button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_SUBSCRIPT = goog.getMsg('Subscript'); - - -/** @desc Superscript button tooltip. */ -goog.ui.editor.DefaultToolbar.MSG_SUPERSCRIPT = goog.getMsg('Superscript'); - - -/** @desc Edit HTML button caption. */ -goog.ui.editor.DefaultToolbar.MSG_EDIT_HTML_CAPTION = goog.getMsg('Edit HTML'); - - -/** - * Map of {@code goog.editor.Command}s to toolbar button descriptor objects, - * each of which has the following attributes: - * <ul> - * <li>{@code command} - The command corresponding to the - * button (mandatory) - * <li>{@code tooltip} - Tooltip text (optional); if unspecified, the button - * has no hover text - * <li>{@code caption} - Caption to display on the button (optional); if - * unspecified, the button has no text caption - * <li>{@code classes} - CSS class name(s) to be applied to the button's - * element when rendered (optional); if unspecified, defaults to - * 'tr-icon' - * plus 'tr-' followed by the command ID, but without any leading '+' - * character (e.g. if the command ID is '+undo', then {@code classes} - * defaults to 'tr-icon tr-undo') - * <li>{@code factory} - factory function used to create the button, which - * must accept {@code id}, {@code tooltip}, {@code caption}, and - * {@code classes} as arguments, and must return an instance of - * {@link goog.ui.Button} or an appropriate subclass (optional); if - * unspecified, defaults to - * {@link goog.ui.editor.DefaultToolbar.makeToggleButton}, - * since most built-in toolbar buttons are toggle buttons - * <li>(@code queryable} - Whether the button's state should be queried - * when updating the toolbar (optional). - * </ul> - * Note that this object is only used for creating toolbar buttons for - * built-in editor commands; custom buttons aren't listed here. Please don't - * try to hack this! - * @type {Object.<!goog.ui.editor.ButtonDescriptor>}. - * @private - */ -goog.ui.editor.DefaultToolbar.buttons_ = {}; - - -/** - * @typedef {{command: string, tooltip: ?string, - * caption: ?goog.ui.ControlContent, classes: ?string, - * factory: ?function(string, string, goog.ui.ControlContent, ?string, - * goog.ui.ButtonRenderer, goog.dom.DomHelper):goog.ui.Button, - * queryable:?boolean}} - */ -goog.ui.editor.ButtonDescriptor; - - -/** - * Built-in toolbar button descriptors. See - * {@link goog.ui.editor.DefaultToolbar.buttons_} for details on button - * descriptor objects. This array is processed at JS parse time; each item is - * inserted into {@link goog.ui.editor.DefaultToolbar.buttons_}, and the array - * itself is deleted and (hopefully) garbage-collected. - * @type {Array.<!goog.ui.editor.ButtonDescriptor>}. - * @private - */ -goog.ui.editor.DefaultToolbar.BUTTONS_ = [{ - command: goog.editor.Command.UNDO, - tooltip: goog.ui.editor.DefaultToolbar.MSG_UNDO_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-undo'), - factory: goog.ui.editor.DefaultToolbar.undoRedoButtonFactory_, - queryable: true -}, { - command: goog.editor.Command.REDO, - tooltip: goog.ui.editor.DefaultToolbar.MSG_REDO_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-redo'), - factory: goog.ui.editor.DefaultToolbar.undoRedoButtonFactory_, - queryable: true -}, { - command: goog.editor.Command.FONT_FACE, - tooltip: goog.ui.editor.DefaultToolbar.MSG_FONT_FACE_TITLE, - classes: goog.getCssName('tr-fontName'), - factory: goog.ui.editor.DefaultToolbar.fontFaceFactory_, - queryable: true -}, { - command: goog.editor.Command.FONT_SIZE, - tooltip: goog.ui.editor.DefaultToolbar.MSG_FONT_SIZE_TITLE, - classes: goog.getCssName('tr-fontSize'), - factory: goog.ui.editor.DefaultToolbar.fontSizeFactory_, - queryable: true -}, { - command: goog.editor.Command.BOLD, - tooltip: goog.ui.editor.DefaultToolbar.MSG_BOLD_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-bold'), - queryable: true -}, { - command: goog.editor.Command.ITALIC, - tooltip: goog.ui.editor.DefaultToolbar.MSG_ITALIC_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-italic'), - queryable: true -}, { - command: goog.editor.Command.UNDERLINE, - tooltip: goog.ui.editor.DefaultToolbar.MSG_UNDERLINE_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-underline'), - queryable: true -}, { - command: goog.editor.Command.FONT_COLOR, - tooltip: goog.ui.editor.DefaultToolbar.MSG_FONT_COLOR_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-foreColor'), - factory: goog.ui.editor.DefaultToolbar.fontColorFactory_, - queryable: true -}, { - command: goog.editor.Command.BACKGROUND_COLOR, - tooltip: goog.ui.editor.DefaultToolbar.MSG_BACKGROUND_COLOR_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-backColor'), - factory: goog.ui.editor.DefaultToolbar.backgroundColorFactory_, - queryable: true -}, { - command: goog.editor.Command.LINK, - tooltip: goog.ui.editor.DefaultToolbar.MSG_LINK_TITLE, - caption: goog.ui.editor.messages.MSG_LINK_CAPTION, - classes: goog.getCssName('tr-link'), - queryable: true -}, { - command: goog.editor.Command.ORDERED_LIST, - tooltip: goog.ui.editor.DefaultToolbar.MSG_ORDERED_LIST_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-insertOrderedList'), - queryable: true -}, { - command: goog.editor.Command.UNORDERED_LIST, - tooltip: goog.ui.editor.DefaultToolbar.MSG_UNORDERED_LIST_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-insertUnorderedList'), - queryable: true -}, { - command: goog.editor.Command.OUTDENT, - tooltip: goog.ui.editor.DefaultToolbar.MSG_OUTDENT_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-outdent'), - factory: goog.ui.editor.ToolbarFactory.makeButton -}, { - command: goog.editor.Command.INDENT, - tooltip: goog.ui.editor.DefaultToolbar.MSG_INDENT_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-indent'), - factory: goog.ui.editor.ToolbarFactory.makeButton -}, { - command: goog.editor.Command.JUSTIFY_LEFT, - tooltip: goog.ui.editor.DefaultToolbar.MSG_ALIGN_LEFT_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-justifyLeft'), - queryable: true -}, { - command: goog.editor.Command.JUSTIFY_CENTER, - tooltip: goog.ui.editor.DefaultToolbar.MSG_ALIGN_CENTER_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-justifyCenter'), - queryable: true -}, { - command: goog.editor.Command.JUSTIFY_RIGHT, - tooltip: goog.ui.editor.DefaultToolbar.MSG_ALIGN_RIGHT_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-justifyRight'), - queryable: true -}, { - command: goog.editor.Command.JUSTIFY_FULL, - tooltip: goog.ui.editor.DefaultToolbar.MSG_JUSTIFY_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-justifyFull'), - queryable: true -}, { - command: goog.editor.Command.REMOVE_FORMAT, - tooltip: goog.ui.editor.DefaultToolbar.MSG_REMOVE_FORMAT_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-removeFormat'), - factory: goog.ui.editor.ToolbarFactory.makeButton -}, { - command: goog.editor.Command.IMAGE, - tooltip: goog.ui.editor.DefaultToolbar.MSG_IMAGE_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-image'), - factory: goog.ui.editor.ToolbarFactory.makeButton -}, { - command: goog.editor.Command.STRIKE_THROUGH, - tooltip: goog.ui.editor.DefaultToolbar.MSG_STRIKE_THROUGH_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-strikeThrough'), - queryable: true -}, { - command: goog.editor.Command.SUBSCRIPT, - tooltip: goog.ui.editor.DefaultToolbar.MSG_SUBSCRIPT, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-subscript'), - queryable: true -} , { - command: goog.editor.Command.SUPERSCRIPT, - tooltip: goog.ui.editor.DefaultToolbar.MSG_SUPERSCRIPT, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-superscript'), - queryable: true -}, { - command: goog.editor.Command.DIR_LTR, - tooltip: goog.ui.editor.DefaultToolbar.MSG_DIR_LTR_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-ltr'), - queryable: true -}, { - command: goog.editor.Command.DIR_RTL, - tooltip: goog.ui.editor.DefaultToolbar.MSG_DIR_RTL_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + goog.getCssName('tr-rtl'), - factory: goog.ui.editor.DefaultToolbar.rtlButtonFactory_, - queryable: true -}, { - command: goog.editor.Command.BLOCKQUOTE, - tooltip: goog.ui.editor.DefaultToolbar.MSG_BLOCKQUOTE_TITLE, - classes: goog.getCssName('tr-icon') + ' ' + - goog.getCssName('tr-BLOCKQUOTE'), - queryable: true -}, { - command: goog.editor.Command.FORMAT_BLOCK, - tooltip: goog.ui.editor.DefaultToolbar.MSG_FORMAT_BLOCK_TITLE, - caption: goog.ui.editor.DefaultToolbar.MSG_FORMAT_BLOCK_CAPTION, - classes: goog.getCssName('tr-formatBlock'), - factory: goog.ui.editor.DefaultToolbar.formatBlockFactory_, - queryable: true -}, { - command: goog.editor.Command.EDIT_HTML, - tooltip: goog.ui.editor.DefaultToolbar.MSG_EDIT_HTML_TITLE, - caption: goog.ui.editor.DefaultToolbar.MSG_EDIT_HTML_CAPTION, - classes: goog.getCssName('tr-editHtml'), - factory: goog.ui.editor.ToolbarFactory.makeButton -}]; - - -(function() { -// Create the goog.ui.editor.DefaultToolbar.buttons_ map from -// goog.ui.editor.DefaultToolbar.BUTTONS_. -for (var i = 0, button; - button = goog.ui.editor.DefaultToolbar.BUTTONS_[i]; i++) { - goog.ui.editor.DefaultToolbar.buttons_[button.command] = button; -} - -// goog.ui.editor.DefaultToolbar.BUTTONS_ is no longer needed -// once the map is ready. -delete goog.ui.editor.DefaultToolbar.BUTTONS_; - -})(); |