RJS 与视图交互

为什么 Nova 不使用 RJS?

WebView 页面可以通过 RJS 查找网页节点、操作 Canvas,或向 SJS 发送消息。Nova 使用小程序节点和原生组件,不执行 .rjs 脚本。如果旧脚本只用于切换按钮颜色,可以改用页面状态和样式。如果页面的主要功能依赖浏览器绘图,可以先保留 WebView。

原来的 RJS 在做什么?

用途Nova 中怎么做
改颜色、显隐、选中态把状态传给组件,用样式类、属性或条件渲染更新界面。
在拖动中更新视图优先使用 slider、movable-view 等提供拖动能力的组件。自定义反馈可以用 SJS 处理组件支持的触摸事件,用组件事件向页面传递操作结果。
测量节点尺寸页面逻辑可用 SelectorQuery。在 WebView 的 SJS 中,getBoundingClientRect() 可以同步返回结果。迁移到 Nova 时,需要通过回调或 Promise 异步读取结果。节点已移除时按无结果处理。
通过共享 eventChannel 通知 SJS把所需数据传为组件属性,通过属性变化触发视图更新。RJS 与 SJS 之间的共享通道在 Nova 中不可用。页面导航的 EventChannel 按页面导航 API 使用。
调用 Web Canvas、DOM 或网页插件先评估是否有可替换的小程序组件。依赖浏览器的交互可以保留在 WebView 路由。

用组件状态更新选中样式

如果旧的 RJS 只是收到「已选中」指令后改按钮颜色,可以把原来的调用改为更新 selected。下面的 Ray 组件用 selected 决定按钮的样式。

import { Button } from '@ray-js/ray';

type DeviceOptionProps = {
  selected: boolean;
  onSelect: () => void;
};

export default function DeviceOption({ selected, onSelect }: DeviceOptionProps) {
  return (
    <Button
      className={selected ? 'device-option-selected' : 'device-option'}
      onClick={onSelect}
    >
      客厅设备
    </Button>
  );
}
.device-option {
  background-color: #f2f3f5;
}

.device-option-selected {
  background-color: #d6f5e6;
}

父页面在 onSelect 中更新状态。回到页面或重新加载数据时,只要传入正确的 selected,按钮就会显示对应样式。如果旧组件还用 RJS 回传点击结果,使用组件的点击事件把结果交回父页面。

原生小程序在模板中绑定 selected,并在页面的 onSelect 中更新它。

<button class="{{selected ? 'device-option-selected' : 'device-option'}}" bindtap="onSelect">
  客厅设备
</button>

已经用了 SJS,怎么传数据?

只在已有组件需要用 SJS 处理局部交互或样式时迁移这段脚本。下面以原生小程序为例,通过组件属性将颜色传给 SJS,color 变化时更新节点样式。

<sjs module="panel" src="./panel.sjs" />
<view color="{{panelColor}}" change:color="{{panel.onColorChange}}" />

在同级 panel.sjs 中更新节点样式。

export default {
  onColorChange(newColor, oldColor, owner, node) {
    node.setStyle({ backgroundColor: newColor });
  },
};

在样式表中设置初始颜色,后续调用 setData({ panelColor: '#d6f5e6' }) 更新颜色。若只是根据选中状态换色,用前一节的样式类即可。

Ray 可以把上面的模板和 panel.sjs 放在 components/sjs-panel/ 中。将模板保存为 index.tyml,在 index.json 中设置 "component": true,并在 index.js 声明组件属性:

Component({
  properties: {
    panelColor: String,
  },
});

然后在页面的 JSX 中导入该组件,并传入颜色。

import SjsPanel from '@/components/sjs-panel';

export function Panel({ panelColor }: { panelColor: string }) {
  return <SjsPanel panelColor={panelColor} />;
}

如果某个页面的大部分交互都依赖浏览器绘图或第三方网页脚本,先让该页继续使用 WebView。其余页面仍可按需启用 Nova。