Aura Open Source Developer Guide Last updated: November 1, 2017 © Copyright 2000–2017 salesforce.com, inc. All rights reserved. Salesforce is a registered trademark of salesforce.com, inc., as are other names and marks. Other marks appearing herein may be trademarks of their respective owners. CONTENTS Chapter 1: What is Aura? . 1 Why Use Aura? . 2 Components . 2 Events . 3 Aura Version Numbers . 3 Chapter 2: Quick Start . 5 Create an Aura App from the Command Line . 6 Import an Aura App into Eclipse . 6 Add a Component . 7 Next Steps . 8 Build Aura from Source . 8 Chapter 3: Creating Components . 11 Component Markup . 12 Component Namespace . 13 Viewing Components . 13 Component Bundles . 14 Component IDs . 14 HTML in Components . 16 CSS in Components . 16 Component Attributes . 17 Component Composition . 19 Component Body . 21 Component Facets . 22 Best Practices for Conditional Markup . 23 Component Versioning . 24 Using Expressions . 25 Dynamic Output in Expressions . 26 Conditional Expressions . 27 Data Binding Between Components . 27 Value Providers . 32 Expression Evaluation . 36 Expression Operators Reference . 37 Expression Functions Reference . 40 Using Labels . 44 $Label . 45 Input Component Labels . 45 Dynamically Populating Label Parameters . 46 Contents Getting Labels in JavaScript . 47 Setting Label Values via a Parent Attribute . 49 Customizing your Label Implementation . 50 Localization . 51 Providing Component Documentation . 51 Working with UI Components . 54 Event Handling in UI Components . 57 Using the UI Components . 58 Working with the Flow Lightning Component . 78 Set Flow Variable Values from a Lightning Component . 79 Get Flow Variable Values to a Lightning Component . 82 Control a Flow’s Finish Behavior in a Lightning Component . 83 Resume a Flow Interview from a Lightning Component . 84 Supporting Accessibility . 85 Button Labels . 87 Carousels . 87 Help and Error Messages . 88 Audio Messages . 88 Forms, Fields, and Labels . 88 Images . 89 Events . 90 Dialog Overlays . 90 Menus . 91 Resolving Accessibility Errors . 91 Add Components to Apps . 95 Chapter 4: Communicating with Events . 96 Actions and Events . 97 Handling Events with Client-Side Controllers . 98 Component Events . 100 Component Event Propagation . 101 Create Custom Component Events . 102 Fire Component Events . 102 Handling Component Events . 103 Component Event Example . 109 Application Events . ..