React ビジュアル開発ツールの紹介 - シャドウウィジェット

この記事では、一般的な GUI 開発に適用される「React + Shadow Widget」のベスト プラクティスを、一般的なシナリオでの最適な開発方法のみに焦点を当てて紹介します。 2 つのパートに分かれており、2 番目のパートでは直交フレームワーク解析モードと一般的なデバッグ方法について説明します。

前の記事を表示するには、ここをクリックしてください。Shadow Widget オープンソース プロジェクトはここにあります。

1. コントローラービューとビュー

典型的な Flux フレームワークでは、ストアとビューの関係は次のとおりです:

この写真は fluxxor.com 「Flux とは?」の記事では、ストア内のデータがコンポーネントに渡され、コンポーネントが props 属性を介して多層コンポーネントのサブノードを駆動してインターフェイスを表示します。このデータ転送関係では、複数のComponentがViewになっていますが、Storeからデータを取得するViewは特殊であり、「Controller View」と呼ばれます（上図参照）。 Shadow WidgetのMVVMフレームワークにおけるController ViewとViewに対応し、Controller ViewがVM(ViewModel)、VMによって駆動される子ComponentがV(View)となります。 <code>fluxxor.com 的 “What is Flux?” 一文，Store 中的数据传递给一个 Component，这个 Component 又通过 props 属性驱动多层 Component 子节点来展示界面。在这种数据传递关系中，多个 Component 都是 View，但从 Store 获得数据的那个 View 比较特殊，称为 "Controller View"（见上图）。将 Controller View 与 View 对应到 Shadow Widget 的 MVVM 框架，Controller View 就是 VM（ViewModel），由 VM 驱动的子级 Component 就是 V (View)。

然而现实编程并非上图那么简单，Controller View 的子节点，也即 View 节点，有时很复杂，其外部若只依赖从上级 props 传递下来的数据来驱动渲染，会很别扭。开发者常不由自主的放弃 “纯净” 的编程模式，突破限制，让 View 也从全局变量读数据，即，变相的把部分数据从 Store 分离出去，改用全局变量表达，或者干脆让 View 也直接从 Store 读数据，而不是只用 Controller View 代传的数据。

Shadow Widget 将问题简化，既然 Store 主要用于存贮数据，那就还原它的数据特性，作为数据，在哪儿定义关系不大，直接拿 Component 的属性存贮数据就好，将 Store 并入 Component 没有不可逾越的障碍，当然，前提是我们已设计了 “双源属性” 与 “W 树” 机制。然后，Controller View 及其下级多个 View，合起来视作一个 FB（Functionarity Block），在同一 Functionarity Block Namespace 下用 javascript 定义各节点行为。把相关节点的投影定义写一起，很大程度消除了节点间隔阂，因为，你能随时可以定义一个变量用来传数据。

2. 正交框架分析模式

接本文上篇的例子，假定我们在原功能基础上，再增加 “全局配置” 的功能，提供 3 个可选项：“自动选 Celsius 还是 Fahrenheit 格式”、“固定用 Celsius”、“固定用 Fahrenheit”。其中，第一个选项 Auto（自动选格式）依据浏览器特性推断国别信息，然后智能选择 Celsius 或 Fahrenheit。

新增如下界面设计：

相应的，增加一个 Functionarity Block，JS 编码如下：

(function() { // functionarity block

var configComp = null;

idSetter['config'] = function(value,oldValue) {
  // ...
};
})();

该 FB 的入口节点是 configComp。再接着细化设计，我们该将 configComp 定义挪到全局变量定义区，因为该节点在两个 FB 功能块都用到。

为方便讲述起见，我们把这两个 FB 分别称为 config 与 calculator，以 FB 分布为横轴，以 W 树为纵轴，W 树中的节点是层层串联的，绘制这两个 FB 的分布如下图：

当我们整体设计 GUI 时，应以 MVVM 方式思考。结合本例，也就是规划 config 与 calculator 两个 “功能块”，确定各功能块的入口节点，以及它的上下层串接关系。而处理各个功能块之间联动关系时，应切换到 Flux 单向数据流思考方式。

总结一下，整个 HTML 页面是一颗 DOM 树，是纵向的，在这颗树划分若干功能块的过程，是基于 MVVM 为主的设计过程；而处理各功能块之间横向联系，则以 FRP 思路为主导。这一纵一横的思考方式，我们称为 “正交框架” 分析模式。

说明，Flux 是 FRP（Functional Reactiv Programming）开发思想的一种实现，对于 React 开发，上面所提 Flux 与 FRP 基本等效。

至于 FB 之间的功能如何交互，如果处理逻辑简单，不妨在相关 FB 代码块中直接写代码，如果逻辑复杂，不妨取相关 FB 的共有父节点作为入口节点，新设一个 FB 功能块。取共有父节点的主要作用是，该父节点从创建到 unmount

ただし、実際のプログラミングは、コントローラー ビューの子ノード、つまりビュー ノードが上位から渡されたデータのみに依存する場合、非常に複雑になることがあります。レンダリングを駆動するための小道具を使用すると、非常に厄介になります。開発者は、意図せずに「純粋な」プログラミング モデルを放棄し、制限を突破して、ビューにグローバル変数からデータを読み取らせることがよくあります。つまり、一部のデータを偽装してストアから分離し、それを表現するためにグローバル変数を使用するか、単にそのままにします。ビューは、コントローラー ビューによって渡されたデータのみを使用するのではなく、ストアから直接データを読み取ります。 🎜🎜 Shadow Widget は問題を単純化します。Store は主にデータを保存し、そのデータ特性をデータとして復元するために使用されるため、コンポーネントのプロパティを使用してデータを保存し、それを Store にマージするだけです。もちろん、「デュアル ソース プロパティ」と「W ツリー」メカニズムを設計していれば、コンポーネントに克服できない障害はありません。そして、Controller View とその配下にある複数の View をまとめて FB (Functionarity Block) とみなし、同じ Functionality Block Namespace の下で JavaScript を使用して各ノードの動作を定義します。関連するノードの投影定義をまとめて記述すると、いつでもデータを送信する変数を定義できるため、ノードのギャップが大幅に解消されます。 🎜🎜2. 直交フレーム解析モード🎜🎜 前の記事の例に引き続き、元の機能に基づいて「グローバル設定」機能を追加し、「摂氏または華氏形式を自動的に選択」、「固定」の 3 つのオプションを提供すると仮定します。摂氏で固定」、「華氏で固定」。その中で、最初のオプション Auto (自動形式選択) は、ブラウザーの特性に基づいて国情報を推測し、摂氏または華氏をインテリジェントに選択します。 🎜🎜次のインターフェースデザインを追加しました: 🎜🎜🎜🎜🎜🎜それに応じて、追加機能ブロックであり、JS コードは次のとおりです: 🎜

if (!window.W) { window.W = new Array(); W.$modules = [];}
W.$modules.push( function(require,module,exports) {

var W = require('shadow-widget');

var dataSrc = W.$dataSrc = {};
dataSrc['.body.calculator.field'] = { 'scale': 'f' };

});

🎜 この FB のエントリ ノードは configComp です。次に、設計を改良するには、configComp 定義をグローバル変数定義領域に移動する必要があります。これは、このノードが両方の FB 関数ブロックで使用されるためです。 🎜🎜説明の便宜上、これら 2 つの FB をそれぞれ config と calculator と呼びます。FB 分布を横軸とし、W ツリーを縦軸とします。W ツリー内のノードはレイヤーごとに直列に接続されます。これらの 2 つの FB のディストリビューション GUI を設計するときは、MVVM の考え方で考えてください。この例と組み合わせて、2 つの「ファンクション ブロック」のコンフィグと計算機を計画し、各ファンクション ブロックのエントリ ノードとその上下の直列接続関係を決定します。さまざまな機能ブロック間の連携関係を扱う場合はFluxの一方向データフロー思考法に切り替える必要があります。要約すると、HTML ページ全体は垂直方向の DOM ツリーであり、このツリー内で複数の機能ブロックを分割するプロセスは、MVVM ベースの設計プロセスと各機能ブロック間の水平方向の処理に基づいています。コンタクトはFRPのアイデアが主流です。この垂直方向と水平方向の考え方を「直交フレームワーク」 分析モードと呼びます。 🎜🎜Flux は FRP (Functional Reactiv Programming) 開発アイデアの実装であり、React 開発においては、上記の Flux は基本的に FRP と同等であることを説明します。 🎜🎜 FB 間の関数がどのように相互作用するかについては、処理ロジックが単純な場合は、関連する FB コード ブロックにコードを直接記述するとよいでしょう。ロジックが複雑な場合は、FB の共有親ノードを取得するとよいでしょう。該当する FB をエントリノードとして、新しい FB ファンクションブロックを設定します。共有親ノードを取得する主な機能は、親ノードがその下のすべてのノードの作成から unmount までのライフサイクルをカバーできることです。idSetter 関数でプログラムする方が便利です。 🎜

3. 挂载数据来驱动调测

在可视设计器中开发界面的过程，可能存在破坏式重构，比如你在某个 FB 的入口节点指定 data 属性值，然后它的子节点根据 data 取值自动生成子节点，如果你给定的 data 初始值格式不对，其下子节点会无法生成。所给初值不对可能因为设计变化了，你的 data 格式还没来得及调整。

为了最大幅度减少上述破坏式重构带来错误，在设计界面时，我们建议用作驱动源头的数据初值应取 “空” 值，比如赋给 null 或 [] 之类的值。

界面设计过程中，若想查看不同数据初值会驱动什么样的界面形态，不妨启用 W.$dataSrc 定义，比如前面例子界面缺省显示 Celsius 温度格式，因为 '.body.calculator.field' 节点的 scale 属性初值是 'c'，现在我们想检查 scale='f' 界面是否正确。按如下方式使用两行代码即可：

if (!window.W) { window.W = new Array(); W.$modules = [];}
W.$modules.push( function(require,module,exports) {

var W = require('shadow-widget');

var dataSrc = W.$dataSrc = {};
dataSrc['.body.calculator.field'] = { 'scale': 'f' };

});

其中，var dataSrc = W.$dataSrc = {} 表示启用 W.$dataSrc，缺省是不启用的。另一句 dataSrc['.body.calculator.field'] = { 'scale': 'f' }，用来预定义哪个节点要附加哪些属性的初值。

上面代码可以写入独立的 js 文件，多个此类 js 文件可构造不同的调测场景，然后用 3f1c4e4b6b16bbbd69b2ee476dc4f83a 标签按需把某一个 js 文件导入到被测页面。

4. 结合 shadow-bootstrap 的可视化设计

shadow-bootstrap 新近推出 v1.1 版本，Bootstrap 设计方式在 Shadow Widget 体系得到完整支持了。

Bootstrap 提供了优秀的前端控件库，在 shadow-widget 上用 bootstrap 堪称完美，毕竟上百个 class 类谁都记不住，大家做开发时，要不停的查手册。用 shadow-widget 的可视化设计器，只需从右侧样板页拖一个样板扔进来，就创建你想要的构件了，然后选择相应节点，把相关属性配置一下，你的界面很快就做好。

上图是其中一个样板页，该拖入哪个样板，看一眼就能区分，不再受那么多 class 类名困扰了。

5. 注意事项

刚开始使用 Shadow Widget 时，大家可能不适应它的可视化设计，容易忘掉几项设计约束，简单举几个例子：

1. 在根节点（即 ".body" 节点）下只能摆放面板与绝对定位的构件（如 ScenePage 等），即首层节点要么是 Panel 类构件，要么是指定 position='absolute' 的非行内构件。

2. 绝对定位的构件，应挂到根节点，不宜在其它地方出现。（注：此项为建议，不强制）

3. 面板之下不能直接放行内构件，要在面板下放置 P 类构件后，才能放 Span 类构件。

4. 一个构件要么启用 "html." 属性，要么使用它的若干子节点，两者只能二选一，若定义子节点了，以 "html." 表示文本将被忽略。

总之，与界面设计打交道，设计总是具体的，你要面对各类封装好的构件，不少构件有特殊要求，《Shadow Widget 用户手册》有全面介绍，有必要通读该手册。

6. 关于团队分工

Shadow Widget 最佳实践还建议团队成员要按技能分工，至少有两个工种，其一是能运用他人已封装好的 WTC 类或库化 UI，进行 GUI 开发；其二是为他人封装 WTC 类或库化 UI。前者对技能要求不高，后者则要求深入掌握 React 与 Shadow Widget 知识。

对于微型团队，也应按上述分工的思路规划您的产品开发，因为这两种分工的目标不同，前者着眼短期目标，尽快把产品做出来，把界面弄漂亮些，后者着眼中长期目标，用封装库提高开发复用率。即使是单人团队，同样需要分工，无非在时间上错开，一段时间承担一种角色，另一段时间换一个角色。

Shadow Widget 当前的 WTC 类与界面库还不够丰富，但它的架子已搭好，起点不低。它的定制扩展能力出色，已通过一些上规模代码的产品检验，如 shadow-bootstrap， pinp-blogs 等，具备一定成熟度。我们有理由相信，这个产品会随着扩展库逐渐增多，前景越来越光明。

以上がReact ビジュアル開発ツールの紹介 - シャドウウィジェットの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。