Tutoriel Technique · Itération 4 (Semaine 13)

Programmer un configurateur à URL adressable et un panier vivant en Drag & Drop

JavaScript 100 % vanille (URLSearchParams, history.replaceState, API HTML5 Drag and Drop, fetch JSON) + Architecture PHP MVC (PHP Filters et DAO PDO).

Vue d'ensemble de l'architecture

Ce tutoriel auto-portant vous donne toutes les briques de code pour réaliser le volet CONFIGURATEUR + PANIER sans aucune librairie externe :

  1. Étape 1 (Le Configurateur réactif et son URL adressable) : modifier l'aperçu visuel et le prix en direct, pousser les paramètres dans l'URL avec history.replaceState(), et relire l'URL au chargement (en PHP et en JS).
  2. Étape 2 (Le Glisser-Déposer natif HTML5 + Ergonomie) : implémenter les 4 événements du Drag & Drop (dragstart, dragover, dragleave, drop) avec les affordances visuelles et l'alternative bouton/clavier.
  3. Étape 3 (La Synchronisation Ajax fetch + JSON avec le serveur MVC) : envoyer le produit configuré ou l'article glissé au serveur en POST, recalculer le prix de manière sécuritaire côté PHP (filter_var + PDO préparé), et rafraîchir le panier vivant sans recharger la page.

ÉTAPE 1 Le configurateur réactif et son URL adressable

Dans un bon configurateur, chaque fois que le client choisit une option (couleur, matériau, taille, garniture), trois choses se produisent simultanément sans recharger la page :

1.1 Lecture initiale des paramètres côté PHP (avec PHP Filters)

Lorsque la page se charge pour la première fois, votre contrôleur PHP lit les paramètres de l'URL avec filter_input_array(INPUT_GET, ...) et applique des valeurs par défaut sûres :

<?php
// Dans le contrôleur de la page du configurateur (ex: configurateur.php)
$filtresUrl = array(
    'base'    => FILTER_SANITIZE_SPECIAL_CHARS,
    'glacage' => FILTER_SANITIZE_SPECIAL_CHARS,
    'deco'    => FILTER_SANITIZE_SPECIAL_CHARS
);
$optionsUrl = filter_input_array(INPUT_GET, $filtresUrl) ?: array();

$baseChoisie    = $optionsUrl['base']    ?? 'vanille';
$glacageChoisi  = $optionsUrl['glacage'] ?? 'framboise';
$decoChoisie    = $optionsUrl['deco']    ?? 'eclats-or';
?>

1.2 Le HTML sémantique du configurateur (avec attributs data-prix)

<section id="atelier-configurateur">
    <!-- Aperçu visuel en direct -->
    <div id="apercu-produit" data-base="<?= htmlspecialchars($baseChoisie) ?>"
                             data-glacage="<?= htmlspecialchars($glacageChoisi) ?>">
        <div class="calque-visuel" id="calque-base"></div>
        <div class="calque-visuel" id="calque-glacage"></div>
        <div class="calque-visuel" id="calque-deco"></div>
        <p class="prix-direct">Prix composé : <strong id="affichage-prix">5,50</strong> $</p>
    </div>

    <!-- Formulaire d'options -->
    <form id="formulaire-configurateur">
        <fieldset>
            <legend>1. Choisissez la base (4,00 $)</legend>
            <label>
                <input type="radio" name="base" value="vanille" data-prix="4.00"
                    <?= ($baseChoisie === 'vanille') ? 'checked' : '' ?>> Vanille Bourbon
            </label>
            <label>
                <input type="radio" name="base" value="chocolat" data-prix="4.50"
                    <?= ($baseChoisie === 'chocolat') ? 'checked' : '' ?>> Chocolat Noir (+0,50 $)
            </label>
        </fieldset>

        <fieldset>
            <legend>2. Choisissez le glaçage</legend>
            <label>
                <input type="radio" name="glacage" value="framboise" data-prix="1.00"
                    <?= ($glacageChoisi === 'framboise') ? 'checked' : '' ?>> Nuage Framboise (+1,00 $)
            </label>
            <label>
                <input type="radio" name="glacage" value="pistache" data-prix="1.50"
                    <?= ($glacageChoisi === 'pistache') ? 'checked' : '' ?>> Crème Pistache (+1,50 $)
            </label>
        </fieldset>

        <fieldset>
            <legend>3. Finition décorative</legend>
            <select name="deco" id="choix-deco">
                <option value="aucune" data-prix="0.00" <?= ($decoChoisie === 'aucune') ? 'selected' : '' ?>>Aucune (+0,00 $)</option>
                <option value="eclats-or" data-prix="0.75" <?= ($decoChoisie === 'eclats-or') ? 'selected' : '' ?>>Éclats d'or (+0,75 $)</option>
            </select>
        </fieldset>
    </form>

    <!-- Carte glissable représentant le produit actuellement configuré -->
    <div id="carte-produit-compose" class="element-glissable" draggable="true"
         data-type="creation-sur-mesure">
        <span class="poignee" aria-hidden="true">⋮⋮</span>
        <strong id="resume-config">Création : Vanille · Framboise · Éclats d'or</strong>
        <button type="button" id="bouton-ajouter-config">+ Ajouter au panier</button>
    </div>
