资源选择器属性 asset-selector-properties

您可以使用资源选择器属性来自定义资源选择器的呈现方式。下表列出了可用于自定义和使用资源选择器的属性。

属性
类型
必需
默认
描述
边栏
布尔值
如果标记为true,则资产选择器将在左边栏视图中呈现。 如果资产选择器标记为false,则会在模式视图中呈现该资产选择器。
imsOrg
字符串
为组织设置 Adobe Experience Manager as a Cloud Service 时分配的 Adobe Identity Management System (IMS) ID。需要使用imsOrg密钥来验证您访问的组织是否位于Adobe IMS下。
imsToken
字符串
用于身份验证的 IMS 持有者令牌。如果您使用Adobe应用程序进行集成,则需要imsToken
apiKey
字符串
用于访问 AEM 发现服务的 API 密钥。如果您使用Adobe应用程序集成,则需要apiKey
filterSchema
数组
用于配置过滤器属性的模型。这在需要限制资源选择器中的某些过滤器选项时很有用。
filterFormProps
对象
指定您需要用于细化搜索的过滤器属性。为了! 例如,MIME类型JPG、PNG、GIF。
selectedAssets
数组 <Object>
呈现资源选择器时指定选定资源。包含资源的 id 属性的必需对象数组。例如,[{id: 'urn:234}, {id: 'urn:555'}] 资源必须在当前目录中可用。如果您需要使用其他目录,请也为 path 属性提供一个值。
acvConfig
对象
资产收藏集视图属性,该属性包含用于覆盖默认值的自定义配置的对象。 此外,此属性与rail属性一起使用,以启用资产查看器的边栏视图。
i18nSymbols
Object<{ id?: string, defaultMessage?: string, description?: string}>
如果OOTB翻译无法满足应用程序的需求,则可以公开一个界面,通过该界面可通过i18nSymbols prop传递您自己的自定义本地化值。 通过此界面传递值将覆盖提供的默认转换,并转而使用您自己的转换。 要执行覆盖,您必须将一个有效的消息描述符对象传递到要覆盖的 i18nSymbols 键。
intl
对象
资产选择器提供默认的OOTB翻译。 您可以通过用 intl.locale 属性提供有效的区域设置字符串来选择翻译语言。例如:intl={{ locale: "es-es" }}

支持的区域设置字符串遵循语言标准名称表示的 ISO 639 - 代码

支持的区域设置列表:英语 -“en-us”(默认)西班牙语 -“es-es”德语 -“de-de”法语 -“fr-fr”意大利语 -“it-it”日语 -“ja-jp”朝鲜语 -“ko-kr”葡萄牙语 -“pt-br”中文(繁体)-“zh-cn”中文(台湾地区)-“zh-tw”
repositoryId
字符串
''
资源选择器从中加载内容的存储库。
additionalAemSolutions
Array<string>
[ ]
它允许您添加其他AEM存储库的列表。 如果此属性中未提供任何信息,则仅考虑媒体库或 AEM Assets 存储库。
hideTreeNav
布尔值
指定是显示还是隐藏资源树导航侧边栏。它仅在模态视图中使用,因此,该属性在边栏视图中不起作用。
onDrop
函数
该属性允许资源的删除功能。
dropOptions
{allowList?: Object}
使用“allowList”配置删除选项。
colorScheme
字符串
为资源选择器配置主题(lightdark)。
主题
字符串
默认
将主题应用于defaultexpress之间的资产选择器应用程序。 它还支持@react-spectrum/theme-express
handleSelection
函数

在资源已选定并单击模态上的 Select 按钮时调用资源项数组。仅在模态视图中调用此函数。对于边栏视图,请使用 handleAssetSelectiononDrop 函数。示例:

handleSelection=(assets: Asset[])=> {…}

有关详细信息,请参阅选择的资源

handleAssetSelection
函数

在选择或取消选择资源时调用项目数组。如果您需要在用户选择资源时进行侦听,这会很有用。示例:

handleSelection=(assets: Asset[])=> {…}

有关详细信息,请参阅选择的资源

onClose
函数
在按下模态视图中的 Close 按钮时调用。这仅在 modal 视图中被调用,在 rail 视图中将被忽略。
onFilterSubmit
函数
当用户更改其他过滤器条件时调用过滤器项。
selectionType
字符串
单身
一次性为 singlemultiple 资源选择配置。
dragOptions.允许列表
布尔型
属性用于允许或拒绝拖动不可选资产。
aemTierType
字符串
它允许您选择是显示交付层、创作层中的资产,还是同时显示两者。

语法: aemTierType:[0]: "author" 1: "delivery"

例如,如果同时使用了["author","delivery"],则存储库切换器将显示创作和投放选项。
handleNavigateToAsset
函数
它是一个回调函数,用于处理资源的选择。
noWrap
布尔值
noWrap ​属性有助于在侧边栏面板中呈现资产选择器。 如果未提及此属性,则默认情况下会呈现​ 对话框视图
dialogSize
小型、中型、大型、全屏或全屏接管
字符串
可选
通过使用给定选项指定布局大小可控制布局。
colorScheme
浅色或深色
此属性用于设置Asset Selector应用程序的主题。 您可以选择浅色或深色主题。
filterRepoList
函数
您可以使用filterRepoList回调函数来调用Experience Manager存储库并返回已过滤的存储库列表。
expiryOptions
函数
您可以在以下两个属性之间使用:getExpiryStatus,它提供已过期资源的状态。 函数根据您提供的资源的到期日期返回EXPIREDEXPIRING_SOONNOT_EXPIRED。 请参阅自定义过期的资源。 此外,您可以使用​ allowSelectionAndDrag,其中函数的值可以是truefalse。 如果该值设置为false,则无法在画布上选择或拖动过期的资产。
showToast
它允许资产选择器为已过期的资产显示自定义的toast消息。
metadataSchema
数组
添加您为从用户那里收集元数据而提供的字段数组。 使用此属性,您还可以使用自动分配给资源但用户不可见的隐藏元数据。
onMetadataFormChange
回调函数
它包含propertyvalueProperty等于从​ metadataSchema ​传递的字段​ mapToProperty,该字段的值正在更新。 而,value等于提供的新值作为输入。
targetUploadPath
字符串
"/content/dam"
默认为资源存储库根目录的文件目标上传路径。
hideUploadButton
布尔值
它确保内部上传按钮是否隐藏。
onUploadStart
函数
它是一个回调函数,用于在Dropbox、OneDrive或本地之间传递上传源。 语法为(uploadInfo: UploadInfo) => void
importSettings
函数
它支持从第三方来源导入资产。 sourceTypes使用要启用的导入源数组。 支持的源为Onedrive和Dropbox。 语法为{ sourceTypes?: ImportSourceType[]; apiKey?: string; }
onUploadComplete
函数
它是一个回调函数,用于在成功、失败或复制之间传递文件上传状态。 语法为(uploadStats: UploadStats) => void
onFilesChange
函数
它是一个回调函数,用于在文件更改时显示上载行为。 它会传递挂起的待上传文件的新数组以及上传的源类型。 如果发生错误,Source类型可以为null。 语法为(newFiles: File[], uploadType: UploadType) => void
uploadingPlaceholder
字符串
它是一个占位符图像,在启动资源上传时替换元数据表单。 语法为{ href: string; alt: string; }
上载配置
对象
它是一个对象,其中包含用于上载的自定义配置。
功能集
数组
字符串
featureSet:[ ]属性用于启用或禁用Asset Selector应用程序中的特定功能。 要启用该组件或功能,您可以在数组中传递字符串值,或将数组留空以禁用该组件。 例如,要在资产选择器中启用上载功能,请使用语法featureSet:[0:"upload"]
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab