Twaver-HTML5基础学习(5)告警元素(Alarm)的告警位置(偏移量以及定位理解)

简介: 本文介绍了在Twaver HTML5中如何设置告警元素(Alarm)的位置,包括Node和Link网元的告警位置偏移量以及定位理解。通过示例代码展示了如何在不同类型网元上设置告警位置,并解释了如何通过百分比来确定告警在Link网元上的位置。

告警位置

Node等网元

网元中Alarm的位置可以参考Alarm样式属性alarm.position一栏。具体位置可与下图一一对应。注意Node网元中Alarm的Position位置属性没有from和to选项,因为概念上是讲不通的。
对于Node网元alarm.xoffset和alarm.yoffset分别代表了相对于alarm当前位置的x轴和y轴偏移量。

在这里插入图片描述

Link等网元

Link网元中alarm.position除了具有fron和to两个特殊的位置外,其他和上面的Node网元完全是一致的。在此着重介绍hotspot、from、to三个位置。

在这里插入图片描述
对于Link网元的alarm.xoffset和alarm.yoffset有个特殊的含义:
如果将xoffset的值设置为正负(0-1)之间的值,则代表了alarm在Link上的百分比位置。
当alarm.position设置为”from”,xoffset 取值为”0 – 1”则表示百分比,否则按实际值计算,偏移量均相对于起始from点,
position为”to”,则反之。
position为其他任何值,hotspot点为所有link长度一半的点,xoffset可取正数(0 – 1)、也可取负数(-1-0),都则按实际值计算。

例子

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
工具JS代码:

const twaver = require('twaver');
// 设置每个图元name的颜色
twaver.Styles.setStyle('label.color', '#ec6c00');
// 设置每个图元name2的颜色
twaver.Styles.setStyle('label2.color', '#57ab9a');
twaver.Styles.setStyle('select.color', '#ef8200');
//TWaver内部预定义六中告警级别
twaver.AlarmSeverity.CRITICAL = twaver.AlarmSeverity.add(500, 'Critical', 'C', "#FF0000");
twaver.AlarmSeverity.MAJOR = twaver.AlarmSeverity.add(400, 'Major', 'M', "#FFA000");
twaver.AlarmSeverity.MINOR = twaver.AlarmSeverity.add(300, 'Minor', 'm', "#FFFF00");
twaver.AlarmSeverity.WARNING = twaver.AlarmSeverity.add(200, 'Warning', 'W', "#00FFFF");
twaver.AlarmSeverity.INDETERMINATE = twaver.AlarmSeverity.add(100, 'Indeterminate', 'N', "#C800FF");
twaver.AlarmSeverity.CLEARED = twaver.AlarmSeverity.add(0, 'Cleared', 'R', "#00FF00");

const {
    CRITICAL, MAJOR, WARNING, MINOR, INDETERMINATE, CLEARED } = twaver.AlarmSeverity
export const ALARM1 = CLEARED
export const ALARM2 = INDETERMINATE
export const ALARM3 = MINOR
export const ALARM4 = MAJOR
export const ALARM5 = CRITICAL

    /**
     * 创建一个dataBox容器
     * 容器中可以add图元
     */
    export const returnElementBoxFun = () => new twaver.ElementBox()


/**
 * 创建一个画布 network对象
 * @param {ElementBox} box  创建一个画布 network对象
 */
export const returnNetworkFun = (box) => new twaver.vector.Network(box)

/**
 * 创建一个Group
 * 用于包裹图元
 */
export const returnGroupFun = (box, obj = {
   }) => {
   
    let group = new twaver.Group(obj)
    box.add(group)
    return group
}



/**
 * 创建一个容器dataBox和一个画布
 * 并将容器实例化画布
 * @returns [box,network] box network
 */
export const returnElementBoxAndNetworkFun = () => {
   
    let box = returnElementBoxFun();
    let network = returnNetworkFun(box);
    return [box, network]
}

/**
 * 用于创建一个节点
 * @param {ElementBox} box dataBox 
 * @param {String} name 当前节点的name
 * @param {Number} x   当前节点的x坐标
 * @param {Number} y 当前节点的y坐标
 * @returns {Node} Node
 */
export const returnNodeFun = (box, Obj = {
   }) => {
   
    let node = new twaver.Node(Obj);
    // node.setName(name);
    // node.setLocation(x, y);
    box.add(node);
    return node
}

/**
 * 
 * @param {Node} node1 节点1
 * @param {Node} node2 节点2
 */
export const returnLineFun = (node1, node2) => new twaver.Link(node1, node2)

