Office Web Widgets: Información general experimental
Advertencia
Widgets de Web de Office: Experimental solo se ofrece a efectos de investigación y comentarios. No se usa en escenarios de producción. El comportamiento de Office Web Widgets puede cambiar significativamente en futuras versiones. Lea y revise los Términos de licencia de Office Web Widgets: Experimental.
Los controles de cliente, como Office Web Widgets: Experimental, pueden reducir notablemente la cantidad de tiempo necesario para compilar complementos y, al mismo tiempo, aumentar su calidad. Para que esto se cumpla, debemos asegurarnos de que los widgets cumplan ciertos criterios.
Los widgets deben:
Diseñarse para su uso en cualquier página web aunque no esté hospedada en SharePoint.
Trabajar en el entorno de ejecución de controles de Office. Esto nos permite proporcionar un conjunto común de requisitos y una sintaxis coherente para usar los widgets.
Vuelva a comunicarse con SharePoint mediante la biblioteca entre dominios. Los widgets no tienen una dependencia en una plataforma o tecnología del lado servidor en particular, por lo que puede usar los widgets independientemente de la tecnología de servidor que elija.
Coexista con otros elementos de la página. La inclusión del widget en una página no debe modificar otros elementos en él.
Use bien los marcos existentes. Queremos asegurarnos de que pueda seguir usando las herramientas y tecnologías a las que está acostumbrado.
Complemento donde se usa Office Web Widgets: Experimental
Puede usar los widgets instalando el paquete NuGet Office Web Widgets - Experimental desde Visual Studio. Para obtener más información, vea Interfaz de usuario del Administrador de paquetes NuGet. También puede examinar la Página Galería de NuGet.
Sus comentarios y comentarios nos ayudaron a decidir qué widgets proporcionar. Como puede ver en la ilustración anterior, los widgets (1) Personas Selector y (2) Vista de lista de escritorio están listos para que lo pruebe. Mantenga los comentarios que llegan en el sitio de UserVoice de la Plataforma para desarrolladores de Office.
También puede ver los widgets en acción en el ejemplo de código Demostración de Office Web Widgets: Experimental.
Widget Selector de personas
Puede usar el widget experimental Selector de personas en los complementos para ayudar a los usuarios a buscar y seleccionar personas y grupos en un inquilino. Los usuarios empiezan a escribir en el cuadro de texto y el widget recupera a las personas cuyo nombre o correo electrónico coincida con el texto.
Widget Selector de personas mientras soluciona una consulta
Puede declarar el widget en el marcado HTML o mediante programación mediante JavaScript. En cualquier caso, se usa un elemento div como marcador de posición para el widget. También puede establecer las propiedades y los controladores de eventos del widget Selector de personas. En la tabla siguiente se muestran las propiedades y los eventos disponibles en el widget Selector de personas.
| Propiedad o evento | Tipo | Descripción |
|---|---|---|
| objectType | Objeto JSON (lista de cadenas) | Tipo de elementos que resolverá el widget. Opciones: El grupo de usuarios es el valor predeterminado solo para el usuario. |
| allowMultipleSelections | Booleano | True o False. Si es False, el widget debe permitir seleccionar solo un elemento a la vez. Valor predeterminado = False. |
| rootGroupName | String | Si se especifica, el widget limita la selección a los elementos de este grupo. Si no se especifica, el widget consultas objetos de todo el espacio empresarial. |
| selectedItems | Matriz JSON | Lista de los elementos seleccionados. Cada elemento devuelve un objeto que representa un usuario o grupo. |
| onAdded | Función | Evento que se desencadena al agregar un nuevo objeto a la selección. La función del controlador recibe el objeto agregado. |
| onRemoved | Función | Evento que se desencadena al quitar un nuevo objeto de la selección. La función del controlador recibe el objeto quitado. |
| onChange | Función | Al agregar o quitar objetos se desencadena el evento. No se pasa ningún parámetro a la función del controlador. |
| validationErrors | Array | Matriz de posibles errores de validación: empty, unresolvedItem, tooManyItems |
| autoShowValidationMessage | Boolean | True = Mostrar False = No mostrar |
| hasErrors | Boolean | True = Hay uno o más errores de validación False = No hay ningún error de validación |
| errors | Array | Matriz de posibles errores de validación: empty, unresolvedItem, tooManyItems |
| displayErrors | Boolean | True = Mostrar los errores False = No mostrar los errores |
Las clases CSS del widget Selector de personas se definen en la hoja de estilos Office.Controls.css. Puede invalidar las clases y adaptar el estilo del widget a su complemento.
Para obtener más información, vea Usar el widget experimental de selector de Personas en complementos de SharePoint y Usar el widget experimental selector de Personas en un ejemplo de código de complemento.
Widget Vista de lista de escritorio
Los usuarios pueden aprovechar el widget Vista de lista para mostrar los datos de una lista como se hace con el widget Vista de lista normal, pero aquel se puede usar en los complementos que no están hospedados necesariamente en SharePoint.
Widget Vista de lista de escritorio donde se muestran los datos en una lista
Puede especificar una vista existente en la lista; el widget representará los campos en el orden en que aparecen en la vista.
Nota:
Actualmente, el widget Vista de lista de escritorio solo muestra los datos. No ofrece capacidades de edición.
Puede proporcionar un marcador de posición para el widget con un elemento div. El widget se puede usar con declaración o con programación.
También puede establecer las propiedades o los controladores de eventos para el widget Vista de lista de escritorio. En la tabla siguiente se recogen las propiedades y los eventos disponibles en el widget Vista de lista de escritorio.
| Propiedad/evento | Tipo | Descripción |
|---|---|---|
| listUrl | URL | Dirección URL de la vista de lista de la que se van a extraer los elementos. Puede ser una dirección URL relativa, en cuyo caso se supone que se encuentra en la propia web de complemento, o una dirección URL absoluta. |
| viewName | String | Nombre de la vista que se muestra. Se trata del nombre de programación de la vista (no su nombre para mostrar). |
| onItemSelected | Función | Evento que se desencadena al seleccionar un elemento de la lista. |
| onItemAdded | Función | Evento que se desencadena al agregar un nuevo elemento a la lista. |
| onItemRemoved | Función | Evento que se desencadena al quitar un elemento de la lista. |
| selectedItems | Array | Lista de elementos seleccionados en formato JSON. |
El widget requiere la hoja de estilos del sitio web de SharePoint. Se puede hacer referencia a la hoja de estilos de SharePoint directamente o usar el widget de Chrome. Para obtener más información sobre la hoja de estilos, vea Usar la hoja de estilos de un sitio web de SharePoint en complementos de SharePoint y Usar el control de cromo de cliente en complementos de SharePoint.
Para ver el widget Vista de lista en acción, vea el ejemplo de código Usar el widget experimental Vista de lista de escritorio en un complemento . También puede ver Usar el widget experimental Vista de lista de escritorio en complementos para SharePoint.
Los widgets pueden contribuir a acelerar el proceso de desarrollo y a reducir el coste y el plazo de comercialización de los complementos. Office Web Widgets: Experimental ofrece widgets que puede usar en complementos ajenos a la producción. Esperamos sus comentarios en el sitio Office Developer Platform UserVoice.