Change actions tutorial

site/content/tutorial/12-actions/01-actions/app-a/App.svelte

@@ -1,26 +1,10 @@
 <script>
-	import { spring } from 'svelte/motion';
 
-	const coords = spring({ x: 0, y: 0 }, {
-		stiffness: 0.2,
-		damping: 0.4
-	});
 	
-	function handlePanStart() {
+	let showModal = true;
-		coords.stiffness = coords.damping = 1;
-	}
-
-	function handlePanMove(event) {
-		coords.update($coords => ({
-			x: $coords.x + event.detail.dx,
-			y: $coords.y + event.detail.dy
-		}));
-	}
 
-	function handlePanEnd(event) {
+	function handleOutclick(){
-		coords.stiffness = 0.2;
+		showModal = false;
-		coords.damping = 0.4;
-		coords.set({ x: 0, y: 0 });
 	}
 </script>
 
@@ -35,15 +19,15 @@
 		top: calc(50% - var(--height) / 2);
 		border-radius: 4px;
 		background-color: #ff3e00;
-		cursor: move;
+		color: #fff;
+		text-align: center;
+		font-style: bold;
 	}
 </style>
 
-<div class="box"
+<button on:click={() => (showModal = true)}>Show Modal</button>
-	on:panstart={handlePanStart}
+{#if showModal}
-	on:panmove={handlePanMove}
+	<div class="box" on:outclick={handleOutclick}>
-	on:panend={handlePanEnd}
+		Click outside me!
-	style="transform:
+	</div>
-		translate({$coords.x}px,{$coords.y}px)
+{/if}
-		rotate({$coords.x * 0.2}deg)"
-></div>

site/content/tutorial/12-actions/01-actions/app-a/pannable.js

@@ -1,9 +1,9 @@
-export function pannable(node) {
+export function clickOutside(node) {
 	// setup work goes here...
 
 	return {
 		destroy() {
 			// ...cleanup goes here
-		}
+		},
+	};
 };
-}

site/content/tutorial/12-actions/01-actions/app-b/App.svelte

@@ -1,27 +1,10 @@
 <script>
-	import { spring } from 'svelte/motion';
+	import { clickOutside } from "./pannable.js";
-	import { pannable } from './pannable.js';
 
-	const coords = spring({ x: 0, y: 0 }, {
+	let showModal = true;
-		stiffness: 0.2,
-		damping: 0.4
-	});
 
-	function handlePanStart() {
+	function handleOutclick(){
-		coords.stiffness = coords.damping = 1;
+		showModal = false;
-	}
-
-	function handlePanMove(event) {
-		coords.update($coords => ({
-			x: $coords.x + event.detail.dx,
-			y: $coords.y + event.detail.dy
-		}));
-	}
-
-	function handlePanEnd(event) {
-		coords.stiffness = 0.2;
-		coords.damping = 0.4;
-		coords.set({ x: 0, y: 0 });
 	}
 </script>
 
@@ -36,16 +19,15 @@
 		top: calc(50% - var(--height) / 2);
 		border-radius: 4px;
 		background-color: #ff3e00;
-		cursor: move;
+		color: #fff;
+		text-align: center;
+		font-style: bold;
 	}
 </style>
 
