@things-factory/board-ui 6.1.129 → 6.1.140

package/helps/board-modeller/data-spread.zh.md

@@ -1,65 +1,98 @@
-# Data Binding
+# 数据绑定
 
-[About Data Binding](./data-binding.md)
+[数据绑定简介](./data-binding.md)
 
-## Data Spread
+## 数据传播
 
-- 此设置根据源组件的数据值更改目标组件的属性。
-- 如果源组件更改了目标组件的数据属性，则目标组件的数据传播功能将连续运行，因此该功能称为数据传播。
-- 可以进行多种数据传播设置
+- 数据传播是基于源组件的数据值来更改目标组件的属性的配置。
+- 如果源组件更改了目标组件的数据属性，则目标组件的数据传播功能会持续工作，因此称为数据传播功能。
+- 可以进行多个数据传播配置。
 
 ### 复制、粘贴和删除
 
-- 由于与“数据传播”相关的重复设置可能很麻烦，因此提供了复制、粘贴和删除功能。
-- 复制粘贴：您可以复制一个组件的整个“数据传播”设置并将其粘贴到另一个组件的“数据传播”设置中。 请小心，因为粘贴会替换目标组件的所有“数据传播”设置。
-- 删除：仅删除组件“数据传播”设置中当前选项卡的设置。
+- 为了简化重复的数据传播配置，提供了复制、粘贴和删除功能。
+- 复制-粘贴：您可以复制一个组件的整个数据传播配置，并粘贴到另一个组件的数据传播配置中。请注意，粘贴会替换目标组件的所有数据传播配置，因此要小心。
+- 删除：它仅删除组件数据传播配置中当前选项卡的配置。
 
-### 源数据 (source)
+### 源数据（source）
 
-- 指定源组件后，它将将该组件的数据传播到目标组件。
-- 基于组件关系的目标指定
-  - (self)：组件本身
+- 当指定源组件时，它会将该组件的数据传播到目标组件（们）。
+- 基于组件关系的目标指定：
+  - (self)：组件本身。
 - 通过 ID 指定：#id
-- 如果未指定，它将传播组件本身的数据，与(self)相同。
+- 如果未指定，则将该组件本身的数据传播为(self)。
 
-### accessor
+### 访问器（accessor）
 
