React 可视化开发工具 Shadow Widget 非正经入门(之五:指令式界面设计)

本系列博文从 Shadow Widget 作者的视角,解释该框架的设计要点。本篇解释 Shadow Widget 中类 Vue 的控制指令,与指令式界面设计相关。

《React 可视化开发工具 Shadow Widget 非正经入门(之五:指令式界面设计)》

1. 指令式界面设计

Vue 与 Angular 都支持用控制指令描述界面,比如 Vue 中循环创建多个节点:

<div v-for="(index, item) in items">
  {{ index }} {{ item.message }}
</div>

Angular 也有类似 v-for, v-if, v-else 等控制指令,这些对于快速定义用户界面很有用,而 React 实现类似功能需借助 JS 编程,在便捷、直观方面不如 Angular 与 Vue。Shadow Widget 通过引入可计算属性与 MJI 解释器,弥补了 React 这项缺陷。

2. 节点引用

界面设计中常需要照着一个构件的样式,复制出多个,比如下面 btn2 按钮,保持与 btn1 一致的样式:

  <span $=Button key='btn1' sty__='background:#eee; border-color:#ccc'>Test 1</span>
  <span $='//btn1' key='btn2'>Test 2</span>

Shadow Widget 的转义标签也用 $=xx 属性表达节点引用,这与指定 WTC 类(如上面 $=Button)不冲突,因为表达引用时,字串值必是路径格式,首字母必是 '.''/',而指示 WTC 类,首字母必定不是这两个。系统能自动识别这两种用法,用于路径引用时,我们习惯用引号括起来,而用作 WTC 类时,不加引号(不必担心,浏览器会自动把它看成字串的),这么书写理解起来很清晰。

3. 开启解释执行的上下文环境

控制指令是可计算属性中的一种,可计算属性是一种通过脚本表达式,借助 MJI (Mini Javascript Interpreter) 解释器动态解析计算的属性。比如:

<span $=Button key='btn1' sty__='background:#eee; border-color:#ccc'>Test 1</span>
<span $='//btn1' key='btn2' data='{{"desc":"Test 2"}}' 
      $html="duals.data.desc"></span>

这里 $html 是可计算属性,这段代码运行效果与前面等同。

须注意,可计算属性只在开启 MJI 解释运行环境后才生效,否则它只是常规字串。解释运行环境按需动态开启,用完即自动销毁,有此环境 MJI 才能维护脚本计算的上下文运算关系。有下面几种开启解释运行环境的方式:

  1. $=path 建立引用,如上面举例,如果引用位置尚不存在解释运行环境,系统将自动创建一个。
  2. $for=expr$$for=expr 指示将一层调用空间压入栈,系统自动检测当前是否有解释运行环境,若没有,也自动创建。
  3. $for='' 开启一个调用空间,如果当前没有解释运行环境,系统自动创建。

4. 栈式调用空间

与常规编程语言类似,MJI 解释运行环境也有调用栈,一个 $for 循环要使用一套 item, index, count 变量,多个 $for 循环嵌套使用,就形成多套 item, index, count 变量的栈式结构。

在 MJI 解释运行环境中,按如下方式使用首层调用空间中的变量:

  props(0).attr   duals(0).attr   state(0).attr
  item(0)   index(0)   count(0)

或简写如下:

  props.attr   duals.attr   state.attr
  item   index   count

如果读上一层栈中变量:

  props(-1).attr   duals(-1).attr   state(-1).attr
  item(-1)   index(-1)   count(-1)

再往一层,则用 -2 指示,其它类推。

5. 举一个例子

<div $=Panel key='top' height='{null}'>
  <div $=Div key='msg' dual-required='{30}' $for=''
    dual-data='{[{"name":"Wayne","age":20},{"name":"George","age":35}]}'>
    <div $=Ul width='{0.9999}' $title='duals.data.length + " people"' 
         $for='item in duals.data'>
      <div $=Li $key='"if_" + index' $if='item.age >= duals(-1).required'
           $html='item.name + " is old"'></div>
      <div $=Li $key='"el_" + index' $else=''
           $html='item.name + " is young"'></div>
    </div>
  </div>
</div>

运行效果如下:

   《React 可视化开发工具 Shadow Widget 非正经入门(之五:指令式界面设计)》

这个例子包含知识点较集中,讲解几个要点:

  1. $for='' 开启一个解释执行的计算环境,后面的 $for='item in duals.data' 则进入下一层,当前调用空间将压栈。
  2. 内层 $for 中的可计算属性要引用上层调用空间,这么书写:duals(-1).required
  3. $if$else 也是控制指令,有条件的显示特定节点。还有一个 $elif 没举例到,含义为 "else if",用法可类推。
  4. $for 下用来表达循环生成的节点,要显式指定 key 值,如本例的 $key="if_"+index$key="el_"+index,这里 index 是循环序号,依次取值为 0, 1, 2...

6. 更多功能

本系列博文提供引导式入门介绍,过多细节略去不讲。关于指令式界面设计的内容,重要些的还有:

  1. $for 组装子成员提供过滤、排序等功能
  2. 可计算表达式能用于异步计算,比如发起 ajax 调用
  3. 提供 flex 布局面板,方便可视化的快速搭建一个页面
  4. 支持模板定义(TempPanel, TempDiv),便于定制化引用、批量引用
  5. 用导航面板与选项构件,快速搭建列表导航、分页导航等应用,导航面板还为绝对路径分段,让其下节点能用 "./xx""../../xx" 相对路径方式做引用。
  6. 选项构件支持弹出浮窗,支持 trigger 触发器等

细节请阅读《Shadow Widget 用户手册》。

本专栏历史文章:

  1. 介绍一项让 React 可以与 Vue 抗衡的技术
  2. React 可视化开发工具 Shadow Widget 非正经入门(之一:React 三宗罪)
  3. React 可视化开发工具 Shadow Widget 非正经入门(之二:分离界面设计)
  4. React 可视化开发工具 Shadow Widget 非正经入门(之三:双源属性与数据驱动)
  5. React 可视化开发工具 Shadow Widget 非正经入门(之四:flux、mvc、mvvm)
    原文作者:程序强
    原文地址: https://segmentfault.com/a/1190000009786170
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