HT for Web

Namespace: Default

ht. Default

工具对象，包含HT默认的配置参数和一些工具函数
不要直接修改这个对象的属性值，如果需要改变HT的默认配置，需要通过全局的htconfig变量名指定，HT系统只在初始化时读取htconfig的配置信息， 因此htconfig必须在引入ht.js包之前初始化好，运行状态时修改htconfig变量不会再起作用，示例代码如下：

Example

<script>
  htconfig = {
      Color: {
          label: '#000',
          highlight: '#1ABC9C',
      },
      Default: {
          toolTipDelay: 100,
          toolTipContinual: true
      }
  };
</script>
<script src="ht.js"></script>

Members

<static> accordionViewCollapseIcon :String

折叠组件关闭状态图标

Type:
  • String

<static> accordionViewExpandIcon :String

折叠组件展开状态图标

Type:
  • String

<static> accordionViewLabelColor :color

折叠组件文字颜色

Type:
  • color
Default Value:
  • #FFF

<static> accordionViewLabelFont :String

折叠组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> accordionViewSelectBackground :color

折叠组件选中背景

Type:
  • color
Default Value:
  • #1ABC9C

<static> accordionViewSelectWidth :Number

折叠组件选中宽度

Type:
  • Number
Default Value:
  • 3

<static> accordionViewSeparatorColor :color

折叠组件分隔条颜色

Type:
  • color

<static> accordionViewTitleBackground :color

折叠组件抬头背景

Type:
  • color
Default Value:
  • #2C3E50

<static> animEasing :function

默认动画效果函数

Type:
  • function
Default Value:
  • function (m){return m*m}

<static> autoHideScrollBar :boolean

决定组件的滚动条默认是否自动隐藏，true为自动显示和隐藏，false则需要滚动时一直显示不会自动隐藏

Type:
  • boolean
Default Value:
  • true

<static> autoMakeVisible :boolean

决定Data元素被选中时，组件是否自动滚动到Data元素可见位置

Type:
  • boolean
Default Value:
  • true

<static> baseZIndex :Number

指定组件基准CSS的ZIndex值，改值仅在将HT与其他第三方组件混合使用时根据需要设置"

Type:
  • Number

<static> compStack :Array

矢量组件comp嵌套堆栈，矢量组件comp可嵌套定义，通过改参数能得到当前嵌套层次信息

Type:
  • Array

<static> dashPattern :Array

连线或多边形等图形的默认虚线样式

Type:
  • Array

<static> devicePixelRatio :Number

设备像素比，HT系统自动取至window.devicePixelRatio，某些特性情况需要为mobile应用牺牲精度节省内存时可以强制设置为较小值

Type:
  • Number

<static> disabledBackground :color

组件无效时的背景色

Type:
  • color

<static> disabledOpacity :Number

组件无效时的透明度

Type:
  • Number

<static> edgeGroupAgentFunc :function

此函数返回连线组的代理连线，edges为ht.List类型的ht.Edge对象数组，默认返回edges.get(0)，可重载自定义规则

Type:
  • function

<static> graph3dViewAttributes :Object

Graph3dView组件初始化WebGL上下文参数，一般无需改动

Type:
  • Object
Default Value:
  • null

<static> graph3dViewAxisXColor :color

Graph3dView组件显示x轴线颜色

Type:
  • color
Default Value:
  • [1,0,0,1]

<static> graph3dViewAxisYColor :color

Graph3dView组件显示y轴线颜色

Type:
  • color
Default Value:
  • [0,1,0,1]

<static> graph3dViewAxisZColor :color

Graph3dView组件显示z轴线颜色

Type:
  • color
Default Value:
  • [0,0,1,1]

<static> graph3dViewCenter :Array

Graph3dView组件投影呈现时，眼睛最终锁定的目标中心位置

Type:
  • Array
Default Value:
  • [0,0,0]

<static> graph3dViewCenterAxisVisible :Boolean

Graph3dView组件屏幕中心点x|y|z三个轴线是否可见

Type:
  • Boolean
Default Value:
  • false

<static> graph3dViewEditSizeColor :color

Graph3dView组件在编辑状态图元拉伸标识颜色

Type:
  • color
Default Value:
  • [1,1,0,1]

<static> graph3dViewEye :Array

Graph3dView组件投影呈现时，眼睛观察点所在位置

Type:
  • Array
Default Value:
  • [0,300,1000]

<static> graph3dViewFar :Number

Graph3dView组件投影呈现内容的最远距离，该值可根据场景最远范围进行调节设置

Type:
  • Number
Default Value:
  • 10000

<static> graph3dViewFirstPersonMode :Boolean

Graph3dView组件是否为第一人称交互方式

Type:
  • Boolean
Default Value:
  • false

<static> graph3dViewFogColor :color

雾颜色

Type:
  • color
Default Value:
  • white

<static> graph3dViewFogDisabled :Boolean

是否关闭雾化效果

Type:
  • Boolean
Default Value:
  • true

<static> graph3dViewFogFar :Number

代表从该距离之后物体完全看不清

Type:
  • Number
Default Value:
  • 2000

<static> graph3dViewFogNear :Number

代表从该距离起物体开始受雾效果影响

Type:
  • Number
Default Value:
  • 1

<static> graph3dViewFovy :Number

Graph3dView组件在透视投影方式下的y轴张角弧度（Field of view）

Type:
  • Number
Default Value:
  • 0.7853981633974483

<static> graph3dViewGridColor :color

Graph3dView组件显示xz面的网格线颜色

Type:
  • color
Default Value:
  • [0.4,0.75,0.85,1]

<static> graph3dViewGridGap :Number

Graph3dView组件显示xz面的网格行列间距

Type:
  • Number
Default Value:
  • 50

<static> graph3dViewGridSize :Number

Graph3dView组件显示xz面的网格行列数

Type:
  • Number
Default Value:
  • 50

<static> graph3dViewGridVisible :Boolean

Graph3dView组件是否允许显示xz面网格

Type:
  • Boolean
Default Value:
  • false

<static> graph3dViewHeadlightColor :Array

头灯颜色

Type:
  • Array
Default Value:
  • [1,1,1,1]

<static> graph3dViewHeadlightDisabled :Boolean

是否关闭头灯效果

Type:
  • Boolean
Default Value:
  • false

<static> graph3dViewHeadlightIntensity :Number

头灯强度，默认为1，大于1增强，小于1减弱

Type:
  • Number
Default Value:
  • 1

<static> graph3dViewHeadlightRange :Number

头灯影响范围，默认为0代表可照射到无穷远处，如果设置了值则光照射效果随物体远离光影而衰减

Type:
  • Number
Default Value:
  • 0

<static> graph3dViewHeadlightRange :Number

头灯影响范围，默认为0代表可照射到无穷远处，如果设置了值则光照射效果随物体远离光影而衰减

Type:
  • Number
Default Value:
  • 0

<static> graph3dViewMouseRoamable :Boolean

Graph3dView组件在第一人称交互方式时，鼠标是否能漫游

Type:
  • Boolean
Default Value:
  • true

<static> graph3dViewMoveStep :Number

Graph3dView组件键盘控制移动的步进

Type:
  • Number
Default Value:
  • 15

<static> graph3dViewNear :Number

Graph3dView组件投影呈现内容的最近距离，该值在可接受的范围内尽量设置较大值有利于呈现精度

Type:
  • Number
Default Value:
  • 10

<static> graph3dViewOriginAxisVisible :Boolean

Graph3dView组件原点x|y|z三个轴线是否可见

Type:
  • Boolean
Default Value:
  • false

<static> graph3dViewOrtho :Boolean

Graph3dView组件是否显示为正交投影方式

Type:
  • Boolean
Default Value:
  • false

<static> graph3dViewOrthoWidth :Number

Graph3dView组件正交投影方式下屏幕宽度内显示的逻辑宽度值

Type:
  • Number
Default Value:
  • 2000

<static> graph3dViewPannable :Boolean

Graph3dView组件是否允许按Shift键进行手抓图平移

Type:
  • Boolean
Default Value:
  • true

<static> graph3dViewRectSelectable :Boolean

Graph3dView组件是否允许框选

Type:
  • Boolean
Default Value:
  • true

<static> graph3dViewRectSelectBackground :color

Graph3dView组件框选背景

Type:
  • color
Default Value:
  • rgba(0,0,0,0.35)

<static> graph3dViewResettable :Boolean

Graph3dView组件是否允许按空格键复位，复位调用了Graph3dView#reset()函数，该函数会重置Graph3dView的eye|center|up三个参数

Type:
  • Boolean
Default Value:
  • true

<static> graph3dViewRotatable :Boolean

Graph3dView组件是否允许进行旋转中心或方位操作

Type:
  • Boolean
Default Value:
  • true

<static> graph3dViewRotateStep :Number

Graph3dView组件键盘控制旋转的步进

Type:
  • Number
Default Value:
  • 0.05235987755982988

<static> graph3dViewUp :Array

Graph3dView组件投影呈现时，摄像镜头垂直朝上方向

Type:
  • Array
Default Value:
  • [0,1,-1e-7]

<static> graph3dViewWalkable :Boolean

Graph3dView组件是否允许前进后退操作

Type:
  • Boolean
Default Value:
  • true

<static> graph3dViewZoomable :Boolean

Graph3dView组件是否允许缩放

Type:
  • Boolean
Default Value:
  • true

<static> graphViewAutoScrollZone :Number

GraphView组件中拖动图元到边缘时会自动滚动，该参数决定开始自动滚动的区域范围，设置为0或负数则代表关闭自动滚动功能

Type:
  • Number
Default Value:
  • 16

<static> graphViewEditPointBackground :color

GraphView组件编辑点背景颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> graphViewEditPointBorderColor :color

GraphView组件编辑点边框颜色

Type:
  • color
Default Value:
  • #2C3E50

<static> graphViewEditPointSize :Number

GraphView组件编辑点大小

Type:
  • Number
Default Value:
  • 7

<static> graphViewPannable :Boolean

决定GraphView组件是否允许手抓图操作

Type:
  • Boolean
Default Value:
  • true

<static> graphViewRectSelectable :Boolean

决定GraphView组件是否允许按Ctrl键进行框选操作

Type:
  • Boolean
Default Value:
  • true

<static> graphViewRectSelectBackground :color

GraphView组件框选背景颜色

Type:
  • color
Default Value:
  • rgba(0,0,0,0.35)

<static> graphViewRectSelectBorderColor :color

GraphView组件框选边框颜色

Type:
  • color
Default Value:
  • #2C3E50

<static> graphViewResettable :Boolean

决定GraphView组件按空格键是否允许复位，复位调用了GraphView#reset()函数，该函数默认会调用setZoom(1)和setTranslate(0, 0)

Type:
  • Boolean
Default Value:
  • true

<static> graphViewScrollBarVisible :Boolean

决定GraphView组件是否显示滚动条

Type:
  • Boolean
Default Value:
  • true

<static> handleImageLoaded :function

图片在加载之后的回调函数

Type:
  • function
Example
ht.Default.handleImageLoaded = function(name, img) {

}

<static> handleUnfoundImage :function

无法加载图片资源时会调用该函数，默认访问空，可自定义返回一个默认的图片

Type:
  • function
Example
ht.Default.handleImageLoaded = function(name, url) {

}

<static> hitMaxArea :Number

进行框选判断时为了避免内存占用过大，HT会根据最大面积限制进行缩放判断，该参数一般无需改动

Type:
  • Number
Default Value:
  • 3000

<static> imageGradient :String

默认图片的渐进色类型

Type:
  • String
Default Value:
  • linear.northeast

<static> isTouchable :boolean

判断是否为触屏可Touch方式交互，HT系统一般会自动判断，对于极少数HT无法正确识别的系统下，可以通过配置强制指定

Type:
  • boolean

<static> labelColor :color

默认文字颜色

Type:
  • color
Default Value:
  • #000

<static> labelFont :font

默认文字字体

Type:
  • font
Default Value:
  • 12px arial, sans-serif

<static> labelFont :font

默认文字字体

Type:
  • font
Default Value:
  • 12px arial, sans-serif

<static> labelSelectColor :color

选中状态下文字颜色

Type:
  • color
Default Value:
  • #fff

<static> lineCap :String

线条末端线帽的样式，可选值为butt|round|square

Type:
  • String
Default Value:
  • butt

<static> lineJoin :String

当两条线交汇时创建边角的类型，可选参数为：bevel|round|miter

Type:
  • String
Default Value:
  • round

<static> listViewLabelColor :color

列表组件文字颜色

Type:
  • color
Default Value:
  • #000

<static> listViewLabelFont :String

列表组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> listViewLabelSelectColor :color

列表组件文字选中颜色

Type:
  • color
Default Value:
  • #FFF

<static> listViewRowLineColor :color

列表组件行线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> listViewRowLineVisible :Boolean

列表组件行线是否可见

Type:
  • Boolean
Default Value:
  • false

<static> listViewSelectBackground :color

列表组件选中背景色

Type:
  • color
Default Value:
  • #1ABC9C

<static> numberListener :function

数字类型监听器，该监听器将使得input文本输入框只允许输入数学相关字符

Type:
  • function
Example
numberListener: (function(){
     var map = {
         46: 1,
         8: 1,
         9: 1,
         27: 1,
         13: 1,
         109: 1,
         110: 1,
         189: 1,
         190: 1
     };
     return function(e){
         var keyCode = e.keyCode;
         if(map[keyCode] || (keyCode === 65 && Default.isCtrlDown(e)) || (keyCode >= 35 && keyCode <= 39)){
             return;
         }
         if ((e.shiftKey || (keyCode < 48 || keyCode > 57)) && (keyCode < 96 || keyCode > 105)) {
             e.preventDefault();
         }
     };
 })()

<static> pinchZoomIncrement :Number

默认双指触屏Touch方式缩放步进

Type:
  • Number
Default Value:
  • 1.08

<static> propertyViewBackground :color

属性组件背景

Type:
  • color
Default Value:
  • #ECF0F1

<static> propertyViewCollapseIcon :String

属性组件合并图标

Type:
  • String

<static> propertyViewColumnLineColor :color

属性组件列线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> propertyViewColumnLineVisible :Boolean

属性组件列线是否可见

Type:
  • Boolean
Default Value:
  • true

<static> propertyViewExpandIcon :String

属性组件展开图标

Type:
  • String

<static> propertyViewLabelColor :color

属性组件文字颜色

Type:
  • color
Default Value:
  • #000

<static> propertyViewLabelFont :String

属性组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> propertyViewLabelSelectColor :color

属性组件文字选中颜色

Type:
  • color
Default Value:
  • #FFF

<static> propertyViewRowLineColor :color

属性组件行线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> propertyViewRowLineVisible :Boolean

属性组件行线是否可见

Type:
  • Boolean
Default Value:
  • true

<static> propertyViewSelectBackground :color

属性组件选中背景色

Type:
  • color
Default Value:
  • #1ABC9C

<static> reinvalidateCount :Number

组件初次加载时界面宽高值可能会为0，HT会自动尝试等待下次延迟刷新，该参数指定尝试次数，一般无需改动

Type:
  • Number
Default Value:
  • 3

<static> scrollBarColor :color

滚动条默认颜色

Type:
  • color
Default Value:
  • rgba(0,0,0,0.35)

<static> scrollBarInteractiveSize :Number

滚动条起作用区域默认大小

Type:
  • Number
Default Value:
  • 16

<static> scrollBarMinLength :Number

滚动条默认最小长度

Type:
  • Number
Default Value:
  • 20

<static> scrollBarSize :Number

滚动条默认宽度

Type:
  • Number
Default Value:
  • 7

<static> scrollBarTimeout :Number