</section>

1.3 Le JavaScript vanille qui synchronise l'aperçu, le prix et l'URL

// fichier: js/configurateur.js
function lireConfigurationActuelle() {
    const formulaire = document.getElementById("formulaire-configurateur");
    const radioBase = formulaire.querySelector('input[name="base"]:checked');
    const radioGlacage = formulaire.querySelector('input[name="glacage"]:checked');
    const selectDeco = document.getElementById("choix-deco");
    const optionDeco = selectDeco.options[selectDeco.selectedIndex];

    const prixTotal = parseFloat(radioBase.dataset.prix)
                    + parseFloat(radioGlacage.dataset.prix)
                    + parseFloat(optionDeco.dataset.prix);

    return {
        base: radioBase.value,
        glacage: radioGlacage.value,
        deco: selectDeco.value,
        prix: prixTotal.toFixed(2)
    };
}

function mettreAJourConfigurateur() {
    const config = lireConfigurationActuelle();

    // 1. Mettre à jour l'aperçu visuel (attributs data-* utilisés par le CSS)
    const apercu = document.getElementById("apercu-produit");
    apercu.dataset.base = config.base;
    apercu.dataset.glacage = config.glacage;
    apercu.dataset.deco = config.deco;

    // 2. Mettre à jour le prix et le résumé de la carte glissable
    document.getElementById("affichage-prix").textContent = config.prix.replace(".", ",");
    document.getElementById("resume-config").textContent =
        "Création : " + config.base + " · " + config.glacage + " · " + config.deco;

    // 3. Rendre l'état adressable dans l'URL sans recharger la page !
    const parametres = new URLSearchParams();
    parametres.set("base", config.base);
    parametres.set("glacage", config.glacage);
    parametres.set("deco", config.deco);
    const nouvelleUrl = window.location.pathname + "?" + parametres.toString();
    window.history.replaceState(null, "", nouvelleUrl);
}

document.getElementById("formulaire-configurateur")
        .addEventListener("change", mettreAJourConfigurateur);
Pourquoi history.replaceState() est-il magique ? Il modifie l'adresse affichée en haut du navigateur en temps réel sans déclencher de requête HTTP. Si l'utilisateur ajoute la page à ses favoris ou envoie l'URL à un ami, votre code PHP de l'étape 1.1 lira le $_GET et reconstruira exactement le même produit !

ÉTAPE 2 Le Panier Vivant en Drag & Drop natif HTML5

L'API HTML5 Drag and Drop repose sur deux acteurs : l'élément glissable (qui porte l'attribut draggable="true") et la zone de dépôt (le panier vivant).

⚠️ Le piège n° 1 en HTML5 Drag & Drop : Par défaut, le navigateur interdit de déposer un élément sur une <div>. Pour qu'une zone accepte le dépôt (et que l'événement drop se déclenche), vous devez obligatoirement appeler evenement.preventDefault() dans l'écouteur dragover !