-<div class="box"
+<button on:click={() => (showModal = true)}>Show Modal</button>
-	use:pannable
+{#if showModal}
-	on:panstart={handlePanStart}
+	<div class="box" use:clickOutside on:outclick={handleOutclick}>
-	on:panmove={handlePanMove}
+		Click outside me!
-	on:panend={handlePanEnd}
+	</div>
-	style="transform:
+{/if}
-		translate({$coords.x}px,{$coords.y}px)
-		rotate({$coords.x * 0.2}deg)"
-></div>

site/content/tutorial/12-actions/01-actions/app-b/pannable.js

@@ -1,47 +1,15 @@
-export function pannable(node) {
+export function clickOutside(node) {
-	let x;
+	const handleClick = (event) => {
-	let y;
+		if (!node.contains(event.target)) {
-
+			node.dispatchEvent(new CustomEvent("outclick"));
-	function handleMousedown(event) {
-		x = event.clientX;
-		y = event.clientY;
-
-		node.dispatchEvent(new CustomEvent('panstart', {
-			detail: { x, y }
-		}));
-
-		window.addEventListener('mousemove', handleMousemove);
-		window.addEventListener('mouseup', handleMouseup);
-	}
-
-	function handleMousemove(event) {
-		const dx = event.clientX - x;
-		const dy = event.clientY - y;
-		x = event.clientX;
-		y = event.clientY;
-
-		node.dispatchEvent(new CustomEvent('panmove', {
-			detail: { x, y, dx, dy }
-		}));
-	}
-
-	function handleMouseup(event) {
-		x = event.clientX;
-		y = event.clientY;
-
-		node.dispatchEvent(new CustomEvent('panend', {
-			detail: { x, y }
-		}));
-
-		window.removeEventListener('mousemove', handleMousemove);
-		window.removeEventListener('mouseup', handleMouseup);
 		}
+	};
 
-	node.addEventListener('mousedown', handleMousedown);
+	document.addEventListener("click", handleClick, true);
 
 	return {
 		destroy() {
-			node.removeEventListener('mousedown', handleMousedown);
+			document.removeEventListener("click", handleClick, true);
-		}
+		},
+	};
 };
-}

site/content/tutorial/12-actions/01-actions/text.md

@@ -4,85 +4,45 @@ title: The use directive
 
 Actions are essentially element-level lifecycle functions. They're useful for things like:
 
-* interfacing with third-party libraries
+- interfacing with third-party libraries
-* lazy-loaded images
+- lazy-loaded images
-* tooltips
+- tooltips
-* adding custom event handlers
+- adding custom event handlers
 
-In this app, we want to make the orange box 'pannable'. It has event handlers for the `panstart`, `panmove` and `panend` events, but these aren't native DOM events. We have to dispatch them ourselves. First, import the `pannable` function...
+In this app, we want to make the orange modal close when the user clicks outside it. It has an event handler for the `outclick` event, but it isn't a native DOM event. We have to dispatch it ourselves. First, import the `clickOutside` function...
 
 ```js
-import { pannable } from './pannable.js';
+import { clickOutside } from "./pannable.js";
 ```
 
 ...then use it with the element:
 
 ```html
-<div class="box"
+<div class="box" use:clickOutside on:outclick="{handleOutclick}">
-	use:pannable
+	Click outside me!
-	on:panstart={handlePanStart}
+</div>
-	on:panmove={handlePanMove}
-	on:panend={handlePanEnd}
-	style="transform:
-		translate({$coords.x}px,{$coords.y}px)
-		rotate({$coords.x * 0.2}deg)"
-></div>
 ```
 
-Open the `pannable.js` file. Like transition functions, an action function receives a `node` and some optional parameters, and returns an action object. That object can have a `destroy` function, which is called when the element is unmounted.
+Open the `click_outside.js` file. Like transition functions, an action function receives a `node` (which is the element that the action is applied to) and some optional parameters, and returns an action object. That object can have a `destroy` function, which is called when the element is unmounted.
 
-We want to fire `panstart` event when the user mouses down on the element, `panmove` events (with `dx` and `dy` properties showing how far the mouse moved) when they drag it, and `panend` events when they mouse up. One possible implementation looks like this:
+We want to fire the `outclick` event when the user clicks outside the orange box. One possible implementation looks like this:
 
 ```js
-export function pannable(node) {
+export function clickOutside(node) {
-	let x;
+	const handleClick = (event) => {
-	let y;
+		if (!node.contains(event.target)) {
-
+			node.dispatchEvent(new CustomEvent("outclick"));
-	function handleMousedown(event) {
-		x = event.clientX;
-		y = event.clientY;
-
-		node.dispatchEvent(new CustomEvent('panstart', {
-			detail: { x, y }
-		}));
-
-		window.addEventListener('mousemove', handleMousemove);
-		window.addEventListener('mouseup', handleMouseup);
-	}
-
-	function handleMousemove(event) {
-		const dx = event.clientX - x;
-		const dy = event.clientY - y;
-		x = event.clientX;
-		y = event.clientY;
-
-		node.dispatchEvent(new CustomEvent('panmove', {
-			detail: { x, y, dx, dy }
-		}));
-	}
-
-	function handleMouseup(event) {
-		x = event.clientX;
-		y = event.clientY;
-
-		node.dispatchEvent(new CustomEvent('panend', {
-			detail: { x, y }
-		}));
-
-		window.removeEventListener('mousemove', handleMousemove);
-		window.removeEventListener('mouseup', handleMouseup);
 		}
+	};
 
-	node.addEventListener('mousedown', handleMousedown);
+	document.addEventListener("click", handleClick, true);
 
 	return {
 		destroy() {
-			node.removeEventListener('mousedown', handleMousedown);
+			document.removeEventListener("click", handleClick, true);
-		}
+		},
 	};
 }
 ```
 
-Update the `pannable` function and try moving the box around.
+Update the `clickOutside` function, click the button to show the modal and then click outside it to close it.
-
-> This implementation is for demonstration purposes — a more complete one would also consider touch events.