From e581487005954da8c3af4b8f9609dc4163fd419d Mon Sep 17 00:00:00 2001 From: yumoqing Date: Sun, 12 Oct 2025 15:14:55 +0800 Subject: [PATCH] bugfix --- docs/cn/brief.md | 27 +++++++++++++++++++++++++-- docs/cn/event.md | 3 --- 2 files changed, 25 insertions(+), 5 deletions(-) diff --git a/docs/cn/brief.md b/docs/cn/brief.md index c53de77..fd3a587 100644 --- a/docs/cn/brief.md +++ b/docs/cn/brief.md @@ -17,7 +17,7 @@ * 事件以及事件处理 * 控件嵌套和页面组装 -###控件与控件继承 +### 控件与控件继承 bricks采用控件这一概念来描述web GUI的显示部件，每个控件均映射到一个html 的标签类型的一个javascript类。每个控件均可以实例化，并可在页面显示。 控件分为：基本控件，容器控件。 @@ -37,4 +37,27 @@ bricks采用控件这一概念来描述web GUI的显示部件，每个控件均 所以bricks控件的事件来源于两类，dom元素原生事件以及控件类中创造的事件。 两类事件处理方式相同。 -### +### 控件表达形式 +在服务器的后台，以json文件的形式表达控件，每个ui文件定义一个控件， +对于容器控件，可以在ui文件中的subwidgets子属性中为此控件添加子控件 + +#### id属性 +字符串属性，定义控件的id，让控件可以用getWidgetById找到，如果不给定，系统会自动生成一个id +#### options属性 +字典属性，创建控件时的选项，每个控件可接受的选项请参看控件选项说明 +#### binds属性 +数组属性，定义零到多个事件响应，每个bind字典需要遵守[事件](event.md)要求 +#### 容器控件特有属性 +##### subwidgets +数组属性，定义容器控件的子控件，每个元素定义一个子控件，子控件遵守控件的数据要素要求 + +## 开发 +使用存放在服务器后台的.ui后缀的json格式文件来开发，每个.ui文件定义一个控件， 支持基本控件和容器空间。 + +关于如何书写ui文件请参考[UI文件格式](descjson.md) + +## 调试 +ui文件可以直接调试，如在服务器根目录下的test目录下有一个hello.ui文件， +就可以在浏览器中用url：https://sername/test/hello.ui调试 + + diff --git a/docs/cn/event.md b/docs/cn/event.md index f09c14b..01872af 100644 --- a/docs/cn/event.md +++ b/docs/cn/event.md @@ -506,6 +506,3 @@ params：传递给事件的参数，处理函数可以使用evemt.params获得 ``` 上述例子中定义了Button的click事件使用script事件处理方式来处理，但是在处理前需要显示信息，让用户确认是否继续，如果用户放弃则不处理事件，确认后正常的处理事件。 - -## actions方法 -