滚动条默认的隐藏间隔毫秒数

Type:
  • Number
Default Value:
  • 1000

<static> scrollZoomIncrement :Number

默认滚轮缩放步进

Type:
  • Number
Default Value:
  • 1.05

<static> segmentResolution :Number

默认曲线分段微分数

Type:
  • Number
Default Value:
  • 12

<static> shapeResolution :Number

默认模型分段微分数

Type:
  • Number
Default Value:
  • 24

<static> shapeSide :Number

默认模型边数

Type:
  • Number
Default Value:
  • 24

<static> sortFunc :function

默认排序函数

Type:
  • function
Example
ht.Default.sortFunc = function(v1, v2) {

}

<static> splitViewDividerBackground :color

分割组件分隔条背景

Type:
  • color
Default Value:
  • #2C3E50

<static> splitViewDividerSize :Number

分割组件分隔条宽度

Type:
  • Number
Default Value:
  • 1

<static> splitViewDragOpacity :Number

分割组件分隔条拖拽过程透明度

Type:
  • Number
Default Value:
  • 0.5

<static> splitViewToggleIcon :String

分割组件展开合并图标

Type:
  • String

<static> tableHeaderBackground :color

表头组件背景

Type:
  • color
Default Value:
  • #ECF0F1

<static> tableHeaderColumnLineColor :color

表头组件列线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> tableHeaderColumnLineVisible :Boolean

表头组件列线是否可见

Type:
  • Boolean
Default Value:
  • true

<static> tableHeaderInsertColor :color

表头组件插入状态颜色

Type:
  • color
Default Value:
  • #1ABC9C

<static> tableHeaderLabelColor :color

表头组件文字颜色

Type:
  • color
Default Value:
  • #000

<static> tableHeaderLabelFont :String

表头组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> tableHeaderMoveBackground :color

表头组件移动状态背景

Type:
  • color
Default Value:
  • rgba(0,0,0,0.35)

<static> tableHeaderSortAscIcon :String

表头组件升序图标

Type:
  • String

<static> tableHeaderSortDescIcon :String

表头组件降序图标

Type:
  • String

<static> tableViewColumnLineColor :color

表格组件列线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> tableViewColumnLineVisible :Boolean

表格组件列线是否可见

Type:
  • Boolean
Default Value:
  • true

<static> tableViewLabelColor :color

表格组件文字颜色

Type:
  • color
Default Value:
  • #000

<static> tableViewLabelFont :String

表格组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> tableViewLabelSelectColor :color

表格组件文字选中颜色

Type:
  • color
Default Value:
  • #FFF

<static> tableViewRowLineColor :color

表格组件行线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> tableViewRowLineVisible :Boolean

表格组件行线是否可见

Type:
  • Boolean
Default Value:
  • true

<static> tableViewSelectBackground :color

表格组件选中背景色

Type:
  • color
Default Value:
  • #1ABC9C

<static> tabViewInsertColor :color

页签组件插入状态颜色

Type:
  • color
Default Value:
  • #1ABC9C

<static> tabViewLabelColor :color

页签组件文字颜色

Type:
  • color
Default Value:
  • #FFF

<static> tabViewLabelFont :String

页签组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> tabViewMoveBackground :color

页签组件移动状态背景

Type:
  • color
Default Value:
  • rgba(0,0,0,0.35)

<static> tabViewSelectBackground :color

页签组件选中背景

Type:
  • color
Default Value:
  • #1ABC9C

<static> tabViewSelectWidth :Number

页签组件选中宽度

Type:
  • Number
Default Value:
  • 3

<static> tabViewTabBackground :color

页签组件背景

Type:
  • color
Default Value:
  • #2C3E50

<static> tabViewTabGap :Number

页签组件间距

Type:
  • Number
Default Value:
  • 1

<static> toolbarBackground :color

工具条组件背景

Type:
  • color
Default Value:
  • #ECF0F1

<static> toolbarItemGap :Number

工具条组件Item的间距

Type:
  • Number
Default Value:
  • 8

<static> toolbarLabelColor :color

工具条组件文字颜色

Type:
  • color
Default Value:
  • #000

<static> toolbarLabelFont :String

工具条组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> toolbarLabelSelectColor :color

工具条组件文字选中颜色

Type:
  • color
Default Value:
  • #FFF

<static> toolbarSelectBackground :color

工具条组件选中背景色

Type:
  • color
Default Value:
  • #1ABC9C

<static> toolbarSeparatorColor :color

工具条组件的分隔条颜色

Type:
  • color
Default Value:
  • #868686

<static> toolTipBackground :color

ToolTip的背景颜色

Type:
  • color
Default Value:
  • #FFFFE0

<static> toolTipContinual :boolean

组件的ToolTip显示的情况下，如果鼠标移动到新的位置时，ToolTip是否实时持续跟进

Type:
  • boolean
Default Value:
  • false

<static> toolTipDelay :Number

组件的ToolTip显示的延迟间隔

Type:
  • Number
Default Value:
  • 800

<static> toolTipLabelColor :color

ToolTip的文字颜色

Type:
  • color
Default Value:
  • #000

<static> toolTipLabelFont :String

ToolTip的文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> toolTipLabelFont :String

ToolTip的文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> toolTipShadowColor :color

ToolTip的阴影颜色

Type:
  • color
Default Value:
  • rgba(0,0,0,0.35)

