Lightning Components Developer’s Guide

Getting Started
Creating Components
Communicating with Events
Creating Apps
Debugging
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

aura:if

aura:if renders the content within the tag if the isTrue attribute evaluates to true.

The framework evaluates the isTrue expression on the server and instantiates components either in its body or else attribute.

aura:if instantiates the components in either its body or the else attribute, but not both. aura:renderIf instantiates both the components in its body and the else attribute, but only renders one. If the state of isTrue changes, aura:if has to first instantiate the components for the other state and then render them. We recommend using aura:if instead of aura:renderIf to improve performance.

Note

Attribute Name Type Description
else ComponentDefRef[] The markup to render when isTrue evaluates to false. Set this attribute using the aura:set tag.
isTrue string Required. An expression that determines whether the content is displayed. If it evaluates to true, the content is displayed.

Example

This snippet of markup uses the <aura:if> tag to conditionally display an edit button.

1swfobject.registerObject("clippy.example_markup", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17<aura:attribute name="edit" type="Boolean" default="true"/>
18<aura:if isTrue="{!v.edit}">
19    <ui:button label="Edit"/>
20    <aura:set attribute="else">
21        You can’t edit this.
22    </aura:set>
23</aura:if>

If the edit attribute is set to true, a ui:button displays. Otherwise, the text in the else attribute displays.