DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Seletor de fragmento de conteúdo — Propriedades relacionadas content-fragment-selector-related-properties

Last update: Fri Dec 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Administrador
  • Usuário

O Seletor de fragmento de conteúdo de micro front-end permite navegar ou pesquisar fragmentos de conteúdo no repositório e usá-los no aplicativo.

Você pode usar as seguintes propriedades para personalizar como o Seletor de fragmento de conteúdo é renderizado e como ele pode ser usado:

Propriedades do seletor de fragmentos de conteúdo content-fragment-selector-properties

Propriedade
Tipo
Obrigatório
Padrão
Descrição
ref
RefSeletorFragmento
Referência à instância ContentFragmentSelector, permitindo acesso à funcionalidade fornecida, como reload.
imsToken
string
Não
Token IMS usado para autenticação. Se não for fornecido, o fluxo de logon do IMS será iniciado.
repoId
string
Não
ID do repositório usada para o Seletor de fragmentos. Quando fornecido, o seletor se conecta automaticamente ao repositório especificado e a lista suspensa de repositórios fica oculta. Se não for fornecido, o usuário poderá selecionar um repositório na lista de repositórios disponíveis aos quais tem acesso.
defaultRepoId
string
Não
ID do repositório que será selecionado por padrão quando o seletor de repositório for exibido. Usado apenas quando repoId não é fornecido. Se repoId estiver definido, o seletor de repositório ficará oculto e esse valor será ignorado.
orgId
string
Não
ID da organização usada para autenticação. Se não for fornecido, o usuário poderá selecionar um repositório de diferentes organizações às quais tem acesso. Se o usuário não tiver acesso a nenhum repositório ou organização, o conteúdo não será carregado.
locale
string
Não
en-US
Localidade.
env
string
Não
Ambiente de implantação. Consulte o tipo Env para obter os nomes de ambiente permitidos.
filters
FiltroDeFragmentos
Não
{ folder: "/content/dam" }
Filtros a serem aplicados à lista de fragmentos de conteúdo. Por padrão, os fragmentos em /content/dam serão exibidos.
isOpen
booleano
Não
false
Sinalizador para controlar se o seletor está aberto ou fechado.
noWrap
booleano
Não
false
Determina se o Seletor de fragmentos é renderizado sem uma caixa de diálogo de encapsulamento. Quando definido como true, o Seletor de fragmento é inserido diretamente no contêiner pai. Útil para integrar o seletor em layouts ou fluxos de trabalho personalizados.
onSelectionChange
({ contentFragments: ContentFragmentSelection, domainName?: string, tenantInfo?: string, repoId?: string, deliveryRepos?: DeliveryRepository[] }) => void
Não
A função de retorno de chamada é acionada sempre que a seleção de fragmentos de conteúdo é alterada. Fornece os fragmentos selecionados no momento, o nome do domínio, as informações do locatário, a ID do repositório e os repositórios de entrega.
onDismiss
() => void
Não
A função de retorno de chamada disparada quando a ação de descarte é executada; por exemplo, fechar o seletor.
onSubmit
({ contentFragments: ContentFragmentSelection, domainName?: string, tenantInfo?: string, repoId?: string, deliveryRepos?: DeliveryRepository[] }) => void
Não
A função de retorno de chamada é acionada quando o usuário confirma sua seleção. Recebe os fragmentos de conteúdo selecionados, o nome do domínio, as informações do locatário, a ID do repositório e os repositórios de entrega.
theme
"claro" ou "escuro"
Não
Tema para o Seletor de fragmentos. Por padrão, é definido como o tema de ambiente unifiedShell.
selectionType
"único" ou "múltiplo"
Não
single
O tipo de seleção pode ser usado para restringir a seleção do Seletor de fragmentos.
dialogSize
"fullscreen" ou "fullscreenTakeover"
Não
fullscreen
Prop opcional para controlar o tamanho do diálogo.
runningInUnifiedShell
booleano
Não
Se DestinationSelector está em execução no UnifiedShell ou autônomo.
readonlyFilters
CampoFiltrosSomenteLeituraRecurso[]
Não
Filtros somente leitura aplicados à lista de fragmentos de conteúdo. Esses filtros não podem ser removidos pelo usuário.
selectedFragments
IdentificadorFragmentoConteúdo[]
Não
[]
Seleção inicial de fragmentos de conteúdo a serem pré-selecionados quando o seletor é aberto.
hipaaEnabled
booleano
Não
false
Indica se a conformidade com a HIPAA está habilitada.
inventoryView
TipodeVisualizaçãodeInventário
Não
table
Tipo de exibição padrão de estoque a ser usado no seletor.
inventoryViewToggleEnabled
booleano
Não
false
Indica se a opção de exibição de estoque está habilitada, permitindo que o usuário alterne entre as exibições de tabela e grade.