<static> treeTableViewCollapseIcon :String

树表格组件关闭状态图标

Type:
  • String

<static> treeTableViewColumnLineColor :color

树表格组件列线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> treeTableViewColumnLineVisible :Boolean

树表格组件列线是否可见

Type:
  • Boolean
Default Value:
  • true

<static> treeTableViewExpandIcon :String

树表格组件展开状态图标

Type:
  • String

<static> treeTableViewLabelColor :color

树表组件文字颜色

Type:
  • color
Default Value:
  • #000

<static> treeTableViewLabelFont :String

树表组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> treeTableViewLabelSelectColor :color

树表组件文字选中颜色

Type:
  • color
Default Value:
  • #FFF

<static> treeTableViewRowLineColor :color

树表格组件行线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> treeTableViewRowLineVisible :Boolean

树表格组件行线是否可见

Type:
  • Boolean
Default Value:
  • true

<static> treeTableViewSelectBackground :color

树表组件选中背景色

Type:
  • color
Default Value:
  • #1ABC9C

<static> treeViewCollapseIcon :String

树组件关闭状态图标

Type:
  • String

<static> treeViewExpandIcon :String

树组件展开状态图标

Type:
  • String

<static> treeViewLabelColor :color

树组件文字颜色

Type:
  • color
Default Value:
  • #000

<static> treeViewLabelFont :String

树组件文字字体

Type:
  • String
Default Value:
  • 12px arial, sans-serif

<static> treeViewLabelSelectColor :color

树组件文字选中颜色

Type:
  • color
Default Value:
  • #FFF

<static> treeViewRowLineColor :color

树组件行线颜色

Type:
  • color
Default Value:
  • #D9D9D9

<static> treeViewRowLineVisible :Boolean

树组件行线是否可见

Type:
  • Boolean
Default Value:
  • false

<static> treeViewSelectBackground :color

树组件选中背景色

Type:
  • color
Default Value:
  • #1ABC9C

<static> widgetHeaderHeight :Number

通用组件抬头高度，例如TabView，TableHeader和Toolbar等的头部高度

Type:
  • Number
Default Value:
  • 22

<static> widgetIndent :Number

通用组件缩进，例如树组件每一层的缩进

Type:
  • Number
Default Value:
  • 20

<static> widgetRowHeight :Number

通用组件行高，例如表格每行行高

Type:
  • Number
Default Value:
  • 20

<static> widgetTitleHeight :Number

AccordionView和TabView等组件的Title默认高度

Type:
  • Number
Default Value:
  • 24

<static> zoomIncrement :Number

默认缩放步进

Type:
  • Number
Default Value:
  • 1.3

<static> zoomMax :Number

默认最大缩放倍数

Type:
  • Number
Default Value:
  • 20

<static> zoomMin :Number

默认最小缩放倍数

Type:
  • Number
Default Value:
  • 0.01

Methods

<static> brighter(color, factor) → {color}

返回比color更亮的颜色

Parameters:
Name Type Description
color color

原始颜色
factor Number

变化因子，默认为40，允许值0~100
Returns:

新的颜色

Type
color
Example
var newColor = ht.Default.brighter('#f00');

<static> callLater(func, scope, args, delay)

获取全局下一个id编号

Parameters:
Name Type Description
func function

回调函数
scope Object

函数域
args Array

函数参数列表
delay Number

延迟时间(毫秒)

<static> clone(obj) → {Object}

传入一个对象参数，以浅拷贝的方式返回一个新的复制对象

Parameters:
Name Type Description
obj Object

要复制的对象
Returns:

新复制的对象

Type
Object

<static> containedInView(event, view) → {Boolean}

判断交互事件所处位置是否在View组件之上，一般用于Drog And Drop的拖拽操作判断

Parameters:
Name Type Description
event Event

事件对象
view Object

视图对象
Returns:
Type
Boolean

<static> containsPoint(rect, point) → {Boolean}

判断point是否包含在rect的矩形区域里

Parameters:
Name Type Description
rect Object

矩形
point Object

点
Returns:

矩形是否包含点

Type
Boolean
Example
 ht.Default.containsPoint({x: 0, y: 0, width: 100, height: 100}, {x: 50, y: 50})//true

<static> containsRect(rect1, rect2) → {Boolean}

判断矩形区域rect1是否包含矩形区域rect2

Parameters:
Name Type Description
rect1 Object

矩形1
rect2 Object

矩形2
Returns:

矩形1是否包含矩形2

Type
Boolean
Example
 ht.Default.containsRect({x: 0, y: 0, width: 100, height: 100}, {x: 0, y: 0, width: 10, height: 10})//true

<static> createBoxModel()

构建六面体模型，该模型的六个面显示的颜色和贴图都将一样

<static> createConeModel()

构建圆锥体模型

<static> createCylinderModel()

构建圆柱体模型

<static> createElement(tagName, borderColor, font, value) → {Element}

创建DOM对象

Parameters:
Name Type Description
tagName String

DOM类型(如div、a、span等)
borderColor String

边框颜色
font String

字体
value String

内容
Returns:

DOM对象

Type
Element

<static> createExtrusionModel()

根据xz平面多边形，挤压形成3D模型

<static> createMatrix()

将一组JSON描述的缩放、移动和旋转等操作转换成对应的变化矩阵

<static> createParallelogramModel()

构建平行四边形体模型

<static> createRectModel()

构建矩形体模型

<static> createRightTriangleModel()

构建直角三角形体模型

<static> createRingModel()

根据xy平面的曲线，环绕一周形成3D模型

<static> createRoundRectModel()

构建圆角矩形体模型

<static> createSmoothConeModel()

构建光滑圆锥体模型

<static> createSmoothCylinderModel()

构建光滑圆柱体模型

<static> createSmoothRingModel()

根据xy平面的曲线，环绕一周形成光滑3D模型

<static> createSmoothSphereModel()

构建光滑球体模型

<static> createSmoothTorusModel()

构建光滑圆环体模型

<static> createSphereModel()

构建球体模型

<static> createStarModel()

构建星形体模型

<static> createTorusModel()

构建圆环体模型

<static> createTrapezoidModel()

构建梯形体模型

<static> createTriangleModel()

构建三角形体模型

<static> darker(color, factor) → {color}

返回比color更暗的颜色

Parameters:
Name Type Description
color color

原始颜色
factor Number

变化因子，默认为40，允许值0~100
Returns:

新的颜色

Type
color
Example
var newColor = ht.Default.darker('#f00');

<static> def(className, superClass, methods)

定义类

Parameters:
Name Type Description
className String | Object

类名，如果为字符串，自动注册到HT的classMap中，一般使用函数(构造函数)即可
superClass Object

要继承的父类
methods Object

方法和变量声明
Example
function MyData() {
	MyData.superClass.constructor.call(this);
}
ht.Default.def(MyData, ht.Data, {
	sayHello: function() {
		console.log('hello');
	}
});

<static> drawCenterImage(g, img, x, y, data, view, color)

以x,y为中心绘制img图片

Parameters:
Name Type Description
g CanvasRenderingContext2D

画笔对象
img HTMLImageElement | HTMLCanvasElement | Object

要绘制的图片(img对象、canvas对象或矢量对象)
x Number

中心点x坐标
y Number

中心点y坐标
data ht.Data

要绑定的Data对象
view Object

要绑定的视图对象
color color

染色

<static> drawImage(g, image, x, y, width, height, data, view, blendColor)

绘制图片

Parameters:
Name Type Description
g CanvasRenderingContext2D

画笔对象
image HTMLImageElement | HTMLCanvasElement | Object

要绘制的图片(img对象、canvas对象或矢量对象)
x Number

绘制范围左上角x坐标
y Number

绘制范围左上角y坐标
width Number

绘制范围宽度
height Number

绘制范围高度
data ht.Data

要绑定的Data对象
view Object

要绑定的视图对象
blendColor color

染色

<static> drawStretchImage(g, img, stretch, x, y, w, h, data, view, color)

在矩形位置内绘制图片

Parameters:
Name Type Description
g CanvasRenderingContext2D

画笔对象
img HTMLImageElement | HTMLCanvasElement | Object

要绘制的图片(img对象、canvas对象或矢量对象)
stretch String

拉伸类型(uniform/centerUniform/fill)
x Number

矩形左上角x坐标
y Number

矩形左上角y坐标
w Number

矩形宽度
h Number

矩形高度
data ht.Data

要绑定的Data对象
view Object

要绑定的视图对象
color color

染色

<static> drawText(g, value, font, color, x, y, width, height, align, vAlign)

绘制文字

Parameters:
Name Type Description
g CanvasRenderingContext2D

画笔对象
value String

文字内容
font String

文字字体
color color

文字颜色
x Number

绘制开始的x坐标
y Number

绘制开始的y坐标
width Number

绘制的宽度
height Number

绘制的高度
align String

文字水平对齐方式，可选值为left|center|right
vAlign String

文字垂直对齐方式，可选值为top|middle|bottom
Example
 ht.Default.drawText(g, 'Hello, HT', '12px Arial', 0, 0, 200, 100, 'center', 'middle');

<static> getBatchInfo(name) → {Oject}

获取已注册的批量信息

Parameters:
Name Type Description
name String

批量名
Returns:

批量信息

Type
Oject

<static> getClass(name) → {function}

传入全路径类字符串名称，返回类定义(构造函数)

Parameters:
Name Type Description
name String

类名
Returns:

类定义(构造函数)

Type
function

<static> getClassMap() → {Object}

返回所有HT预定义类的json结构信息，key为类全路径名，value为类声明(构造函数)

Returns:

类结构信息

Type
Object

<static> getClientPoint(e) → {Object}

返回client属性坐标

Parameters:
Name Type Description
e Event

事件对象
Returns:

client坐标对象

Type
Object
Example
 //返回值示例:
{
   x: 100,
   y: 100
}

<static> getCompType(type)

获得注册的矢量组件类型

Parameters:
Name Type Description
type String

类型名称

<static> getCurrentComp() → {Object}

返回当前矢量组件comp，即ht.Default.compStack[0]，一般用于矢量值绑定func动态调用时使用

Returns:

矢量组件comp

Type
Object

<static> getCurrentKeyCodeMap() → {Object}

返回当前键盘按键信息，key为键的keyCode，如果按下则值为true

Returns:

键盘按键信息

Type
Object

<static> getDistance(p1, p2) → {Number}

获取两点之间距离，或向量长度

Parameters:
Name Type Description
p1 Object | Array

第一个点的坐标(格式：{x: x, y: y})或第一个向量(格式：[x, y, z])
p2 Object | Array

