Blazor Toolbar Overview

    Blazor Toolbar 구성 요소는 주로 차트 구성 요소와 함께 사용되는 UI 작업을 위한 동반 컨테이너입니다. 도구 모음은 IgbDataChart 또는 IgbCategoryChart 구성 요소에 연결되면 미리 설정된 속성 및 도구 항목으로 동적으로 업데이트됩니다. 최종 사용자가 변경 사항을 제공하고 끝없는 양의 사용자 정의를 제공할 수 있도록 프로젝트에 대한 사용자 정의 도구를 만들 수 있습니다.

    Blazor Toolbar Example

    Dependencies

    Add the IgniteUI.Blazor.Controls namespace in the _Imports.razor file:

    @using IgniteUI.Blazor.Controls

    ​IgbDataChart 구성 요소 및 해당 기능과 함께 IgbToolbar 사용할 때 다음 모듈이 필요합니다.

    // in Program.cs file

builder.Services.AddIgniteUIBlazor(
    typeof(IgbToolbarModule),
    typeof(IgbDataChartToolbarModule),
    typeof(IgbDataChartCoreModule),
    typeof(IgbDataChartCategoryModule),
    typeof(IgbDataChartAnnotationModule),
    typeof(IgbDataChartInteractivityModule),
    typeof(IgbDataChartCategoryTrendLineModule)
);

    또한 IgbToolbar 구성 요소에 스타일을 적용하려면 추가 CSS 파일을 연결해야 합니다. 다음은 Blazor 웹 어셈블리 프로젝트의 wwwroot/index.html 파일 또는 Blazor Server 프로젝트의 Pages/_Host.cshtml 파일에 배치되어야 합니다.

    <link href="_content/IgniteUI.Blazor/themes/light/bootstrap.css" rel="stylesheet" />

    Usage

    Tool Actions

    다음은 도구 모음에 추가할 수 있는 다양한 IgbToolAction 항목 목록입니다.

    이러한 도구 각각은 마우스 클릭으로 트리거되는 OnCommand 이벤트를 노출합니다.

    ​IgbToolAction 개체의 OverlayId, BeforeId 및 AfterId 속성을 사용하여 새 도구와 기존 도구의 위치를 변경하고 숨김으로 표시할 수 있습니다. ToolActions는 Visibility 속성도 노출합니다.

    다음 예에서는 기본 제공 항목을 모두 숨기는 방법을 보여줍니다. 확대/축소 재설정 그리고 분석메뉴 메뉴 도구 작업. 새로운 인스턴스 확대/축소 재설정 도구 작업이 추가되어 확대/축소메뉴를 사용하여 AfterId 속성을 할당하고 축소. 그러면 새 재설정 도구가 화면 하단에 표시됩니다. 확대/축소메뉴.

    Blazor Data Chart Integration

    Blazor 도구 모음에는 Target 속성이 포함되어 있습니다. 이는 아래 코드에 표시된 대로 IgbDataChart와 같은 구성 요소를 연결하는 데 사용됩니다.

      <IgbToolbar
    Name="Toolbar"
    @ref="toolbar"
    Target="@chart">
  <IgbToolbar>

  <IgbDataChart
    Name="chart"
    @ref="chart">
  </IgbDataChart>

    ​IgbDataChart가 도구 모음과 연결되면 기존의 여러 IgbToolAction 항목과 메뉴를 사용할 수 있습니다. 다음은 기본 제공 Blazor IgbDataChart 도구 작업 및 관련 OverlayId 목록입니다.

    확대/축소 작업

    추세 조치

    • AnalyzeMenu: 차트의 다양한 옵션을 구성하기 위한 여러 옵션이 포함된 IgbToolActionIconMenu 입니다.
    • AnalyzeHeader: 하위 섹션 헤더입니다.
    • LinesMenu: 차트에 다양한 가로 점선을 표시하기 위한 다양한 도구가 포함된 하위 메뉴입니다.
      • LinesHeader: 다음 세 가지 도구에 대한 하위 메뉴 섹션 헤더입니다.
        • MaxValue: 계열의 최대값에서 yAxis를 따라 가로 점선을 표시하는 IgbToolActionCheckbox 입니다.
        • MinValue: 계열의 최소값에서 yAxis를 따라 가로 점선을 표시하는 IgbToolActionCheckbox 입니다.
        • Average: 계열의 평균 값에서 yAxis를 따라 가로 점선을 표시하는 IgbToolActionCheckbox 입니다.
    • TrendsMenu: IgbDataChart 플롯 영역에 다양한 추세선을 적용하기 위한 도구가 포함된 하위 메뉴입니다.
      • TrendsHeader: 다음 세 가지 도구에 대한 하위 메뉴 섹션 헤더입니다.
    • HelpersHeader: 하위 섹션 헤더입니다.
    • SeriesAvg: ㅏ IgbToolActionCheckbox 추가하거나 제거하는 IgbValueLayer 다음을 사용하여 차트의 시리즈 컬렉션에 ValueLayerValueMode 유형의 Average.
    • ValueLabelsMenu: 플롯 영역에 다양한 주석을 표시하기 위한 다양한 도구가 포함된 하위 메뉴입니다 IgbDataChart.
    • ShowCrosshairs: 차트의 CrosshairsDisplayMode 속성을 통해 마우스 오버 십자선 주석을 전환하는 IgbToolActionCheckbox 입니다.
    • ShowGridlines: ㅏ IgbToolActionCheckbox 이를 적용하여 추가 격자선을 전환합니다. MajorStroke X축으로.

    이미지에 저장 작업

    • CopyAsImage: 차트를 클립보드에 복사하는 옵션을 노출하는 A IgbToolActionLabel 입니다.
    • CopyHeader: 하위 섹션 머리글입니다.

    SVG Icons

    도구를 수동으로 추가할 때 이 RenderIconFromText 방법을 사용하여 아이콘을 할당할 수 있습니다. 이 메서드에는 세 가지 매개 변수가 있습니다. 첫 번째는 도구에 정의된 아이콘 컬렉션 이름입니다. IconCollectionName 두 번째는 도구에 정의된 아이콘의 이름(예: IconName SVG 문자열 추가)입니다.

    <IgbToolActionLabel
    Title="Custom Icon"
    IconName="CustomIcon"
    IconCollectionName="CustomCollection">