/**
 * 注册图片 用于设置图元的img setImage
 * @param {String} url 图片 url
 * @param {NetWork} svg  NetWork对象
 */
export function returnRegisterImage(url, svg) {
   
    var image = new Image();
    image.src = url;
    var views = arguments;
    image.onload = function () {
   
        // getImageName 获取到的图片name用做 node节点的显示img
        twaver.Util.registerImage(getImageName(url), image, image.width, image.height, svg === true);
        image.onload = null;
        for (var i = 1; i < views.length; i++) {
   
            var view = views[i];
            if (view.invalidateElementUIs) {
   
                view.invalidateElementUIs();
            }
            if (view.invalidateDisplay) {
   
                view.invalidateDisplay();
            }
        }
    };
    // getImageName 获取到的图片name用做 node节点的显示img
    const getImageName = (url) => {
   
        var index = url.lastIndexOf('/');
        var name = url;
        if (index >= 0) {
   
            name = url.substring(index + 1);
        }
        index = name.lastIndexOf('.');
        if (index >= 0) {
   
            name = name.substring(0, index);
        }
        return name;
    }
}


/*
 * @param {*} 告警的Id 
 * @param {*} 告警网元的Id 
  * @param {*} 告警级别 
 * @param {*} alarmBox 网元容器.getAlarmBox()
 */
export const returnAlarmFun = (alarmID, elementID, alarmSeverity, alarmBox) => {
   
    var alarm = new twaver.Alarm(alarmID, elementID, alarmSeverity);
    alarmBox.add(alarm);
}

react页面代码:

import React, {
    useEffect, useState } from 'react'
import {
   
    // returnElementBoxFun,
    // returnNetworkFun,
    returnGroupFun,
    returnElementBoxAndNetworkFun,
    returnNodeFun,
    returnLineFun,
    returnRegisterImage,
    returnAlarmFun, ALARM1, ALARM2, ALARM3, ALARM4, ALARM5
} from './utils'
const twaver = require('twaver');
// const demo = require('demo');
const Demo = () => {
   
    const [network, setnetwork] = useState({
   })
    const init = () => {
   
        const [box, network] = returnElementBoxAndNetworkFun()
        setnetwork(_ => network)
        document.getElementById("testID").appendChild(network.getView());
        // 设置最初的大小
        network.adjustBounds({
    x: 0, y: 0, width: 800, height: 800 });


        let positions = ["from", "hotspot", "to"];
        let alarmSeverity = [ALARM1, ALARM2, ALARM3, ALARM4, ALARM5];
        let node1 = returnNodeFun(box, {
    name: '节点1', name2: "节点1name2", location: {
    x: 100, y: 100 }, })
        let node2 = returnNodeFun(box, {
    name: '节点2', name2: "节点2name2", location: {
    x: 540, y: 300 }, })
        let group1 = returnGroupFun(box, {
    name: "group1" })
        group1.addChild(node1)
        group1.addChild(node2)
        var line1 = returnLineFun(node1, node2)
        box.add(line1);
        line1.s('alarm.position', positions[0]);
        line1.s('alarm.xoffset', .3);
        returnAlarmFun("link" + 1, line1.getId(), alarmSeverity[1], box.getAlarmBox());

        var link = new twaver.ShapeLink(node1, node2);
        box.add(link);


        let node3 = returnNodeFun(box, {
    name: '节点3', location: {
    x: 300, y: 300 }, })
        let node4 = returnNodeFun(box, {
    name: '节点4', location: {
    x: 440, y: 400 }, })
        let group2 = returnGroupFun(box, {
    name: "group2" })
        group2.addChild(node3)
        group2.addChild(node4)
        var link2 = new twaver.ShapeLink(node3, node4);
        box.add(link2);
        var list = new twaver.List();
        list.add({
   
            x: 250,
            y: 500
        });
        list.add({
   
            x: 400,
            y: 500
        });
        link2.addPoint(list);
        link2.s('alarm.position', positions[1]);
        link2.s('alarm.xoffset', .5);
        returnAlarmFun("shapelink" + 1, link2.getId(), alarmSeverity[2], box.getAlarmBox());
        returnAlarmFun("group2" + 1, group2.getId(), alarmSeverity[3], box.getAlarmBox());
        group2.s('alarm.position','right')
        // ====================
        var groupline = returnLineFun(group1, group2)
        box.add(groupline)
    }
    useEffect(init, [])
    return (
        <>
            <p style={
   {
    fontSize: "20px", paddingLeft: "50px", poaddingTop: "50px" }}>tips: </p>
            <ul style={
   {
    fontSize: "20px", paddingLeft: "50px" }}>
                <li>alarm.xoffset和alarm.yoffset以及alarm.position </li>

                <li>对于Link网元的alarm.xoffset和alarm.yoffset有个特殊的含义,<br />
                    如果将xoffset的值设置为正负(0-1)之间的值,则代表了alarm在Link上的百分比位置。<br />
                    当alarm.position设置为”from”,xoffset 取值为”01”则表示百分比,否则按实际值计算,偏移量均相对于起始from点,<br />
                    position为”to”,则反之。position为其他任何值,<br />
                    hotspot点为所有link长度一半的点,xoffset可取正数(01)、也可取负数(-1-0),都则按实际值计算。</li>
            </ul>
            {
   /* 画布元素需要开启定位 不然生成的图元坐标点会偏移 */}
            <div id="testID" style={
   {
    width: "800px", height: "800px", border: "1px solid #ccc", position: "relative" }}></div>
        </>
    )
}
export default Demo