第二个点的坐标(格式：{x: x, y: y})或第二个向量(格式：[x, y, z])
Returns:

距离

Type
Number
Example
 //二维两点距离
var distance = ht.Default.getDistance({x: 0, y: 0}, {x: 10, y: 0});// distance equals 10
//三维两点距离
var distance3d = ht.Default.getDistance([0, 0, 0], [0, 10, 0]);// distance3d equals 10

<static> getEdgeType(type) → {function}

获取连线类型函数

Parameters:
Name Type Description
type String

连线类型名
Returns:

连线类型函数

Type
function

<static> getId() → {Number}

获取全局下一个id编号

Returns:

id

Type
Number

<static> getImage(name, color) → {HTMLImageElement|HTMLCanvasElement|Object}

获得已注册的图片

Parameters:
Name Type Argument Description
name String

图片名
color color <optional>

染色
Returns:

返回已经注册的图片

Type
HTMLImageElement | HTMLCanvasElement | Object

<static> getImageMap() → {Object}

获得所有注册图片的信息对象

Returns:

已注册图片的映射表

Type
Object

<static> getLogicalPoint(e, view, translateX, translateY, zoomX, zoomY) → {Object}

获取交互点的逻辑坐标，使用视图对象上的此方法更为便捷

Parameters:
Name Type Description
e Event

事件对象
view Object

视图对象
translateX Number

水平偏移
translateY Number

垂直偏移
zoomX Number

水平缩放
zoomY Number

垂直缩放
Returns:

逻辑点坐标

Type
Object

<static> getPagePoint(e) → {Object}

返回page属性坐标

Parameters:
Name Type Description
e Event

事件对象
Returns:

page坐标对象

Type
Object
Example
 //返回值示例:
{
   x: 100,
   y: 100
}

<static> getParentComp() → {Object}

返回当前矢量组件上一层comp，即ht.Default.compStack[1]，一般用于矢量值绑定func动态调用时使用

Returns:

矢量组件comp

Type
Object

<static> getShape3dModel(name) → {Object}

返回所注册的3D模型

Parameters:
Name Type Description
name String

模型名
Returns:

模型

Type
Object

<static> getTextSize(font, text) → {Object}

计算文字的尺寸

Parameters:
Name Type Description
font String

文字字体，如:12px Arial
text String

文字内容
Returns:

文字尺寸

Type
Object
Example
 //返回值示例:
{
	width: 100,
	height: 100
}

<static> getToolTipDiv() → {Element}

返回ToolTip的相应div对象，可获取进行风格自定义

Returns:

ToolTip相应的div对象

Type
Element

<static> getTouchCount(e) → {Number}

获取当前Touch手指个数

Parameters:
Name Type Description
e Event

事件对象
Returns:

Touch手指个数

Type
Number

<static> getVersion() → {String}

获得HT的版本号

Returns:

版本号

Type
String

<static> getWindowInfo()

获取当前窗口left|top|width|height的参数信息

返回的对象格式如下：

Example
 {
	left: 0,
	top: 0,
	width: 1280
	height: 768
}

<static> grow(rect, extend)

改变rect大小，上下左右分别扩展extend的大小

Parameters:
Name Type Description
rect Object

原始矩形
extend Number

扩展大小
Example
 var rect = {x: 0, y: 0, width: 100, height: 100};
ht.Default.grow(rect, 2)
//rect结果：
{
	x: -2,
	y: -2,
	width: 104,
	height: 104
}

<static> hideToolTip()

隐藏正在显示的ToolTip

<static> intersection(rect1, rect2) → {Object}

获得两个矩形的相交区域

Parameters:
Name Type Description
rect1 Object

矩形1
rect2 Object

矩形2
Returns:

相交的矩形区域，如果没有相交，返回null

Type
Object
Example
 var rect = ht.Default.intersection({x: 0, y: 0, width: 100, height: 100}, {x: 50, y: 50, width: 200, height: 200})
//rect结果：
{
	x: 50,
	y: 50,
	width: 50,
	height: 50
}

<static> intersectsRect(rect1, rect2) → {Boolean}

判断矩形区域rect1和矩形区域rect2是否相交

Parameters:
Name Type Description
rect1 Object

矩形1
rect2 Object

矩形2
Returns:

两个矩形是否相交

Type
Boolean
Example
 ht.Default.intersectsRect({x: 0, y: 0, width: 100, height: 100}, {x: 0, y: 0, width: 200, height: 200})//true

<static> isCtrlDown(e) → {boolean}

判断Ctrl键是否被按下

Parameters:
Name Type Description
e Event

事件对象
Returns:

Ctrl键是否被按下

Type
boolean

<static> isDoubleClick(e) → {boolean}

判断是否为双击事件

Parameters:
Name Type Description
e Event

事件对象
Returns:

是否是双击

Type
boolean

<static> isDragging() → {boolean}

判断目前是否处于拖拽状态

Returns:

是否处于拖拽状态

Type
boolean

<static> isIsolating() → {Boolean}

判断目前系统是否处于隔离状态，处于隔离状态时host吸附和Group组等图元间的联动关系将会被停止

Returns:

是否处于隔离状态

Type
Boolean

<static> isLeftButton(e) → {boolean}

判断是否鼠标左键被按下

Parameters:
Name Type Description
e Event

