Essential CSS
JavaScript Roadmap
Learn JavaScript
Mastering Web Typography
Practical Astro
Understanding Async JS
Unorthodox Tailwind
API Masterclass
Build and Deploy
The Beginner Freelancer
Real World Node
Profile Billing Logout
Learn JavaScript
Lesson Plan
  1. JavaScript and its ecosystem
    1. Welcome to Learn JavaScript!
    2. What is JavaScript used for?
    3. The JavaScript ecosystem
    4. Varying versions of JavaScript
  2. JS Basics
    1. Linking your JavaScript file
    2. Preparing your text editor
    3. The Console
    4. Comments
    5. On semicolons
    6. Strings, numbers and booleans
    7. Understanding Variables
    8. Understanding Functions
    9. The Flow of a Function
    10. Arrow functions
    11. Intro to objects
    12. If/else statements
    13. Comparing Objects
    14. The NOT operator
    15. Null and Undefined
    16. The BOM and the DOM
    17. Selecting an Element
    18. Changing Classes
    19. Listening to events
    20. Callbacks
  3. Building simple components
    1. How to think like a developer
    2. Starter files and Source codes
    3. Do this for every component
    4. ๐Ÿ›  Off-canvas menu: Building an off-canvas menu
    5. ๐Ÿ›  Modal: Building a Modal
    6. Lessons from the building process
    7. Debugging errors
    8. How to use a linter
  4. Arrays and loops
    1. Introduction to Arrays
    2. Array methods
    3. For loops
    4. The forEach loop
    5. Selecting multiple elements
    6. Nodes vs Elements
    7. ๐Ÿ›  Accordion: Building an accordion
  5. Dom basics
    1. Id, classes, attributes, and tags
    2. Changing CSS with JavaScript
    3. Getting CSS with JavaScript
    4. Changing Attributes
    5. Finding an element's size and position
    6. DOM Traversals
    7. ๐Ÿ›  Tabby: Building Tabby (A Tabbed component)
    8. ๐Ÿ›  Carousel: HTML and CSS
    9. ๐Ÿ›  Carousel: Switching slides with JavaScript
    10. ๐Ÿ›  Carousel: Working the dots
    11. ๐Ÿ›  Carousel: Positioning slides with JavaScript
  6. Events deep dive
    1. The listening element
    2. Default Behaviors
    3. Event propagation
    4. Event delegation
    5. Removing Event Listeners
    6. ๐Ÿ›  Modal: Closing the modal
    7. ๐Ÿ›  Accordion: Event delegation
    8. ๐Ÿ›  Tabby: Event delegation
    9. ๐Ÿ›  Carousel: Event delegation
  7. Transitions and Animations
    1. CSS Transitions
    2. CSS Animations
    3. Silky-smooth animations
    4. Integrating CSS transitions and animations with JavaScript
    5. Animating with JavaScript
    6. GreenSock Animation API (GSAP)
    7. ๐Ÿ›  Off-canvas menu: Animations
    8. ๐Ÿ›  Modal: Animating the modal
    9. ๐Ÿ›  Modal: Animating the pointing hand
    10. ๐Ÿ›  Modal: Animating the waving hand
    11. ๐Ÿ›  Modal: Wave hand animation with JavaScript (using GSAP)
    12. ๐Ÿ›  Accordion: Animations
    13. ๐Ÿ›  Carousel: Animations
  8. Useful JS features
    1. Ternary operators
    2. AND and OR operators
    3. Early returns
    4. Template Literals
    5. Destructuring
    6. Default parameters
    7. Enhanced Object Literals
    8. Rest and Spread
    9. Useful array methods
    10. Looping through objects
    11. Returning objects with implicit return
    12. ๐Ÿ›  Accordion: Using useful JavaScript features
    13. ๐Ÿ›  Tabby: Using useful JavaScript features
    14. ๐Ÿ›  Carousel: Useful JavaScript features
  9. JS Best practices
    1. Write declarative code
    2. Functions with a purpose
    3. Manage scope
    4. Reduce state changes
    5. Don't reassign
    6. Don't mutate
    7. Preventing Objects from mutating
    8. Preventing Arrays from mutating
    9. Write pure functions
    10. ๐Ÿ›  Accordion: Refactor
    11. ๐Ÿ›  Carousel: First refactor
    12. ๐Ÿ›  Carousel: Refactoring the dots part
    13. ๐Ÿ›  Carousel: Previous and next buttons
    14. ๐Ÿ›  Carousel: Second refactor
  10. Manipulating text and content
    1. Changing Text and HTML
    2. Creating HTML Elements
    3. Adding multiple elements to the DOM
    4. Removing Elements from the DOM
    5. ๐Ÿ›  Carousel: Creating dots with JavaScript
    6. ๐Ÿ› ๏ธ Calculator: HTML and CSS
    7. ๐Ÿ› ๏ธ Calculator: Happy Path
    8. ๐Ÿ› ๏ธ Calculator: Testing the Happy Path
    9. ๐Ÿ› ๏ธ Calculator: Easy Edge Cases
    10. ๐Ÿ› ๏ธ Calculator: Difficult Edge Cases
    11. ๐Ÿ› ๏ธ Calculator: Refactoring
    12. The switch statement
    13. ๐Ÿ› ๏ธ Calculator: Refactoring (Part 2)
    14. ๐Ÿ› ๏ธ Popover: Making one popover
    15. ๐Ÿ› ๏ธ Popover: Making four popovers
    16. ๐Ÿ› ๏ธ Popover: Making popovers with JavaScript
  11. Handling Forms
    1. Intro to forms
    2. Selecting form fields with JavaScript
    3. Form fields and their events
    4. Sanitize your output
    5. Generating unique IDs
    6. ๐Ÿ› ๏ธ Popover: Dynamic ID
    7. ๐Ÿ› ๏ธ Todolist: The HTML and CSS
    8. ๐Ÿ› ๏ธ Todolist: Creating tasks with JavaScript
    9. ๐Ÿ› ๏ธ Todolist: Deleting tasks with JavaScript
    10. ๐Ÿ› ๏ธ Typeahead: The HTML and CSS
    11. ๐Ÿ› ๏ธ Typeahead: Displaying predictions
    12. ๐Ÿ› ๏ธ Typeahead: Selecting a prediction
    13. ๐Ÿ› ๏ธ Typeahead: Bolding search terms
  12. Handling Dates
    1. The Date object
    2. Getting a formatted date
    3. Getting the time
    4. Local time and UTC Time
    5. Setting a specific date
    6. Setting a date with Date methods
    7. Adding (or subtracting) date and time
    8. Comparing Dates and times
    9. ๐Ÿ› ๏ธ Datepicker: HTML and CSS
    10. ๐Ÿ› ๏ธ Datepicker: Building the calendar
    11. ๐Ÿ› ๏ธ Datepicker: Building the datepicker with JavaScript
    12. ๐Ÿ› ๏ธ Datepicker: Previous and Next buttons
    13. ๐Ÿ› ๏ธ Datepicker: Selecting a date
    14. ๐Ÿ› ๏ธ Datepicker: Positioning the datepicker
    15. ๐Ÿ› ๏ธ Datepicker: Showing and hiding
    16. Formatting a date with toLocaleString
    17. setTimeout
    18. setInterval
    19. ๐Ÿ› ๏ธ Countdown timer: HTML and CSS
    20. ๐Ÿ› ๏ธ Countdown timer: JavaScript
    21. ๐Ÿ› ๏ธ Countdown timer: Counting Months
    22. ๐Ÿ› ๏ธ Countdown timer: Daylight Saving Time
    23. ๐Ÿ› ๏ธ Countdown timer: Counting Years
  13. Async JS
    1. Introduction to Ajax
    2. Understanding JSON
    3. The Fetch API
    4. Possible data types
    5. JavaScript Promises
    6. Requests and responses
    7. Sending a POST request
    8. Authentication
    9. Handling errors
    10. Viewing response headers
    11. CORS and JSONP
    12. XHR vs Fetch
    13. Using an Ajax library
    14. Reading API documentation
    15. Understanding curl
    16. ๐Ÿ› ๏ธ Todolist: The Todolist API
    17. ๐Ÿ› ๏ธ Todolist: Fetching tasks
    18. ๐Ÿ› ๏ธ Todolist: Creating tasks
    19. ๐Ÿ› ๏ธ Todolist: Editing tasks
    20. ๐Ÿ› ๏ธ Todolist: Deleting tasks
    21. ๐Ÿ› ๏ธ Todolist: Creating tasks with Optimistic UI
    22. ๐Ÿ› ๏ธ Todolist: Handling Optimistic UI errors
    23. ๐Ÿ› ๏ธ Todolist: Editing tasks with Optimistic UI
    24. ๐Ÿ› ๏ธ Todolist: Deleting tasks with Optimistic UI
    25. ๐Ÿ› ๏ธ Todolist: Refactor
    26. ๐Ÿ› ๏ธ Typeahead: How to add Ajax
    27. ๐Ÿ› ๏ธ Typeahead: Adding Ajax
    28. ๐Ÿ› ๏ธ Typeahead: Handling errors
    29. ๐Ÿ› ๏ธ Google Maps Clone: Creating your first Google Map
    30. ๐Ÿ› ๏ธ Google Maps Clone: Fetching JSONP via JavaScript
    31. ๐Ÿ› ๏ธ Google Maps Clone: Drawing directions
    32. ๐Ÿ› ๏ธ Google Maps Clone: Driving directions
    33. ๐Ÿ› ๏ธ Google Maps Clone: Handling errors
    34. ๐Ÿ› ๏ธ Google Maps Clone: Adding stopovers
    35. ๐Ÿ› ๏ธ Google Maps Clone: Refactor
  14. Advanced Async JS
    1. Requesting many resources at once
    2. Asynchronous functions
    3. Handling multiple awaits
    4. Asynchronous loops
    5. ๐Ÿ› ๏ธ Dota Heroes: Listing heroes
    6. ๐Ÿ› ๏ธ Dota Heroes: Filtering heroes (Part 1)
    7. ๐Ÿ› ๏ธ Dota Heroes: Filtering heroes (Part 2)
    8. ๐Ÿ› ๏ธ Dota Heroes: Refactoring
    9. ๐Ÿ› ๏ธ Dota Heroes: Hero Page
    10. ๐Ÿ› ๏ธ Dota Heroes: Making the hero page robust
    11. ๐Ÿ› ๏ธ Dota Heroes: Heroes page refactor
  15. Handling Keyboard Events
    1. Keyboard users
    2. Handling commonly used keys
    3. Keyboard events
    4. Understanding Tabindex
    5. Detecting the focused element
    6. Directing focus
    7. Preventing people from tabbing into elements
    8. How to choose keyboard shortcuts
    9. Creating single-key shortcuts
    10. ๐Ÿ› ๏ธ Off-canvas: Adding keyboard interaction
    11. ๐Ÿ› ๏ธ Modal: Adding keyboard interaction
    12. ๐Ÿ› ๏ธ Accordion: Adding keyboard interaction
    13. ๐Ÿ› ๏ธ Tabby: Adding keyboard interaction
    14. ๐Ÿ› ๏ธ Tabby: Refactoring
    15. ๐Ÿ› ๏ธ Carousel: Adding keyboard interaction
    16. ๐Ÿ› ๏ธ Carousel: Displaying help text
    17. ๐Ÿ› ๏ธ Calculator: Adding keyboard interaction
    18. ๐Ÿ› ๏ธ Popover: Keyboard
    19. ๐Ÿ› ๏ธ Popover: Refactor
    20. Keyboard shortcuts with Command and Control modifiers
    21. ๐Ÿ› ๏ธ Todolist: Keyboard
    22. ๐Ÿ› ๏ธ Typeahead: Keyboard
    23. ๐Ÿ› ๏ธ Typeahead: Selecting a prediction with the keyboard
    24. ๐Ÿ› ๏ธ Google Maps Clone: Keyboard
    25. ๐Ÿ› ๏ธ Dota Heroes: Keyboard
    26. ๐Ÿ› ๏ธ Datepicker: Tabbing in and out
    27. ๐Ÿ› ๏ธ Datepicker: Keyboard shortcuts
  16. Screen reader accessibility
    1. What is accessibility?
    2. How to use a screen reader
    3. Using NVDA
    4. Using Voiceover
    5. Aria roles
    6. Landmark roles
    7. Document structure roles
    8. Live region roles
    9. Widget roles
    10. Window and Abstract roles
    11. Accessible names and descriptions
    12. Hiding content
    13. ARIA properties and ARIA states
    14. ARIA for expandable widgets
    15. ๐Ÿ› ๏ธ Off-canvas: Accessibility
    16. ARIA for modal dialogs
    17. ๐Ÿ› ๏ธ Modal: Screen reader accessibility
    18. ๐Ÿ› ๏ธ Accordion: Screen reader accessibility
    19. ARIA for Tabbed components
    20. ๐Ÿ› ๏ธ Tabby: Screen reader accessibility
    21. ๐Ÿ› ๏ธ Tabby: Refactor
    22. ๐Ÿ› ๏ธ Carousel: Screen reader accessibility
    23. Roles that trigger Forms and Application modes
    24. What's next for accessibility?
  17. Handling Scroll
    1. The Scroll event
    2. ๐Ÿ› ๏ธ Auto-hiding Sticky-nav: HTML and CSS
    3. ๐Ÿ› ๏ธ Auto-hiding Sticky-nav: JavaScript
    4. ๐Ÿ› ๏ธ Auto-hiding Sticky-nav: Natural reveal
    5. Intersection Observer API
    6. Intersection Observer Options
    7. ๐Ÿ› ๏ธ Slide & Reveal
    8. ๐Ÿ› ๏ธ Slide & Reveal: Always fade-in when you scroll down
    9. ๐Ÿ› ๏ธ Slide & Reveal: Fine-tuning the animation
    10. ๐Ÿ› ๏ธ Infinite Scroll: Anatomy
    11. ๐Ÿ› ๏ธ Infinite Scroll: Infinite load
    12. ๐Ÿ› ๏ธ Infinite Scroll: Refactor
    13. ๐Ÿ› ๏ธ Infinite Scroll: Implementing the Infinite Scroll
  18. Mouse, Touch, and Pointer events
    1. Mouse Events
    2. ๐Ÿ› ๏ธ Spinning Pacman: HTML and CSS
    3. ๐Ÿ› ๏ธ Spinning Pacman: JavaScript
    4. Touch events
    5. Pointer events
    6. Touch-action
    7. ๐Ÿ› ๏ธ Spinning Pacman: Supporting Touch
    8. Cloning elements
    9. ๐Ÿ› ๏ธ DragDrop: HTML and CSS
    10. ๐Ÿ› ๏ธ DragDrop: JavaScript
    11. ๐Ÿ› ๏ธ DragDrop: Creating a drop preview
    12. ๐Ÿ› ๏ธ DragDrop: Sortable drop preview
    13. ๐Ÿ› ๏ธ DragDrop: Robustness
    14. ๐Ÿ› ๏ธ DragDrop: Refactor
  19. Object Oriented Programming
    1. Before we begin
    2. What is Object Oriented Programming?
    3. Four Flavours of Object Oriented Programming
    4. Inheritance
    5. This in JavaScript
    6. Call, bind, apply
    7. Creating Derivative Objects
    8. Composition vs Inheritance
    9. Polymorphism
    10. Encapsulation
    11. Closures
    12. Encapsulation in Object Oriented Programming
    13. Getters and Setters
    14. What OOP flavour to use
    15. When to use Object Oriented Programming
  20. Writing reusable code
    1. Creating reusable code by writing libraries
    2. Two Types of libraries
    3. Including libraries with Script tags
    4. Including libraries with ES6 Modules
    5. Dynamic imports
    6. ๐Ÿ› ๏ธ Off Canvas: Building a Library
    7. ๐Ÿ› ๏ธ Modal: Library setup
    8. ๐Ÿ› ๏ธ Modal: Opening the Modal
    9. ๐Ÿ› ๏ธ Modal: Closing the modal
    10. ๐Ÿ› ๏ธ Modal: Inheritance and Polymorphism
    11. ๐Ÿ› ๏ธ Modal: Resolving differences between subclasses
    12. ๐Ÿ› ๏ธ Modal: Exposing properties and methods
    13. ๐Ÿ› ๏ธ Accordion: Building a library
    14. ๐Ÿ› ๏ธ Tabby: Building a library
    15. ๐Ÿ› ๏ธ Carousel: Building a library
    16. ๐Ÿ› ๏ธ Calculator: Library
    17. ๐Ÿ› ๏ธ Calculator: Fixing the Clear Key
    18. ๐Ÿ› ๏ธ Calculator: Handling other keys
    19. ๐Ÿ› ๏ธ Calculator: State
    20. ๐Ÿ› ๏ธ Popover: Library
    21. ๐Ÿ› ๏ธ Popover: Adding event listeners
    22. ๐Ÿ› ๏ธ Typeahead: Library
    23. ๐Ÿ› ๏ธ DatePicker: Library
  21. Going from Vanilla JS to JS Frameworks
    1. ๐Ÿ› ๏ธ Building a Tiny framework
    2. ๐Ÿ› ๏ธ Tiny: Add event listeners
    3. ๐Ÿ› ๏ธ Tiny: Updating state
    4. ๐Ÿ› ๏ธ Tiny: Rendering Child Components
    5. ๐Ÿ› ๏ธ Tiny: Changing Parent State
    6. ๐Ÿ› ๏ธ Tiny: Passing Props
    7. ๐Ÿ› ๏ธ Tiny: Multiple Props
    8. ๐Ÿ› ๏ธ Tiny: Passing values from sibling components
    9. ๐Ÿ› ๏ธ Tiny: Mounting
    10. ๐Ÿ› ๏ธ Tiny: Passing props to descendants
    11. ๐Ÿ› ๏ธ Tiny: A tiny refactor
  22. Single Page Apps
    1. What is a Single Page App?
    2. Simple SPA using only CSS
    3. The Location Interface
    4. The History Interface
    5. Minimum viable server for a SPA
    6. ๐Ÿ› ๏ธ Dota SPA: Introduction
    7. ๐Ÿ› ๏ธ Dota SPA: Building The Heroes List
    8. ๐Ÿ› ๏ธ Dota SPA: Building the filters
    9. ๐Ÿ› ๏ธ Dota SPA: Filtering heroes
    10. ๐Ÿ› ๏ธ Dota SPA: Displaying filtered heroes
    11. ๐Ÿ› ๏ธ Dota SPA: Getting Ready to build the Hero Page
    12. ๐Ÿ› ๏ธ Dota SPA: Building the hero page
    13. ๐Ÿ› ๏ธ Dota SPA: Lore and abilities
    14. ๐Ÿ› ๏ธ Dota SPA: Routing for Single-page apps

๐Ÿ› ๏ธ Carousel: Building a library

Weโ€™ll start refactoring the Carousel by creating a carousel.js file. Make sure you link this carousel.js file to main.js.

<script type="module" src="js/main.js"></script>
import './carousel.js'

Multiple carousels can be used on the same page. Hereโ€™s one example (which I helped build a long time ago).

If we want to support multiple carousel instances, we need to find these 8 variables for each carousel that appears on the page.

const carousel = document.querySelector('.carousel')
const previousButton = carousel.querySelector('.previous-button')
const nextButton = carousel.querySelector('.next-button')
const contents = carousel.querySelector('.carousel__contents')
const slides = [...carousel.querySelectorAll('.carousel__slide')]
const dotsContainer = createDots(slides)
const dots = [...dotsContainer.children]
const liveregion = carousel.querySelector('[role="status"]')

Did you notice the last 7 variables all depend on carousel? We can easily create multiple instances with a forEach loop.

const carousels = [...document.querySelectorAll('.carousel')]
carousels.forEach(carousel => {
const previousButton = carousel.querySelector('.previous-button')
const nextButton = carousel.querySelector('.next-button')
const contents = carousel.querySelector('.carousel__contents')
const slides = [...carousel.querySelectorAll('.carousel__slide')]
const dotsContainer = createDots(slides)
const dots = [...dotsContainer.children]
const liveregion = carousel.querySelector('[role="status"]')
// All functions here
// All event listeners here
})

Of course, we should check whether a carousel is present in the first place. Weโ€™ll only execute the code if carousels are present (so there wonโ€™t be errors).

const carousels = [...document.querySelectorAll('.carousel')]
if (carousels.length > 0) {
// Do stuff
}

At this point, the carousel should still function as normal.

The Carouselโ€™s code is really hard to read at this point. Functions are all over the place, and the code doesnโ€™t seem to have any structure.

We can make this code easier to read by using Object Oriented Programming. We will use Factory Functions for this component.

My favourite way of structuring components with Object Oriented Programming (with the Factory Function Flavour) is in the following format:

function ComponentName() {
// Declare Private Variables
// Declare component state (if required)
const component = {
// Declare methods
// Declare event listeners
}
// Initialize the component
// Add event listeners here as necessary
// Return the component
return component
}

Creating the Blueprint

Weโ€™ll start by creating a Carousel function to hold create carousels.

function Carousel() {
// Do stuff
}

We can then create each carousel instance by calling Carousel.

if (carousels.length > 0) {
carousels.forEach(carousel => {
Carousel(carousel)
})
}

Thatโ€™s all you need to do for an Automatic Library.

Manual Libraries

If youโ€™re creating a Manual Library, you can export Carousel. Then create the instances inside main.js.

export default function Carousel() {
// Do stuff
}

