Visão geral do Office Web Widgets – Experimental
Aviso
Os Widgets Web do Office – Experimental são fornecidos apenas para fins de pesquisa e comentários. Não use em cenários de produção. O comportamento do Office Web Widgets pode mudar significativamente em versões futuras. Leia e examine os Widgets web do Office – Termos de licença experimentais.
Os controles do cliente, como o Office Web Widgets – Experimental, podem reduzir consideravelmente o tempo necessário para criar suplementos e, ao mesmo tempo, aumentar a qualidade dos suplementos. Para que isso seja verdade, temos que ter certeza de que os widgets atendem a determinados critérios.
Os widgets devem:
Seja projetado para ser usado em qualquer página da Web, mesmo que a página não esteja hospedada no SharePoint.
Trabalhar no runtime de controles do Office. Isso nos permite fornecer um conjunto comum de requisitos e uma sintaxe consistente para usar os widgets.
Comunique-se novamente ao SharePoint usando a biblioteca entre domínios. Os Widgets não têm uma dependência de uma plataforma ou tecnologia específica do lado do servidor, portanto, você pode usar os widgets independentemente da sua escolha de tecnologia de servidor.
Coexista com outros elementos na página. A inclusão do widget em uma página não deve modificar outros elementos nela.
Jogue bem com estruturas existentes. Queremos ter certeza de que você ainda pode usar as ferramentas e tecnologias às quais está acostumado.
Um suplemento usando Widgets Web do Office – Experimental
Você pode usar os widgets instalando o pacote Office Web Widgets – NuGet Experimental do Visual Studio. Para obter mais informações, consulte Interface do usuário do Gerenciador de Pacotes do NuGet. Você também pode navegar pela página da galeria do NuGet.
Seus comentários e comentários nos ajudaram a decidir quais widgets fornecer. Como você pode ver na figura anterior, os widgets (1) Pessoas Picker e (2) Desktop List View estão prontos para você experimentar. Mantenha os comentários no site UserVoice da Plataforma do Desenvolvedor do Office.
Você também pode ver os widgets em ação no exemplo de código do Office Web Widgets – Demo Experimental .
Widget Seletor de Pessoas
Você pode usar o widget experimental Pessoas Picker em suplementos para ajudar seus usuários a encontrar e selecionar pessoas e grupos em um locatário. Os usuários podem começar a digitar na caixa de texto e o widget recupera as pessoas cujo nome ou email corresponde ao texto.
Pessoas widget picker resolvendo uma consulta
Você pode declarar o widget na marcação HTML ou programaticamente usando JavaScript. Em ambos os casos, você usa um elemento div como espaço reservado para o widget. Você também pode definir propriedades e manipuladores de eventos para o widget Pessoas Picker. A tabela a seguir mostra as propriedades e eventos disponíveis no widget Pessoas Picker.
| Propriedade/Evento | Tipo | Descrição |
|---|---|---|
| objectType | Objeto JSON (lista de cadeias de caracteres) | Tipo de itens que o widget resolverá. Opções: Padrão de Grupo de Usuário somente para usuário. |
| allowMultipleSelections | Booliano | Verdadeiro/Falso. Se False, o widget deverá permitir a seleção de apenas um item por vez. Default=False. |
| rootGroupName | Cadeia de caracteres | Se fornecido, o widget limitará a seleção a itens nesse grupo. Se não for fornecido, o widget consultará objetos de toda a locação. |
| selectedItems | Matriz JSON | Lista de itens selecionados. Cada item retorna um objeto que representa um usuário ou grupo. |
| onAdded | Função | Evento que é disparado quando um novo objeto é adicionado à seleção. A função manipuladora recebeu o objeto adicionado. |
| onRemoved | Função | Evento que é disparado quando um novo objeto é removido da seleção. A função manipuladora recebeu o objeto removido. |
| onChange | Função | Adicionar ou remover objetos dispara esse evento. Nenhum parâmetro é passado para a função de manipulador. |
| validationErrors | Matriz | Matriz de possíveis erros de validação: vazio, não resolvidoItem, tooManyItems |
| autoShowValidationMessage | Boolean | True=Show False=Não mostrar |
| hasErrors | Boolean | True= Há 1 ou mais erros de validação False=Não há erros de validação |
| errors | Matriz | Matriz de possíveis erros de validação: vazio, não resolvidoItem, tooManyItems |
| displayErrors | Boolean | True=Exibir os erros False=Não exibir os erros |
As classes CSS para o widget Pessoas Picker são definidas na folha de estilos Office.Controls.css. Você pode substituir as classes e estilizar o widget para seu suplemento.
Para obter mais informações, consulte Usar o widget experimental Pessoas Picker nos suplementos do SharePoint e usar o widget experimental do Picker Pessoas em um exemplo de código de suplemento.
Widget Exibição de Lista da Área de Trabalho
Seus usuários podem se beneficiar do widget Exibição de Lista e exibir os dados em uma lista, assim como o widget regular de Exibição de Lista, mas você pode usá-lo em seus suplementos que não estão necessariamente hospedados no SharePoint.
Widget Do Modo de Exibição de Lista da Área de Trabalho que exibe os dados em uma lista
Você pode especificar uma exibição existente na lista; O widget renderiza os campos na ordem em que eles aparecem no modo de exibição.
Observação
Neste momento, o widget Do Modo de Exibição de Lista da Área de Trabalho exibe apenas os dados. Ele não oferece recursos de edição.
Você pode fornecer um espaço reservado para o widget usando um elemento div . Você pode usar programaticamente ou declarativamente o widget.
Você também pode definir propriedades ou manipuladores de eventos para o widget Modo de Exibição de Lista da Área de Trabalho. A tabela a seguir mostra as propriedades e eventos disponíveis no widget Modo de Exibição de Lista da Área de Trabalho.
| Propriedade/Evento | Tipo | Descrição |
|---|---|---|
| listUrl | URL | URL da exibição de lista para desenhar itens. Pode ser uma URL relativa, nesse caso, presume-se que ela esteja localizada na própria Web do suplemento ou em uma URL absoluta. |
| viewName | Cadeia de caracteres | Nome da exibição a ser exibida. Este é o nome programático do modo de exibição (não seu nome de exibição). |
| onItemSelected | Função | Evento que dispara quando um item é selecionado na lista. |
| onItemAdded | Função | Evento que dispara quando um novo item é adicionado à lista. |
| onItemRemoved | Função | Evento que dispara quando um item é removido da lista. |
| selectedItems | Matriz | Lista de itens selecionados no formato JSON. |
O widget requer a folha de estilos do site do SharePoint. Você pode referenciar a folha de estilos do SharePoint diretamente ou usar o widget cromado. Para obter mais informações sobre a folha de estilos, consulte Usar a folha de estilos de um site do SharePoint em Suplementos do SharePoint e Usar o controle cromado do cliente em Suplementos do SharePoint.
Para ver o widget de Exibição de Lista em ação, consulte o widget experimental Use the Desktop List View em um exemplo de código de suplemento . Consulte Também Usar o widget experimental do Modo de Exibição de Lista de Área de Trabalho em Suplementos do SharePoint.
Os Widgets podem ajudar a acelerar o processo de desenvolvimento e reduzir o custo e o tempo de comercialização de seus suplementos. Widgets web do Office – o experimental fornece widgets que você pode usar em seus suplementos de não produção. Seus comentários e comentários são bem-vindos no site UserVoice da Plataforma do Desenvolvedor do Office.