Fresh项目中条件渲染子组件的信号使用问题解析

问题背景

在使用Fresh框架开发岛屿(Island)组件时，开发者经常会遇到需要根据条件动态显示或隐藏子组件的情况。本文通过一个典型案例，分析如何正确使用信号(Signal)来实现条件渲染。

典型案例分析

让我们看一个简单的Shell组件实现，它接收一个hidden属性来控制是否显示子组件：

type ShellProps = {
  children: ComponentChildren;
  hidden?: boolean;
} & JSX.HTMLAttributes<HTMLAnchorElement>;

export default function Shell(props: ShellProps) {
  typeof document !== 'undefined' && alert(props.value);

  const hidden = useSignal(props.hidden);

  if (props.hidden) {
    setTimeout(() => {
      console.log('unhide');
      hidden.value = false
    }, 2500);
  }

  return <>{hidden ? '' : props.children}{hidden}</>;
}

问题现象

开发者发现虽然hidden信号的值确实从true变为了false（通过控制台日志确认），但子组件<Button>却始终没有显示出来。

问题根源

关键在于渲染部分的这段代码：

return <>{hidden ? '' : props.children}{hidden}</>;

这里直接使用了hidden信号对象进行条件判断，而信号在JavaScript中是一个对象/类实例，任何对象在布尔上下文中都会被转换为true。因此无论hidden.value是true还是false，hidden本身作为对象总是被评估为true，导致条件渲染始终返回空字符串。

正确解决方案

应该访问信号的.value属性来获取实际值：

return <>{hidden.value ? '' : props.children}{hidden.value}</>;

深入理解

1. 信号的本质：在Fresh/Preact中，信号是一种响应式状态管理工具，它是一个包含.value属性的特殊对象。

2. 条件渲染的正确方式：

   • 错误方式：hidden（直接使用信号对象）
   • 正确方式：hidden.value（访问信号的实际值）

3. 最佳实践：

   • 对于简单的条件渲染，可以直接使用hidden.value
   • 对于复杂逻辑，建议使用计算属性或派生状态
   • 考虑将定时器逻辑放入useEffect中以避免潜在的副作用

完整修正代码

export default function Shell(props: ShellProps) {
  const hidden = useSignal(props.hidden);

  useEffect(() => {
    if (props.hidden) {
      const timer = setTimeout(() => {
        hidden.value = false;
      }, 2500);
      return () => clearTimeout(timer);
    }
  }, [props.hidden]);

  return <>{hidden.value ? null : props.children}</>;
}

总结

在Fresh/Preact中使用信号进行条件渲染时，务必记住要访问.value属性来获取实际值。信号对象本身作为条件判断总是为真，这是许多开发者容易忽视的一个细节。理解这一点可以帮助避免许多类似的渲染问题。