We can then create each carousel instance by calling Carousel.

main.js
const carousels = [...document.querySelectorAll('.carousel')]
if (carousels.length > 0) {
carousels.forEach(carousel => {
Carousel(carousel)
})
}

We rely on users to create the HTML for the Carousel. This means we need them to pass in the carousel element. Weโ€™ll name this variable carouselElement to make it clear for us.

carousel.js
export default function Carousel(carouselElement) {
// ...
}

We then derive the rest of the variables we need from this carouselElement.

export default function Carousel(carouselElement) {
const contents = carouselElement.querySelector('.carousel__contents')
const slides = [...carouselElement.querySelectorAll('.carousel__slide')]
const previousButton = carouselElement.querySelector('.previous-button')
const nextButton = carouselElement.querySelector('.next-button')
const liveregion = carouselElement.querySelector('[role="status"]')
const dotsContainer = createDots(slides)
const dots = [...dotsContainer.children]
}

Notice that dotsContainer needs a createDots function. We can copy-paste createDots into carousel.js.

carousel.js
export default function Carousel(carouselElement) {
/* ... */
}
function createDots(slides) {
const dotsContainer = document.createElement('div')
dotsContainer.classList.add('carousel__dots')
dotsContainer.setAttribute('aria-hidden', true)
slides.forEach(slide => {
const dot = document.createElement('button')
dot.classList.add('carousel__dot')
dot.setAttribute('tabindex', -1)
if (slide.classList.contains('is-selected')) {
dot.classList.add('is-selected')
}
dotsContainer.appendChild(dot)
})
return dotsContainer
}

