Angular 원형 진행 구성 요소 개요
Ignite UI for Angular Circular Progress Indicator 구성 요소는 애플리케이션 프로세스가 변경될 때 시각적 표시기를 제공합니다. 원형 표시기는 상태가 변경될 때 모양이 업데이트됩니다.
Angular Circular Progress Example
Getting Started with Ignite UI for Angular Circular Progress
Ignite UI for Angular Circular Progress 구성 요소를 시작하려면 먼저 Ignite UI for Angular 설치해야 합니다. 기존 Angular 애플리케이션에서 다음 명령을 입력합니다.
ng add igniteui-angular
Ignite UI for Angular에 대한 전체 소개는 시작 항목을 참조하십시오.
다음 단계는 다음 단계를 가져오는 것입니다.IgxProgressBarModule 안에 app.module.ts 파일:
// app.module.ts
...
import { IgxProgressBarModule } from 'igniteui-angular/progressbar';
// import { IgxProgressBarModule } from '@infragistics/igniteui-angular'; for licensed package
@NgModule({
...
imports: [..., IgxProgressBarModule],
...
})
export class AppModule {}
또는16.0.0 독립 실행형 의존성으로 가져오IgxCircularProgressBarComponent 거나, 토큰을IGX_CIRCULAR_PROGRESS_BAR_DIRECTIVES 사용해 컴포넌트와 그 지원 컴포넌트, 명령어를 가져올 수도 있습니다.
// home.component.ts
import { IGX_CIRCULAR_PROGRESS_BAR_DIRECTIVES } from 'igniteui-angular/progressbar';
// import { IGX_CIRCULAR_PROGRESS_BAR_DIRECTIVES } from '@infragistics/igniteui-angular'; for licensed package
@Component({
selector: 'app-home',
template: `
<igx-circular-bar
[value]="100"
[animate]="true"
class="custom-size"
></igx-circular-bar>
`,
styleUrls: ['home.component.scss'],
standalone: true,
imports: [IGX_CIRCULAR_PROGRESS_BAR_DIRECTIVES],
/* or imports: [IgxCircularProgressBarComponent] */
})
export class HomeComponent {}
이제 Ignite UI for Angular Progress Bar 모듈이나 지시를 가져왔으니, 컴포넌트를igx-circular-bar 사용할 수 있습니다.
Using the Angular Circular Progress
모든 것이 어떻게 작동하는지 더 잘 이해하기 위해 데모에 있는 것과 같은 간단한 예를 만들어 보겠습니다.
<igx-circular-bar [value]="100" [animate]="true" class="custom-size"></igx-circular-bar>
그런 다음 브라우저에 데모 샘플이 있어야 합니다.
Note
그 igx-원형 바 방출onProgressChanged 이런 객체를 출력하는 이벤트입니다{currentValue: 65, previousValue: 64} 각 계단마다 말이다.
Note
기본 진행 상황은 매 업데이트 주기마다 값의max 1% 씩 증가하며, 값이step 정의되지 않았을 때 발생합니다. 업데이트 속도를step 변경하려면 값을 정의해야 합니다.''
Indeterminate Progress
정확히 결정되지 않은 프로세스를 추적하고 싶다면, 입력 속성을 를 설정할indeterminate 수 있습니다.true
<igx-circular-bar [animate]="false" [indeterminate]="true" [textVisibility]="false"></igx-circular-bar>
Note
원형 진행 바의 텍스트를 숨기려면 속성을 다음으로 설정textVisibility 하면 됩니다.false
최종 결과는 다음과 같습니다.
Dynamic Progress
버튼과 같은 외부 컨트롤을 사용하여 진행률 값을 동적으로 변경할 수 있습니다. 이를 달성하기 위해 값을 클래스 속성에 바인딩할 수 있습니다.
<div class="sample-content">
<igx-circular-bar
[value]="currentValue"
[max]="100"
[animate]="true"
class="custom-size">
</igx-circular-bar>
<div class="button-container">
<button igxIconButton="flat" (click)="decrementProgress()">
<igx-icon fontSet="material">remove</igx-icon>
</button>
<button igxIconButton="flat" (click)="incrementProgress()">
<igx-icon fontSet="material">add</igx-icon>
</button>
</div>
</div>
값을 증가 및 감소시키는 메소드를 추가하십시오.
@Component({...})
export class HomeComponent {
public currentValue: number;
public ngOnInit() {
this.currentValue = 0;
}
public incrementProgress() {
this.currentValue += 10;
if (this.currentValue > 100) {
this.currentValue = 100;
}
}
public decrementProgress() {
this.currentValue -= 10;
if (this.currentValue < 0) {
this.currentValue = 0;
}
}
}
몇 가지 스타일을 추가하세요.
.custom-size {
--diameter: 100px;
}
.sample-content {
width: 300px;
display: flex;
align-items: center;
margin: 30px;
}
Gradient Progress
진행 바를 커스터마이즈하는 한 가지 방법은 단색 대신 색상 그라데이션을 사용하는 것입니다. 이는 두 가지 방법 중 하나로 할 수 있습니다 - 지시문을 사용하는IgxProgressBarGradientDirective 것과, 최대 두 개의 색상 스톱을 지원하는 맞춤형 테마를 구현하는 것입니다.
커스텀 테마를 사용해 두 개의 색상 스톱만 가진 그라데이션을 만들려면, 색상 목록을 만들어 테마 매개변수에$fill-color-default 전달해야 합니다:
$colors: #695cf9, #ef017c;
$custom-theme: progress-circular-theme(
$fill-color-default: $colors,
);
원형 진행 바 스타일링에 대해 더 알아보려면 다음에서 확인할 수 있습니다.Styling Section
2개 이상의 색상 스톱을 가지는 그라데이션을 제공하려면, 다음과 같은 방식으로 에ng-templateigx-circular-bar 대해 명령어를 사용해야 합니다:
<div class="sample-content">
<igx-circular-bar
[value]="currentValue"
[max]="100"
[animate]="true"
class="custom-size">
<ng-template igxProgressBarGradient let-id>
<svg:linearGradient [id]="id" gradientTransform="rotate(90)">
<stop offset="0%" stop-color="#ff9a40" />
<stop offset="50%" stop-color="#1eccd4" />
<stop offset="100%" stop-color="#ff0079" />
</svg:linearGradient>
</ng-template>
</igx-circular-bar>
<div class="button-container">
<button igxIconButton="flat" (click)="removeProgress()">
<igx-icon fontSet="material">remove</igx-icon>
</button>
<button igxIconButton="flat" (click)="addProgress()">
<igx-icon fontSet="material">add</igx-icon>
</button>
</div>
</div>
위 단계를 재현한 후 결과는 다음과 같습니다.
스타일링
원형 진행 바를 스타일링하기 시작하려면, 모든 테마 함수와 컴포넌트 믹스인이 있는 파일을 가져와index야 합니다:
@use "igniteui-angular/theming" as *;
// IMPORTANT: Prior to Ignite UI for Angular version 13 use:
// @import '~igniteui-angular/lib/core/styles/themes/index';
가장 간단한 방법을 따라, 우리는 와progress-circular-theme 매개변수를 확장하고 받아들$base-circle-color 이는 새로운 테마를 만듭니다.$fill-color-default
$custom-theme: progress-circular-theme(
$fill-color-default: rgb(32, 192, 17),
$diameter: 50px
);
마지막 단계는 애플리케이션에 구성 요소 테마를 포함하는 것입니다.
@include css-vars($custom-theme);
Demo
API
GitHub