Propriedades de ImsAuthProps imsauthprops-properties

As propriedades ImsAuthProps definem as informações de autenticação e o fluxo que o Seletor de fragmento de conteúdo usa para obter um imsToken. Ao definir essas propriedades, é possível controlar como o fluxo de autenticação deve se comportar e registrar ouvintes para vários eventos de autenticação.

Nome de propriedade
Descrição
imsClientId
Um valor de string que representa a ID do cliente IMS usada para fins de autenticação. Esse valor é fornecido pela Adobe e é específico para a sua organização do Adobe AEM CS.
imsScope
Descreve os escopos usados na autenticação. Os escopos determinam o nível de acesso que o aplicativo tem aos recursos da organização. Vários escopos podem ser separados por vírgulas.
redirectUrl
Representa o URL para o qual o usuário é redirecionado após a autenticação. Normalmente, esse valor é definido como o URL atual do aplicativo. Se um redirectUrl não for fornecido, ImsAuthService usará o redirectUrl usado para registrar o imsClientId
modalMode
Um booleano que indica se o fluxo de autenticação deve ser exibido em um modal (pop-up) ou não. Se definido como true, o fluxo de autenticação será exibido em um pop-up. Se definido como false, o fluxo de autenticação será exibido em um recarregamento de página completo.
Observação: para obter um UX melhor, você pode controlar este valor dinamicamente se o usuário tiver o pop-up do navegador desabilitado.
onImsServiceInitialized
Uma função de retorno de chamada que é chamada quando o serviço de autenticação do Adobe IMS é inicializado. Essa função recebe um parâmetro, service, que é um objeto que representa o serviço Adobe IMS. Consulte ImsAuthService para obter mais detalhes.
onAccessTokenReceived
Uma função de retorno de chamada que é chamada quando um imsToken é recebido do serviço de autenticação do Adobe IMS. Esta função recebe um parâmetro, imsToken, que é uma cadeia de caracteres que representa o token de acesso.
onAccessTokenExpired
Uma função de retorno de chamada chamada chamada quando um token de acesso expira. Normalmente, essa função é usada para acionar um novo fluxo de autenticação para obter um novo token de acesso.
onErrorReceived
Uma função de retorno de chamada que é chamada quando ocorre um erro durante a autenticação. Essa função usa dois parâmetros: o tipo de erro e a mensagem de erro. O tipo de erro é uma cadeia de caracteres que representa o tipo de erro, e a mensagem de erro é uma cadeia de caracteres que representa a mensagem de erro.

Propriedades de ImsAuthService imsauthservice-properties

A classe ImsAuthService manipula o fluxo de autenticação para o Seletor de fragmento de conteúdo. Ele é responsável por obter um imsToken do serviço de autenticação do Adobe IMS. O imsToken é usado para autenticar o usuário e autorizar o acesso ao repositório do Adobe Experience Manager (AEM) CS. O ImsAuthService usa as propriedades ImsAuthProps para controlar o fluxo de autenticação e registrar ouvintes de vários eventos de autenticação. Você pode usar a conveniente função registerContentFragmentSelectorAuthService para registrar a instância ImsAuthService com o Seletor de fragmentos de conteúdo. As seguintes funções estão disponíveis na classe ImsAuthService. No entanto, se você estiver usando a função registerContentFragmentSelectorAuthService, não será necessário chamar essas funções diretamente.

Nome da função
Descrição
isSignedInUser
Determina se o usuário está conectado ao serviço no momento e retorna um valor booleano correspondente.
getImsToken
Recupera a autenticação imsToken para o usuário conectado no momento, que pode ser usada para autenticar solicitações para outros serviços, como gerar a representação do ativo.
signIn
Inicia o processo de entrada do usuário. Esta função usa o ImsAuthProps para mostrar autenticação em um pop-up ou em um recarregamento de página completo.
signOut
Desconecta o usuário do serviço, invalidando seu token de autenticação e exigindo que ele entre novamente para acessar recursos protegidos. Chamar essa função recarregará a página atual.
refreshToken
Atualiza o token de autenticação do usuário conectado no momento, evitando a expiração e garantindo acesso ininterrupto aos recursos protegidos. Retorna um novo token de autenticação que pode ser usado para solicitações subsequentes.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab