ANS-1711 · DéVELOPPEMENT SUITESCRIPT
Comment implémenter des familles de polices personnalisées dans SuiteCommerce Advanced (SCA) Aconcagua+
Ce guide décrit la procédure à suivre pour intégrer des polices personnalisées à votre site SCA, afin de garantir la cohérence de votre image de marque et un affichage optimal sur tous les navigateurs.
Solution courte
Pour inclure des polices personnalisées dans SuiteCommerce Advanced (Aconcagua+), placez les fichiers de polices dans le dossier assets/fonts/ de votre thème, mettez à jour le fichier ns.package.json afin de les inclure dans la compilation, déclarez les règles @font-face dans votre SCSS, puis appliquez la famille de polices dans le CSS de votre site. Déployez les thèmes et les extensions pour les activer.
Scénario
Les clients ont souvent besoin de familles de polices spécifiques pour garantir la cohérence de leur image de marque sur leur site SuiteCommerce Advanced. La police par défaut « Open Sans » peut ne pas être conforme à leurs directives de marque, ce qui nécessite l’intégration de polices personnalisées afin de renforcer l’identité visuelle du site.
Solution
Le processus d’intégration de familles de polices personnalisées dans SuiteCommerce Advanced (SCA) comporte plusieurs étapes clés, en particulier pour la version Aconcagua et les versions ultérieures, où l’utilisation de thèmes et d’extensions est l’approche recommandée. Pour une prise en charge optimale par les navigateurs, il est préférable de fournir chaque police dans plusieurs formats : TTF/OTF, WOFF, WOFF2, SVG et EOT. Si un seul type de fichier est disponible, les formats TTF et OTF offrent la prise en charge la plus étendue.
Recherchez ou créez un thème/une extension et un répertoire de polices
pour la version Aconcagua de SCA et les versions ultérieures, les polices personnalisées sont généralement gérées au sein des thèmes et des extensions. La meilleure pratique consiste à stocker les polices personnalisées dans le dossier « assets » d’un thème ou d’une extension. Dans ce dossier « assets », créez un sous-dossier « fonts » (par exemple,
ThemeName/assets/fonts/) et y copiez les fichiers de polices fournis par le client.
Intégrer les polices dans la compilation Gulp
Modifiez le fichier
ns.package.jsonde votre thème ou de votre extension afin d’inclure les polices dans le processus de compilation. Cela garantit que les fichiers de polices sont traités et déployés avec votre thème.
json{ "gulp": { "sass":[ "Scss/**/*.scss" ], "fonts": [ "assets/fonts/*" ] }}Déclarer une nouvelle police
Dans les fichiers SCSS de votre thème (par exemple,
Sass/_base.scssou un fichier SCSS dédié aux polices), déclarez la nouvelle police à l’aide des règles
@font-face. Attribuez-lui un nom descriptif
font-familyet incluez toutes les versions de type de fichier fournies. Assurez-vous que l’URL
srcpointe correctement vers les fichiers de police par rapport au fichier SCSS.
css@font-face { font-family: 'FontName'; src: url('../fonts/filename.eot'); src: url('../fonts/filename.eot') format('embedded-opentype'),url('../fonts/filename.woff') format('woff'),url('../fonts/filename.ttf') format('truetype'),url('../fonts/filename.svg') format('svg'); font-weight: normal; font-style: normal; }Pour une prise en charge Web complète, déclarez des règles alternatives @font-face
pour les versions en gras et en italique de la police, en utilisant la même valeur FontName
mais en modifiant les propriétés font-weight
et font-style
, qui pointent vers leurs fichiers source respectifs.
css@font-face { font-family: 'FontName'; src: ... font-weight: bold;}@font-face { font-family: 'FontName'; src: ... font-style: italic, oblique;}@font-face { font-family: 'FontName'; src: ... font-weight: bold; font-style: italic, oblique;}Définir la nouvelle police comme police principale du site
:Dans le fichier SCSS de votre thème (par exemple,
Sass/_reset.scssou un fichier de style global), repérez la section qui définit les propriétés
font-familypour les éléments
htmlet
body. Indiquez votre nouvelle famille de polices personnalisée avant les polices par défaut telles que « Open Sans » afin de vous assurer qu’elle soit priorisée. Conservez les valeurs de repli à la fin pour garantir une dégradation gracieuse.
csshtml,body { font-family:"Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;}Modifiez ceci comme suit :
csshtml,body { font-family:"FontName", "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;}Testez et déployez
:Utilisez
gulp localpour tester les modifications dans votre environnement de développement local. Une fois que vous êtes satisfait, bien que
gulp deploypuisse être utilisé pour le déploiement des ressources, à partir de la version SCA Aconcagua et des versions ultérieures, les thèmes et les extensions sont déployés sur un compte, puis activés via l’interface NetSuite.
Support expert NetSuite
Besoin d’aide pour cet enjeu NetSuite ?
Accompagnement-conseil et configuration pour Développement SuiteScript