-- 它是根据源组件的数据值更改目标组件的属性的设置。
-- 设置方法遵循[JSONATA 文档](http://docs.jsonata.org/overview.html)。
+- 配置方法遵循[JSONATA 文档](http://docs.jsonata.org/overview.html)。
 
-### target
+### 目标（target）
 
-- 指定用于数据传播的目标组件。
-- 基于与组件本身的关系进行定位
-  - (self) : 组件本身
-- 由 ID 指定：#id
-- 指定为类：.class
-- 基于数据的目标指定 -（key）：以数据对象的键值为 id 的组件将成为目标组件。 -[property]：将数据对象的属性值作为 ID 的组件将成为目标组件。
+- 指定数据传播的目标组件（们）。
+- 基于组件关系的目标指定：
+  - (self)：组件本身。
+- 通过 ID 指定：#id
+- 通过类别指定：.class
+- 基于数据指定的目标：
+  - (key)：具有与数据对象的键值对应的 ID 的组件将成为目标组件。
+  - [property]：具有与数据对象属性值的 ID 对应的组件将成为目标组件。
+
+### 属性（property）
+
+- 指定传播的数据值将应用于目标组件的属性。
+- 如果将属性值设置为'(action)'，则它不适用于目标组件（们）的任何属性。'(action)'属性通常用于在数据传播时执行脚本操作。
+
+### 规则类型（rule）
+
+指定如何将传播的数据应用于目标组件的属性。
+
+- 值（value）
+  - 值本身直接设置为目标组件的属性。
+- 映射（map）
+  - 使用值作为键来查找映射值，然后将其设置为目标组件的属性。
+- 范围（range）
+  - 将值包含在范围内的映射值设置为目标组件的属性。
+- 函数（eval）
+  - Eval 代码可以使用 JavaScript 语法编写。
+  - Eval 代码的上下文（this）是源组件。
+  - Eval 代码具有参数：value 和 targets。
+    - value：具有源组件数据的访问器应用值。
+    - targets：目标组件列表。
+
+### 没有数据，就没有传播
+
+- 仅在基于规则
+
+### 部分传播
+
+部分传播是在操作对象、复制或修改其属性时非常有用的概念。
 
-### property
+例如，让我们考虑一个管理餐厅菜单项的组件。每个组件都包含以下信息的'data'对象：
 
-- 指定要传播数据值的目标组件的属性。
-- 如果属性值设置为“(action)”，则它不会应用于目标组件的任何属性。 '(action)' 属性主要用于在数据传播时只执行脚本操作的情况。
+```plaintext
+目标组件数据（更新前）：
+- 名称（name）
+- 价格（price）
+- 描述（description）
+- 卡路里（calories）
+```
 
-### rule
+我们想要更新目标组件的某些属性。以下是包含在源数据中的更新信息：
 
-指定如何将要传播的数据应用于目标组件属性。
+```plaintext
+更新信息：
+- 价格（price）
+- 卡路里（calories）
+```
 
-- value
-  - 值本身被设置为组件的目标属性。
-- map
-  - 在目标组件的属性中设置数据属性的值。
-- range
-  - 在目标组件的属性中设置包含该值的范围的映射值。
-- eval
-  - eval 代码可以用 JavaScript 语法编写。
-  - eval 代码的 context (this)是源组件。
-  - eval 代码的参数具有 value 和 targets。
-    - value：源组件的数据中 accessor 对应的值
-    - targets：目标组件列表
+现在，使用部分传播，我们可以仅将源数据中的某些信息应用于更新目标组件。这样，我们可以只使用源数据更改目标数据的所需属性。
 
-### 无数据不传播(No Data No Spreading)
+结果，目标组件的数据将如下更新：
 
-- 只有当根据规则类型的最终结果值不是空值时，才会传播数据。
-  - 如果结果值为 undefined、null、NaN 或空白 ('')，则不会展开。
-  - 否则，即使结果是数字零，数据也会被传播。
+```plaintext
+目标组件数据（更新后）：
+- 名称（name）
+- 价格（price，更新后的值）
+- 描述（description）
+- 卡路里（calories，更新后的值）
+```

package/helps/board-modeller/effects/tap-event.ko.md

@@ -62,6 +62,10 @@
   - 대상 컴포넌트의 현재 데이타를 기준으로 숫자 0/1/2 순서로 데이타를 순환시킨다.
   - 파라미터
     - 대상 : 데이타를 순환시킬 대상 컴포넌트
+- forcely execute data spreading of target component
+  - 대상 컴포넌트의 현재 데이타를 이용해서 강제 데이타 전파를 실행한다.
+  - 파라미터
+    - 대상(target) : 데이타전파를 실행할 대상 컴포넌트
 - set value to target component data
   - 설정한 값으로 대상 컴포넌트의 'data'를 변경한다.
   - 보통 컴포넌트의 data를 변화시키는 것은 대상 컴포넌트에 지정된 데이타 스프레드를 트리거링하는 효과를 발휘한다.

package/helps/board-modeller/effects/tap-event.md

@@ -58,6 +58,10 @@ When a tap event occurs on the component, the configured shadow effect disappear
   - Cycles the data of the target component between the numbers 0, 1, and 2 based on its current data value.
   - Parameters:
     - Target: The target component for cycling the data.
+- Forcefully execute data spreading of the target component.
+  - Execute forced data propagation using the current data of the target component.
+  - Parameters:
+    - Target: The target component to change the data.
 - Set value to target component data:
   - Changes the 'data' of the target component to the specified value.
   - Changing the data of a component triggers the corresponding data spread in the target component.

package/helps/board-modeller/effects/tap-event.zh.md

@@ -59,12 +59,16 @@
   - 根据目标组件的当前数据值，按照数字 0/1/2 的顺序循环数据。
   - 参数：
     - 目标（target）：要循环数据的目标组件。
+- 强制执行目标组件的数据传播。(forcely execute data spreading of target component)
+  - 使用目标组件的当前数据执行强制数据传播。
+  - 参数：
+    - 目标（target）：要更改数据的目标组件。
 - 设置值到目标组件数据（set value to target component data）
-- 根据指定的值更改目标组件的'data'。
-- 通常，更改组件的 data 会触发目标组件上指定的数据传播效果。
-- 参数：
-  - 目标（target）：要更改数据的目标组件。
-  - value：要设置为目标组件的值（可以指定字符串、数字或对象类型）。
+  - 根据指定的值更改目标组件的'data'。
+  - 通常，更改组件的 data 会触发目标组件上指定的数据传播效果。
+  - 参数：
+    - 目标（target）：要更改数据的目标组件。
+    - value：要设置为目标组件的值（可以指定字符串、数字或对象类型）。
 - 设置值到目标组件值（set value to target component value）
   - 根据指定的值更改目标组件的'value'。
   - 通常，更改组件的 value 会触发目标组件上指定的操作效果。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/board-ui",
-  "version": "6.1.129",
+  "version": "6.1.140",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -41,5 +41,5 @@
     "file-saver": "^2.0.2",
     "sortablejs": "^1.10.2"
   },
-  "gitHead": "34348ec14b8648940212758df1945b9321a13593"
+  "gitHead": "694fd29950b1d23bdd751096d6325f8a254df0ac"
 }

package/translations/en.json

@@ -325,6 +325,7 @@
   "label.opinion": "opinion",
   "label.options": "options",
   "label.padding": "padding",
+  "label.partial-spreading": "partial spreading",
   "label.passcode": "passcode",
   "label.path": "path",
   "label.pattern": "pattern",

package/translations/ja.json

@@ -325,6 +325,7 @@
   "label.opinion": "意見",
   "label.options": "options",
   "label.padding": "余白",
+  "label.partial-spreading": "部分的な拡散",
   "label.passcode": "パースコード",
   "label.path": "経路",
   "label.pattern": "パターン",

package/translations/ko.json

@@ -325,6 +325,7 @@
   "label.opinion": "의견",
   "label.options": "options",
   "label.padding": "여백",
+  "label.partial-spreading": "부분 전파",
   "label.passcode": "패스코드",
   "label.path": "경로",
   "label.pattern": "패턴",