After we create dotsContainer, we need to add it to the carousel.

export default function Carousel(carouselElement) {
// ...
const dotsContainer = createDots(slides)
const dots = [...dotsContainer.children]
carouselElement.appendChild(dotsContainer)
}

We also need to set the width and position of each slide.

export default function Carousel(carouselElement) {
// ...
carouselElement.appendChild(dotsContainer)
setSlidePositions(slides)
}

We need to use setSlidePositions here, so go ahead and copy-paste setSlidePositions into carousel.js.

carousel.js
export default function Carousel(carouselElement) {
/* ... */
}
function createDots(slides) {
/* ... */
}
function setSlidePositions(slides) {
const slideWidth = slides[0].getBoundingClientRect().width
slides.forEach((slide, index) => {
slide.style.left = slideWidth * index + 'px'
})
}

Next, we want to add event listeners.

Adding Event Listeners

Since we only have one variation for this carousel, we can add the event listeners directly inside Carousel.

export default function Carousel(carouselElement) {
// Declare variables
// Initialize Carousel
// Add event listeners
}

Weโ€™ll add the event listeners one by one.

Next Button Event Listener

We will start with the nextButtonโ€™s event listener. Go ahead and copy-paste everything we wrote into Carousel.

export default function Carousel(carouselElement) {
// ...
nextButton.addEventListener('click', event => {
const currentSlideIndex = getCurrentSlideIndex()
const nextSlideIndex = currentSlideIndex + 1
switchSlide(currentSlideIndex, nextSlideIndex)
})
}

We can see that this event listener needs getCurrentSlideIndex and switchSlide. Weโ€™ll work through them one by one.

Hereโ€™s what we wrote for getCurrentSlideIndex previously. If you examine the code closely, youโ€™ll see we need contents and slides variables to work.

function getCurrentSlideIndex() {
const currentSlide = contents.querySelector('.is-selected')
return slides.findIndex(slide => slide === currentSlide)
}

Since each Carousel instance has their own contents and slides, it make sense for us to create getCurrentSlideIndex inside Carousel. If we do this, contents and slides will be available in the lexical scope.

I prefer to put functions like getCurrentSlideIndex as methods to the component. The additional indentation makes it easy to understand the structure at a glance.

export default function Carousel(carouselElement) {
// Declare variables
const carousel = {
getCurrentSlideIndex() {
const currentSlide = contents.querySelector('.is-selected')
return slides.findIndex(slide => slide === currentSlide)
},
}
// Initialize Carousel
// Add event listeners
}

We can use getCurrentSlideIndex like this. Notice I used the carousel object instead of this so we wonโ€™t have to deal with contexts where the value of this changes to something else.

export default function Carousel(carouselElement) {
// ...
nextButton.addEventListener('click', event => {
const currentSlideIndex = carousel.getCurrentSlideIndex()
// ...
})
}

