Masquage d'options d'alignement, de largeur ou d'espacement de composant pour un thème

Par défaut, la plupart des composants permettent aux créateurs de site d'indiquer des options d'alignement, de largeur et d'espacement dans la boîte de dialogue de paramètres. Toutefois, en tant que développeur, vous souhaiterez peut-être masquer ces options pour un composant personnalisé afin que les contributeurs n'affichent pas le contenu d'une manière ne concordant pas avec le thème de site. Par exemple, si vous voulez favoriser une présentation avec des boutons centrés dont l'espacement est défini sur 30 pixels, vous pouvez masquer les options permettant de modifier ces éléments dans les paramètres en modifiant le fichier components.json du thème.

Il se peut aussi que vous souhaitiez remplacer les valeurs par défaut initiales d'un composant personnalisé, ce que vous pouvez également faire en modifiant le fichier components.json. Les modifications apportées aux valeurs initiales ne s'appliquent qu'aux composants ajoutés à la page après téléchargement du fichier components.json modifié en tant que nouvelle version.

Afin de masquer les options d'alignement, de largeur ou d'espacement dans les paramètres d'un composant pour un thème, procédez comme suit :

  1. Dans le menu de navigation de gauche d'Oracle Content Management, cliquez sur Développeur.
  2. Sur la page Développeur, cliquez sur Afficher tous les thèmes.
  3. Sur la page Thèmes, sélectionnez le thème à modifier, puis choisissez Ouvrir dans le menu contextuel ou cliquez sur Icône Ouvrir dans la barre d'actions.
  4. Sélectionnez le fichier components.json et cliquez sur Télécharger en local.
  5. Ouvrez le fichier components.json dans un éditeur de texte.
  6. Ajoutez des objets pour indiquer le type et l'ID du composant, et définissez les propriétés à masquer sur true.
    Par exemple, l'entrée suivante masque les propriétés d'alignement, de largeur et d'espacement d'un composant de bouton dans la boîte de dialogue des paramètres :
    "type":"scs-button",
    "id":"scs-button",
    "hideAlignmentAndWidth": true,
    "hideSpacing": true,
    Si vous souhaitez remplacer les propriétés d'alignement et d'espacement par défaut du composant de bouton, voici un exemple de la manière dont il faut indiquer les valeurs initiales :
    "initialData": {
        "alignment": "center",
        "marginTop": 30,
        "marginBottom": 30

    Dans le fichier components.json, l'entrée complète permettant d'indiquer des valeurs par défaut et de masquer les options d'alignement, de largeur et d'espacement dans la boîte de dialogue des paramètres d'un composant de bouton utilisé dans un thème est la suivante :

    [
        {
            "name": "",
            "list": [
                {
                    "type": "scs-button",
                    "id": "scs-button",
                    "hideAlignmentAndWidth": true,
                    "hideSpacing": true,
                    "initialData": {
                        "alignment": "center",
                        "marginTop": 30,
                        "marginBottom": 30
                    }
                }
            ]
        },
        {
            "name": "Starter",
            "list": [
                {
                    "type": "component",
                    "id": "StarterComponent",
                    "themed": true
                },
                {
                    "type": "component",
                    "id": "StarterFooter",
                    "themed": true
                }
            ]
        }
    ]
  7. Une fois les modifications voulues effectuées, téléchargez le fichier components.json en tant que nouvelle version du thème.