小程序开放平台

文档中心
小组件配置
框架接口
XHSML 语法参考
数据绑定
列表渲染
条件渲染
模版
引用

条件渲染

开发
>
框架
>
XHSML 语法参考
>
条件渲染
>
更新时间:2025-08-04 16:23:08

xhs:if

在框架中,使用

xhs:if=""
来判断是否需要渲染该代码块:

<view xhs:if="{{condition}}"> True </view>

也可以用

xhs:elif
xhs:else
来添加一个 else 块:

<view xhs:if="{{length > 5}}"> 1 </view>
<view xhs:elif="{{length > 2}}"> 2 </view>
<view xhs:else> 3 </view>

block xhs:if

因为

xhs:if
是一个控制属性,需要将它添加到一个标签上。如果要一次性判断多个组件标签,可以使用一个
<block/>
标签将多个组件包装起来,并在上边使用
xhs:if
控制属性

<block xhs:if="{{true}}">
  <view> view1 </view>
  <view> view2 </view>
</block>

注意:

<block/>
并不是一个组件,它仅仅是一个包装元素,不会在页面中做任何渲染,只接受控制属性。

xhs:if
vs
hidden

因为

xhs:if
之中的模板也可能包含数据绑定,所以当
xhs:if
的条件值切换时,框架有一个局部渲染的过程,因为它会确保条件块在切换时销毁或重新渲染。

同时

xhs:if
也是惰性的,如果在初始渲染条件为 false,框架什么也不做,在条件第一次变成真的时候才开始局部渲染。

相比之下,hidden 就简单的多,组件始终会被渲染,只是简单的控制显示与隐藏。

一般来说,

xhs:if
有更高的切换消耗而 hidden 有更高的初始渲染消耗。因此,如果需要频繁切换的情景下,用 hidden 更好,如果在运行时条件不大可能改变则
xhs:if
较好。

该文档是否对您有帮助?