Lightning Components Developer’s Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Newer Version Available

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

Accessing the DOM

The Document Object Model (DOM) is the language-independent model for representing and interacting with objects in HTML and XML documents. The framework’s rendering service takes in-memory component state and updates the component in the DOM.

The framework automatically renders your components so you don't have to know anything more about rendering unless you need to customize the default rendering behavior for a component.

There are two very important guidelines for accessing the DOM from a component or app.

  • You should never modify the DOM outside a renderer. However, you can read from the DOM outside a renderer.
  • Use expressions, whenever possible, instead of trying to set a DOM element directly.

Using Renderers

The rendering service is the bridge from the framework to update the DOM. If you modify the DOM from a client-side controller, the changes may be overwritten when the components are rendered, depending on how the component renderers behave.

Using Expressions

You can often avoid writing a custom renderer by using expressions in the markup instead.