3D 手册 -HT for Web----新手学习-ht.Default

 

ht.Default

ht.Default定义了所有组件的默认参数值，命名规范以组件名+属性名的结合方式，例如树组件TreeView的行线是否显示属性rowLineVisible，该属性的默认值定义在ht.Default.treeViewRowLineVisible上，因此可通过treeView.setRowLineVisible(true)改变具体组件实例，也可通过配置ht.Default.treeViewRowLineVisible属性达到全局修改所有TreeView实例的效果。

ht.Default中出了定义了默认参数外，还包含很多工具函数，以下例子是对所有属性参数，以及工具函数使用的描述说明：

{
    "numberDigits": "Nbmber 序列化时，数值类型数据的最大精度值",
    "baseZIndex": "undefined，指定组件基准CSS的ZIndex值，改值仅在将HT与其他第三方组件混合使用时根据需要设置",
    "isTouchable": "false，判断是否为触屏可Touch方式交互，HT系统一般会自动判断，对于极少数HT无法正确识别的系统下，可以通过配置强制指定",
    "devicePixelRatio": "1.375，设备像素比，HT系统自动取至window.devicePixelRatio，某些特性情况需要为mobile应用牺牲精度节省内存时可以强制设置为较小值",
    "reinvalidateCount": "3，组件初次加载时界面宽高值可能会为0，HT会自动尝试等待下次延迟刷新，该参数一般无需改动",
    "hitMaxArea": "3000，进行框选判断时为了避免内存占用过大，HT会根据最大面积限制进行缩放判断，该参数一般无需改动",
    "imageCacheThreshold": "[[[20]]]",
    "autoMakeVisible": "true，决定Data元素被选中时，组件是否自动滚动到Data元素可见位置",
    "autoHideScrollBar": "true，决定组件的滚动条默认是否自动隐藏，true为自动显示和隐藏，false则需要滚动时一直显示不会自动隐藏",
    "disabledOpacity": "组件无效时的透明度",
    "disabledBackground": "组件无效时的背景色",
    "forceHierarchicalSerialization": "[[[true]]]",
    "hoverDelay": "[[[600]]]",
    "toolTipDelay": "800，决定组件的ToolTip显示的延迟间隔",
    "toolTipContinual": "false，决定组件的ToolTip显示的情况下，如果鼠标移动到新的位置时，ToolTip是否实时持续跟进",
    "getDragger": "getDragger()获取当前响应拖拽事件的交互器",
    "lineCap": "butt，决定线条末端线帽的样式，可选参数为：butt|round|square",
    "lineJoin": "round，决定当两条线交汇时创建边角的类型，可选参数为：bevel|round|miter",
    "imageGradient": "linear.northeast，决定默认图片的渐进色类型",
    "dashPattern": "连线或多边形等图形的默认虚线样式",
    "animDuration": "200，决定默认动画周期",
    "animEasing": "function (z){return z*z}，决定默认动画效果函数，可参考http://msdn.microsoft.com/en-us/library/ee308751(v=vs.110).aspx",
    "labelColor": "#000，默认文字颜色",
    "labelSelectColor": "#FFF，默认选择状态下文字颜色",
    "labelFont": "12px arial, sans-serif，默认文字字体",
    "widgetIndent": "20，该属性决定通用组件缩进，例如树组件每一层的缩进",
    "widgetRowHeight": "20，该属性决定通用组件行高，例如表格每行行高",
    "widgetHeaderHeight": "22，该属性决定通用组件抬头高度，例如TabView，TableHeader和Toolbar等的头部高度",
    "widgetTitleHeight": "24，该属性决定AccordionView和TabView等组件的Title默认高度",
    "scrollBarColor": "rgba(0,0,0,0.35)，默认滚动条颜色",
    "scrollBarSize": "7，默认滚动条宽度",
    "scrollBarTimeout": "1000，默认滚动条隐藏间隔毫秒数",
    "scrollBarMinLength": "20，默认滚动条最小长度",
    "scrollBarInteractiveSize": "16，默认滚动条起作用区域大小",
    "zoomIncrement": "1.3，默认缩放步进",
    "scrollZoomIncrement": "1.05，默认滚轮缩放步进",
    "pinchZoomIncrement": "1.08，默认双指触屏Touch方式缩放步进",
    "zoomMax": "20，默认最大缩放倍数",
    "zoomMin": "0.01，默认最小缩放倍数",
    "segmentResolution": "12，默认曲线分段微分数",
    "shapeResolution": "24，默认模型分段微分数",
    "shapeSide": "24，默认模型边数",
    "intersectionLineRect": "intersectionLineRect(p1, p2, r)获取 2D 上线和面的交点信息",
    "intersectionLineLine": "intersectionLineLine(a1x, a1y, a2x, a2y, b1x, b1y, b2x, b2y, segment)获取 2D 上两条线之间的交点",
    "isEnter": "isEnter(e)判断键盘是否按下 Enter 键",
    "isEsc": "isEsc(e)判断键盘四否按下 Esc 键",
    "isDelete": "isDelete(e)判断键盘是否按下 Delete 键",
    "isSpace": "isSpace(e)判断键盘是否按下空格键",
    "isLeft": "isLeft(e)判断键盘是否按下方向左键",
    "isUp": "isUp(e)判断键盘是否按下方向上键",
    "isRight": "isRight(e)判断键盘是否按下方向右键",
    "isDown": "isDown(e)判断键盘是否按下方向下键",
    "getTarget": "getTarget(e)获取事件对象",
    "isString": "isString(s)判断对象是否为字符串类型",
    "isNumber": "isNumber(n)判断对象是否为数值类型",
    "isBoolean": "isBoolean(b)判断对象是否为 Boolean 类型",
    "isArray": "isArray(a)判断对象是否为数组类型",
    "isSelectAll": "isSelectAll(e)判断键盘是否按下 ctrl + A",
    "isFunction": "isFunction(f)判断对象是否为函数类型",
    "isObject": "[[[function (N){return N&&\"object\"==typeof N}]]]",
    "getPropertyValue": "getPropertyValue(data, type, name)根据类型获取节点上的属性值",
    "setPropertyValue": "setPropertyValue(data, type, name, value)设置节点上指定类型的属性值",
    "addMethod": "addMethod(clazz, o, keepExist)向类中添加方法或属性值",
    "getVersion": "function (){return\"6.1.8\"}，getVersion()获取HT系统版本号",
    "appendToScreen": "[[[function (p){p=p.getView?p.getView():p,(r.fullscreenElement||r.mozFullScreenElement||r.webkitFullscreenElement||r.msFullscreenElement||r.body).appendChild(p)}]]]",
    "toggleFullscreen": "[[[function (x){var T=x.getView();if(!(r.fullscreenElement||r.mozFullScreenElement||r.webkitFullscreenElement||r.msFullscreenElement)){var s=!0;if(x.isSelfViewEvent){var m=x.getX(),u=x.getY(),B=x.getWidth(),A=x.getHeight(),j=T.style.background;j||(T.style.background=\"white\"),T.requestFullscreen?T.requestFullscreen():T.msRequestFullscreen?T.msRequestFullscreen():T.mozRequestFullScreen?T.mozRequestFullScreen():T.webkitRequestFullscreen&&T.webkitRequestFullscreen();var i=setInterval(function(){if(T!==(r.fullscreenElement||r.mozFullScreenElement||r.webkitFullscreenElement||r.msFullscreenElement))clearInterval(i),x.setX(m),x.setY(u),x.setWidth(B),x.setHeight(A),x._fullscreen=!1,T.style.background=j,x.iv();else{var y=z.Default.getWindowInfo();(s||y.width!==x.getWidth()||y.height!==x.getHeight())&&(x.setX(y.left),x.setY(y.top),x.setWidth(y.width),x.setHeight(y.height),x._fullscreen=!0,x.iv(),s=!1)}},500)}else{var U=T.style.left,I=T.style.top,B=T.style.width,A=T.style.height,j=T.style.background;j||(T.style.background=\"white\"),T.requestFullscreen?T.requestFullscreen():T.msRequestFullscreen?T.msRequestFullscreen():T.mozRequestFullScreen?T.mozRequestFullScreen():T.webkitRequestFullscreen&&T.webkitRequestFullscreen();var i=setInterval(function(){if(T!==(r.fullscreenElement||r.mozFullScreenElement||r.webkitFullscreenElement||r.msFullscreenElement))clearInterval(i),T.style.left=U,T.style.top=I,T.style.width=B,T.style.height=A,T.style.background=j,x.iv();else{var Q=z.Default.getWindowInfo();(s||Q.width!==x.getWidth()||Q.height!==x.getHeight())&&(Pm(x),s=!1)}},500)}}}]]]",
    "appendTimeStamp": "appendTimeStamp(url)给 URL 加上时间戳",
    "setCompType": "setCompType(type, function(g, rect, comp, data, view){})注册矢量组件类型",
    "getCompType": "getCompType(type)获取矢量组件类型",
    "getCompTypeMap": "getCompTypeMap()获取矢量自定义类型 Map 对象",
    "drawCompType": "drawCompType(func, g, rect, comp, data, view)绘制矢量自定义类型",
    "numberListener": "数字类型监听器，该监听器将使得input文本输入框只允许输入数学相关字符",
    "ignoreKeyCodes": "系统忽略不处理的按键代码列表",
    "preventDefault": "preventDefault(e)阻止默认行为函数，常用于屏蔽触屏上默认DoubleTap缩放等行为",
    "getWindowInfo": "getWindowInfo()获取当前窗口left|top|width|height的参数信息",
    "isDragging": "判断目前是否处于拖拽状态，isDraging()无输入参数，返回true|false",
    "isLeftButton": "判断是否鼠标左键被按下，isLeftButton(e)，传入交互事件，返回true|false",
    "isInput": "isInput(target)判断对象是否为输入框",
    "getTouchCount": "获取当前Touch手指个数，getTouchCount(e)，传入交互事件，返回int类型个数",
    "isDoubleClick": "判断是否为双击事件，isDoubleClick(e)，传入交互事件，返回true|false",
    "isShiftDown": "判断是否鼠标Shift键被按下，isShiftDown(e)，传入交互事件，返回true|false",
    "isCtrlDown": "判断是否鼠标Ctrl键被按下，isCtrlDown(e)，传入交互事件，返回true|false",
    "getClientPoint": "返回client属性坐标，getClientPoint(e)，传入交互事件，返回{x:clientX, y:clientY}格式对象",
    "isMouseEvent": "isMouseEvent(e)判断对象是否为鼠标事件对象",
    "getTargetElement": "getTargetElement(e)获取事件对象下的 Dom 元素",
    "getPagePoint": "返回page属性坐标，getPagePoint(e)，传入交互事件，返回{x:pageX, y:pageY}格式对象",
    "createObject": "createObject(clazz, attributes)构建类对象",
    "setImage": "setImage(name)|setImage(name, img)|setImage(name, src)|setImage(name, width, height, src)四种方式设置图片，HT数据模型设置图片只需设置注册图片的name名称即可",
    "getImage": "getImage(name, color)获取图片，name为图片名称，color为染色颜色",
    "isImageComplete": "[[[function (j,g,H){var W=Ki(j)?j:us[j];if(!W)return!1;if(W.tagName)return W.complete;for(var i,j,V=W.comps,E=!0,r=0,Q=V.length;Q>r;r++)if(i=V[r],\"image\"===i.type){j=i.name,j&&j.func&&(j=Vo(j,g));var F=ql(j,g,H);if(!F){E=!1;break}}return E}]]]",
    "getId": "getId()获取全局下一个id编号，该函数用户自动生成新创建Data对象的id值",
    "callLater": "延迟回调函数callLater(func, scope, args, delay)，scope|args|delay皆为可选项，返回处理句柄",
    "asyncEach": "asyncEach(items, next, callback)异步遍历",
    "xhrLoad": "xhrLoad(urls, cb, opt)发送 Get 请求",
    "clone": "克隆函数clone(obj)，传入一个对象参数，浅拷贝方式返回一个新的复制对象",
    "callWhenLoaded": "[[[function (g,S){S=S||100;var i=ao(g,S);Sh||(Sh={}),Sh[i]={tick:i,cb:g,delay:S}}]]]",
    "beforeLoadURL": "[[[function (R){if(Sh){var O={};for(var i in Sh){var G=Sh[i];u(G.tick);var T=ao(G.cb,G.delay);O[T]={tick:T,delay:G.delay,cb:G.cb}}Sh=O}return h.convertURL?h.convertURL(R):R}]]]",
    "convertURL": "[[[function (I){return I}]]]",
    "handleRefGraphLoaded": "[[[function (){}]]]",
    "handleCompTypeLoaded": "handleCompTypeLoaded(name, compType)自定义矢量类型加载完成后的回调",
    "handleImageLoaded": "handleImageLoaded(name, img)系统图片在加载之后的回调函数",
    "handleUnfoundImage": "handleUnfoundImage(name, url)对系统内部找不到图片的情况下会调用该函数，默认访问空，可自定义返回一个默认的图片",
    "sortFunc": "默认排序函数sortFunc(v1, v2)，传入两个比较值，返回-1|0|1的比较结果，例如用于默认的表头排序逻辑，可重载自定义",
    "getClassMap": "getClassMap()函数返回所有HT预定义类的json结构信息，key为类全路径名，value为类定义",
    "getClass": "getClass(name)，传入全路径类字符串名称，返回类定义",
    "def": "def(className, superClass, methods)定义类函数，例如ht.Default.def(\"com.hightopo.MyData\", ht.Data, {getAge: function(){ return 33; }});",
    "startAnim": "启动动画函数startAnim(params)，参考入门手册详细说明",
    "getTextSize": "getTextSize(font, text)获取文本大小，返回{width: 100, height: 20}的结构信息",
    "drawText": "drawText(g, value, font, color, x, y, width, height, align, vAlign)绘制文字，align的可选值为left|center|right，vAlign可选值为top|middle|bottom",
    "getDistance": "getDistance(point1, point2)|getDistance(vec1, vec2)|getDistance(vec)获取两点之间距离，或矢量长度，point为{x:x,y:y}格式，vec为[x,y,z]数组",
    "brighter": "brighter(color, factor)返回比color更亮的颜色，factor缺省值为40，允许值为0~100",
    "darker": "darker(color, factor)返回比color更暗的颜色，factor缺省值为-40，允许值为0~-100",
    "unionPoint": "unionPoint(point1, point2)|unionPoint(points)函数返回点组合的矩形区域，可传入两个点，也可传入ht.List和Array类似的数组",
    "unionRect": "unionRect(rect1, rect2)函数返回两个矩形区域union融合后的新矩形区域",
    "containsPoint": "containsPoint(rect, point)函数判断point是否包含在rect的矩形区域里，返回true|false",
    "containsRect": "containsRect(rect1, rect2)函数判断矩形区域rect2是否包含在矩形区域rect1里面，返回true|false",
    "intersectsRect": "intersectsRect(rect1, rect2)函数判断矩形区域rect1和矩形区域rect2是否相交，返回true|false",
    "intersection": "intersection(rect1, rect2)函数判断矩形区域rect1和矩形区域rect2的相交矩形区域，无相交则返回null",
    "grow": "grow(rect, extend)函数改变rect大小，上下左右分别扩展extend的大小",
    "getLogicalPoint": "getLogicalPoint(e, view, translateX, translateY, zoomX, zoomY)获取交互点的逻辑坐标，一般View会提供getLogicalPoint(e)更便捷的函数",
    "removeHTML": "removeHTML(html)从界面删除指定的html元素",
    "getToolTipDiv": "getToolTipDiv()函数返回ToolTip的相应div组件，可获取进行风格自定义",
    "isToolTipShowing": "isToolTipShowing()函数判断当前ToolTip是否正在显示状态，返回true|false",
    "hideToolTip": "hideToolTip()函数隐藏正在显示的ToolTip",
    "showToolTip": "showToolTip(eventOrPoint, innerHTML)显示ToolTip，第一个参数可为交互事件或指定坐标点，第二个参数为文字内容",
    "startDragging": "启动拖拽函数startDragging(interactor, e)",
    "getImageMap": "getImageMap()返回所有注册的图片信息对象",
    "toBoundaries": "toBoundaries(points, segments, resolution)将不连续曲线转化成Graph3dView#setBoundaries(bs)设置边界需要的参数格式",
    "getCurrentKeyCodeMap": "getCurrentKeyCodeMap()函数返回当前键盘按键信息，key为键的keyCode，如果按下则值为true",
    "drawCenterImage": "drawCenterImage(g, img, x, y, data, view, color)在指定的x,y为中心位置绘制img图片",
    "drawStretchImage": "drawStretchImage(g, img, stretch, x, y, w, h, data, view, color)在矩形位置内绘制图片，stretch参数可为uniform/centerUniform/fill",
    "toCanvas": "toCanvas(image, width, height, stretch, data, view, color)将图标转换成Canvas组件，image可为注册的图片或矢量",
    "createGradientImage": "[[[function (p,F,l,m){for(var C=[\"L\",0,0,p,0,1,0,0,1,0,0],f=0,$=Math.min(F.length,l.length);$>f;f++)C.push(l[f],F[f]);\r\nvar c=z.Default.toCanvas({width:p,height:p,clampToEdge:!0,comps:[{type:\"shape\",rotation:m||0,points:[0,0,p,0,p,p,0,p],background:\"#ffffff\",gradientPack:C}]});return c}]]]",
    "createElement": "createElement(tagName, borderColor, font, value)创建html元素",
    "containedInView": "containedInView(event, view)判断交互事件所处位置是否在指定View组件之上，一般用于Drog And Drop的拖拽操作判断",
    "isIsolating": "isIsolating()判断目前系统是否处于隔离状态，处于隔离状态时host吸附和Group组等图元间的联动关系将会被停止",
    "setIsolating": "setIsolating(true)指定目前系统是否处于隔离状态，处于隔离状态时host吸附和Group组等图元间的联动关系将会被停止",
    "stringify": "stringify(json, space)格式化 JSON 对象",
    "parse": "parse(str)还原 JSON 字符串",
    "loadJS": "loadJS(urls, cb)批量加载 js 文件",
    "toRoundedCorner": "[[[function (F,M){var q=F.size();if(0>=M)return{points:F};var h,T=new ag,J=new ag,o=F.get(0);T.add(o),J.add(1);for(var f=1;q>f;f++)if(q>f+1){var g=F.get(f),e=F.get(f+1),n=o.x,v=o.y,j=g.x,u=g.y,i=u-v,z=j-n,E=c(i,z);h=R(.99*uh(o,g),M),T.add({x:j-h*s(E),y:u-h*L(E)}),T.add(g),n=g.x,v=g.y,j=e.x,u=e.y,i=u-v,z=j-n,E=c(i,z),h=R(.99*uh(g,e),M),o={x:n+h*s(E),y:v+h*L(E)},T.add(o),J.addAll([2,3])}else T.add(F.get(f)),J.add(2);return{points:T,segments:J}}]]]",
    "toColorData": "toColorData(color)传入字符串的color值，返回[r,g,b,a]四个颜色数组信息",
    "setCanvas": "setCanvas(c, w, h, ratio)设置 Canvas 宽高",
    "createDiv": "createDiv(hidden, parent)创建 Div 元素",
    "createDisabledDiv": "createDisabledDiv(iconURL)创建遮罩 Div 元素",
    "createView": "createView(hidden, context)创建 View 对应的 Div",
    "createCanvas": "createCanvas(parent, respondEvents)创建 Canvas 元素",
    "appendChild": "appendChild(parent, child, absolute)追加孩子节点",
    "initContext": "initContext(canvas)初始化 Canvas 画笔",
    "translateAndScale": "translateAndScale(g, x, y, z)设置便宜和缩放",
    "layout": "layout(view, x, y, width, height)布局组件",
    "drawPoints": "drawPoints(g, points, segments, closePath)绘制线条",
    "drawRoundRect": "drawRoundRect(g, x, y, width, height, topLeftRadius, topRightRadius, bottomLeftRadius, bottomRightRadius)绘制圆角矩形",
    "drawBorder": "drawBorder(g, color, x, y, width, height, w)绘制矩形边框",
    "setFocus": "setFocus(e)设置元素获取焦点",
    "isEmptyObject": "isEmptyObject(obj)判断对象是否为空对象",
    "toolTipLabelColor": "#000，ToolTip的文字颜色",
    "toolTipLabelFont": "12px arial, sans-serif，ToolTip的文字字体",
    "toolTipBackground": "#FFFFE0，ToolTip的背景颜色",
    "toolTipShadowColor": "rgba(0,0,0,0.35)，ToolTip的阴影颜色",