Wednesday, February 1, 2023

Lightning Web Components (LWC) Best Practice

Lightning Web Components (LWC) is a new Salesforce development method using open web standards like standard JavaScript and HTML which means developers who have never worked with Salesforce can now jump right in and existing developers can now use standard techniques and tools never before available. In this post, we will learn about Lightning Web Components(LWC) Best Practices.

Let’s learn Lightning Web Components (LWC) Best Practices like when to use apex class and when not to use apex class. When we should use which event in LWC?

1. LWC component Bundle naming convention 

Check this post to learn about what is camelCase, PascalCase and kebab-case.

  1. Html file : Use camel case to name your component and use kebab-case to reference a component in the markup
  2. JavaScript File : Java Script Class name should be in PascalCase
  3. Bundle Component : use camelCase. 

2. Calling Apex From LWC

There are two ways to call Apex class in the Lightning web component.

  1. Imperatively
  2. Wire 
    1. Wire a property
    2. Wire a function  

Wire Vs Imperatively:

As per Lightning component best practices use @wire over imperative method invocation. @wire fits nicely in the overall Lightning Web Component reactive architecture. Salesforce is building some performance enhancement features that are only available with @wire. But there are a few use cases,, that require you to use imperative Apex.

Wire Property Vs Wire Function:

Prefer wiring to a property. This best practice applies to @wire in general (not just to wiring Apex methods).

3. Lightning Data Service (LDS)

As per LWC best practice use Lightning Data Service functions to create,Record, and delete a record over invoking Apex methods. Yes there are some use cases where you need to multiple records then we can use Apex methods.

Lightning Data Service is built on top of User Interface API. UI API is a public Salesforce API that Salesforce uses to build Lightning Experience. Like its name suggests, UI API is designed to make it easy to build Salesforce UI. UI API gives you data and metadata in a single response

Give preference to user interface form-type in below order.

  1. lightning-record-form : It is the fastest/most productive way to build a form.
  2. lightning-record-view-form : If you need more control over the layout, want to handle events on individual input fields, or need to execute pre-submission
  3. @wire(getRecord) : If you need even more control over the UI, or if you need to access data without a UI

4. Event in LWC

There are typically 3 approaches for communication between the components using events.

  1. Communication using Method in LWC ( Parent to Child )
  2. Custom Event Communication in Lightning Web Component (Child to Parent )
  3. Publish Subscriber model in Lightning Web Component Or Lightning Message Service ( Two components which don’t have a direct relation )

Here is some recommendation for DOM Event.

  1. No uppercase letters
  2. No Spaces
  3. use underscores to separate words
  4. Don’t prefix your event name with the string “on”.

Learn more about Events in lightning web components here. Avoid using Lightning Message Service or pubsub when not needed.

5. Streaming API, Platform Event, Change Data Capture

The lightning/empApi module provides access to methods for subscribing to a streaming channel and listening to event messages. All streaming channels are supported, including channels for platform events, PushTopic events, generic events, and Change Data Capture events. This component requires API version 44.0 or later. The lightning/empApi module uses a shared CometD connection. Example Code.

6. How to debug LWC

Use Chrome’s pretty JS setting to see unminified JavaScript and Debug Proxy Values for Data. Here is example.

  • Enable Debug mode
    • It gives unminified Javascript
    • Console warnings
    • Pretty data structure
  • Caution – it reduces the performance of Salesforce, make sure it’s disabled in production

7. Use Storable Action

Use Storable Action, It will reduces call to Server. Syntax – @AuraEnabled(cacheable=true)

Caution: A storable action might result in no call to the server. Never mark as storable an action that updates or deletes data.
For storable actions in the cache, the framework returns the cached response immediately and also refreshes the data if it’s stale. Therefore, storable actions might have their callbacks invoked more than once: first with cached data, then with updated data from the server.

8. Build reusable Lightning Web Components

Modularity is key to creating a scalable application by reusing components. We rarely write code that is abstract enough to be reusable everywhere. You should write components not to be reused out of the box, but to be abstract and composable enough to serve that purpose in a variety of implementations.

Component Composition

Components are the building blocks of a page. We should consider the following point before dividing the components in LWC

  • Level 1: Based on its functionality
  • Level 2: Based on its reusability : Passing attributes becomes a pain when you need to pass lots of inputs to the component. Consider passing objects as parameters instead of having multiple attributes.
LWC Best Practices to make reusable components.

Learn more about Design Patterns and Best Practices to build reusable Lightning Web Components.

9. Styling Reusable Components

LWC encapsulates and isolates a component’s stylesheet. Does it mean it is hard to style a child component from a parent?

  • Spend some time at design time to think about possible variants of your component.
  • Use CSS Custom Properties for custom styles
  • Use Styling Hooks to override styling of Base Components.
  • Favor Styling Hooks and CSS Custom Properties over component attributes.

Check out how to Share CSS styles among Lightning Web Components.

10. LWC Best Practices

Here are some other LWC best practices which we can follow while building LWC components.

  • Use UI API Wire Adapters and Lightning Base Components
    • Gives the admin the opportunity to configure your components without modifying code by configuring lists views, record layouts.
    • If required don’t hesitate to restrict your components visibility to certain objects
  • Think whether the component needs to be tied to an object, or can it be object agnostic
    • Don’t use static references
    • If needed, create object agnostic classes
  • Extract utility methods outside your LWC components
    • LWC components should only deal with UI-related logic.
  • Favor public properties over public methods
    • Properties can be set directly in the template, while a method requires the consumer to render the component first, retrieve it back from the DOM, and invoke the method

11. Tips & Trick for Lightning Web Components

Check out our post to learn 20 Tips for Lightning Web Components (LWC) in Salesforce.

Lightning Web Components (LWC) Best Practice

Hear from the man who helps make it happen: Salesforce Principal Developer Evangelist René Winkelmeyer. Building rich, efficient, and resilient Lightning Web Components is no black magic. This webinar will cover best practices around:

Agenda :-

  1. Using public, and private properties for effective component composition.
    1. When we should use @api or @track variable
  2. Event communication for child-to-parent as well as for sibling components (pubsub).
    1. Parent to Child Communication
    2. Child to Parent Communication
    3. pubsub
  3. When, and when not, to use Apex with Lightning Web Components
  4. Aura interoperability

No comments:

Post a Comment