資產選擇器屬性 asset-selector-properties

您可以使用資產選擇器屬性自訂資產選擇器的呈現方式。下表列出可用於自訂和使用資產選擇器的屬性。

屬性
類型
必要
預設
說明
rail
布林值
如果標籤為true,資產選擇器將會在左側邊欄檢視中轉譯。 如果資產選擇器標示為false,則會以模組檢視呈現。
imsOrg
字串
Adobe Identity Management System (IMS) ID 是在為您的組織佈建 Adobe Experience Manager as a Cloud Service 時所指派的。imsOrg金鑰是驗證您所存取的組織是否位於Adobe IMS下的必要專案。
imsToken
字串
用於身份驗證的 IMS 持有人語彙基元。如果您使用Adobe應用程式進行整合,則需要imsToken
apiKey
字串
用於存取 AEM Discovery 服務的 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傳遞自己的自訂本地化值。 透過此介面傳遞值會覆寫所提供的預設翻譯,並改用您自己的翻譯。 若要執行覆寫,您必須傳遞一個有效的 Message Descriptor 物件至您想要覆寫的 i18nSymbols 金鑰。
intl
物件
資產選擇器提供預設的OOTB翻譯。 您可以透過 intl.localeprop 提供有效的語言環境字串,以選擇翻譯語言。例如: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
字串
為資產選擇器設定主題 (light或者dark)。
佈景主題
字串
預設
套用主題至defaultexpress之間的資產選擇器應用程式。 它也支援@react-spectrum/theme-express
handleSelection
函數

在選取資產並按一下Select模組上的按鈕時,叫用資產項目陣列。此函數僅在模組視圖中叫用。對於邊欄視圖,請使用 handleAssetSelectiononDrop 函數。範例:

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

如需詳細資訊,請參閱選取的資產

handleAssetSelection
函數

在選擇或取消選擇資產時,以項目陣列叫用。當您想要在使用者選擇資產時進行監聽,這是十分實用的功能。範例:

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

如需詳細資訊,請參閱選取的資產

onClose
函數
在按下Close模組視圖中的按鈕時叫用。這只在modal視圖中呼叫,而在rail視圖中忽略。
onFilterSubmit
函數
當使用者變更不同的篩選條件時,以篩選項目叫用。
selectionType
字串
單身
一次設定singlemultiple資產選擇方式。
dragOptions.allowList
布林值
屬性可用來允許或拒絕拖曳無法選取的資產。
aemTierType
字串
它可讓您選取是否要顯示傳送層級、作者層級或兩者的資產。

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

例如,如果同時使用["author","delivery"],則存放庫切換器會顯示製作和傳遞的選項。
handleNavigateToAsset
函數
這是一個Callback函式,可處理資產的選取專案。
noWrap
布林值
noWrap ​屬性有助於在側邊欄面板中轉譯「資產選取器」。 如果未提及此屬性,預設會轉譯​ 對話方塊檢視
dialogSize
小型、中型、大型、全熒幕或全熒幕接管
字串
選用
您可以使用指定的選項指定版面大小,以控制版面。
colorScheme
淺色或深色
此屬性用於設定Asset Selector應用程式的主題。 您可以選擇淺色或深色主題。
filterRepoList
函數
您可以使用filterRepoList回呼函式來呼叫Experience Manager存放庫並傳回已篩選的存放庫清單。
expiryOptions
函數
您可以在下列兩個屬性之間使用: getExpiryStatus,它提供過期資產的狀態。 函式會根據您提供的資產到期日傳回EXPIREDEXPIRING_SOONNOT_EXPIRED。 請參閱自訂過期的資產。 此外,您可以使用​ allowSelectionAndDrag,函式值可以是truefalse。 當值設定為false時,無法在畫布上選取或拖曳過期的資產。
showToast
它可讓「資產選擇器」顯示已過期資產的自訂快顯通知訊息。
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; }
uploadConfig
物件
此物件包含上傳的自訂設定。
功能集
陣列
字串
featureSet:[ ]屬性是用來啟用或停用Asset Selector應用程式中的特定功能。 若要啟用元件或功能,您可以在陣列中傳遞字串值,或將陣列保留空白以停用該元件。 例如,您想在「資產選擇器」中啟用上傳功能,請使用語法featureSet:[0:"upload"]
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab