mirror of
https://github.com/mermaid-js/mermaid.git
synced 2025-02-04 07:13:25 +08:00
44877545e5
ER and Sequence Chart Accessibility
448 lines
11 KiB
JavaScript
448 lines
11 KiB
JavaScript
import mermaidAPI from '../../mermaidAPI';
|
|
import * as configApi from '../../config';
|
|
import { log } from '../../logger';
|
|
import { sanitizeText } from '../common/common';
|
|
|
|
let prevActor = undefined;
|
|
let actors = {};
|
|
let messages = [];
|
|
const notes = [];
|
|
let title = '';
|
|
let description = '';
|
|
let sequenceNumbersEnabled = false;
|
|
let wrapEnabled = false;
|
|
|
|
export const parseDirective = function (statement, context, type) {
|
|
mermaidAPI.parseDirective(this, statement, context, type);
|
|
};
|
|
|
|
export const addActor = function (id, name, description, type) {
|
|
// Don't allow description nulling
|
|
const old = actors[id];
|
|
if (old && name === old.name && description == null) return;
|
|
|
|
// Don't allow null descriptions, either
|
|
if (description == null || description.text == null) {
|
|
description = { text: name, wrap: null, type };
|
|
}
|
|
if (type == null || description.text == null) {
|
|
description = { text: name, wrap: null, type };
|
|
}
|
|
|
|
actors[id] = {
|
|
name: name,
|
|
description: description.text,
|
|
wrap: (description.wrap === undefined && autoWrap()) || !!description.wrap,
|
|
prevActor: prevActor,
|
|
links: {},
|
|
properties: {},
|
|
actorCnt: null,
|
|
rectData: null,
|
|
type: type || 'participant',
|
|
};
|
|
if (prevActor && actors[prevActor]) {
|
|
actors[prevActor].nextActor = id;
|
|
}
|
|
|
|
prevActor = id;
|
|
};
|
|
|
|
const activationCount = (part) => {
|
|
let i;
|
|
let count = 0;
|
|
for (i = 0; i < messages.length; i++) {
|
|
if (messages[i].type === LINETYPE.ACTIVE_START) {
|
|
if (messages[i].from.actor === part) {
|
|
count++;
|
|
}
|
|
}
|
|
if (messages[i].type === LINETYPE.ACTIVE_END) {
|
|
if (messages[i].from.actor === part) {
|
|
count--;
|
|
}
|
|
}
|
|
}
|
|
return count;
|
|
};
|
|
|
|
export const addMessage = function (idFrom, idTo, message, answer) {
|
|
messages.push({
|
|
from: idFrom,
|
|
to: idTo,
|
|
message: message.text,
|
|
wrap: (message.wrap === undefined && autoWrap()) || !!message.wrap,
|
|
answer: answer,
|
|
});
|
|
};
|
|
|
|
export const addSignal = function (
|
|
idFrom,
|
|
idTo,
|
|
message = { text: undefined, wrap: undefined },
|
|
messageType
|
|
) {
|
|
if (messageType === LINETYPE.ACTIVE_END) {
|
|
const cnt = activationCount(idFrom.actor);
|
|
if (cnt < 1) {
|
|
// Bail out as there is an activation signal from an inactive participant
|
|
let error = new Error('Trying to inactivate an inactive participant (' + idFrom.actor + ')');
|
|
error.hash = {
|
|
text: '->>-',
|
|
token: '->>-',
|
|
line: '1',
|
|
loc: { first_line: 1, last_line: 1, first_column: 1, last_column: 1 },
|
|
expected: ["'ACTIVE_PARTICIPANT'"],
|
|
};
|
|
throw error;
|
|
}
|
|
}
|
|
messages.push({
|
|
from: idFrom,
|
|
to: idTo,
|
|
message: message.text,
|
|
wrap: (message.wrap === undefined && autoWrap()) || !!message.wrap,
|
|
type: messageType,
|
|
});
|
|
return true;
|
|
};
|
|
|
|
export const getMessages = function () {
|
|
return messages;
|
|
};
|
|
|
|
export const getActors = function () {
|
|
return actors;
|
|
};
|
|
export const getActor = function (id) {
|
|
return actors[id];
|
|
};
|
|
export const getActorKeys = function () {
|
|
return Object.keys(actors);
|
|
};
|
|
export const getTitle = function () {
|
|
return title;
|
|
};
|
|
export const enableSequenceNumbers = function () {
|
|
sequenceNumbersEnabled = true;
|
|
};
|
|
export const showSequenceNumbers = () => sequenceNumbersEnabled;
|
|
|
|
export const setWrap = function (wrapSetting) {
|
|
wrapEnabled = wrapSetting;
|
|
};
|
|
|
|
export const autoWrap = () => wrapEnabled;
|
|
|
|
export const clear = function () {
|
|
actors = {};
|
|
messages = [];
|
|
sequenceNumbersEnabled = false;
|
|
};
|
|
|
|
export const parseMessage = function (str) {
|
|
const _str = str.trim();
|
|
const message = {
|
|
text: _str.replace(/^[:]?(?:no)?wrap:/, '').trim(),
|
|
wrap:
|
|
_str.match(/^[:]?wrap:/) !== null
|
|
? true
|
|
: _str.match(/^[:]?nowrap:/) !== null
|
|
? false
|
|
: undefined,
|
|
};
|
|
log.debug('parseMessage:', message);
|
|
return message;
|
|
};
|
|
|
|
export const LINETYPE = {
|
|
SOLID: 0,
|
|
DOTTED: 1,
|
|
NOTE: 2,
|
|
SOLID_CROSS: 3,
|
|
DOTTED_CROSS: 4,
|
|
SOLID_OPEN: 5,
|
|
DOTTED_OPEN: 6,
|
|
LOOP_START: 10,
|
|
LOOP_END: 11,
|
|
ALT_START: 12,
|
|
ALT_ELSE: 13,
|
|
ALT_END: 14,
|
|
OPT_START: 15,
|
|
OPT_END: 16,
|
|
ACTIVE_START: 17,
|
|
ACTIVE_END: 18,
|
|
PAR_START: 19,
|
|
PAR_AND: 20,
|
|
PAR_END: 21,
|
|
RECT_START: 22,
|
|
RECT_END: 23,
|
|
SOLID_POINT: 24,
|
|
DOTTED_POINT: 25,
|
|
};
|
|
|
|
export const ARROWTYPE = {
|
|
FILLED: 0,
|
|
OPEN: 1,
|
|
};
|
|
|
|
export const PLACEMENT = {
|
|
LEFTOF: 0,
|
|
RIGHTOF: 1,
|
|
OVER: 2,
|
|
};
|
|
|
|
export const addNote = function (actor, placement, message) {
|
|
const note = {
|
|
actor: actor,
|
|
placement: placement,
|
|
message: message.text,
|
|
wrap: (message.wrap === undefined && autoWrap()) || !!message.wrap,
|
|
};
|
|
|
|
// Coerce actor into a [to, from, ...] array
|
|
const actors = [].concat(actor, actor);
|
|
|
|
notes.push(note);
|
|
messages.push({
|
|
from: actors[0],
|
|
to: actors[1],
|
|
message: message.text,
|
|
wrap: (message.wrap === undefined && autoWrap()) || !!message.wrap,
|
|
type: LINETYPE.NOTE,
|
|
placement: placement,
|
|
});
|
|
};
|
|
|
|
export const addLinks = function (actorId, text) {
|
|
// find the actor
|
|
const actor = getActor(actorId);
|
|
// JSON.parse the text
|
|
try {
|
|
let sanitizedText = sanitizeText(text.text, configApi.getConfig());
|
|
sanitizedText = sanitizedText.replace(/&/g, '&');
|
|
sanitizedText = sanitizedText.replace(/=/g, '=');
|
|
const links = JSON.parse(sanitizedText);
|
|
// add the deserialized text to the actor's links field.
|
|
insertLinks(actor, links);
|
|
} catch (e) {
|
|
log.error('error while parsing actor link text', e);
|
|
}
|
|
};
|
|
|
|
export const addALink = function (actorId, text) {
|
|
// find the actor
|
|
const actor = getActor(actorId);
|
|
try {
|
|
const links = {};
|
|
let sanitizedText = sanitizeText(text.text, configApi.getConfig());
|
|
var sep = sanitizedText.indexOf('@');
|
|
sanitizedText = sanitizedText.replace(/&/g, '&');
|
|
sanitizedText = sanitizedText.replace(/=/g, '=');
|
|
var label = sanitizedText.slice(0, sep - 1).trim();
|
|
var link = sanitizedText.slice(sep + 1).trim();
|
|
|
|
links[label] = link;
|
|
// add the deserialized text to the actor's links field.
|
|
insertLinks(actor, links);
|
|
} catch (e) {
|
|
log.error('error while parsing actor link text', e);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @param {any} actor
|
|
* @param {any} links
|
|
*/
|
|
function insertLinks(actor, links) {
|
|
if (actor.links == null) {
|
|
actor.links = links;
|
|
} else {
|
|
for (let key in links) {
|
|
actor.links[key] = links[key];
|
|
}
|
|
}
|
|
}
|
|
|
|
export const addProperties = function (actorId, text) {
|
|
// find the actor
|
|
const actor = getActor(actorId);
|
|
// JSON.parse the text
|
|
try {
|
|
let sanitizedText = sanitizeText(text.text, configApi.getConfig());
|
|
const properties = JSON.parse(sanitizedText);
|
|
// add the deserialized text to the actor's property field.
|
|
insertProperties(actor, properties);
|
|
} catch (e) {
|
|
log.error('error while parsing actor properties text', e);
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @param {any} actor
|
|
* @param {any} properties
|
|
*/
|
|
function insertProperties(actor, properties) {
|
|
if (actor.properties == null) {
|
|
actor.properties = properties;
|
|
} else {
|
|
for (let key in properties) {
|
|
actor.properties[key] = properties[key];
|
|
}
|
|
}
|
|
}
|
|
|
|
export const addDetails = function (actorId, text) {
|
|
// find the actor
|
|
const actor = getActor(actorId);
|
|
const elem = document.getElementById(text.text);
|
|
|
|
// JSON.parse the text
|
|
try {
|
|
const text = elem.innerHTML;
|
|
const details = JSON.parse(text);
|
|
// add the deserialized text to the actor's property field.
|
|
if (details['properties']) {
|
|
insertProperties(actor, details['properties']);
|
|
}
|
|
|
|
if (details['links']) {
|
|
insertLinks(actor, details['links']);
|
|
}
|
|
} catch (e) {
|
|
log.error('error while parsing actor details text', e);
|
|
}
|
|
};
|
|
|
|
export const getActorProperty = function (actor, key) {
|
|
if (typeof actor !== 'undefined' && typeof actor.properties !== 'undefined') {
|
|
return actor.properties[key];
|
|
}
|
|
|
|
return undefined;
|
|
};
|
|
|
|
export const setTitle = function (txt) {
|
|
let sanitizedText = sanitizeText(txt, configApi.getConfig());
|
|
title = sanitizedText;
|
|
};
|
|
|
|
export const apply = function (param) {
|
|
if (param instanceof Array) {
|
|
param.forEach(function (item) {
|
|
apply(item);
|
|
});
|
|
} else {
|
|
switch (param.type) {
|
|
case 'addParticipant':
|
|
addActor(param.actor, param.actor, param.description, 'participant');
|
|
break;
|
|
case 'addActor':
|
|
addActor(param.actor, param.actor, param.description, 'actor');
|
|
break;
|
|
case 'activeStart':
|
|
addSignal(param.actor, undefined, undefined, param.signalType);
|
|
break;
|
|
case 'activeEnd':
|
|
addSignal(param.actor, undefined, undefined, param.signalType);
|
|
break;
|
|
case 'addNote':
|
|
addNote(param.actor, param.placement, param.text);
|
|
break;
|
|
case 'addLinks':
|
|
addLinks(param.actor, param.text);
|
|
break;
|
|
case 'addALink':
|
|
addALink(param.actor, param.text);
|
|
break;
|
|
case 'addProperties':
|
|
addProperties(param.actor, param.text);
|
|
break;
|
|
case 'addDetails':
|
|
addDetails(param.actor, param.text);
|
|
break;
|
|
case 'addMessage':
|
|
addSignal(param.from, param.to, param.msg, param.signalType);
|
|
break;
|
|
case 'loopStart':
|
|
addSignal(undefined, undefined, param.loopText, param.signalType);
|
|
break;
|
|
case 'loopEnd':
|
|
addSignal(undefined, undefined, undefined, param.signalType);
|
|
break;
|
|
case 'rectStart':
|
|
addSignal(undefined, undefined, param.color, param.signalType);
|
|
break;
|
|
case 'rectEnd':
|
|
addSignal(undefined, undefined, undefined, param.signalType);
|
|
break;
|
|
case 'optStart':
|
|
addSignal(undefined, undefined, param.optText, param.signalType);
|
|
break;
|
|
case 'optEnd':
|
|
addSignal(undefined, undefined, undefined, param.signalType);
|
|
break;
|
|
case 'altStart':
|
|
addSignal(undefined, undefined, param.altText, param.signalType);
|
|
break;
|
|
case 'else':
|
|
addSignal(undefined, undefined, param.altText, param.signalType);
|
|
break;
|
|
case 'altEnd':
|
|
addSignal(undefined, undefined, undefined, param.signalType);
|
|
break;
|
|
case 'setTitle':
|
|
setTitle(param.text);
|
|
break;
|
|
case 'parStart':
|
|
addSignal(undefined, undefined, param.parText, param.signalType);
|
|
break;
|
|
case 'and':
|
|
addSignal(undefined, undefined, param.parText, param.signalType);
|
|
break;
|
|
case 'parEnd':
|
|
addSignal(undefined, undefined, undefined, param.signalType);
|
|
break;
|
|
}
|
|
}
|
|
};
|
|
|
|
const setAccDescription = function (description_lex) {
|
|
let sanitizedText = sanitizeText(description_lex, configApi.getConfig());
|
|
description = sanitizedText;
|
|
};
|
|
|
|
const getAccDescription = function () {
|
|
return description;
|
|
};
|
|
|
|
export default {
|
|
addActor,
|
|
addMessage,
|
|
addSignal,
|
|
addLinks,
|
|
addDetails,
|
|
addProperties,
|
|
autoWrap,
|
|
setWrap,
|
|
enableSequenceNumbers,
|
|
showSequenceNumbers,
|
|
getMessages,
|
|
getActors,
|
|
getActor,
|
|
getActorKeys,
|
|
getActorProperty,
|
|
getTitle,
|
|
parseDirective,
|
|
getConfig: () => configApi.getConfig().sequence,
|
|
clear,
|
|
parseMessage,
|
|
LINETYPE,
|
|
ARROWTYPE,
|
|
PLACEMENT,
|
|
addNote,
|
|
setTitle,
|
|
apply,
|
|
setAccDescription,
|
|
getAccDescription,
|
|
};
|