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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
|
// Copyright 2005 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 Trogedit constants for browser features and quirks that should
* be used by the rich text editor.
*/
goog.provide('goog.editor.BrowserFeature');
goog.require('goog.editor.defines');
goog.require('goog.labs.userAgent.browser');
goog.require('goog.userAgent');
goog.require('goog.userAgent.product');
goog.require('goog.userAgent.product.isVersion');
/**
* Maps browser quirks to boolean values, detailing what the current
* browser supports.
* @const
*/
goog.editor.BrowserFeature = {
// Whether this browser uses the IE TextRange object.
HAS_IE_RANGES: goog.userAgent.IE && !goog.userAgent.isDocumentModeOrHigher(9),
// Whether this browser uses the W3C standard Range object.
// Assumes IE higher versions will be compliance with W3C standard.
HAS_W3C_RANGES: goog.userAgent.GECKO || goog.userAgent.WEBKIT ||
goog.userAgent.OPERA || goog.userAgent.EDGE ||
(goog.userAgent.IE && goog.userAgent.isDocumentModeOrHigher(9)),
// Has the contentEditable attribute, which makes nodes editable.
//
// NOTE(nicksantos): FF3 has contentEditable, but there are 3 major reasons
// why we don't use it:
// 1) In FF3, we listen for key events on the document, and we'd have to
// filter them properly. See TR_Browser.USE_DOCUMENT_FOR_KEY_EVENTS.
// 2) In FF3, we listen for focus/blur events on the document, which
// simply doesn't make sense in contentEditable. focus/blur
// on contentEditable elements still has some quirks, which we're
// talking to Firefox-team about.
// 3) We currently use Mutation events in FF3 to detect changes,
// and these are dispatched on the document only.
// If we ever hope to support FF3/contentEditable, all 3 of these issues
// will need answers. Most just involve refactoring at our end.
HAS_CONTENT_EDITABLE: goog.userAgent.IE || goog.userAgent.WEBKIT ||
goog.userAgent.OPERA || goog.userAgent.EDGE ||
(goog.editor.defines.USE_CONTENTEDITABLE_IN_FIREFOX_3 &&
goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('1.9')),
// Whether to use mutation event types to detect changes
// in the field contents.
USE_MUTATION_EVENTS: goog.userAgent.GECKO,
// Whether the browser has a functional DOMSubtreeModified event.
// TODO(user): Enable for all FF3 once we're confident this event fires
// reliably. Currently it's only enabled if using contentEditable in FF as
// we have no other choice in that case but to use this event.
HAS_DOM_SUBTREE_MODIFIED_EVENT: goog.userAgent.WEBKIT ||
(goog.editor.defines.USE_CONTENTEDITABLE_IN_FIREFOX_3 &&
goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('1.9')),
// Whether nodes can be copied from one document to another
HAS_DOCUMENT_INDEPENDENT_NODES: goog.userAgent.GECKO,
// Whether the cursor goes before or inside the first block element on
// focus, e.g., <body><p>foo</p></body>. FF will put the cursor before the
// paragraph on focus, which is wrong.
PUTS_CURSOR_BEFORE_FIRST_BLOCK_ELEMENT_ON_FOCUS: goog.userAgent.GECKO,
// Whether the selection of one frame is cleared when another frame
// is focused.
CLEARS_SELECTION_WHEN_FOCUS_LEAVES:
goog.userAgent.IE || goog.userAgent.WEBKIT || goog.userAgent.OPERA,
// Whether "unselectable" is supported as an element style.
HAS_UNSELECTABLE_STYLE: goog.userAgent.GECKO || goog.userAgent.WEBKIT,
// Whether this browser's "FormatBlock" command does not suck.
FORMAT_BLOCK_WORKS_FOR_BLOCKQUOTES:
goog.userAgent.GECKO || goog.userAgent.WEBKIT || goog.userAgent.OPERA,
// Whether this browser's "FormatBlock" command may create multiple
// blockquotes.
CREATES_MULTIPLE_BLOCKQUOTES:
(goog.userAgent.WEBKIT && !goog.userAgent.isVersionOrHigher('534.16')) ||
goog.userAgent.OPERA,
// Whether this browser's "FormatBlock" command will wrap blockquotes
// inside of divs, instead of replacing divs with blockquotes.
WRAPS_BLOCKQUOTE_IN_DIVS: goog.userAgent.OPERA,
// Whether the readystatechange event is more reliable than load.
PREFERS_READY_STATE_CHANGE_EVENT: goog.userAgent.IE,
// Whether hitting the tab key will fire a keypress event.
// see http://www.quirksmode.org/js/keys.html
// TODO(user): This is fixed in IE8 and higher.
TAB_FIRES_KEYPRESS: !goog.userAgent.IE,
// Has a standards mode quirk where width=100% doesn't do the right thing,
// but width=99% does.
// TODO(user|user): This should be fixable by less hacky means
NEEDS_99_WIDTH_IN_STANDARDS_MODE: goog.userAgent.IE,
// Whether keyboard events only reliably fire on the document.
// On Gecko without contentEditable, keyboard events only fire reliably on the
// document element. With contentEditable, the field itself is focusable,
// which means that it will fire key events. This does not apply if
// application is using ContentEditableField or otherwise overriding Field
// not to use an iframe.
USE_DOCUMENT_FOR_KEY_EVENTS: goog.userAgent.GECKO &&
!goog.editor.defines.USE_CONTENTEDITABLE_IN_FIREFOX_3,
// Whether this browser shows non-standard attributes in innerHTML.
SHOWS_CUSTOM_ATTRS_IN_INNER_HTML: goog.userAgent.IE,
// Whether this browser shrinks empty nodes away to nothing.
// (If so, we need to insert some space characters into nodes that
// shouldn't be collapsed)
COLLAPSES_EMPTY_NODES:
goog.userAgent.GECKO || goog.userAgent.WEBKIT || goog.userAgent.OPERA,
// Whether we must convert <strong> and <em> tags to <b>, <i>.
CONVERT_TO_B_AND_I_TAGS: goog.userAgent.GECKO || goog.userAgent.OPERA,
// Whether this browser likes to tab through images in contentEditable mode,
// and we like to disable this feature.
TABS_THROUGH_IMAGES: goog.userAgent.IE,
// Whether this browser unescapes urls when you extract it from the href tag.
UNESCAPES_URLS_WITHOUT_ASKING:
goog.userAgent.IE && !goog.userAgent.isVersionOrHigher('7.0'),
// Whether this browser supports execCommand("styleWithCSS") to toggle between
// inserting html tags or inline styling for things like bold, italic, etc.
HAS_STYLE_WITH_CSS:
goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('1.8') ||
goog.userAgent.WEBKIT || goog.userAgent.OPERA,
// Whether clicking on an editable link will take you to that site.
FOLLOWS_EDITABLE_LINKS: goog.userAgent.WEBKIT ||
goog.userAgent.IE && goog.userAgent.isVersionOrHigher('9'),
// Whether this browser has document.activeElement available.
HAS_ACTIVE_ELEMENT: goog.userAgent.IE || goog.userAgent.EDGE ||
goog.userAgent.OPERA ||
goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('1.9'),
// Whether this browser supports the setCapture method on DOM elements.
HAS_SET_CAPTURE: goog.userAgent.IE,
// Whether this browser can't set background color when the selection
// is collapsed.
EATS_EMPTY_BACKGROUND_COLOR: goog.userAgent.GECKO ||
goog.userAgent.WEBKIT && !goog.userAgent.isVersionOrHigher('527'),
// Whether this browser supports the "focusin" or "DOMFocusIn" event
// consistently.
// NOTE(nicksantos): FF supports DOMFocusIn, but doesn't seem to do so
// consistently.
SUPPORTS_FOCUSIN: goog.userAgent.IE || goog.userAgent.OPERA,
// Whether clicking on an image will cause the selection to move to the image.
// Note: Gecko moves the selection, but it won't always go to the image.
// For example, if the image is wrapped in a div, and you click on the img,
// anchorNode = focusNode = div, anchorOffset = 0, focusOffset = 1, so this
// is another way of "selecting" the image, but there are too many special
// cases like this so we will do the work manually.
SELECTS_IMAGES_ON_CLICK: goog.userAgent.IE || goog.userAgent.OPERA,
// Whether this browser moves <style> tags into new <head> elements.
MOVES_STYLE_TO_HEAD: goog.userAgent.WEBKIT,
// Whether this browser collapses the selection in a contenteditable when the
// mouse is pressed in a non-editable portion of the same frame, even if
// Event.preventDefault is called. This field is deprecated and unused -- only
// old versions of Opera have this bug.
COLLAPSES_SELECTION_ONMOUSEDOWN: false,
// Whether the user can actually create a selection in this browser with the
// caret in the MIDDLE of the selection by double-clicking.
CARET_INSIDE_SELECTION: goog.userAgent.OPERA,
// Whether the browser focuses <body contenteditable> automatically when
// the user clicks on <html>. This field is deprecated and unused -- only old
// versions of Opera don't have this behavior.
FOCUSES_EDITABLE_BODY_ON_HTML_CLICK: true,
// Whether to use keydown for key listening (uses keypress otherwise). Taken
// from goog.events.KeyHandler.
USES_KEYDOWN: goog.userAgent.IE || goog.userAgent.EDGE ||
goog.userAgent.WEBKIT && goog.userAgent.isVersionOrHigher('525'),
// Whether this browser converts spaces to non-breaking spaces when calling
// execCommand's RemoveFormat.
// See: https://bugs.webkit.org/show_bug.cgi?id=14062
ADDS_NBSPS_IN_REMOVE_FORMAT:
goog.userAgent.WEBKIT && !goog.userAgent.isVersionOrHigher('531'),
// Whether the browser will get stuck inside a link. That is, if your cursor
// is after a link and you type, does your text go inside the link tag.
// Bug: http://bugs.webkit.org/show_bug.cgi?id=17697
GETS_STUCK_IN_LINKS:
goog.userAgent.WEBKIT && !goog.userAgent.isVersionOrHigher('528'),
// Whether the browser corrupts empty text nodes in Node#normalize,
// removing them from the Document instead of merging them.
NORMALIZE_CORRUPTS_EMPTY_TEXT_NODES:
goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('1.9') ||
goog.userAgent.IE || goog.userAgent.EDGE || goog.userAgent.OPERA ||
goog.userAgent.WEBKIT && goog.userAgent.isVersionOrHigher('531'),
// Whether the browser corrupts all text nodes in Node#normalize,
// removing them from the Document instead of merging them.
NORMALIZE_CORRUPTS_ALL_TEXT_NODES: goog.userAgent.IE,
// Browsers where executing subscript then superscript (or vv) will cause both
// to be applied in a nested fashion instead of the first being overwritten by
// the second.
NESTS_SUBSCRIPT_SUPERSCRIPT: goog.userAgent.IE || goog.userAgent.EDGE ||
goog.userAgent.GECKO || goog.userAgent.OPERA,
// Whether this browser can place a cursor in an empty element natively.
CAN_SELECT_EMPTY_ELEMENT: !goog.userAgent.IE && !goog.userAgent.WEBKIT,
FORGETS_FORMATTING_WHEN_LISTIFYING: goog.userAgent.GECKO ||
goog.userAgent.WEBKIT && !goog.userAgent.isVersionOrHigher('526'),
LEAVES_P_WHEN_REMOVING_LISTS: goog.userAgent.IE || goog.userAgent.OPERA,
CAN_LISTIFY_BR: !goog.userAgent.IE && !goog.userAgent.OPERA,
// See bug 1286408. When somewhere inside your selection there is an element
// with a style attribute that sets the font size, if you change the font
// size, the browser creates a font tag, but the font size in the style attr
// overrides the font tag. Only webkit removes that font size from the style
// attr.
DOESNT_OVERRIDE_FONT_SIZE_IN_STYLE_ATTR:
!goog.userAgent.WEBKIT && !goog.userAgent.EDGE,
// Implements this spec about dragging files from the filesystem to the
// browser: http://www.whatwg/org/specs/web-apps/current-work/#dnd
SUPPORTS_HTML5_FILE_DRAGGING: (goog.userAgent.product.CHROME &&
goog.userAgent.product.isVersion('4')) ||
(goog.userAgent.product.SAFARI &&
goog.userAgent.isVersionOrHigher('533')) ||
(goog.userAgent.GECKO && goog.userAgent.isVersionOrHigher('2.0')) ||
(goog.userAgent.IE && goog.userAgent.isVersionOrHigher('10')) ||
// TODO(user): Remove when b/27923889 is fixed.
(goog.userAgent.OPERA &&
goog.labs.userAgent.browser.isVersionOrHigher('15')) ||
goog.userAgent.EDGE,
// Version of Opera that supports the opera-defaultBlock execCommand to change
// the default block inserted when [return] is pressed. Note that this only is
// used if the caret is not already in a block that can be repeated.
// TODO(user): Link to public documentation of this feature if Opera puts
// something up about it.
SUPPORTS_OPERA_DEFAULTBLOCK_COMMAND:
goog.userAgent.OPERA && goog.userAgent.isVersionOrHigher('11.10'),
SUPPORTS_FILE_PASTING:
goog.userAgent.product.CHROME && goog.userAgent.product.isVersion('12')
};
|
