Linhas de tendência do gráfico Blazor

    No Ignite UI for Blazor, as linhas de tendência ajudam a identificar uma tendência ou encontrar padrões em dados. As linhas de tendência são sempre renderizadas na frente de pontos de dados vinculados ao gráfico e são suportadas por IgbCategoryChart, IgbFinancialChart e IgbDataChart (exceto para séries empilhadas, séries de formas e séries de intervalo).

    As linhas de tendência estão desativadas por padrão, mas você pode habilitá-las definindo a propriedade TrendLineType. Além disso, você pode modificar várias propriedades de aparência das linhas de tendência, como pincel, período e espessura.

    As linhas de tendência também têm a capacidade de ter uma matriz de traços aplicada a elas, uma vez ativadas. Isso é feito definindo a TrendLineDashArray propriedade como uma matriz de números. A matriz numérica descreve o comprimento dos traços da linha de tendência.

    Exemplo de linhas de tendência do gráfico Blazor

    O exemplo a seguir descreve um IgbFinancialChart mostrando a tendência de ações da Microsoft entre 2013 e 2017 com uma linha de tendência QuinticFit aplicada inicialmente. Há um menu suspenso que permitirá que você altere o tipo de linha de tendência aplicada, e todos os tipos de linha de tendência possíveis são listados nesse menu suspenso.

    Exemplo de matriz de traços de linhas de tendência do gráfico Blazor

    O exemplo a seguir descreve um IgbDataChart mostrando um IgbFinancialPriceSeries com uma linha de tendência tracejada QuarticFit aplicada por meio da propriedade TrendLineDashArray:

    Blazor Camada de linha de tendência do gráfico

    O TrendLineLayer é um tipo de série projetado para exibir um único tipo de linha de tendência para uma série de destino. A diferença entre isso e os recursos de linha de tendência existentes nos tipos de série existentes é que, como é TrendLineLayer um tipo de série, você pode adicionar mais de um deles à Series coleção do gráfico para ter várias linhas de tendência anexadas à mesma série. Você também pode fazer com que a linha de tendência apareça na legenda, o que não era possível anteriormente.

    Trendline Layer Usage

    O TrendLineLayer deve ser fornecido com a TargetSeries e a TrendLineType para funcionar corretamente. Os diferentes tipos de linha de tendência disponíveis são os mesmos que as linhas de tendência disponíveis na série.

    Se você quiser mostrar o TrendLineLayer na Legenda, poderá fazê-lo definindo a UseLegend propriedade como true.

    Styling the Trendline Layer

    Por padrão, o renderiza TrendLineLayer com a mesma cor que está TargetSeries em uma linha tracejada. Isso pode ser configurado usando as várias propriedades de estilo no TrendLineLayer.

    Para alterar a cor da linha de tendência desenhada, você pode definir sua Brush propriedade. Como alternativa, você também pode definir a UseIndex propriedade como true, que será extraída da paleta do Brushes gráfico com base no índice no qual o TrendLineLayer é colocado na coleção do Series gráfico.

    Você também pode modificar a maneira como o TrendLineLayer aparece usando suas AppearanceMode propriedades e ShiftAmount. O ShiftAmount assume um valor entre -1,0 e 1,0 para determinar quanto de um "deslocamento" aplicar às opções que terminam em "Deslocamento".

    A seguir estão as opções para a AppearanceMode propriedade:

    • Auto: Isso será padronizado para a enumeração DashPattern.
    • BrightnessShift: A linha de tendência pegará o TargetSeries pincel e modificará seu brilho com base no fornecido ShiftAmount.
    • DashPattern: A linha de tendência aparecerá como uma linha tracejada. A frequência dos traços pode ser modificada usando a DashArray propriedade no TrendLineLayer.
    • OpacityShift: A linha de tendência pegará o TargetSeries pincel e modificará sua opacidade com base no fornecido ShiftAmount.
    • SaturationShift: A linha de tendência pegará o TargetSeries pincel e modificará sua saturação com base no fornecido ShiftAmount.

    Additional Resources

    Você pode encontrar mais informações sobre recursos de gráfico relacionados nestes tópicos:

    API References

    Os componentes IgbCategoryChart e IgbFinancialChart compartilham as seguintes propriedades de API:

    No componente IgbDataChart, a maioria dos tipos de séries tem as seguintes propriedades de API: