RJS 与视图交互
为什么 Nova 不使用 RJS?
WebView 页面可以通过 RJS 查找网页节点、操作 Canvas,或向 SJS 发送消息。Nova 使用小程序节点和原生组件,不执行 .rjs 脚本。如果旧脚本只用于切换按钮颜色,可以改用页面状态和样式。如果页面的主要功能依赖浏览器绘图,可以先保留 WebView。
原来的 RJS 在做什么?
用组件状态更新选中样式
如果旧的 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。