2.1 Le HTML et le CSS d'affordance (Poignée, Silhouette et États)

<!-- Zone du panier vivant (Cible de dépôt) -->
<aside id="panier-vivant" aria-label="Votre panier d'achat">
    <h2>🛒 Votre Panier</h2>

    <!-- Zone de dépôt avec silhouette en vidéo inversée -->
    <div id="zone-depot-panier" class="zone-depot">
        <div class="silhouette-inverse" aria-hidden="true">+</div>
        <p>Glissez votre création ou un article ici</p>
    </div>

    <!-- Liste des lignes du panier mise à jour en Ajax -->
    <div id="lignes-panier" aria-live="polite"></div>

    <div class="pied-panier">
        Total : <strong id="total-panier">0,00 $</strong>
    </div>
</aside>
/* CSS d'affordance (selon les 6 lois d'Amélie Boucher) */
.element-glissable {
    cursor: grab;
    user-select: none;
    transition: transform 0.15s ease, opacity 0.15s ease, box-shadow 0.15s ease;
}
.element-glissable:active {
    cursor: grabbing;
}
.element-glissable.en-glissement {
    opacity: 0.45;
    transform: scale(0.98);
}

.zone-depot {
    background: #e9e9f2;
    border: 3px dashed #8a8aa8;
    border-radius: 12px;
    padding: 18px;
    text-align: center;
    transition: background 0.15s ease, border-color 0.15s ease, transform 0.15s ease;
}
/* Silhouette blanche sur fond gris pâle (vidéo inversée) */
.silhouette-inverse {
    width: 46px;
    height: 46px;
    margin: 0 auto 8px;
    border-radius: 50%;
    background: #ffffff;
    color: #8a8aa8;
    font-size: 26px;
    line-height: 46px;
    font-weight: bold;
}
/* Quand un objet survole la zone de dépôt */
.zone-depot.survol-actif {
    background: #eefbf1;
    border-color: #1e7a38;
    transform: scale(1.02);
}

2.2 Les 4 événements JavaScript du Glisser-Déposer + le Fallback Clavier/Bouton

// fichier: js/panier-drag-drop.js
function preparerElementGlissable(element) {
    element.addEventListener("dragstart", function (evenement) {
        element.classList.add("en-glissement");

        // On prépare le paquet JSON à transporter jusqu'au panier
        let donneesArticle;
        if (element.dataset.type === "creation-sur-mesure") {
            donneesArticle = lireConfigurationActuelle();
            donneesArticle.type = "creation-sur-mesure";
        } else {
            donneesArticle = {
                type: "catalogue",
                idProduit: parseInt(element.dataset.idProduit, 10)
            };
        }

        evenement.dataTransfer.effectAllowed = "copy";
        evenement.dataTransfer.setData("application/json", JSON.stringify(donneesArticle));
    });

    element.addEventListener("dragend", function () {
        element.classList.remove("en-glissement");
    });
}

// Initialiser tous les éléments glissables de la page
document.querySelectorAll(".element-glissable").forEach(preparerElementGlissable);

// Configurer la zone de dépôt du panier
const zoneDepot = document.getElementById("zone-depot-panier");

zoneDepot.addEventListener("dragover", function (evenement) {
    evenement.preventDefault(); // OBLIGATOIRE pour autoriser le drop !
    evenement.dataTransfer.dropEffect = "copy";
    zoneDepot.classList.add("survol-actif");
});

zoneDepot.addEventListener("dragleave", function () {
    zoneDepot.classList.remove("survol-actif");
});

zoneDepot.addEventListener("drop", function (evenement) {
    evenement.preventDefault();
    zoneDepot.classList.remove("survol-actif");

    const texteJson = evenement.dataTransfer.getData("application/json");
    if (!texteJson) return;

    const articleDepose = JSON.parse(texteJson);
    envoyerAuPanierAjax(articleDepose);
});

// Fallback accessible obligatoire : le bouton [+ Ajouter au panier] appelle la MÊME fonction !
document.getElementById("bouton-ajouter-config").addEventListener("click", function () {
    const config = lireConfigurationActuelle();
    config.type = "creation-sur-mesure";
    envoyerAuPanierAjax(config);
});

ÉTAPE 3 La synchronisation Ajax (fetch + JSON) avec le serveur MVC

Lorsqu'un article est déposé dans le panier (ou ajouté au clic), JavaScript envoie une requête POST avec fetch() à votre point d'entrée PHP, puis rafraîchit le DOM du panier avec le JSON retourné.

3.1 L'envoi Ajax côté client (les 5 étapes de l'Ajax)

function envoyerAuPanierAjax(article) {
    fetch("api/ajouter-panier.php", {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
            "Accept": "application/json"
        },
        body: JSON.stringify(article)
    })
    .then(function (reponse) {
        if (!reponse.ok) {
            throw new Error("Erreur réseau lors de la mise à jour du panier");
        }
        return reponse.json();
    })
    .then(function (etatPanier) {
        afficherPanierDansDom(etatPanier);
    })
    .catch(function (erreur) {
        console.error(erreur);
        document.getElementById("lignes-panier").innerHTML =
            '<p class="erreur-reseau">Impossible de joindre le serveur. Veuillez réessayer.</p>';
    });
}

function afficherPanierDansDom(etatPanier) {
    const conteneur = document.getElementById("lignes-panier");
    conteneur.innerHTML = "";

    etatPanier.articles.forEach(function (item) {
        const ligne = document.createElement("div");
        ligne.className = "ligne-panier";
        ligne.textContent = item.quantite + "x " + item.libelle + " (" + item.sousTotal + " $)";
        conteneur.appendChild(ligne);
    });

    document.getElementById("total-panier").textContent = etatPanier.grandTotal + " $";
}

3.2 Le point d'entrée PHP côté serveur : Validation par PHP Filters & Recalcul officiel du prix

🔒 Règle d'or de sécurité e-commerce : Ne faites JAMAIS confiance au prix envoyé par le JavaScript du navigateur (un utilisateur malveillant peut modifier data-prix="0.01" dans l'inspecteur !). Le serveur PHP reçoit uniquement les identifiants des options choisies (base, glacage, deco) et recalcule lui-même le prix officiel à partir du catalogue en base de données !
<?php
// fichier: api/ajouter-panier.php
session_start();
header('Content-Type: application/json; charset=utf-8');

require_once '../configuration.php';
require_once '../modele/LignePanier.php';
require_once '../accesseur/PanierDAO.php';

// 1. Lire le corps JSON envoyé par fetch()
$corpsBrut = file_get_contents('php://input');
$donneesBrutes = json_decode($corpsBrut, true);

if (!is_array($donneesBrutes)) {
    http_response_code(400);
    echo json_encode(array('erreur' => 'Format JSON invalide'));
    exit;
}

// 2. Nettoyer et valider les entrées avec filter_var_array (PHP Filters)
$filtres = array(
    'type'    => FILTER_SANITIZE_SPECIAL_CHARS,
    'base'    => FILTER_SANITIZE_SPECIAL_CHARS,
    'glacage' => FILTER_SANITIZE_SPECIAL_CHARS,
    'deco'    => FILTER_SANITIZE_SPECIAL_CHARS
);
$entrees = filter_var_array($donneesBrutes, $filtres);

// 3. Recalculer le prix côté serveur et enregistrer via le Modèle et le DAO PDO
$ligne = new LignePanier($entrees);
PanierDAO::ajouterOuIncrementerLigne(session_id(), $ligne);

// 4. Récupérer l'état à jour du panier en BDD et répondre en JSON
$etatPanier = PanierDAO::obtenirEtatPanier(session_id());
echo json_encode($etatPanier);
?>
✅ Checklist avant votre Sprint Review :
  • Votre URL change-t-elle en direct quand on clique sur les options du configurateur ?
  • Copier-coller cette URL dans un nouvel onglet reconstruit-il exactement les mêmes choix ?
  • La zone de dépôt s'illumine-t-elle au survol (dragover) et un bouton [+ Ajouter] permet-il d'ajouter sans souris ?
  • Le panier reste-t-il intact lorsqu'on rafraîchit la page (grâce à la sauvegarde serveur) ?