We can do the same thing with switchSlide.

export default function Carousel(carouselElement) {
// Declare variables
const carousel = {
getCurrentSlideIndex() {
const currentSlide = contents.querySelector('.is-selected')
return slides.findIndex(slide => slide === currentSlide)
},
switchSlide(currentSlideIndex, targetSlideIndex) {
// Copy-paste the code we wrote here
},
}
// Initialize Carousel
// Add event listeners
}

Hereโ€™s how we use switchSlide.

export default function Carousel(carouselElement) {
// ...
nextButton.addEventListener('click', event => {
// ...
carousel.switchSlide(currentSlideIndex, nextSlideIndex)
})
}

Reorganising the event listener

When you look at nextButtonโ€™s event listener, do you intuitively know what it does? Probably not. You have to read the code and figure out it changes to the next slide.

We can make this process easier to understand by creating a showNextSlide callback for this event listener. Weโ€™ll put this callback inside carousel.

export default function Carousel(carouselElement) {
// Declare variables
const carousel = {
// Methods ...
// Listeners
showNextSlide() {
const currentSlideIndex = carousel.getCurrentSlideIndex()
const nextSlideIndex = currentSlideIndex + 1
carousel.switchSlide(currentSlideIndex, nextSlideIndex)
},
}
// Initialize Carousel
// Add event listeners
}

We can then use showNextSlide like this:

export default function Carousel(carouselElement) {
// ...
nextButton.addEventListener('click', carousel.showNextSlide)
}

Previous buttonโ€™s event listener

We can use the same process above to create the previous buttonโ€™s event listener.

First, we will copy-paste the event listener into Carousel.

export default function Carousel(carouselElement) {
// ...
previousButton.addEventListener('click', event => {
const currentSlideIndex = getCurrentSlideIndex()
const previousSlideIndex = currentSlideIndex - 1
switchSlide(currentSlideIndex, previousSlideIndex)
})
}

Weโ€™ll update the function to use carousel.getCurrentSlideIndex and carousel.switchSlide.

export default function Carousel(carouselElement) {
// ...
previousButton.addEventListener('click', event => {
const currentSlideIndex = carousel.getCurrentSlideIndex()
const previousSlideIndex = currentSlideIndex - 1
carousel.switchSlide(currentSlideIndex, previousSlideIndex)
})
}

Finally, we will create a showPreviousSlide callback for this event listener. It makes the code easier to read.

export default function Carousel(carouselElement) {
// Declare variables
const carousel = {
// Methods ...
// Listeners
showNextSlide() {
/* ... */
},
showPreviousSlide() {
const currentSlideIndex = carousel.getCurrentSlideIndex()()
const previousSlideIndex = currentSlideIndex - 1
carousel.switchSlide(currentSlideIndex, previousSlideIndex)
},
}
// Initialize Carousel
// Add event listeners
}

Dots Event Listener

Next, we have an event listener that handles a click on each dot. Hereโ€™s the code we wrote previously:

dotsContainer.addEventListener('click', event => {
const dot = event.target.closest('button')
if (!dot) return
const currentSlideIndex = getCurrentSlideIndex()
const targetSlideIndex = dots.findIndex(d => d === dot)
switchSlide(currentSlideIndex, targetSlideIndex)
})

You know the drill at this point.

  1. We will copy-paste this code into Carousel.
  2. Update this code to use carousel.getCurrentSlideIndex and carousel.switchSlide
  3. Create a named callback function. Weโ€™ll call this callback handleClicksOnDots.
export default function Carousel(carouselElement) {
// Declare variables
const carousel = {
// Methods ...
// Listeners
showNextSlide() {
/* ... */
},
showPreviousSlide() {
/* ... */
},
handleClicksOnDots(event) {
const dot = event.target.closest('button')
if (!dot) return
const currentSlideIndex = carousel.getCurrentSlideIndex()
const targetSlideIndex = dots.findIndex(d => d === dot)
carousel.switchSlide(currentSlideIndex, targetSlideIndex)
},
}
// ...
dotsContainer.addEventListener('click', carousel.handleClicksOnDots)
}

Handle Left and Right arrow keys

We have one last event listener where we allowed users to switch slides with left and right arrow keys. Hereโ€™s what we wrote previously:

contents.addEventListener('keydown', event => {
const { key } = event
if (key !== 'ArrowLeft' && key !== 'ArrowRight') return
const currentSlideIndex = getCurrentSlideIndex()
let targetSlideIndex
if (key === 'ArrowLeft') targetSlideIndex = currentSlideIndex - 1
if (key === 'ArrowRight') targetSlideIndex = currentSlideIndex + 1
if (targetSlideIndex < 0) targetSlideIndex = 0
if (targetSlideIndex > slides.length - 1) targetSlideIndex = slides.length - 1
switchSlide(currentSlideIndex, targetSlideIndex)
// Focus on the correct slide
const targetLink = slides[targetSlideIndex].querySelector('a')
targetLink.focus({ preventScroll: true })
// Fallback for preventScroll
setTimeout(() => {
contents.parentElement.scrollLeft = 0
}, 0)
})

Same drill applies.

export default function Carousel(carouselElement) {
// Declare variables
const carousel = {
// Methods ...
// Listeners
showNextSlide() {
/* ... */
},
showPreviousSlide() {
/* ... */
},
handleClicksOnDots(event) {
/* ... */
},
handleKeydown(event) {
const { key } = event
if (key !== 'ArrowLeft' && key !== 'ArrowRight') return
const currentSlideIndex = carousel.getCurrentSlideIndex()
let targetSlideIndex
if (key === 'ArrowLeft') targetSlideIndex = currentSlideIndex - 1
if (key === 'ArrowRight') targetSlideIndex = currentSlideIndex + 1
if (targetSlideIndex < 0) targetSlideIndex = 0
if (targetSlideIndex > slides.length - 1)
targetSlideIndex = slides.length - 1
carousel.switchSlide(currentSlideIndex, targetSlideIndex)
// Focus on the correct slide
const targetLink = slides[targetSlideIndex].querySelector('a')
targetLink.focus({ preventScroll: true })
// Fallback for preventScroll
setTimeout(() => {
contents.parentElement.scrollLeft = 0
}, 0)
},
}
// ...
contents.addEventListener('keydown', carousel.handleKeydown)
}

Weโ€™re almost done. Thereโ€™s only one more improvement to make.

Using a Getter function

Did you notice that getCurrentSlideIndex is a function?

export default function Carousel(carouselElement) {
// ...
const carousel = {
getCurrentSlideIndex() {
const currentSlide = contents.querySelector('.is-selected')
return slides.findIndex(slide => slide === currentSlide)
},
// ...
}
// ...
}

Since we put getCurrentSlideIndex into an object. And since weโ€™re using it to get a value, we can use a Getter function instead.

export default function Carousel(carouselElement) {
// ...
const carousel = {
get currentSlideIndex() {
const currentSlide = contents.querySelector('.is-selected')
return slides.findIndex(slide => slide === currentSlide)
},
// ...
}
// ...
}

This lets us get the current slide index with the dot notation.

// Before
const currentSlideIndex = carousel.getCurrentSlideIndex()
// After
const currentSlideIndex = carousel.currentSlideIndex

Thatโ€™s it!