61 lines
2.2 KiB
Markdown
61 lines
2.2 KiB
Markdown
# 控件ID
|
||
在控件描述文件中，我们可以使用“id“属性能设置控件的id， 这个id会设置到控件对应的dom元素上
|
||
|
||
## 控件ID的作用
|
||
像DOM体系，bricks使用控件ID用🐟标识控件，不一定要求唯一，但在使用时通常只会使用找到的一个控件
|
||
|
||
bricks的事件处理依赖控件id来确认事件的发起控件， 事件的目标控件以及事件的数据来源控件
|
||
|
||
## 控件查找开始位置
|
||
从binds区域所在的控件开始查找，对于"."号分割的id，首先从当前位置查找到第一段id的控件，再用上一个找到的控件作为下一段id的开始位置，直到最后一段，并将最后一段找到的控件作为最终控件返回。如果任何一个位置的id没找到对应的控件，返回空。
|
||
|
||
## 控件ID书写规则
|
||
|
||
bricks事件处理中的控件ID， 通过“."号开分段，标识要分段查找相应的控件。
|
||
|
||
## 控件查找方向
|
||
"-"号开始的id从当前位置向上查找控件
|
||
否则从当前位置向下查找
|
||
|
||
## 预定于的id
|
||
预定义的id通常放在"."分割的第一段，用来改变控件查找的开始位置
|
||
|
||
### app
|
||
"app“ bricks.App属性，也是Body控件，对应于html的<body>元素
|
||
|
||
### root
|
||
bricks前端应用只放一个控件在bricks.Body中，所有其他的控件都放在这个root控件之下， "root"ID用于查找这个控件
|
||
|
||
### self
|
||
binds区域所在的控件
|
||
|
||
## binds区域中和控件ID有关的属性
|
||
|
||
|
||
### wid
|
||
字符串属性，定义事件发起方的id， 缺省为"self"
|
||
|
||
### target
|
||
定义事件处理的控件， 下面对不同的事件处理方式分别说明
|
||
|
||
#### urlwidget
|
||
target控件是此事件生成的子控件的父控件，需要是个容器控件
|
||
参看[控件表述文件](descjson.md)
|
||
|
||
#### method
|
||
事件的method方法的控件。
|
||
|
||
#### script
|
||
script脚本可用this变量来使用target对应的控件
|
||
|
||
#### registerfunction
|
||
注册函数可以使用this变量来使用target对应的控件
|
||
|
||
#### event
|
||
定义触发事件的控件实体
|
||
|
||
### datawidget
|
||
定义事件的参数来源对象，如果找到此控件，则通过该控件的datamethod（如果定义）方法来获取参数，或者通过datascript脚本来获取参数
|
||
获得的参数将会添加到binds事件处理定义中说明的参数中
|
||
|