</IgbToolActionLabel>

@code {

    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        var toolbar = this.toolbar;

        if (firstRender) {
            this.ToolbarCustomIconOnViewInit();
        }
    }

    private IgbToolbar toolbar;

    public void ToolbarCustomIconOnViewInit()
    {
    	this.toolbar.EnsureReady().ContinueWith(new Action<Task>((e) =>
    	{
    		string icon =
    		@"
    			<svg width=""28px"" height=""28px"" stroke=""none"" viewBox=""0 0 3.5 3.5"" xmlns=""http://www.w3.org/2000/svg"" xmlns:xlink=""http://www.w3.org/1999/xlink"" aria-hidden=""true"" role=""img"" class=""iconify iconify--gis"" preserveAspectRatio=""xMidYMid meet""><path d=""M0.436 0.178a0.073 0.073 0 0 0 -0.062 0.036L0.01 0.846a0.073 0.073 0 0 0 0.063 0.109h0.729a0.073 0.073 0 0 0 0.063 -0.109L0.501 0.214a0.073 0.073 0 0 0 -0.064 -0.036zm0.001 0.219 0.238 0.413H0.199zM1.4 0.507v0.245h0.525v-0.245zm0.77 0v0.245h1.33v-0.245zM0.073 1.388A0.073 0.073 0 0 0 0 1.461v0.583a0.073 0.073 0 0 0 0.073 0.073h0.729A0.073 0.073 0 0 0 0.875 2.045V1.461a0.073 0.073 0 0 0 -0.073 -0.073zm0.073 0.146h0.583v0.438H0.146zM1.4 1.674v0.245h0.945v-0.245zm1.19 0v0.245h0.91v-0.245zM0.438 2.447c-0.241 0 -0.438 0.197 -0.438 0.438 0 0.241 0.197 0.438 0.438 0.438s0.438 -0.197 0.438 -0.438c0 -0.241 -0.197 -0.438 -0.438 -0.438zm0 0.146a0.291 0.291 0 0 1 0.292 0.292 0.291 0.291 0 0 1 -0.292 0.292 0.291 0.291 0 0 1 -0.292 -0.292A0.291 0.291 0 0 1 0.438 2.593zM1.4 2.842v0.245h0.525v-0.245zm0.77 0v0.245h1.33v-0.245z"" fill=""#000000"" fill-rule=""evenodd""/></svg>
    		";
    		this.toolbar.RegisterIconFromTextAsync("CustomCollection", "CustomIcon", icon);
    	}));
    }

}

    Vertical Orientation

    기본적으로 Blazor 도구 모음은 가로로 표시되지만 Orientation 속성을 설정하여 세로로 표시할 수도 있습니다.

    <IgbToolbar Orientation="ToolbarOrientation.Vertical" />

    다음 예제에서는 Blazor Toolbar의 세로 방향을 보여 줍니다.

    API References

    Additional Resources