feat(experimental): Rating add new component (#5633)

Co-authored-by: taiga-family-bot <[email protected]>

projects/cdk/constants/used-icons.ts

@@ -49,6 +49,7 @@ export const TUI_USED_ICONS = [
     `tuiIconCheckCircle`,
     `tuiIconXCircle`,
     `tuiIconChevronLeft`,
+    `tuiIconStarLarge`,
     `tuiIconChevronDown`,
     `tuiIconChevronDownLarge`,
     `tuiIconFileLarge`,
@@ -61,7 +62,6 @@ export const TUI_USED_ICONS = [
     `tuiIconEyeLarge`,
     `tuiIconClock`,
     `tuiIconClockLarge`,
-    `tuiIconStarLarge`,
     `tuiIconToggleOff`,
     `tuiIconToggleOffLarge`,
     `tuiIconToggleOn`,

projects/core/styles/mixins/mixins.less

@@ -273,7 +273,7 @@
 
 .hoverable-with-shadow() {
     .shadow();
-    .transition(all);
+    .transition();
     cursor: pointer;
     transition-property: transform, box-shadow;
     will-change: transform, box-shadow;

projects/core/styles/mixins/mixins.scss

@@ -229,7 +229,7 @@
 }
 
 // transition
-@mixin transition($param, $speed: var(--tui-duration, 300ms)) {
+@mixin transition($param: all, $speed: var(--tui-duration, 300ms)) {
     transition-property: $param;
     transition-duration: $speed;
     transition-timing-function: ease-in-out;

projects/demo/src/modules/app/app.routes.ts

@@ -257,6 +257,14 @@ export const ROUTES: Routes = [
             title: `Fade`,
         },
     },
+    {
+        path: `experimental/rating`,
+        loadChildren: async () =>
+            (await import(`../experimental/rating/rating.module`)).ExampleTuiRatingModule,
+        data: {
+            title: `Rating`,
+        },
+    },
     {
         path: `experimental/sensitive`,
         loadChildren: async () =>

projects/demo/src/modules/app/pages.ts

@@ -865,6 +865,12 @@ export const pages: TuiDocPages = [
         keywords: `overflow, ellipsis, gradient, clamp, line`,
         route: `/experimental/fade`,
     },
+    {
+        section: `Experimental`,
+        title: `Rating `,
+        keywords: `рейтинг, оценка, звезда, rating, star, rate`,
+        route: `/experimental/rating`,
+    },
     {
         section: `Experimental`,
         title: `Sensitive`,

projects/demo/src/modules/experimental/button/button.template.html

@@ -122,7 +122,7 @@
     <ng-template pageTab>
         <ol class="b-demo-steps">
             <li>
-                <p>Import module</p>
+                <p>Import module:</p>
 
                 <tui-doc-code
                     filename="myComponent.module.ts"

projects/demo/src/modules/experimental/compass/compass.template.html

@@ -61,7 +61,7 @@
     <ng-template pageTab>
         <ol class="b-demo-steps">
             <li>
-                <p>Import module</p>
+                <p>Import module:</p>
 
                 <tui-doc-code
                     filename="my.module.ts"

projects/demo/src/modules/experimental/rating/examples/1/index.html

@@ -0,0 +1,6 @@
+<label tuiLabel="Rate Taiga UI">
+    <tui-rating
+        class="rating"
+        [(ngModel)]="value"
+    ></tui-rating>
+</label>

projects/demo/src/modules/experimental/rating/examples/1/index.less

@@ -0,0 +1,5 @@
+.rating {
+    fill: currentColor;
+    font-size: 0.625rem;
+    width: 10rem;
+}

projects/demo/src/modules/experimental/rating/examples/1/index.ts

@@ -0,0 +1,14 @@
+import {Component} from '@angular/core';
+import {changeDetection} from '@demo/emulate/change-detection';
+import {encapsulation} from '@demo/emulate/encapsulation';
+
+@Component({
+    selector: 'tui-rating-example-1',
+    templateUrl: './index.html',
+    styleUrls: ['./index.less'],
+    changeDetection,
+    encapsulation,
+})
+export class TuiRatingExample1 {
+    value = 0;
+}

projects/demo/src/modules/experimental/rating/examples/2/index.html

@@ -0,0 +1,20 @@
+<label tuiLabel="Are you satisfied with Taiga UI?">
+    <tui-rating
+        class="rating"
+        [attr.data-value]="value"
+        [icon]="icon"
+        [max]="3"
+        [(ngModel)]="value"
+    ></tui-rating>
+    <button
+        *ngIf="value"
+        appearance="icon"
+        iconLeft="tuiIconCloseLarge"
+        size="s"
+        tuiIconButton
+        class="button"
+        (click)="value = 0"
+    >
+        Clear
+    </button>
+</label>

projects/demo/src/modules/experimental/rating/examples/2/index.less

@@ -0,0 +1,23 @@
+.rating,
+.button {
+    display: inline-block;
+    vertical-align: middle;
+}
+
+.rating {
+    &[data-value='1'] {
+        color: var(--tui-negative);
+    }
+
+    &[data-value='2'] {
+        color: var(--tui-warning-fill);
+    }
+
+    &[data-value='3'] {
+        color: var(--tui-positive);
+    }
+
+    &:hover {
+        color: var(--tui-info-fill);
+    }
+}

projects/demo/src/modules/experimental/rating/examples/2/index.ts

@@ -0,0 +1,29 @@
+import {Component} from '@angular/core';
+import {changeDetection} from '@demo/emulate/change-detection';
+import {encapsulation} from '@demo/emulate/encapsulation';
+import {TuiContextWithImplicit} from '@taiga-ui/cdk';
+import {PolymorpheusContent} from '@tinkoff/ng-polymorpheus';
+
+@Component({
+    selector: 'tui-rating-example-2',
+    templateUrl: 'index.html',
+    styleUrls: ['index.less'],
+    changeDetection,
+    encapsulation,
+})
+export class TuiRatingExample2 {
+    value = 0;
+
+    readonly icon: PolymorpheusContent<TuiContextWithImplicit<number>> = ({
+        $implicit,
+    }) => {
+        switch ($implicit) {
+            case 1:
+                return 'tuiIconFrownLarge';
+            case 2:
+                return 'tuiIconMehLarge';
+            default:
+                return 'tuiIconSmileLarge';
+        }
+    };
+}

projects/demo/src/modules/experimental/rating/examples/3/index.html

@@ -0,0 +1,7 @@
+<label tuiLabel="Back to the Future">
+    <tui-rating
+        [max]="10"
+        [ngModel]="8.5"
+        [readOnly]="true"
+    ></tui-rating>
+</label>

projects/demo/src/modules/experimental/rating/examples/3/index.ts

@@ -0,0 +1,11 @@
+import {Component} from '@angular/core';
+import {changeDetection} from '@demo/emulate/change-detection';
+import {encapsulation} from '@demo/emulate/encapsulation';
+
+@Component({
+    selector: 'tui-rating-example-3',
+    templateUrl: 'index.html',
+    changeDetection,
+    encapsulation,
+})
+export class TuiRatingExample3 {}

projects/demo/src/modules/experimental/rating/examples/import/import-module.md

@@ -0,0 +1,13 @@
+```ts
+import {NgModule} from '@angular/core';
+import {TuiRatingModule} from '@taiga-ui/experimental';
+// ...
+
+@NgModule({
+  imports: [
+    // ...
+    TuiRatingModule,
+  ],
+})
+export class MyModule {}
+```

projects/demo/src/modules/experimental/rating/examples/import/insert-template.md

@@ -0,0 +1,3 @@
+```html
+<tui-rating [(ngModel)]="value"></tui-rating>
+```

projects/demo/src/modules/experimental/rating/rating.component.ts

@@ -0,0 +1,33 @@
+import {Component} from '@angular/core';
+import {changeDetection} from '@demo/emulate/change-detection';
+import {TuiDocExample, TuiRawLoaderContent} from '@taiga-ui/addon-doc';
+
+@Component({
+    selector: 'example-rating',
+    templateUrl: './rating.template.html',
+    changeDetection,
+})
+export class ExampleTuiRatingComponent {
+    readonly exampleModule: TuiRawLoaderContent = import(
+        './examples/import/import-module.md?raw'
+    );
+
+    readonly exampleHtml: TuiRawLoaderContent = import(
+        './examples/import/insert-template.md?raw'
+    );
+
+    readonly example1: TuiDocExample = {
+        HTML: import('./examples/1/index.html?raw'),
+        LESS: import('./examples/1/index.less?raw'),
+    };
+
+    readonly example2: TuiDocExample = {
+        TypeScript: import('./examples/2/index.ts?raw'),
+        HTML: import('./examples/2/index.html?raw'),
+        LESS: import('./examples/2/index.less?raw'),
+    };
+
+    readonly example3: TuiDocExample = {
+        HTML: import('./examples/3/index.html?raw'),
+    };
+}

projects/demo/src/modules/experimental/rating/rating.module.ts

@@ -0,0 +1,31 @@
+import {CommonModule} from '@angular/common';
+import {NgModule} from '@angular/core';
+import {FormsModule} from '@angular/forms';
+import {tuiGetDocModules} from '@taiga-ui/addon-doc';
+import {TuiLabelModule, TuiNotificationModule} from '@taiga-ui/core';
+import {TuiButtonModule, TuiRatingModule} from '@taiga-ui/experimental';
+
+import {TuiRatingExample1} from './examples/1';
+import {TuiRatingExample2} from './examples/2';
+import {TuiRatingExample3} from './examples/3';
+import {ExampleTuiRatingComponent} from './rating.component';
+
+@NgModule({
+    imports: [
+        CommonModule,
+        FormsModule,
+        TuiRatingModule,
+        TuiNotificationModule,
+        TuiLabelModule,
+        tuiGetDocModules(ExampleTuiRatingComponent),
+        TuiButtonModule,
+    ],
+    declarations: [
+        ExampleTuiRatingComponent,
+        TuiRatingExample1,
+        TuiRatingExample2,
+        TuiRatingExample3,
+    ],
+    exports: [ExampleTuiRatingComponent],
+})
+export class ExampleTuiRatingModule {}

projects/demo/src/modules/experimental/rating/rating.template.html

@@ -0,0 +1,59 @@
+<tui-doc-page
+    header="Rating"
+    package="EXPERIMENTAL"
+    type="components"
+>
+    <ng-template pageTab>
+        <tui-notification status="warning">
+            This code is
+            <strong>experimental</strong>
+            and is a subject to change. Expect final solution to be shipped in the next major version
+        </tui-notification>
+
+        <tui-doc-example
+            id="basic"
+            heading="Basic"
+            [content]="example1"
+        >
+            <tui-rating-example-1></tui-rating-example-1>
+        </tui-doc-example>
+
+        <tui-doc-example
+            id="icons"
+            heading="Custom icons"
+            [content]="example2"
+        >
+            <tui-rating-example-2></tui-rating-example-2>
+        </tui-doc-example>
+
+        <tui-doc-example
+            id="readonly"
+            heading="Readonly"
+            [content]="example3"
+        >
+            <tui-rating-example-3></tui-rating-example-3>
+        </tui-doc-example>
+    </ng-template>
+
+    <ng-template pageTab="Setup">
+        <ol class="b-demo-steps">
+            <li>
+                <p>Import module:</p>
+
+                <tui-doc-code
+                    filename="my.module.ts"
+                    [code]="exampleModule"
+                ></tui-doc-code>
+            </li>
+
+            <li>
+                <p>Add to the template:</p>
+
+                <tui-doc-code
+                    filename="my.component.html"
+                    [code]="exampleHtml"
+                ></tui-doc-code>
+            </li>
+        </ol>
+    </ng-template>
+</tui-doc-page>

projects/experimental/components/index.ts

@@ -5,3 +5,4 @@ export * from '@taiga-ui/experimental/components/badge-alert';
 export * from '@taiga-ui/experimental/components/badged-content';
 export * from '@taiga-ui/experimental/components/button';
 export * from '@taiga-ui/experimental/components/compass';
+export * from '@taiga-ui/experimental/components/rating';

projects/experimental/components/rating/index.ts

@@ -0,0 +1,3 @@
+export * from './rating.component';
+export * from './rating.module';
+export * from './rating.options';

projects/experimental/components/rating/ng-package.json

@@ -0,0 +1,8 @@
+{
+    "lib": {
+        "entryFile": "index.ts",
+        "styleIncludePaths": [
+            "../../../core/styles"
+        ]
+    }
+}