Hi All,
I was trying to build a modal dialog box in lightning component and it took me some time to figure out how to use svg tag and use it in Lightning component.
In this blog, I will try to create a Account List Lightning Component which will have a new Account create button.The new button will open a form dialog box which will contain the Account fields.On the click of Save the Account record will be created.
Attached is the screen of the Lightning App once you complete this tutorial.
Let’s first create a lightning component which shows a list of accounts
AccountListController.apxc :
public class AccountListController { @AuraEnabled public static list<Account> getAccountlist(){ return [Select id, Name,Industry,Phone from Account Order by CreatedDate desc limit 10]; } @AuraEnabled public static void getAccountupdatedlist(Account newAcc){ insert newAcc ; } }
Next Step is to get the Lightning design system.You can download the latest version from https://www.lightningdesignsystem.com/resources/downloads and upload it as a static resource.
Now, first lets create a reusuable Lightning component so that we can use svg tags to show images.You can follow salesforce trailhead to create this. (https://developer.salesforce.com/trailhead/en/project/slds-lightning-components-workshop/slds-lc-4)
svg.cmp
<aura:component > <aura:attribute name="class" type="String" description="CSS classname for the SVG element" /> <aura:attribute name="xlinkHref" type="String" description="SLDS icon path. Ex: /assets/icons/utility-sprite/svg/symbols.svg#download" /> <aura:attribute name="ariaHidden" type="String" default="true" description="aria-hidden true or false. defaults to true" /> </aura:component>
svgRenderer.js
({ render: function(component, helper) { //grab attributes from the component markup var classname = component.get("v.class"); var xlinkhref = component.get("v.xlinkHref"); var ariaHidden = component.get("v.ariaHidden"); //return an svg element w/ the attributes var svg = document.createElementNS("http://www.w3.org/2000/svg", "svg"); svg.setAttribute('class', classname); svg.setAttribute('aria-hidden', ariaHidden); svg.innerHTML = '<use xlink:href="'+xlinkhref+'"></use>'; return svg; } })
The next step will be to create a component to show the list of Accounts. We can use the reusuable svg component to add any images to the component by just passing the class and xlinkHref attribute in the component.
AccountListComponent.cmp
<aura:component controller="AccountListController"> <ltng:require styles="/resource/SLDS/assets/styles/salesforce-lightning-design-system.min.css"/> <aura:attribute name="accountlist" type="Account[]"/> <aura:handler name="init" value="{!this}" action="{!c.getAccountlst}"/> <table class="slds-table slds-table--bordered" style="width: 80%;border-right: 1px solid #d8dde6;border-left: 1px solid #d8dde6;margin-left: 2%;"> <thead> <tr class="slds-text-heading--label"> <th class="slds-cell-shrink" scope="col"></th> <th class="slds-truncate" scope="col"> <span class="slds-truncate">Account Name</span></th> <th scope="col"> <span class="slds-truncate">Industry</span></th> <th scope="col"> <span class="slds-truncate">Phone</span></th> </tr> </thead> <tbody> <aura:iteration items="{!v.accountlist}" var="acc"> <tr class="slds-hint-parent"> <th data-label="acc-name" role="row"> <c:svg class="slds-icon slds-icon-text-default" xlinkHref="/resource/SLDS/assets/icons/standard-sprite/svg/symbols.svg#account" /></th> <th data-label="acc-name" role="row"> <a href="#" class="slds-truncate">{!acc.Name}</a></th> <td data-label="industry"> <a href="#" class="slds-truncate">{!acc.Industry}</a></td> <td data-label="industry"> <a href="#" class="slds-truncate">{!acc.Phone}</a></td> </tr> </aura:iteration></tbody> </table> </aura:component>
The controller of the component calls an aura method and sets the accountlist attribute which is being used to show the accounts.
AccountListComponentController.js
({ getAccountlst : function(component, event, helper) { var action = component.get("c.getAccountlist"); action.setCallback(this, function(a) { if (a.getState() === "SUCCESS") { component.set("v.accountlist", a.getReturnValue()); } else if (a.getState() === "ERROR") { $A.log("Errors", a.getError()); } }); $A.enqueueAction(action); } })
This is a very basic component which only shows the last 10 created accounts.Lets create a header component.
AccountListHeader.cmp
<aura:component > <div class="slds-page-header" role="banner"> <div class="slds-grid"> <div class="slds-col slds-has-flexi-truncate"> <h1 class="slds-text-heading--medium slds-truncate" title="All Accounts">Accounts</h1> </div> <div class="slds-col slds-no-flex slds-align-bottom"> <div class="slds-button-group"> <button class="slds-button slds-button--neutral" onclick="{!c.showModal}">Add Account</button> </div> </div> </div> <p class="slds-text-body--small slds-m-top--x-small">10 items, ordered by recently created</p> </div> </aura:component>
The controller of component is used for the new Account button which is adding a style to the modal dialog box(explained below).
AccountListHeaderController.js
({ showModal : function(component, event, helper) { document.getElementById("backGroundSectionId").style.display = "block"; document.getElementById("newAccountSectionId").style.display = "block"; } })
The next step is to create the modal dialog lightning component.By default I have added a style(diplay :none;) to the div so that it's hidden by default.On the click of new Account button it calls a javascript button which changes the style of the div.
AccountCreateComponent.cmp
<aura:component controller="AccountListController"> <aura:attribute name="newAccount" type="Account" default="{ 'sobjectType': 'Account', 'Name': '', 'Industry': '', 'Phone': '' }"/> <div aria-hidden="false" id="newAccountSectionId" role="dialog" class="slds-modal slds-modal--large slds-fade-in-open" style="display:none;"> <div class="slds-modal__container"> <div class="slds-modal__header"> <h2 class="slds-text-heading--medium">New Account</h2> <button class="slds-button slds-button--icon-inverse slds-modal__close" onclick="{!c.showModalBox}"> <c:svg class="slds-button__icon slds-button__icon--large" xlinkHref="/resource/SLDS/assets/icons/action-sprite/svg/symbols.svg#close" ariaHidden="true" /> <span class="slds-assistive-text">Close</span> </button> </div> <div class="slds-modal__content"> <div> <div class="slds-form-element"> <div class="slds-form-element__control"> <ui:inputText aura:id="accname" label="Account Name" class="slds-input" labelClass="slds-form-element__label" value="{!v.newAccount.Name}" required="true"/> </div> </div> <div class="slds-form-element"> <div class="slds-form-element__control"> <ui:inputText aura:id="accname" label="Industry" class="slds-input" labelClass="slds-form-element__label" value="{!v.newAccount.Industry}" required="true"/> </div> </div> <div class="slds-form-element"> <div class="slds-form-element__control"> <ui:inputText aura:id="accname" label="Phone" class="slds-input" labelClass="slds-form-element__label" value="{!v.newAccount.Phone}" required="true"/> </div> </div> </div> </div> <div class="slds-modal__footer"> <div class="slds-x-small-buttons--horizontal"> <button class="slds-button slds-button--neutral" onclick="{!c.showModalBox}" >Cancel</button> <button class="slds-button slds-button--neutral slds-button--brand" onclick="{!c.saveAccount}">Save</button> </div> </div> </div> </div> <div class="slds-backdrop slds-backdrop--open" id="backGroundSectionId" style="display:none;"></div> </aura:component>
The controller of the component consists of two methods.One calls an aura method
to save the new account record.The other to hide the modal dialog by update the display style attribute.
AccountCreateComponentController.js
({ showModalBox : function(component, event, helper) { document.getElementById("backGroundSectionId").style.display = "none"; document.getElementById("newAccountSectionId").style.display = "none"; }, saveAccount : function(component, event, helper) { var action = component.get("c.getAccountupdatedlist"); action.setParams({ "newAcc" : component.get("v.newAccount")}); action.setCallback(this, function(a) { if (a.getState() === "SUCCESS") { document.getElementById("backGroundSectionId").style.display = "none"; document.getElementById("newAccountSectionId").style.display = "none"; } else if (a.getState() === "ERROR") { $A.log("Errors", a.getError()); } }); $A.enqueueAction(action); } })
Almost there, the last step is to combine all these 3 components 🙂
AccountListApp.app
<aura:application > <c:AccountListHeader /> <c:AccountCreateComponent /> <c:AccountListComponent /> </aura:application>
I am getting error while saving controller..the error message is
‘expecting a left angle bracket, found ‘&’
at this line…
public static list < Account > getAccountlist() {
….also a.getState() return string value but it is mentioned as "SUCCESS"
is this correct also we call method of controller in lightning component by
var action = component.get(“c.getAccountList”); but here it is mentioed as…
var action = component.get("c.getAccountlist");
Is this correct??
LikeLike
Hi Gaurav,
There was some formatting issue in the code. I have updated it and should be working fine now.
LikeLiked by 1 person
Can you please put App in visualforce page
LikeLike
You can not add App directly to Visualforce page ..But you can follow this article to add all the components inside a visualforce page https://developer.salesforce.com/docs/atlas.en-us.lightning.meta/lightning/components_visualforce.htm
LikeLike
Hi Nitish. Good Blog.
I implement the same functionality in my Org, but I want to rerender newly created account on parent Component Page(AccountListComponent) on save of the Account in modal window.
LikeLike
Hi Mayukh,
Thanks for the positive feedback.
For showing the new account on the parent component page change the saveAccount method to return the newly created accounts and then set the accountlist attribute. That will show the newly created account.
LikeLike
Can I show visualforce page instead of account list??
LikeLike
You can add a visualforce page inside a lightning component using iframe tag. Not a very good practice though. Better to get your visualforce page to lightning component
LikeLike