La documentation sur bem-core d'une manière beaucoup plus informative est également disponible sur bem.info. Il est également disponible en russe.
bem-core est une bibliothèque de base pour le développement d'interface Web. Il fournit la pile minimale pour coder JavaScript côté client et les modèles.
Le moyen le plus simple d'exécuter un projet avec bem-core est d'utiliser le projet de projet.
Vous pouvez utiliser toute autre manière que vous connaissez pour inclure la bibliothèque dans le projet.
common.blocks - Convient pour tous les appareils et navigateursdesktop.blocks - doit être utilisé pour les navigateurs de bureautouch.blocks - Implémentez certains détails de plate-forme tactilei-bem - Bloc de base avec des aides pour JS et HTMLstrings - Aiders pour les strings JSobjects - Aiders pour JS-Objectsfunctions - Aiders pour les fonctions JSevents - JS-Eventsquerystring - Aiders pour travailler avec la requêtetick - temporisateur mondialidle - événement inactifnext-tick - Polyfill pour nextTick / setTimeout(0, ...)inherit - Aiders OOPjquery - jqueryclearfix - Trick Clearfix CSSidentify - Identifier les objets JScookie - Aiders pour travailler avec les cookies du navigateurvow - Implémentation Promises / A +dom - Aiders pour travailler avec Domloader - chargeur pour les fichiers jsua - Détection des caractéristiques du navigateurkeyboard - Aiders de clavierpage - Échafaudage HTML / Head / Body L'API JSDOC automatique peut être trouvée sur bem.info. Par exemple jsdoc pour i-bem est ici https://en.bem.info/platform/libs/bem-core/current/desktop/i-bem/#jsdoc
Vous pouvez consulter le Changelog sur la page Changelog.
Si vous avez déjà utilisé BEM, vérifiez les instructions de migration.
Obtenez le code de version nécessaire (par exemple, v4 ):
$ git clone -b v4 git://github.com/bem/bem-core.git
$ cd bem-coreInstallez les dépendances:
$ npm install Vous avez besoin export PATH=./node_modules/.bin:$PATH ou une autre façon d'exécuter des dépendances npm installées localement.
Installez toutes les bibliothèques nécessaires:
$ npm run depsCréer et exécuter des tests (spécifications):
$ npm testExécuter le serveur de développement:
$ npm startVeuillez vous référer au guide de contribution.
Un bundle de test par défaut pour functions__debounce :
$ magic make desktop.specs/functions__debounceVous pouvez voir les résultats des tests dans le terminal une fois le processus de construction terminé.
Vous pouvez également les regarder dans un navigateur chargé de desktop.specs/functions__debounce/spec-js+browser-js+bemhtml/spec-js+browser-js+bemhtml.html .
Exécutez des tests pour d'autres entités BEM de la même manière. Cela fonctionnera pour ceux qui sont équipés du fichier .spec.js .
Pour créer un rapport de couverture de code, ajoutez ISTANBUL_COVERAGE=yes variable d'environnement à la commande Tests Run:
$ ISTANBUL_COVERAGE=yes magic make desktop.specs && istanbul report htmlVous pouvez également exécuter des tests modulaires avec une couverture en utilisant plus de cible de construction en béton comme décrit ci-dessus.
$ ISTANBUL_COVERAGE=yes magic make desktop.specs/functions__debounce && istanbul report html
Une fois les tests terminés, vous pouvez afficher le rapport HTML de couverture en ouvrant coverage/index.html dans votre navigateur préféré.
L'ensemble des statistiques de couverture de code se trouvent sur la page de profil BEM-Core sur CoverAlls.
Les tests sont construits avec une bibliothèque ENB-Bem-Specs. Vérifiez les détails (disponibles en russe uniquement).
Notre politique de support de navigateur est basée sur les statistiques que nous obtenons des services Yandex.
Les navigateurs avec plus de 2% des utilisateurs bénéficient d'un support complet complexe, plus de 0,5% - partiellement conforme (ce qui signifie que les données sont accessibles mais pas nécessaires à 100%). De nouveaux tests de fonctionnalités ne sont pas fournis par nous pour les navigateurs avec moins de 0,5% d'utilisateurs.
Code et documentation Copyright 2012 Yandex LLC. Code publié sous la licence publique de Mozilla 2.0.