Anotaciones del gráfico Web Components

    Las interacciones y anotaciones del gráfico Web Components se implementan a través de capas de interacción, que son series que se agregan a la colección de series. Estas capas dependen de la posición del cursor. Cada una de estas capas de anotaciones proporciona una interacción de desplazamiento diferente que se puede usar individualmente o combinada con otras para proporcionar interacciones de desplazamiento potentes.

    Web Components Annotations Example

    El siguiente ejemplo demuestra las capas de anotaciones que están disponibles en el gráfico Web Components. Haga clic en las casillas de verificación para activar y desactivar cada capa.

    ¿Te gusta esta muestra? Obtenga acceso a nuestro completo kit de herramientas Web Components y comience a crear sus propias aplicaciones en minutos. Descárgalo gratis.

    Web Components Crosshair Layer

    IgcCrosshairLayerComponent se representa como líneas cruzadas que se cruzan en el valor real de cada serie a la que están configurados para apuntar y cada serie representa un conjunto de líneas separado.

    Los tipos de punto de mira incluyen:

    • Horizontal
    • Vertical
    • Ambos

    La mira del gráfico también se puede configurar para ajustarse a puntos de datos estableciendo la propiedad crosshairsSnapToData en verdadero; de lo contrario, la mira se interpolará entre los puntos de datos. También se pueden habilitar anotaciones para mostrar el valor de la cruz a lo largo del eje.

    Puede configurar la capa en forma de cruz para que la capa solo se muestre en una serie específica, ya que de forma predeterminada se enfocarán en todas las series en el control del gráfico. Para lograr esto, establezca la propiedad targetSeries.

    De forma predeterminada, el color de las líneas en forma de cruz es un color más claro que el de la serie con la que interactúa. Sin embargo, esta configuración predeterminada se puede anular para que pueda seleccionar un color que se utilizará para las líneas en forma de cruz. Esto se hace configurando la propiedad brush de la capa en forma de cruz.

    El siguiente ejemplo muestra cómo configurar la capa en forma de cruz pero apuntando a una sola serie, configurando el tipo en vertical y aplicando estilo al color del pincel.

    Web Components Final Value Layer

    El IgcFinalValueLayerComponent del control IgcDataChartComponent proporciona una vista rápida a lo largo del eje del valor final mostrado en una serie.

    Puede configurar esta anotación para apuntar a una serie específica si desea tener varias capas de valor final presentes con diferentes configuraciones. Esto se puede hacer configurando la propiedad targetSeries.

    También puede personalizar esta anotación configurando las siguientes propiedades:

    • axisAnnotationBackground: esta propiedad se utiliza para elegir el pincel para el color de fondo de la anotación. El valor predeterminado es utilizar el pincel de serie.
    • axisAnnotationTextColor: esta propiedad se utiliza para elegir el pincel para el color del texto de la anotación.
    • axisAnnotationOutline: esta propiedad se utiliza para elegir el pincel para el color del contorno de la anotación.

    El siguiente ejemplo demuestra cómo aplicar estilo a la anotación de la capa de valor final estableciendo las propiedades enumeradas anteriormente.

    <igc-category-chart
         id="chart"
         final-value-annotations-visible="true">
    </igc-category-chart>
    

    Web Components Callout Layer

    IgcCalloutLayerComponent muestra anotaciones de datos nuevos o existentes en el control del gráfico. Las anotaciones aparecen junto a los valores de datos dados en la fuente de datos.

    Utilice las anotaciones de llamada para mostrar información adicional, como notas o detalles específicos sobre puntos de datos, que le gustaría señalar a sus usuarios.

    Puede configurar las leyendas para que se dirijan a una serie específica si desea tener varias capas de leyendas presentes con diferentes configuraciones. Esto se puede hacer configurando la propiedad targetSeries.

    También puede personalizar esta anotación configurando las siguientes propiedades:

    • calloutLeaderBrush: esta propiedad se utiliza para elegir el pincel para las líneas guía de las llamadas de la capa.
    • calloutOutline: esta propiedad se utiliza para elegir el pincel para el color del contorno de la anotación.
    • calloutBackground: esta propiedad se utiliza para elegir el pincel para el color de fondo de la anotación. El valor predeterminado es utilizar el pincel de serie.
    • calloutTextColor: esta propiedad se utiliza para elegir el pincel para el color del texto de la anotación.
    • calloutStrokeThickness: esta propiedad se utiliza para elegir el grosor del respaldo de la llamada.
    • calloutCornerRadius: esta propiedad se utiliza para curvar las esquinas de las llamadas.
    • allowedPositions: esta propiedad se utiliza para elegir qué posiciones puede usar la capa de llamada. p.ej. arriba, abajo

    El siguiente ejemplo demuestra cómo aplicar estilo a las anotaciones de la capa de llamada estableciendo las propiedades enumeradas anteriormente:

    <igc-category-chart
         id="chart"
         width="800px"
         height="400px"
         callouts-visible="true">
    </igc-category-chart>
    
    let chart = (document.getElementById("chart") as IgcCategoryChartComponent);
    
    chart.dataSource = data;
    chart.calloutsDataSource = categoryData;
    chart.calloutsXMemberPath = "index";
    chart.calloutsYMemberPath = "value";
    chart.calloutsLabelMemberPath = "info";
    

    API References

    La siguiente es una lista de miembros de API mencionados en las secciones anteriores: