@angular/animations 19.1.0-next.0 → 19.1.0-next.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/browser/index.d.ts +1 -1
- package/browser/testing/index.d.ts +1 -1
- package/fesm2022/animations.mjs +34 -34
- package/fesm2022/animations.mjs.map +1 -1
- package/fesm2022/browser/testing.mjs +1 -1
- package/fesm2022/browser.mjs +7 -7
- package/fesm2022/browser.mjs.map +1 -1
- package/index.d.ts +29 -29
- package/package.json +2 -2
package/browser/index.d.ts
CHANGED
package/fesm2022/animations.mjs
CHANGED
@@ -1,5 +1,5 @@
|
|
1
1
|
/**
|
2
|
-
* @license Angular v19.1.0-next.
|
2
|
+
* @license Angular v19.1.0-next.2
|
3
3
|
* (c) 2010-2024 Google LLC. https://angular.io/
|
4
4
|
* License: MIT
|
5
5
|
*/
|
@@ -119,7 +119,7 @@ const AUTO_STYLE = '*';
|
|
119
119
|
* The provided animation value is expected to be an array consisting of state and
|
120
120
|
* transition declarations.
|
121
121
|
*
|
122
|
-
* ```
|
122
|
+
* ```ts
|
123
123
|
* @Component({
|
124
124
|
* selector: "my-component",
|
125
125
|
* templateUrl: "my-component-tpl.html",
|
@@ -149,7 +149,7 @@ const AUTO_STYLE = '*';
|
|
149
149
|
* The `transition` animation method also supports reading an inline function which can decide
|
150
150
|
* if its associated animation should be run.
|
151
151
|
*
|
152
|
-
* ```
|
152
|
+
* ```ts
|
153
153
|
* // this method is run each time the `myAnimationTrigger` trigger value changes.
|
154
154
|
* function myInlineMatcherFn(fromState: string, toState: string, element: any, params: {[key:
|
155
155
|
string]: any}): boolean {
|
@@ -182,7 +182,7 @@ const AUTO_STYLE = '*';
|
|
182
182
|
*
|
183
183
|
* The following example shows how to use this feature:
|
184
184
|
*
|
185
|
-
* ```
|
185
|
+
* ```angular-ts
|
186
186
|
* @Component({
|
187
187
|
* selector: 'my-component',
|
188
188
|
* template: `
|
@@ -211,7 +211,7 @@ const AUTO_STYLE = '*';
|
|
211
211
|
* This means that you can disable all animations for an app
|
212
212
|
* by placing a host binding set on `@.disabled` on the topmost Angular component.
|
213
213
|
*
|
214
|
-
* ```
|
214
|
+
* ```ts
|
215
215
|
* import {Component, HostBinding} from '@angular/core';
|
216
216
|
*
|
217
217
|
* @Component({
|
@@ -284,12 +284,12 @@ function trigger(name, definitions) {
|
|
284
284
|
* **Style examples**
|
285
285
|
*
|
286
286
|
* The following example calls `style()` to set a single CSS style.
|
287
|
-
* ```
|
287
|
+
* ```ts
|
288
288
|
* animate(500, style({ background: "red" }))
|
289
289
|
* ```
|
290
290
|
* The following example calls `keyframes()` to set a CSS style
|
291
291
|
* to different values for successive keyframes.
|
292
|
-
* ```
|
292
|
+
* ```ts
|
293
293
|
* animate(500, keyframes(
|
294
294
|
* [
|
295
295
|
* style({ background: "blue" }),
|
@@ -312,7 +312,7 @@ function animate(timings, styles = null) {
|
|
312
312
|
* `keyframes()`, or use `animate()` calls with a delay value.
|
313
313
|
* For example:
|
314
314
|
*
|
315
|
-
* ```
|
315
|
+
* ```ts
|
316
316
|
* group([
|
317
317
|
* animate("1s", style({ background: "black" })),
|
318
318
|
* animate("2s", style({ color: "white" }))
|
@@ -346,7 +346,7 @@ function group(steps, options = null) {
|
|
346
346
|
* - Steps defined by `animate()` calls apply the styling data over time
|
347
347
|
* as specified by the timing data.
|
348
348
|
*
|
349
|
-
* ```
|
349
|
+
* ```ts
|
350
350
|
* sequence([
|
351
351
|
* style({ opacity: 0 }),
|
352
352
|
* animate("1s", style({ opacity: 1 }))
|
@@ -395,7 +395,7 @@ function sequence(steps, options = null) {
|
|
395
395
|
* The following examples create animation styles that collect a set of
|
396
396
|
* CSS property values:
|
397
397
|
*
|
398
|
-
* ```
|
398
|
+
* ```ts
|
399
399
|
* // string values for CSS properties
|
400
400
|
* style({ background: "red", color: "blue" })
|
401
401
|
*
|
@@ -406,7 +406,7 @@ function sequence(steps, options = null) {
|
|
406
406
|
* The following example uses auto-styling to allow an element to animate from
|
407
407
|
* a height of 0 up to its full height:
|
408
408
|
*
|
409
|
-
* ```
|
409
|
+
* ```ts
|
410
410
|
* style({ height: 0 }),
|
411
411
|
* animate("1s", style({ height: "*" }))
|
412
412
|
* ```
|
@@ -469,7 +469,7 @@ function state(name, styles, options) {
|
|
469
469
|
* when each `backgroundColor` value is applied. The color is red at the start, and changes to
|
470
470
|
* blue when 20% of the total time has elapsed.
|
471
471
|
*
|
472
|
-
* ```
|
472
|
+
* ```ts
|
473
473
|
* // the provided offset values
|
474
474
|
* animate("5s", keyframes([
|
475
475
|
* style({ backgroundColor: "red", offset: 0 }),
|
@@ -482,7 +482,7 @@ function state(name, styles, options) {
|
|
482
482
|
* If there are no `offset` values specified in the style entries, the offsets
|
483
483
|
* are calculated automatically.
|
484
484
|
*
|
485
|
-
* ```
|
485
|
+
* ```ts
|
486
486
|
* animate("5s", keyframes([
|
487
487
|
* style({ backgroundColor: "red" }) // offset = 0
|
488
488
|
* style({ backgroundColor: "blue" }) // offset = 0.33
|
@@ -524,7 +524,7 @@ function keyframes(steps) {
|
|
524
524
|
* expression bound to the trigger's element goes from `fromState` to `toState`
|
525
525
|
*
|
526
526
|
* _Example:_
|
527
|
-
* ```
|
527
|
+
* ```ts
|
528
528
|
* transition('open => closed', animate('.5s ease-out', style({ height: 0 }) ))
|
529
529
|
* ```
|
530
530
|
*
|
@@ -532,7 +532,7 @@ function keyframes(steps) {
|
|
532
532
|
* the expression bound to the trigger's element goes from `fromState` to `toState` or vice versa
|
533
533
|
*
|
534
534
|
* _Example:_
|
535
|
-
* ```
|
535
|
+
* ```ts
|
536
536
|
* transition('enabled <=> disabled', animate('1s cubic-bezier(0.8,0.3,0,1)'))
|
537
537
|
* ```
|
538
538
|
*
|
@@ -540,7 +540,7 @@ function keyframes(steps) {
|
|
540
540
|
* element enters or exists the DOM
|
541
541
|
*
|
542
542
|
* _Example:_
|
543
|
-
* ```
|
543
|
+
* ```ts
|
544
544
|
* transition(':enter', [
|
545
545
|
* style({ opacity: 0 }),
|
546
546
|
* animate('500ms', style({ opacity: 1 }))
|
@@ -551,7 +551,7 @@ function keyframes(steps) {
|
|
551
551
|
* the numerical expression bound to the trigger's element has increased in value or decreased
|
552
552
|
*
|
553
553
|
* _Example:_
|
554
|
-
* ```
|
554
|
+
* ```ts
|
555
555
|
* transition(':increment', query('@counter', animateChild()))
|
556
556
|
* ```
|
557
557
|
*
|
@@ -559,7 +559,7 @@ function keyframes(steps) {
|
|
559
559
|
* should occur whenever one of the state change expressions matches
|
560
560
|
*
|
561
561
|
* _Example:_
|
562
|
-
* ```
|
562
|
+
* ```ts
|
563
563
|
* transition(':increment, * => enabled, :enter', animate('1s ease', keyframes([
|
564
564
|
* style({ transform: 'scale(1)', offset: 0}),
|
565
565
|
* style({ transform: 'scale(1.1)', offset: 0.7}),
|
@@ -575,7 +575,7 @@ function keyframes(steps) {
|
|
575
575
|
* - `true` and `false` also match expression values of `1` and `0` respectively (but do not match
|
576
576
|
* _truthy_ and _falsy_ values)
|
577
577
|
*
|
578
|
-
* <div class="alert
|
578
|
+
* <div class="docs-alert docs-alert-helpful">
|
579
579
|
*
|
580
580
|
* Be careful about entering end leaving elements as their transitions present a common
|
581
581
|
* pitfall for developers.
|
@@ -608,7 +608,7 @@ function keyframes(steps) {
|
|
608
608
|
* </div>
|
609
609
|
* ```
|
610
610
|
*
|
611
|
-
* ```
|
611
|
+
* ```ts
|
612
612
|
* trigger("myAnimationTrigger", [
|
613
613
|
* ..., // states
|
614
614
|
* transition("on => off, open => closed", animate(500)),
|
@@ -628,7 +628,7 @@ function keyframes(steps) {
|
|
628
628
|
* </div>
|
629
629
|
* ```
|
630
630
|
*
|
631
|
-
* ```
|
631
|
+
* ```ts
|
632
632
|
* trigger("myAnimationTrigger", [
|
633
633
|
* ..., // states
|
634
634
|
* transition(
|
@@ -662,7 +662,7 @@ function transition(stateChangeExpr, steps, options = null) {
|
|
662
662
|
* The following example defines a reusable animation, providing some default parameter
|
663
663
|
* values.
|
664
664
|
*
|
665
|
-
* ```
|
665
|
+
* ```ts
|
666
666
|
* var fadeAnimation = animation([
|
667
667
|
* style({ opacity: '{{ start }}' }),
|
668
668
|
* animate('{{ time }}',
|
@@ -754,7 +754,7 @@ function useAnimation(animation, options = null) {
|
|
754
754
|
*
|
755
755
|
* Tokens can be merged into a combined query selector string. For example:
|
756
756
|
*
|
757
|
-
* ```
|
757
|
+
* ```ts
|
758
758
|
* query(':self, .record:enter, .record:leave, @subTrigger', [...])
|
759
759
|
* ```
|
760
760
|
*
|
@@ -791,7 +791,7 @@ function useAnimation(animation, options = null) {
|
|
791
791
|
* - Those inserted dynamically (via `ViewContainerRef`)
|
792
792
|
* - Those that have a structural directive (which, under the hood, are a subset of the above ones)
|
793
793
|
*
|
794
|
-
* <div class="alert
|
794
|
+
* <div class="docs-alert docs-alert-helpful">
|
795
795
|
*
|
796
796
|
* Note that elements will be successfully queried via `:enter`/`:leave` even if their
|
797
797
|
* insertion/removal is not done manually via `ViewContainerRef`or caused by their structural
|
@@ -799,7 +799,7 @@ function useAnimation(animation, options = null) {
|
|
799
799
|
*
|
800
800
|
* </div>
|
801
801
|
*
|
802
|
-
* <div class="alert
|
802
|
+
* <div class="docs-alert docs-alert-important">
|
803
803
|
*
|
804
804
|
* There is an exception to what previously mentioned, besides elements entering/leaving based on
|
805
805
|
* their own logic, elements with an animation trigger can always be queried via `:leave` when
|
@@ -812,7 +812,7 @@ function useAnimation(animation, options = null) {
|
|
812
812
|
* The following example queries for inner elements and animates them
|
813
813
|
* individually using `animate()`.
|
814
814
|
*
|
815
|
-
* ```
|
815
|
+
* ```angular-ts
|
816
816
|
* @Component({
|
817
817
|
* selector: 'inner',
|
818
818
|
* template: `
|
@@ -882,7 +882,7 @@ function query(selector, animation, options = null) {
|
|
882
882
|
*
|
883
883
|
* Here is the component code:
|
884
884
|
*
|
885
|
-
* ```
|
885
|
+
* ```ts
|
886
886
|
* import {trigger, transition, style, animate, query, stagger} from '@angular/animations';
|
887
887
|
* @Component({
|
888
888
|
* templateUrl: 'list.component.html',
|
@@ -911,7 +911,7 @@ function query(selector, animation, options = null) {
|
|
911
911
|
*
|
912
912
|
* Here is the animation trigger code:
|
913
913
|
*
|
914
|
-
* ```
|
914
|
+
* ```ts
|
915
915
|
* trigger('listAnimation', [
|
916
916
|
* transition('* => *', [ // each time the binding value changes
|
917
917
|
* query(':leave', [
|
@@ -982,10 +982,10 @@ function stagger(timings, animation) {
|
|
982
982
|
* @publicApi
|
983
983
|
*/
|
984
984
|
class AnimationBuilder {
|
985
|
-
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.1.0-next.
|
986
|
-
static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.1.0-next.
|
985
|
+
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.1.0-next.2", ngImport: i0, type: AnimationBuilder, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
|
986
|
+
static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.1.0-next.2", ngImport: i0, type: AnimationBuilder, providedIn: 'root', useFactory: () => inject(BrowserAnimationBuilder) });
|
987
987
|
}
|
988
|
-
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.1.0-next.
|
988
|
+
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.1.0-next.2", ngImport: i0, type: AnimationBuilder, decorators: [{
|
989
989
|
type: Injectable,
|
990
990
|
args: [{ providedIn: 'root', useFactory: () => inject(BrowserAnimationBuilder) }]
|
991
991
|
}] });
|
@@ -1025,10 +1025,10 @@ class BrowserAnimationBuilder extends AnimationBuilder {
|
|
1025
1025
|
issueAnimationCommand(this._renderer, null, id, 'register', [entry]);
|
1026
1026
|
return new BrowserAnimationFactory(id, this._renderer);
|
1027
1027
|
}
|
1028
|
-
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.1.0-next.
|
1029
|
-
static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.1.0-next.
|
1028
|
+
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.1.0-next.2", ngImport: i0, type: BrowserAnimationBuilder, deps: [{ token: i0.RendererFactory2 }, { token: DOCUMENT }], target: i0.ɵɵFactoryTarget.Injectable });
|
1029
|
+
static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.1.0-next.2", ngImport: i0, type: BrowserAnimationBuilder, providedIn: 'root' });
|
1030
1030
|
}
|
1031
|
-
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.1.0-next.
|
1031
|
+
i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.1.0-next.2", ngImport: i0, type: BrowserAnimationBuilder, decorators: [{
|
1032
1032
|
type: Injectable,
|
1033
1033
|
args: [{ providedIn: 'root' }]
|
1034
1034
|
}], ctorParameters: () => [{ type: i0.RendererFactory2 }, { type: Document, decorators: [{
|