总结:

对于Node网元,直接设置alarm.position为对应值即可;
对于Link网元,alarm.position有三种值:from hotspot to
Link可以设置偏移量属性alarm.xoffset、alarmyoffset;
当为from to的时候,
1:from 到 to的时候是正值 即 0-1 from为起点按照百分比换算长度
2:to 到 from的时候是正值 即 0-1 to为起点按照百分比换算长度
3:hotspot 可以为0-1 -1-0,从from到to为正,to到from为负;默认为中点,比如上面的例子:

 link2.s('alarm.position', positions[1]); //1 ===》 hotspot 
  link2.s('alarm.xoffset', .5);

那么他的意思就是向to方向再次移动一半距离的0.5,其相当于from 的 0.75;

学习参考:TWaver Documents

目录
相关文章
|
1月前
|
移动开发 开发者 UED
HTML5 语义元素详解
HTML5引入了诸多语义元素
WK
|
1月前
|
存储 移动开发 前端开发
HTML5新增了哪些其他元素和属性
这段文字介绍了HTML5中新增的多种元素和属性,包括页面布局元素如header、nav等,表单元素如email、tel输入框等,以及其他元素如canvas、svg等。此外,还介绍了全局及表单属性,例如contenteditable、placeholder等,这些新功能显著增强了HTML5在现代网页设计与开发中的实用性与灵活性。
WK
46 1
|
10天前
HTML 元素
HTML文档由HTML元素定义,元素包括开始标签、内容和结束标签。某些元素内容为空,可在开始标签中关闭。大多数元素可拥有属性,且元素间可相互嵌套,形成复杂结构。
|
15天前
|
人工智能
|
1月前
|
移动开发 数据安全/隐私保护 UED
HTML5 表单元素详解
HTML5 引入了新的表单元素和属性,如 `&lt;form&gt;、&lt;input&gt;、&lt;textarea&gt;、&lt;select&gt;` 和 `&lt;button&gt;`,以及 `required、min、max` 等属性,增强了表单的创建与交互。其中,`&lt;input&gt;` 支持多种类型如 `email、url、date` 等,提供了更好的用户体验和数据验证。此外,HTML5 还新增了原生表单验证功能,简化了开发流程并提升了安全性。
WK
|
1月前
|
Web App开发 存储 移动开发
HTML5新增了哪些表单元素
HTML5通过新增多种表单元素和属性,提升了用户体验与交互性。例如,`email`和`url`元素分别验证邮箱地址和网址格式;`number`和`range`便于输入数字及区间值;`date`等元素简化了日期时间的选择;`search`添加搜索图标,`color`提供颜色选择器;`datalist`结合`input`属性给予用户下拉列表选项;`keygen`用于生成密钥对以增强安全性;`output`则用于动态展示计算结果。这些改进共同提高了表单的功能性和易用性。
WK
21 2
|
23天前
|
数据采集 数据安全/隐私保护
html常见的表单元素有哪些,html表单元素有哪些?
html常见的表单元素有哪些,html表单元素有哪些?
13 0
|
24天前
html基础知识学习
html基础知识学习
29 0
|
27天前
|
JavaScript 前端开发
DOM的概念?获取html元素的方法有哪些?
DOM的概念?获取html元素的方法有哪些?
28 0
|
2月前
|
移动开发 数据可视化 HTML5
Twaver-HTML5基础学习(40)表格可视化视图组件(Table)
本文介绍了如何在Twaver-HTML5中使用表格可视化视图组件(Table),包括创建表格、定义列对象、实现数据绑定和排序,以及处理表格事件和获取表格数据的方法。
35 1