Vous pouvez utiliser les propriétés du sélecteur de ressources pour personnaliser le rendu du sélecteur de ressources. Le tableau suivant répertorie les propriétés que vous pouvez utiliser pour personnaliser et utiliser le sélecteur de ressources.
Propriété
Type
Requis
Valeur par défaut
Description
rail
Booléen
Non
False
S’il est marqué true
, le sélecteur de ressources s’affiche dans un rail à gauche. S’il est marqué false
, le sélecteur de ressources s’affiche dans le mode modal.
imsOrg
Chaîne
Oui
Identifiant Adobe Identity Management System (IMS) attribué lors de l’approvisionnement de Adobe Experience Manager en tant que Cloud Service pour votre organisation. La clé imsOrg
est requise pour vous authentifier, que l’organisation à laquelle vous accédez se trouve sous Adobe IMS ou non.
imsToken
Chaîne
Non
Jeton de support IMS utilisé pour l’authentification. imsToken
est requis si vous utilisez une application Adobe pour l’intégration.
apiKey
Chaîne
Non
Clé d’API utilisée pour accéder au service AEM Discovery. apiKey
est requis si vous utilisez une intégration d’application Adobe.
filterSchema
Tableau
Non
Modèle utilisé pour configurer les propriétés de filtre. Cela s’avère utile lorsque vous souhaitez limiter certaines options de filtre dans le sélecteur de ressources.
filterFormProps
Objet
Non
Spécifiez les propriétés de filtre à utiliser pour affiner votre recherche. Pour ! Par exemple, type MIME JPG, PNG, GIF.
selectedAssets
Tableau <Object>
Non
Spécifiez les ressources sélectionnées lors du rendu du sélecteur de ressources. Un tableau d’objets contenant une propriété d’ID des ressources est requis. Par exemple : [{id: 'urn:234}, {id: 'urn:555'}]
. Une ressource doit être disponible dans le répertoire actuel. Si vous devez utiliser un autre répertoire, saisissez également une valeur pour la propriété path
.
acvConfig
Objet
Non
Propriété d’affichage de collection de ressources qui contient un objet contenant une configuration personnalisée pour remplacer les valeurs par défaut. Cette propriété est également utilisée avec la propriété rail
pour activer l’affichage en rail de la visionneuse de ressources.
i18nSymbols
Object<{ id?: string, defaultMessage?: string, description?: string}>
Non
Si les traductions prêtes à l’emploi ne sont pas suffisantes pour répondre aux besoins de votre application, vous pouvez exposer une interface par laquelle vous pouvez transmettre vos propres valeurs localisées par le biais de la prop
i18nSymbols
. Le transfert d’une valeur par le biais de cette interface remplace les traductions fournies par défaut et utilise plutôt la vôtre. Pour effectuer le remplacement, vous devez transmettre un objet
Descripteur de message valide à la clé de
i18nSymbols
que vous voulez remplacer.
intl
Objet
Non
Le sélecteur de ressources fournit des traductions prêtes à l’emploi par défaut. Vous pouvez sélectionner la langue de traduction en fournissant une chaîne de paramètres régionaux valide via la propriété
intl.locale
. Par exemple :
intl={{ locale: "es-es" }}
. Les chaînes de paramètres régionaux prises en charge suivent la norme
ISO 639 - Codes pour la représentation des noms des normes linguistiques.
Liste des paramètres régionaux pris en charge : anglais (en-us, par défaut), espagnol (es-es), allemand (de-de), français (fr-FR), italien (it-it), japonais (ja-jp), coréen (ko-kr), portugais (pt-br), chinois (traditionnel, zh-cn), chinois (Taïwan, zh-tw).
repositoryId
Chaîne
Non
''
Référentiel à partir duquel le sélecteur de ressources charge le contenu.
additionalAemSolutions
Array<string>
Non
[ ]
Il vous permet d’ajouter une liste de référentiels d’AEM supplémentaires. Si aucune information n’est fournie dans cette propriété, seule la bibliothèque de médias ou les référentiels AEM Assets sont pris en compte.
hideTreeNav
Booléen
Non
Indique s’il faut afficher ou masquer la barre latérale de navigation de l’arborescence de ressources. Elle est utilisée uniquement en mode modal et, par conséquent, cette propriété n’a aucun impact en mode rail.
onDrop
Fonction
Non
La propriété active la fonctionnalité de dépôt d’une ressource.
dropOptions
{allowList?: Object}
Non
Configure les options de dépôt à l’aide de la « liste autorisée ».
colorScheme
Chaîne
Non
Configure le thème (light
ou dark
) du sélecteur de ressources.
Thème
Chaîne
Non
Par défaut
Appliquez le thème à l’application Sélecteur de ressources entre default
et express
. Il prend également en charge @react-spectrum/theme-express
.
handleSelection
Fonction
Non
Appelée avec un tableau d’éléments de ressource lorsque des ressources sont sélectionnées et que vous cliquez sur le bouton Select
en mode modal. Cette fonction est uniquement appelée en mode modal. En mode rail, utilisez les fonctions handleAssetSelection
ou onDrop
. Exemple :
handleSelection=(assets: Asset[])=> {…}
Voir sélection des ressources pour plus d’informations.
handleAssetSelection
Fonction
Non
Appelée avec un tableau d’éléments lorsque les ressources sont sélectionnées ou désélectionnées. Cela s’avère utile si vous souhaitez écouter les ressources lorsque l’utilisateur ou l’utilisatrice les sélectionne. Exemple :
handleSelection=(assets: Asset[])=> {…}
Voir sélection des ressources pour plus d’informations.
onClose
Fonction
Non
Appelée lorsque vous cliquez sur le bouton Close
en mode modal. Cette fonction est uniquement appelée en mode modal
et n’est pas prise en compte en mode rail
.
onFilterSubmit
Fonction
Non
Appelée avec des éléments de filtre lorsque l’utilisateur ou l’utilisatrice modifie des critères de filtre.
selectionType
Chaîne
Non
Célibataire
Configuration pour la sélection single
ou multiple
de ressources à la fois.
dragOptions.liste autorisée
booléen
Non
La propriété est utilisée pour autoriser ou refuser le déplacement des ressources qui ne peuvent pas être sélectionnées.
aemLevelType
Chaîne
Non
Il vous permet de choisir d’afficher les ressources du niveau de diffusion, du niveau auteur ou des deux.
Syntaxe : aemTierType:[0]: "author" 1: "delivery"
Par exemple, si ["author","delivery"]
sont utilisés, le sélecteur de référentiel affiche les options pour l’auteur et la diffusion.
handleNavigateToAsset
Fonction
Non
Il s’agit d’une fonction de rappel permettant de gérer la sélection d’une ressource.
noWrap
Booléen
Non
La propriété noWrap permet de rendre le sélecteur de ressources dans le panneau du rail latéral. Si cette propriété n’est pas mentionnée, elle effectue le rendu de la vue de boîte de dialogue par défaut.
dialogSize
prise en charge de petite, moyenne, grande, plein écran ou plein écran
Chaîne
Facultatif
Vous pouvez contrôler la mise en page en spécifiant sa taille à l’aide des options données.
colorScheme
Clair ou foncé
Non
Cette propriété est utilisée pour définir le thème d’une application de sélecteur de ressources. Vous pouvez choisir entre le thème clair ou sombre.
filterRepoList
Fonction
Non
Vous pouvez utiliser la fonction de rappel filterRepoList
qui appelle le référentiel Experience Manager et renvoie une liste filtrée de référentiels.
expirationOptions
Fonction
Vous pouvez utiliser entre les deux propriétés suivantes :
getExpiryStatus qui fournit l’état d’une ressource expirée. La fonction renvoie
EXPIRED
,
EXPIRING_SOON
ou
NOT_EXPIRED
en fonction de la date d’expiration d’une ressource que vous fournissez. Voir
Personnaliser les ressources expirées. De plus, vous pouvez utiliser
allowSelectionAndDrag dans lequel la valeur de la fonction peut être
true
ou
false
. Lorsque la valeur est définie sur
false
, la ressource expirée ne peut pas être sélectionnée ou déplacée sur la zone de travail.
showToast
Non
Il permet au sélecteur de ressources d’afficher un message de toast personnalisé pour la ressource expirée.
metadataSchema
Tableau
Non
Ajoutez un tableau de champs que vous fournissez pour rassembler les métadonnées de l’utilisateur. Cette propriété vous permet également d’utiliser des métadonnées masquées qui sont automatiquement affectées à une ressource, mais ne sont pas visibles par l’utilisateur.
onMetadataFormChange
Fonction de rappel
Non
Il se compose de property
et value
. Property
est égal à mapToProperty du champ transmis à partir du metadataSchema dont la valeur est mise à jour. En revanche, value
est égal à la nouvelle valeur fournie en tant qu’entrée.
targetUploadPath
Chaîne
"/content/dam"
Chemin de chargement cible des fichiers qui se trouvent par défaut à la racine du référentiel des ressources.
hideUploadButton
Booléen
False
Cela permet de s’assurer que le bouton de chargement interne doit être masqué ou non.
onUploadStart
Fonction
Non
Il s’agit d’une fonction de rappel utilisée pour transmettre la source de chargement entre Dropbox, OneDrive ou local. La syntaxe est (uploadInfo: UploadInfo) => void
importSettings
Fonction
Il permet la prise en charge de l’importation de ressources à partir d’une source tierce. sourceTypes
utilise un tableau des sources d’importation que vous souhaitez activer. Les sources prises en charge sont Onedrive et Dropbox. La syntaxe est { sourceTypes?: ImportSourceType[]; apiKey?: string; }
onUploadComplete
Fonction
Non
Il s’agit d’une fonction de rappel utilisée pour transmettre l’état de chargement du fichier entre réussite, échec ou duplication. La syntaxe est (uploadStats: UploadStats) => void
onFilesChange
Fonction
Non
Il s’agit d’une fonction de rappel utilisée pour afficher le comportement du chargement lorsqu’un fichier est modifié. Il transmet le nouveau tableau de fichiers en attente de chargement et le type source du chargement. Le type Source peut être nul en cas d’erreur. La syntaxe est (newFiles: File[], uploadType: UploadType) => void
uploadingPlaceholder
Chaîne
Il s’agit d’une image d’espace réservé qui remplace le formulaire de métadonnées lorsqu’un téléchargement de la ressource est lancé. La syntaxe est { href: string; alt: string; }
uploadConfig
Objet
Il s’agit d’un objet qui contient une configuration personnalisée pour le téléchargement.
featureSet
Tableau
Chaîne
La propriété featureSet:[ ]
est utilisée pour activer ou désactiver une fonction particulière dans l’application Sélecteur de ressources. Pour activer le composant ou une fonction, vous pouvez transmettre une valeur de chaîne dans le tableau ou laisser le tableau vide pour désactiver ce composant. Par exemple, pour activer la fonctionnalité de chargement dans le sélecteur de ressources, utilisez la syntaxe featureSet:[0:"upload"]
.