跳到主要内容

Aspects / Aspect

源文档地址

Aspect 主要用在节点库开发中。它能让你：

  • 把「标准」节点与「进阶」「内部」节点区分开
  • 把节点标记为「已废弃」或「实验性」

在节点浏览器里，Aspect 可以用来过滤节点。

VL 有这几个 Aspect 关键字：

  • Advanced
  • Internal
  • Experimental
  • Obsolete
  • Adaptive

Advanced​

Advanced 大概是最重要的一个 Aspect。想法是：节点库开发者会提供少数几个特别好用的节点和类型，覆盖 90% 用户的需求。这些节点应该默认就出现在节点浏览器里；其余的等用户遇到进阶需求时再一并露出来。

做法是：库的结构随你怎么组织，只要把进阶节点放进 Advanced 目录 —— 这就告诉节点浏览器：Advanced 按钮关着时（默认关着）把它们藏起来。

节点浏览器还有个按钮用来显示／隐藏「标准」节点（默认开着），方便你检查自己的库是否前后一致。

Internal​

有了这个 Aspect，节点库开发者可以把节点的可见性控制得更细。

Internal 让节点和类型只在定义它们的那个 .vl 文档内部可用。适合那些换个语境就毫无意义的小工具和辅助节点 —— 文档被别人引用时，它们不该露出去。

Obsolete and Experimental / Obsolete 与 Experimental​

这两个分别留给过去和未来的节点。

还没做完、或只是某项新技术的概念验证的节点，放进 Experimental 目录。用它们要当心：可能不稳定，将来也可能有破坏性改动。

Obsolete 一望即知：带这个 Aspect 的节点只为向后兼容而留着，不该再用 —— 多半已经有更新更好的版本。

Adaptive​

你可以在任何地方建一个 Adaptive 目录，目录内所有的节点签名都会进入自适应体系，于是每个类型都能去实现这样一个节点。比如自适应的运算符 +、-、*、/、= 等就放在 Math.Adaptive 目录里，所以它们在节点浏览器里显示在 Math 之下。

给节点施加 Aspect 有几种不同的方式：

Specifying aspects for groups of nodes / 给一组节点指定 Aspect​

用上面任意一个关键字作为名字建目录，就能把 Aspect 施加到这个目录内定义的所有节点上。

注意：Aspect 虽然写成目录的形式，却不计入节点真正的完整目录。所以 MyLibrary.Particles.Advanced 和 MyLibrary.Advanced.Particles 都只会变成 MyLibrary.Value。

在提示框里，Aspect 与目录被清楚地区分开：

Specifying an aspect for a single datatype definition / 给单个数据类型定义指定 Aspect​

对 Process、Record 或 Class，可以通过草图浏览器设定 Aspect。

给某个类型指定的 Aspect，同样作用于它内部的所有元素！

Specifying an aspect for a single operation / 给单个 Operation 指定 Aspect​

要给单个 Operation 指定 Aspect，只要把关键字写进 Operation 名字的版本部分，比如：

GetBytes (Advanced) 或 Transform (Normal Advanced)