Filtri filters

Scopri come definire i filtri per limitare le opzioni disponibili nell’editor, ad esempio i componenti disponibili, le opzioni dell’editor Rich Text e la selezione delle risorse.

Configurazione dei filtri configuring-filters

Quando si utilizza l’Editor universale, è possibile limitare le opzioni consentite per determinate funzionalità definendo un filtro. Un filtro è un elenco di elementi o azioni disponibili per il contesto specifico. Ad esempio, puoi filtrare i componenti disponibili per l'inserimento in un contenitore, filtrare le opzioni disponibili nell'editor Rich Text e filtrare le risorse disponibili nel selettore delle risorse.

Tutti i filtri devono essere definiti in modo simile.

Prendiamo un esempio di filtraggio dei componenti per componente contenitore.

Definizione filtro di riferimento add-tag

Introduce innanzitutto un tag script aggiuntivo, che punta alla definizione del filtro.

Nel nostro esempio, per filtrare i componenti consentiti per contenitore, il tag potrebbe essere simile al seguente.

<script type="application/vnd.adobe.aue.filter+json" src="/static/filter-definition.json"></script>

Definire il filtro define-filter

Una definizione di filtro contiene JSON con un ID univoco per il filtro e i criteri di filtro.

Per filtrare i componenti consentiti per contenitore, nell’esempio potrebbe presentarsi l’aspetto seguente, che limita la possibilità di aggiungere solo testo e immagini in un contenitore.

[
  {
    "id": "container-filter",
    "components": ["text", "image"]
   }
]

In una definizione di filtro, se l’attributo components viene impostato su null, vengono consentiti tutti i componenti, come se non ci fosse alcun filtro.

[
  {
    "id": "another-container-filter",
     "components": null
   }
]

Fai riferimento al filtro reference-filter

Per utilizzare il filtro, è necessario fare riferimento alla definizione del filtro. Per farlo, segui questi passaggi:

  • Facendo riferimento al filtro dal componente contenitore aggiungendo la proprietà data-aue-filter, viene passato l'ID del filtro.

    code language-html
    data-aue-filter="container-filter"
    
  • Facendo riferimento al filtro dalla definizione del componente , ​ passa l'ID del filtro.

    code language-json
    {
       "title":"My Container",
       "id":"my-container",
       "model": "my-model",
       "filter": "container-filter",
       ...
    }
    

Risorse aggiuntive additional-resources

Scopri altre opzioni di personalizzazione ed estensione disponibili per l’editor universale nei documenti:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab