Modernizar personalizações
Importante
As ferramentas de modernização e todos os outros componentes PnP são ferramentas de código aberto, sustentadas por uma comunidade ativa que fornece suporte a eles. Não há SLA para suporte de ferramentas de código aberto a partir dos canais oficiais de suporte da Microsoft.
Um aspecto importante ao modernizar um site é entender as personalizações usadas nele, já que nem todas continuam funcionando após a modernização. Um exemplo clássico que ocorre com frequência é uma faixa de site que mostra algum tipo de informação da empresa (por exemplo, um aviso legal).
Em geral, isso se dá por meio de uma ação personalizada do usuário que insere JavaScript na página, a qual, por sua vez, é responsável por exibir a faixa. Ela fica visível em todas as páginas clássicas, mas não nas modernas. Para contornar esse problema, é possível implementar a faixa como uma extensão Personalizador de aplicativos da Estrutura do SharePoint e implantá-la no site ou no locatário.
Este artigo apresenta uma visão geral das personalizações incompatíveis com a interface do usuário moderna e fornece orientações sobre como corrigi-las.
Personalizações em listas e bibliotecas
Esta seção se concentra nas personalizações que você pode ter implementado em suas listas e bibliotecas. O SharePoint recorre automaticamente à interface do usuário clássica de lista e biblioteca ao detectar uma personalização incompatível. Portanto, é importante lidar com essas personalizações caso deseje obter uma experiência 100% moderna.
Para entender a compatibilidade de suas listas e bibliotecas com a interface do usuário moderna, use o Verificador de modernização do SharePoint.
JSLink
Um modelo bastante comum para controlar como um campo é representado na interface do usuário do SharePoint é usando o JSLink. Basicamente, o JSLink permite conectar o JavaScript, o qual assume, então, a renderização do campo. Na interface do usuário moderna, funcionalidades de personalização semelhantes estão disponíveis para as páginas de exibição de listas, embora personalizar o painel de edição de listas ainda não seja possível.
Caso esteja substituindo o JSLink, há duas abordagens alternativas a serem consideradas; a que vai funcionar melhor dependerá da complexidade da solução existente:
- Se for simplesmente sobre como exibir os dados, geralmente a melhor opção é usar a formatação de colunas.
- Se for necessário mais comportamento, geralmente a melhor opção é usar uma extensão Personalizador de campos da Estrutura do SharePoint.
Usar formatação de colunas
Você pode usar a formatação de colunas para personalizar como os campos são exibidos nas listas e bibliotecas do SharePoint. Para fazer isso, você constrói um objeto JSON que descreve os elementos exibidos quando um campo é incluído em uma exibição de lista, bem como os estilos a serem aplicados a esses elementos. A formatação de colunas não muda os dados no arquivo ou item de lista. Ela só muda a forma como eles são exibidos para os usuários que navegam pela lista. Qualquer pessoa capaz de criar e gerenciar exibições em uma lista pode usar a formatação de colunas para configurar como os campos de exibição são apresentados.
Por exemplo, uma lista com os campos Título, Esforço, Atribuído a e Status e sem personalizações aplicadas pode ter a seguinte aparência:
Uma lista com a aparência dos campos Esforço, Atribuído a e Status personalizados com o uso da formatação de colunas pode ter a seguinte aparência:
Para saber mais sobre a formatação de colunas, consulte:
- Usar a formatação de colunas para personalizar o SharePoint
- Exemplos de formatação de colunas do SharePoint
Usar a extensão Personalizador de campos da Estrutura do SharePoint
As Extensões da Estrutura do SharePoint permitem ampliar a experiência do usuário do SharePoint em páginas modernas e bibliotecas de documentos, utilizando as ferramentas e bibliotecas conhecidas da Estrutura do SharePoint para o desenvolvimento. Os Personalizadores de campos, em especial, permitem o controle total de como os dados de campo são apresentados em seus modos de exibição de lista ou biblioteca.
A seguir, há um exemplo de uma coluna de porcentagem.
Para saber mais sobre as extensões do Personalizador de campos da Estrutura do SharePoint, consulte:
- Criar sua primeira extensão Personalizador de campos
- Migrar personalizações de JSLink para Personalizadores de Campo da Estrutura do SharePoint
- Tutorial: Migrar do JSLink para Extensões da Estrutura do SharePoint
Ações personalizadas do usuário delimitadas por lista que adicionam opções de menu personalizadas ou inserem JavaScript
Usar uma ação personalizada do usuário delimitada por lista que adiciona opções de menu personalizadas na faixa de opções ou no menu de contexto da lista ou que insere JavaScript é, junto com o JSLink, um padrão de personalização bastante comum que não funciona mais para a experiência de listas e bibliotecas modernas. Felizmente, com o uso das Extensões da Estrutura do SharePoint, é possível realizar personalizações semelhantes, em especial, por meio das extensões de um conjunto de comandos que permitem adicionar itens de menu do ECB (Bloco de controle de edição) personalizados ou botões personalizados à barra de comandos de uma biblioteca ou lista. É possível associar qualquer ação do JavaScript (TypeScript) a esses comandos.
Para saber mais sobre as extensões do Conjunto de comandos ListView da Estrutura do SharePoint, consulte:
- Compilar sua primeira extensão de Conjunto de comandos ListView
- Migrar itens de menu do ECB e ações personalizadas de usuário para as Extensões da Estrutura do SharePoint
- Migrar do item de menu do ECB para extensões da Estrutura do SharePoint
- Tutorial: Migrar do UserCustomAction para Extensões da Estrutura do SharePoint
Personalizações em páginas
O SharePoint tem vários tipos de páginas de sites clássicas, como páginas wiki, de Web Parts e de publicação. Cada uma delas permite a personalização pelo usuário com a adição de Web Parts e textos (formatados) ou com a inserção de JavaScript por meio de ações personalizadas do usuário. Esta seção oferece uma visão geral dos modelos de personalização existentes e de como eles podem ser substituídos por opções modernas compatíveis.
Web Parts clássicas prontas para uso
O SharePoint tem diversas Web Parts prontas para uso (incluindo a Web Part de editor de scripts) que funcionam em páginas clássicas, mas não em páginas modernas (ou seja, não há uma equivalência moderna pronta para uso). Também há disponível um conjunto de web parts modernas próprias com funcionalidades semelhantes para algumas das web parts clássicas. No entanto, não há paridade de recursos.
Se você precisar da funcionalidade de uma web part clássica como equivalente moderna, será preciso lançar sua própria versão com base na Estrutura do SharePoint ou, se preferir, usar uma web part de uma ampla lista de web parts de software livre da Estrutura do SharePoint que podem ser encontradas no repositório sp-dev-fx-webparts do GitHub.
A seguir, há um diagrama mostrando um exemplo de uma Web Part.
Para saber mais sobre as web parts da Estrutura do SharePoint, confira:
- Visão geral de web parts do SharePoint
- Migrar as personalizações de Web Part do Editor de Scripts existentes para a Estrutura do SharePoint
- Materiais para tutorial e exemplos de web parts da Estrutura do SharePoint
Ações personalizadas do usuário de escopo no site ou na Web que inserem JavaScript
Na introdução, mencionamos o padrão comum de adicionar uma faixa de site inserindo JavaScript por meio de ações personalizadas do usuário de escopo no site ou na Web. Como esse padrão não é compatível com a interface do usuário moderna, será necessário reformular esse tipo de personalização com base nas extensões do Personalizador de aplicativos da Estrutura do SharePoint. Ao usar personalizadores de aplicativos, é possível incluir scripts personalizados que podem ser usados para inserir HTML na interface do usuário moderna do SharePoint em pontos de extensão predefinidos na parte superior ou inferior da página.
Para saber mais sobre as extensões do Personalizador de aplicativos da Estrutura do SharePoint, consulte:
- Compilar sua primeira Extensão da Estrutura do SharePoint
- Migrar itens de menu do ECB e ações personalizadas de usuário para as Extensões da Estrutura do SharePoint
- Tutorial: Migrar do UserCustomAction para Extensões da Estrutura do SharePoint
Itens de menu personalizados no menu de ações do site
No momento, não é possível adicionar seus próprios itens de menu personalizados ao menu de ações do site (o ícone da engrenagem) em páginas modernas. Dentre as estratégias alternativas estão a adição dos links necessários na navegação ou na home page do site.