Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 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 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 | 1x 1x 1x 9392x 9392x 9392x 6020x 16x 6004x 1x 6003x 48x 48x 46x 2x 5955x 6232x 3372x 3372x 5955x 1x 9357x 9357x 9357x 9357x 3363x 5994x 5994x 5665x 5665x 6215x 5665x 5994x 5994x 1x 82x 51x 51x 31x 31x 82x 1x 57x 37x 37x 20x 20x 57x 1x 3116x 3427x 3489x 3489x 1x 3488x 2923x 503x 503x 81x 422x 155x 155x 6x 416x 3088x 875x 2213x 3088x 3088x 3088x 875x 10x 10x 10x 1x 9x 865x 118x 118x 118x 76x 42x 22x 22x 22x 42x 747x 747x 2213x 2213x 2213x 2213x 3011x 3477x 3477x 3010x 467x 226x 467x 3010x 3010x 2923x 2905x 2923x 2842x 87x 84x 84x 41x 3x 3007x 1x 1x 1176x 955x 677x 278x 278x 499x 447x 52x 52x 12x 40x 1x 86x 1x 1167x 1167x 31x 1x 270x 232x 270x 1x 4637x | /*!
* VisualEditor ContentEditable namespace.
*
* @copyright See AUTHORS.txt
*/
/**
* Namespace for all VisualEditor ContentEditable classes, static methods and static properties.
*
* @namespace
*/
ve.ce = {
// nodeFactory: Initialized in ve.ce.NodeFactory.js
};
/* Static Properties */
/**
* Data URI for minimal GIF image. This is the smallest technically-valid 1x1px transparent GIF it's possible to create.
*/
ve.ce.minImgDataUri = 'data:image/gif;base64,R0lGODlhAQABAAD/ACwAAAAAAQABAAACADs=';
/* Static Methods */
/**
* Gets the plain text of a DOM element (that is a node canContainContent === true)
*
* In the returned string only the contents of text nodes are included, and the contents of
* non-editable elements are excluded (but replaced with the appropriate number of snowman
* characters so the offsets match up with the linear model).
*
* @param {HTMLElement} element DOM element to get text of
* @return {string} Plain text of DOM element
*/
ve.ce.getDomText = function ( element ) {
// Inspired by jQuery.text / Sizzle.getText
const nodeType = element.nodeType;
let text = '';
if (
nodeType === Node.ELEMENT_NODE ||
nodeType === Node.DOCUMENT_NODE ||
nodeType === Node.DOCUMENT_FRAGMENT_NODE
) {
if ( element.classList.contains( 've-ce-branchNode-blockSlug' ) ) {
// Block slugs are not represented in the model at all, but they do
// contain a single nbsp/FEFF character in the DOM, so make sure
// that character isn't counted
return '';
} else if ( element.classList.contains( 've-ce-cursorHolder' ) ) {
// Cursor holders do not exist in the model
return '';
} else if ( element.classList.contains( 've-ce-leafNode' ) ) {
// For leaf nodes, don't return the content, but return
// the right number of placeholder characters so the offsets match up.
const viewNode = $( element ).data( 'view' );
// Only return snowmen for the first element in a sibling group: otherwise
// we'll double-count this node
if ( viewNode && element === viewNode.$element[ 0 ] ) {
// \u2603 is the snowman character: ☃
return new Array( viewNode.getOuterLength() + 1 ).join( '\u2603' );
}
// Second or subsequent sibling, don't double-count
return '';
} else {
// Traverse its children
for ( element = element.firstChild; element; element = element.nextSibling ) {
text += ve.ce.getDomText( element );
}
}
} else Eif ( nodeType === Node.TEXT_NODE ) {
return element.data;
}
return text;
};
/**
* Gets a hash of a DOM element's structure.
*
* In the returned string text nodes are represented as "#" and elements are represented as "<type>"
* and "</type>" where "type" is their element name. This effectively generates an HTML
* serialization without any attributes or text contents. This can be used to observe structural
* changes.
*
* @param {HTMLElement} element DOM element to get hash of
* @return {string} Hash of DOM element
*/
ve.ce.getDomHash = function ( element ) {
const nodeType = element.nodeType,
nodeName = element.nodeName;
let hash = '';
if ( nodeType === Node.TEXT_NODE || nodeType === Node.CDATA_SECTION_NODE ) {
return '#';
} else Eif ( nodeType === Node.ELEMENT_NODE || nodeType === Node.DOCUMENT_NODE ) {
if ( !(
element.classList.contains( 've-ce-branchNode-blockSlug' ) ||
element.classList.contains( 've-ce-cursorHolder' ) ||
element.classList.contains( 've-ce-nail' )
) ) {
hash += '<' + nodeName + '>';
// Traverse its children
for ( element = element.firstChild; element; element = element.nextSibling ) {
hash += ve.ce.getDomHash( element );
}
hash += '</' + nodeName + '>';
}
// Merge adjacent text node representations
hash = hash.replace( /##+/g, '#' );
}
return hash;
};
/**
* @typedef {Object} NodeAndOffset
* @memberof ve.ce
* @return {Node} node
* @return {number} offset
*/
/**
* Get the first cursor offset immediately after a node.
*
* @param {Node} node DOM node
* @return {ve.ce.NodeAndOffset}
*/
ve.ce.nextCursorOffset = function ( node ) {
let nextNode, offset;
if ( node.nextSibling !== null && node.nextSibling.nodeType === Node.TEXT_NODE ) {
nextNode = node.nextSibling;
offset = 0;
} else {
nextNode = node.parentNode;
offset = 1 + ve.parentIndex( node );
}
return { node: nextNode, offset: offset };
};
/**
* Get the first cursor offset immediately before a node.
*
* @param {Node} node DOM node
* @return {ve.ce.NodeAndOffset}
*/
ve.ce.previousCursorOffset = function ( node ) {
let previousNode, offset;
if ( node.previousSibling !== null && node.previousSibling.nodeType === Node.TEXT_NODE ) {
previousNode = node.previousSibling;
offset = previousNode.data.length;
} else {
previousNode = node.parentNode;
offset = ve.parentIndex( node );
}
return { node: previousNode, offset: offset };
};
/**
* Gets the linear offset from a given DOM node and offset within it.
*
* @param {HTMLElement} domNode DOM node
* @param {number} domOffset DOM offset within the DOM node
* @return {number} Linear model offset
* @throws {Error} domOffset is out of bounds
* @throws {Error} domNode has no ancestor with a .data( 'view' )
* @throws {Error} domNode is not in document
*/
ve.ce.getOffset = function ( domNode, domOffset ) {
Iif ( domNode.nodeType === Node.ELEMENT_NODE && domNode.classList.contains( 've-ce-unicorn' ) ) {
if ( domOffset !== 0 ) {
throw new Error( 'Non-zero offset in unicorn' );
}
return $( domNode ).data( 'modelOffset' );
}
/**
* Move to the previous "traversal node" in "traversal sequence".
*
* - A node is a "traversal node" if it is either a leaf node or a "view node"
* - A "view node" is one that has $( n ).data( 'view' ) instanceof ve.ce.Node
* - "Traversal sequence" is defined on every node (not just traversal nodes).
* It is like document order, except that each parent node appears
* in the sequence both immediately before and immediately after its child nodes.
*
* Important properties:
* - Non-traversal nodes don't have any width in DM (e.g. bold).
* - Certain traversal nodes also have no width (namely, those within an alienated node).
* - Both the start and end of a (non-alienated) parent traversal node has width
* (which is one reason why traversal sequence is important).
* - In VE-normalized HTML, a text node cannot be a sibling of a non-leaf view node
* (because all non-alienated text nodes are inside a ContentBranchNode).
* - Traversal-consecutive non-view nodes are either all alienated or all not alienated.
*
* @param {Node} n Node to traverse from
* @return {Node} Previous traversal node from n
* @throws {Error} domNode has no ancestor with a .data( 'view' )
*/
function traverse( n ) {
while ( !n.previousSibling ) {
n = n.parentNode;
if ( !n ) {
throw new Error( 'domNode has no ancestor with a .data( \'view\' )' );
}
if ( $( n ).data( 'view' ) instanceof ve.ce.Node ) {
return n;
}
}
n = n.previousSibling;
if ( $( n ).data( 'view' ) instanceof ve.ce.Node ) {
return n;
}
while ( n.lastChild ) {
n = n.lastChild;
if ( $( n ).data( 'view' ) instanceof ve.ce.Node ) {
return n;
}
}
return n;
}
// Validate domOffset
let maxOffset;
if ( domNode.nodeType === Node.ELEMENT_NODE ) {
maxOffset = domNode.childNodes.length;
} else {
maxOffset = domNode.data.length;
}
Iif ( domOffset < 0 || domOffset > maxOffset ) {
throw new Error( 'domOffset is out of bounds' );
}
let lengthSum = 0;
let startNode, node, view;
// Figure out what node to start traversing at (startNode)
if ( domNode.nodeType === Node.ELEMENT_NODE ) {
if ( domNode.childNodes.length === 0 ) {
// domNode has no children, and the offset is inside of it
// If domNode is a view node, return the offset inside of it
// Otherwise, start traversing at domNode
startNode = domNode;
view = $( startNode ).data( 'view' );
if ( view instanceof ve.ce.Node ) {
return view.getOffset() + ( view.isWrapped() ? 1 : 0 );
}
node = startNode;
} else if ( domOffset === domNode.childNodes.length ) {
// Offset is at the end of domNode, after the last child. Set startNode to the
// very rightmost descendant node of domNode (i.e. the last child of the last child
// of the last child, etc.)
// However, if the last child or any of the last children we encounter on the way
// is a view node, return the offset after it. This will be the correct return value
// because non-traversal nodes don't have a DM width.
startNode = domNode.lastChild;
view = $( startNode ).data( 'view' );
if ( view instanceof ve.ce.Node ) {
return view.getOffset() + view.getOuterLength();
}
while ( startNode.lastChild ) {
startNode = startNode.lastChild;
view = $( startNode ).data( 'view' );
Iif ( view instanceof ve.ce.Node ) {
return view.getOffset() + view.getOuterLength();
}
}
node = startNode;
} else {
// Offset is right before childNodes[domOffset]. Set startNode to this node
// (i.e. the node right after the offset), then traverse back once.
startNode = domNode.childNodes[ domOffset ];
node = traverse( startNode );
}
} else {
// Text inside of a block slug doesn't count
Eif ( !(
domNode.parentNode.classList.contains( 've-ce-branchNode-blockSlug' ) ||
domNode.parentNode.classList.contains( 've-ce-cursorHolder' )
) ) {
lengthSum += domOffset;
}
startNode = domNode;
node = traverse( startNode );
}
// Walk the traversal nodes in reverse traversal sequence, until we find a view node.
// Add the width of each text node we meet. (Non-text node non-view nodes can only be widthless).
// Later, if it transpires that we're inside an alienated node, then we will throw away all the
// text node lengths, because the alien's content has no DM width.
while ( true ) {
// First node that has a ve.ce.Node, stop
// Note that annotations have a .data( 'view' ) too, but that's a ve.ce.Annotation,
// not a ve.ce.Node
view = $( node ).data( 'view' );
if ( view instanceof ve.ce.Node ) {
break;
}
// Text inside of a block slug doesn't count
if (
node.nodeType === Node.TEXT_NODE &&
!node.parentNode.classList.contains( 've-ce-branchNode-blockSlug' ) &&
!node.parentNode.classList.contains( 've-ce-cursorHolder' )
) {
lengthSum += node.data.length;
}
// else: non-text nodes that don't have a .data( 'view' ) don't exist in the DM
node = traverse( node );
}
let offset = view.getOffset();
if ( $.contains( node, startNode ) ) {
// node is an ancestor of startNode
if ( !view.getModel().isContent() ) {
// Add 1 to take the opening into account
offset += view.getModel().isWrapped() ? 1 : 0;
}
if ( view.getModel().canContainContent() ) {
offset += lengthSum;
}
// else: we're inside an alienated node: throw away all the text node lengths,
// because the alien's content has no DM width
} else if ( view.parent ) {
// node is not an ancestor of startNode
// startNode comes after node, so add node's length
offset += view.getOuterLength();
if ( view.isContent() ) {
// view is a leaf node inside of a CBN, so we started inside of a CBN
// (otherwise we would have hit the CBN when entering it), so the text we summed up
// needs to be counted.
offset += lengthSum;
}
} else {
throw new Error( 'Node is not in document' );
}
return offset;
};
/**
* Gets the linear offset of a given slug
*
* @param {HTMLElement} element Slug DOM element
* @return {number} Linear model offset
* @throws {Error}
*/
ve.ce.getOffsetOfSlug = function ( element ) {
const $element = $( element );
let model;
if ( $element.index() === 0 ) {
model = $element.parent().data( 'view' ).getModel();
return model.getOffset() + ( model.isWrapped() ? 1 : 0 );
} else {
// Don't pick up DOM nodes not from the view tree e.g. cursor holders (T202103)
const $prev = $element.prevAll( '.ve-ce-leafNode,.ve-ce-branchNode' ).first();
if ( $prev.length ) {
model = $prev.data( 'view' ).getModel();
return model.getOffset() + model.getOuterLength();
}
throw new Error( 'Incorrect slug location' );
}
};
/**
* Test whether the DOM position lies straight after annotation boundaries
*
* "Straight after" means that in document order, there are annotation open/close tags
* immediately before the position, and there are none immediately after.
*
* This is important for cursors: the DM position is ambiguous with respect to annotation
* boundaries, and the browser does not fully distinguish this position from the preceding
* position immediately before the annotation boundaries (e.g. 'a|<b>c' and 'a<b>|c'),
* but the two positions behave differently for insertions (in this case, whether the text
* appears bolded or not).
*
* In Chromium, cursor focus normalizes to the earliest (in document order) of equivalent
* positions, at least in reasonably-styled non-BIDI text. But in Firefox, the user can
* cursor/click into either the earliest or the latest equivalent position: the cursor lands in
* the closest (in document order) to the click location (for mouse actions) or cursor start
* location (for cursoring).
*
* @param {Node} node Position node
* @param {number} offset Position offset
* @return {boolean} Whether this is the end-most of multiple cursor-equivalent positions
*/
ve.ce.isAfterAnnotationBoundary = function ( node, offset ) {
if ( node.nodeType === Node.TEXT_NODE ) {
if ( offset > 0 ) {
return false;
}
offset = ve.parentIndex( node );
node = node.parentNode;
}
if ( offset === 0 ) {
return ve.dm.modelRegistry.isAnnotation( node );
}
const previousNode = node.childNodes[ offset - 1 ];
if ( previousNode.nodeType === Node.ELEMENT_NODE && (
previousNode.classList.contains( 've-ce-nail-post-close' ) ||
previousNode.classList.contains( 've-ce-nail-post-open' )
) ) {
return true;
}
return ve.dm.modelRegistry.isAnnotation( previousNode );
};
/**
* Check if keyboard shortcut modifier key is pressed.
*
* @param {jQuery.Event} e Key press event
* @return {boolean} Modifier key is pressed
*/
ve.ce.isShortcutKey = function ( e ) {
return !!( e.ctrlKey || e.metaKey );
};
/**
* Find the DM range of a DOM selection
*
* @param {Object} selection DOM-selection-like object
* @param {Node} selection.anchorNode
* @param {number} selection.anchorOffset
* @param {Node} selection.focusNode
* @param {number} selection.focusOffset
* @return {ve.Range|null} DM range, or null if nothing in the CE document is selected
*/
ve.ce.veRangeFromSelection = function ( selection ) {
try {
return new ve.Range(
ve.ce.getOffset( selection.anchorNode, selection.anchorOffset ),
ve.ce.getOffset( selection.focusNode, selection.focusOffset )
);
} catch ( e ) {
return null;
}
};
/**
* Find the closest nailed annotation in which a node lies
*
* @param {Node|null} node The node to test
* @return {Node|null} The closest nailed annotation within which the node lies (possibly the node itself)
*/
ve.ce.nailedAnnotationAt = function ( node ) {
if ( node && node.nodeType === Node.TEXT_NODE ) {
node = node.parentNode;
}
return $( node ).closest( '.ve-ce-nailedAnnotation' )[ 0 ];
};
/**
* Check whether a given DOM element is an inline annotation
*
* @param {Node} element The element
* @return {boolean} Whether the element is an inline annotation
*/
ve.ce.isAnnotationElement = function ( element ) {
return !(
ve.isBlockElement( element ) ||
ve.isVoidElement( element ) ||
element.classList.contains( 've-ce-branchNode-slug' )
);
};
|