事件对象
Returns:

鼠标左键是否被按下

Type
boolean

<static> isShiftDown(e) → {boolean}

判断Shift键是否被按下

Parameters:
Name Type Description
e Event

事件对象
Returns:

Shift键是否被按下

Type
boolean

<static> isToolTipShowing() → {Boolean}

判断ToolTip是否正在显示状态

Returns:

ToolTip是否显示

Type
Boolean

<static> preventDefault(e)

阻止事件的默认行为，常用于屏蔽触屏上默认DoubleTap缩放等行为

Parameters:
Name Type Description
e Event

事件对象

<static> removeHTML(domElement) → {Boolean}

删除指定的DOM对象

Parameters:
Name Type Description
domElement Element

DOM对象
Returns:

操作是否成功

Type
Boolean

<static> setBatchInfo(name, batchInfo)

注册3d图元的批量信息，用于优化大数据量图元绘制性能，详细用法请参考批量手册

Parameters:
Name Type Description
name String

批量名
batchInfo Object

批量信息

<static> setCompType(type, func)

注册矢量组件类型

Parameters:
Name Type Description
type String

类型名称
func function

绘制函数，例：function(g, rect, comp, data, view){}

<static> setEdgeType(type, func)

注册连线类型

Parameters:
Name Type Description
type String

连线类型名
func function

决定连线走向的函数
Example
 ht.Default.setEdgeType('customEdge', function(edge, gap, graphView) {
         return {
         	points: points;
         	segments: segments;
         }
})

<static> setImage(name, width, height, img)

注册图片

Parameters:
Name Type Argument Description
name String

图片名
width Number <optional>

图片宽度
height Number <optional>

图片高度
img HTMLImageElement | HTMLCanvasElement | String | Object

img、canvas对象或图片url或base64字符串或矢量对象

<static> setIsolating(isolating)

设置系统的隔离状态，处于隔离状态时host吸附和Group组等图元间的联动关系将会被停止

Parameters:
Name Type Description
isolating Boolean

新的状态

<static> setShape3dModel(name, model)

注册3D模型，请参考modeling建模手册

Parameters:
Name Type Description
name String

模型名
model Object

模型内容

<static> showToolTip(eventOrPoint, innerHTML)

显示ToolTip

Parameters:
Name Type Description
eventOrPoint Event | Object

鼠标事件对象或点坐标
innerHTML String

ToolTip的内容

<static> startAnim(paramObj)

启动动画

Parameters:
Name Type Description
paramObj Object

动画配置对象，请参考入门手册中的动画属性
Example
ht.Default.startAnim({
	frames: 60,
	interval: 16,
	finishFunc: function() {
		console.log('finish');
	},
	action: function(t) {
		console.log(t);
	}
});

<static> startDragging(interactor, e)

启动拖拽，自定义交互时可能用到

Parameters:
Name Type Description
interactor Object

交互器
e Event

事件对象

<static> toBoundaries(points, segmets, resolution) → {Array}

将不连续曲线转化成Graph3dView#setBoundaries(bs)需要的参数格式

Parameters:
Name Type Description
points Array

曲线上的点坐标数组
segmets Array

曲线上的线段类型数组
resolution Number

曲线微分数
Returns:

适合Graph3dView#setBoundaries(bs)需要的参数格式

Type
Array

<static> toCanvas(image, width, height, stretch, data, view, color) → {HTMLCanvasElement}

将图片转换成Canvas对象

Parameters:
Name Type Description
image HTMLImageElement | Object

要转换的图片(img对象或矢量对象)
width Number

新canvas的宽度
height Number

新canvas的高度
stretch String

拉伸类型(uniform/centerUniform/fill)
data ht.Data

要绑定的Data对象
view Object

要绑定的视图对象
color color

染色
Returns:

canvas对象

Type
HTMLCanvasElement

<static> toColorData(color) → {Array}

将颜色转换为rgba格式

Parameters:
Name Type Description
color color

旧格式的颜色
Returns:

rgba格式的颜色

Type
Array

<static> transformVec()

将指定矢量或顶点，通过矩阵转换运算出变化后的新矢量或顶点位置

<static> unionPoint(p1, p2) → {Object}

将点组合成矩形

Parameters:
Name Type Description
p1 Object

第一个点或点数组
p2 Object

第二个点
Returns:

组合的矩形

Type
Object
Example
 //组合两点：
var rect = ht.Default.unionPoint({x: 0, y: 0}, {x: 100, y: 100});
//rect结果：
{
	x: 0,
	y: 0,
	width: 100,
	height: 100
}
组合多点：
var rect = ht.Default.unionPoint([{x: 0, y: 0}, {x: 50, y: 50}, {x: 100, y: 100}]);
//rect结果：
{
	x: 0,
	y: 0,
	width: 100,
	height: 100
}

<static> unionRect(rect1, rect2) → {Object}

将两个矩形区域union融合成新的矩形区域

Parameters:
Name Type Description
rect1 Object

第一个矩形区域
rect2 Object

第二个矩形区域
Returns:

新的矩形区域

Type
Object
Example
 var rect = ht.Default.unionRect(
{x: 0, y: 0, width: 100, height: 100},
{x: 0, y: 0, width: 200, height: 200});
//rect结果：
{
	x: 0,
	y: 0,
	width: 200,
	height: 200
}
欢迎交流 service@hightopo.com