Page Menu
Home
WickedGov Phorge
Search
Configure Global Search
Log In
Files
F7410021
ve.ui.AnnotationAction.js
No One
Temporary
Actions
View File
Edit File
Delete File
View Transforms
Subscribe
Flag For Later
Award Token
Size
4 KB
Referenced Files
None
Subscribers
None
ve.ui.AnnotationAction.js
View Options
/*!
* VisualEditor UserInterface AnnotationAction class.
*
* @copyright See AUTHORS.txt
*/
/**
* Annotation action.
*
* @class
* @extends ve.ui.Action
*
* @constructor
* @param {ve.ui.Surface} surface Surface to act on
* @param {string} [source]
*/
ve
.
ui
.
AnnotationAction
=
function
VeUiAnnotationAction
()
{
// Parent constructor
ve
.
ui
.
AnnotationAction
.
super
.
apply
(
this
,
arguments
);
};
/* Inheritance */
OO
.
inheritClass
(
ve
.
ui
.
AnnotationAction
,
ve
.
ui
.
Action
);
/* Static Properties */
ve
.
ui
.
AnnotationAction
.
static
.
name
=
'annotation'
;
ve
.
ui
.
AnnotationAction
.
static
.
methods
=
[
'set'
,
'clear'
,
'toggle'
,
'clearAll'
];
/* Methods */
/**
* Set an annotation.
*
* @param {string} name Annotation name, for example: 'textStyle/bold'
* @param {Object} [data] Additional annotation data
* @return {boolean} Action was executed
*/
ve
.
ui
.
AnnotationAction
.
prototype
.
set
=
function
(
name
,
data
)
{
ve
.
track
(
'activity.'
+
name
,
{
action
:
'set'
}
);
return
this
.
setInternal
(
name
,
data
);
};
/**
* Clear an annotation.
*
* @param {string} name Annotation name, for example: 'textStyle/bold'
* @param {Object} [data] Additional annotation data
* @return {boolean} Action was executed
*/
ve
.
ui
.
AnnotationAction
.
prototype
.
clear
=
function
(
name
,
data
)
{
ve
.
track
(
'activity.'
+
name
,
{
action
:
'clear'
}
);
this
.
surface
.
getModel
().
getFragment
().
annotateContent
(
'clear'
,
name
,
data
);
return
true
;
};
/**
* Toggle an annotation.
*
* If the selected text is completely covered with the annotation already the annotation will be
* cleared. Otherwise the annotation will be set.
*
* @param {string} name Annotation name, for example: 'textStyle/bold'
* @param {Object} [data] Additional annotation data
* @return {boolean} Action was executed
*/
ve
.
ui
.
AnnotationAction
.
prototype
.
toggle
=
function
(
name
,
data
)
{
const
surfaceModel
=
this
.
surface
.
getModel
(),
fragment
=
surfaceModel
.
getFragment
(),
annotation
=
ve
.
dm
.
annotationFactory
.
create
(
name
,
data
);
if
(
!
fragment
.
getSelection
().
isCollapsed
()
)
{
ve
.
track
(
'activity.'
+
name
,
{
action
:
'toggle-selection'
}
);
if
(
!
fragment
.
getAnnotations
().
containsComparable
(
annotation
)
)
{
this
.
setInternal
(
name
,
data
);
}
else
{
fragment
.
annotateContent
(
'clear'
,
name
);
}
}
else
if
(
surfaceModel
.
sourceMode
)
{
return
false
;
}
else
{
ve
.
track
(
'activity.'
+
name
,
{
action
:
'toggle-insertion'
}
);
const
insertionAnnotations
=
surfaceModel
.
getInsertionAnnotations
();
const
existingAnnotations
=
insertionAnnotations
.
getAnnotationsByName
(
annotation
.
name
);
const
removes
=
annotation
.
constructor
.
static
.
removes
;
if
(
existingAnnotations
.
isEmpty
()
)
{
const
removesAnnotations
=
insertionAnnotations
.
filter
(
(
ann
)
=>
removes
.
indexOf
(
ann
.
name
)
!==
-
1
);
surfaceModel
.
removeInsertionAnnotations
(
removesAnnotations
);
surfaceModel
.
addInsertionAnnotations
(
annotation
);
}
else
{
surfaceModel
.
removeInsertionAnnotations
(
existingAnnotations
);
}
}
return
true
;
};
/**
* Clear all annotations.
*
* @return {boolean} Action was executed
*/
ve
.
ui
.
AnnotationAction
.
prototype
.
clearAll
=
function
()
{
const
surfaceModel
=
this
.
surface
.
getModel
(),
fragment
=
surfaceModel
.
getFragment
(),
annotations
=
fragment
.
getAnnotations
(
true
);
ve
.
track
(
'activity.allAnnotations'
,
{
action
:
'clear-all'
}
);
const
arr
=
annotations
.
get
();
// TODO: Allow multiple annotations to be set or cleared by ve.dm.SurfaceFragment, probably
// using an annotation set and ideally building a single transaction
for
(
let
i
=
0
,
len
=
arr
.
length
;
i
<
len
;
i
++
)
{
fragment
.
annotateContent
(
'clear'
,
arr
[
i
].
name
,
arr
[
i
].
data
);
}
surfaceModel
.
setInsertionAnnotations
(
null
);
return
true
;
};
/**
* Internal implementation of set(). Do not use this, use set() instead.
*
* @private
* @param {string} name Annotation name, for example: 'textStyle/bold'
* @param {Object} [data] Additional annotation data
* @return {boolean} Action was executed
*/
ve
.
ui
.
AnnotationAction
.
prototype
.
setInternal
=
function
(
name
,
data
)
{
const
annotationClass
=
ve
.
dm
.
annotationFactory
.
lookup
(
name
);
let
fragment
=
this
.
surface
.
getModel
().
getFragment
();
if
(
fragment
.
getSelection
()
instanceof
ve
.
dm
.
LinearSelection
)
{
const
trimmedFragment
=
fragment
.
trimLinearSelection
();
if
(
!
trimmedFragment
.
getSelection
().
isCollapsed
()
)
{
fragment
=
trimmedFragment
;
}
}
const
removes
=
annotationClass
.
static
.
removes
;
for
(
let
i
=
removes
.
length
-
1
;
i
>=
0
;
i
--
)
{
fragment
.
annotateContent
(
'clear'
,
removes
[
i
]
);
}
fragment
.
annotateContent
(
'set'
,
name
,
data
);
return
true
;
};
/* Registration */
ve
.
ui
.
actionFactory
.
register
(
ve
.
ui
.
AnnotationAction
);
File Metadata
Details
Attached
Mime Type
text/plain
Expires
Sat, Nov 21, 22:46 (1 d, 20 h)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
0e/cc/0c57fd05350111aee28fd5daa175
Default Alt Text
ve.ui.AnnotationAction.js (4 KB)
Attached To
Mode
rMWPROD MediaWiki Production
Attached
Detach File
Event Timeline
Log In to Comment