1/* 2 * Copyright (c) 2021-2023 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16/** 17 * @file 18 * @kit ArkUI 19 */ 20 21/** 22 * Provides methods for switching components. 23 * 24 * @syscap SystemCapability.ArkUI.ArkUI.Full 25 * @since 7 26 */ 27/** 28 * Provides methods for switching components. 29 * 30 * @syscap SystemCapability.ArkUI.ArkUI.Full 31 * @crossplatform 32 * @form 33 * @since 10 34 */ 35/** 36 * Provides methods for switching components. 37 * 38 * @syscap SystemCapability.ArkUI.ArkUI.Full 39 * @crossplatform 40 * @form 41 * @atomicservice 42 * @since 11 43 */ 44declare class SwiperController { 45 /** 46 * constructor. 47 * 48 * @syscap SystemCapability.ArkUI.ArkUI.Full 49 * @since 7 50 */ 51 /** 52 * constructor. 53 * 54 * @syscap SystemCapability.ArkUI.ArkUI.Full 55 * @crossplatform 56 * @form 57 * @since 10 58 */ 59 /** 60 * constructor. 61 * 62 * @syscap SystemCapability.ArkUI.ArkUI.Full 63 * @crossplatform 64 * @form 65 * @atomicservice 66 * @since 11 67 */ 68 constructor(); 69 70 /** 71 * Called when the next child component is displayed. 72 * 73 * @syscap SystemCapability.ArkUI.ArkUI.Full 74 * @since 7 75 */ 76 /** 77 * Called when the next child component is displayed. 78 * 79 * @syscap SystemCapability.ArkUI.ArkUI.Full 80 * @crossplatform 81 * @form 82 * @since 10 83 */ 84 /** 85 * Called when the next child component is displayed. 86 * 87 * @syscap SystemCapability.ArkUI.ArkUI.Full 88 * @crossplatform 89 * @form 90 * @atomicservice 91 * @since 11 92 */ 93 showNext(); 94 95 /** 96 * Called when the previous subcomponent is displayed. 97 * 98 * @syscap SystemCapability.ArkUI.ArkUI.Full 99 * @since 7 100 */ 101 /** 102 * Called when the previous subcomponent is displayed. 103 * 104 * @syscap SystemCapability.ArkUI.ArkUI.Full 105 * @crossplatform 106 * @form 107 * @since 10 108 */ 109 /** 110 * Called when the previous subcomponent is displayed. 111 * 112 * @syscap SystemCapability.ArkUI.ArkUI.Full 113 * @crossplatform 114 * @form 115 * @atomicservice 116 * @since 11 117 */ 118 showPrevious(); 119 120 /** 121 * Controlling Swiper to change to the specified subcomponent. 122 * 123 * @param { number } index - the index of item to be redirected. 124 * @param { boolean } useAnimation - If true, swipe to index item with animation. If false, swipe to index item without animation. 125 * The default value is false. 126 * @syscap SystemCapability.ArkUI.ArkUI.Full 127 * @crossplatform 128 * @form 129 * @atomicservice 130 * @since 12 131 */ 132 changeIndex(index: number, useAnimation?: boolean); 133 134 /** 135 * Called when need to stop the swiper animation. 136 * 137 * @param { function } callback 138 * @syscap SystemCapability.ArkUI.ArkUI.Full 139 * @since 7 140 */ 141 /** 142 * Called when need to stop the swiper animation. 143 * 144 * @param { function } callback 145 * @syscap SystemCapability.ArkUI.ArkUI.Full 146 * @crossplatform 147 * @form 148 * @since 10 149 */ 150 /** 151 * Called when need to stop the swiper animation. 152 * 153 * @param { function } callback 154 * @syscap SystemCapability.ArkUI.ArkUI.Full 155 * @crossplatform 156 * @form 157 * @atomicservice 158 * @since 11 159 */ 160 finishAnimation(callback?: () => void); 161} 162 163/** 164 * Defines the indicator class. 165 * 166 * @syscap SystemCapability.ArkUI.ArkUI.Full 167 * @crossplatform 168 * @form 169 * @since 10 170 */ 171/** 172 * Defines the indicator class. 173 * 174 * @syscap SystemCapability.ArkUI.ArkUI.Full 175 * @crossplatform 176 * @form 177 * @atomicservice 178 * @since 11 179 */ 180declare class Indicator<T> { 181 /** 182 * Set the indicator to the left. 183 * 184 * @param { Length } value - the indicator to the left. 185 * @returns { T } 186 * @syscap SystemCapability.ArkUI.ArkUI.Full 187 * @crossplatform 188 * @form 189 * @since 10 190 */ 191 /** 192 * Set the indicator to the left. 193 * 194 * @param { Length } value - the indicator to the left. 195 * @returns { T } 196 * @syscap SystemCapability.ArkUI.ArkUI.Full 197 * @crossplatform 198 * @form 199 * @atomicservice 200 * @since 11 201 */ 202 left(value: Length): T; 203 204 /** 205 * Set the indicator to the top. 206 * 207 * @param { Length } value - the indicator to the top. 208 * @returns { T } 209 * @syscap SystemCapability.ArkUI.ArkUI.Full 210 * @crossplatform 211 * @form 212 * @since 10 213 */ 214 /** 215 * Set the indicator to the top. 216 * 217 * @param { Length } value - the indicator to the top. 218 * @returns { T } 219 * @syscap SystemCapability.ArkUI.ArkUI.Full 220 * @crossplatform 221 * @form 222 * @atomicservice 223 * @since 11 224 */ 225 top(value: Length): T; 226 227 /** 228 * Set the indicator to the right. 229 * 230 * @param { Length } value - the indicator to the right. 231 * @returns { T } 232 * @syscap SystemCapability.ArkUI.ArkUI.Full 233 * @crossplatform 234 * @form 235 * @since 10 236 */ 237 /** 238 * Set the indicator to the right. 239 * 240 * @param { Length } value - the indicator to the right. 241 * @returns { T } 242 * @syscap SystemCapability.ArkUI.ArkUI.Full 243 * @crossplatform 244 * @form 245 * @atomicservice 246 * @since 11 247 */ 248 right(value: Length): T; 249 250 /** 251 * Set the indicator to the bottom. 252 * 253 * @param { Length } value - the indicator to the bottom. 254 * @returns { T } 255 * @syscap SystemCapability.ArkUI.ArkUI.Full 256 * @crossplatform 257 * @form 258 * @since 10 259 */ 260 /** 261 * Set the indicator to the bottom. 262 * 263 * @param { Length } value - the indicator to the bottom. 264 * @returns { T } 265 * @syscap SystemCapability.ArkUI.ArkUI.Full 266 * @crossplatform 267 * @form 268 * @atomicservice 269 * @since 11 270 */ 271 bottom(value: Length): T; 272 273 /** 274 * Set the indicator to the left in LTR 275 * Set the indicator to the right in RTL 276 * 277 * @param { LengthMetrics } value - the indicator to the right in LTR, indicator to the left in RTL 278 * @returns { T } 279 * @syscap SystemCapability.ArkUI.ArkUI.Full 280 * @crossplatform 281 * @form 282 * @atomicservice 283 * @since 12 284 */ 285 start(value: LengthMetrics): T; 286 287 /** 288 * Set the indicator to the left in RTL 289 * Set the indicator to the right in LTR 290 * 291 * @param { LengthMetrics } value - the indicator to the left in RTL, Set the indicator to the right in LTR 292 * @returns { T } 293 * @syscap SystemCapability.ArkUI.ArkUI.Full 294 * @crossplatform 295 * @form 296 * @atomicservice 297 * @since 12 298 */ 299 end(value: LengthMetrics): T; 300 301 /** 302 * DotIndicator class object. 303 * 304 * @returns { DotIndicator } 305 * @static 306 * @syscap SystemCapability.ArkUI.ArkUI.Full 307 * @crossplatform 308 * @form 309 * @since 10 310 */ 311 /** 312 * DotIndicator class object. 313 * 314 * @returns { DotIndicator } 315 * @static 316 * @syscap SystemCapability.ArkUI.ArkUI.Full 317 * @crossplatform 318 * @form 319 * @atomicservice 320 * @since 11 321 */ 322 static dot(): DotIndicator; 323 324 /** 325 * DigitIndicator class object. 326 * 327 * @returns { DigitIndicator } 328 * @static 329 * @syscap SystemCapability.ArkUI.ArkUI.Full 330 * @crossplatform 331 * @form 332 * @since 10 333 */ 334 /** 335 * DigitIndicator class object. 336 * 337 * @returns { DigitIndicator } 338 * @static 339 * @syscap SystemCapability.ArkUI.ArkUI.Full 340 * @crossplatform 341 * @form 342 * @atomicservice 343 * @since 11 344 */ 345 static digit(): DigitIndicator; 346} 347 348/** 349 * Define DotIndicator, the indicator type is dot. 350 * 351 * @extends Indicator<DotIndicator> 352 * @syscap SystemCapability.ArkUI.ArkUI.Full 353 * @crossplatform 354 * @form 355 * @since 10 356 */ 357/** 358 * Define DotIndicator, the indicator type is dot. 359 * 360 * @extends Indicator<DotIndicator> 361 * @syscap SystemCapability.ArkUI.ArkUI.Full 362 * @crossplatform 363 * @form 364 * @atomicservice 365 * @since 11 366 */ 367declare class DotIndicator extends Indicator<DotIndicator> { 368 /** 369 * Constructor. 370 * 371 * @syscap SystemCapability.ArkUI.ArkUI.Full 372 * @crossplatform 373 * @form 374 * @since 10 375 */ 376 /** 377 * Constructor. 378 * 379 * @syscap SystemCapability.ArkUI.ArkUI.Full 380 * @crossplatform 381 * @form 382 * @atomicservice 383 * @since 11 384 */ 385 constructor(); 386 387 /** 388 * Set the indicator item width. 389 * 390 * @param { Length } value - the indicator item width. 391 * @returns { DotIndicator } 392 * @syscap SystemCapability.ArkUI.ArkUI.Full 393 * @crossplatform 394 * @form 395 * @since 10 396 */ 397 /** 398 * Set the indicator item width. 399 * 400 * @param { Length } value - the indicator item width. 401 * @returns { DotIndicator } 402 * @syscap SystemCapability.ArkUI.ArkUI.Full 403 * @crossplatform 404 * @form 405 * @atomicservice 406 * @since 11 407 */ 408 itemWidth(value: Length): DotIndicator; 409 410 /** 411 * Set the indicator item height. 412 * 413 * @param { Length } value - the indicator item height. 414 * @returns { DotIndicator } 415 * @syscap SystemCapability.ArkUI.ArkUI.Full 416 * @crossplatform 417 * @form 418 * @since 10 419 */ 420 /** 421 * Set the indicator item height. 422 * 423 * @param { Length } value - the indicator item height. 424 * @returns { DotIndicator } 425 * @syscap SystemCapability.ArkUI.ArkUI.Full 426 * @crossplatform 427 * @form 428 * @atomicservice 429 * @since 11 430 */ 431 itemHeight(value: Length): DotIndicator; 432 433 /** 434 * Set the indicator item width when selected. 435 * 436 * @param { Length } value - the indicator item width when selected. 437 * @returns { DotIndicator } 438 * @syscap SystemCapability.ArkUI.ArkUI.Full 439 * @crossplatform 440 * @form 441 * @since 10 442 */ 443 /** 444 * Set the indicator item width when selected. 445 * 446 * @param { Length } value - the indicator item width when selected. 447 * @returns { DotIndicator } 448 * @syscap SystemCapability.ArkUI.ArkUI.Full 449 * @crossplatform 450 * @form 451 * @atomicservice 452 * @since 11 453 */ 454 selectedItemWidth(value: Length): DotIndicator; 455 456 /** 457 * Set the indicator item height when selected. 458 * 459 * @param { Length } value - the indicator item height when selected. 460 * @returns { DotIndicator } 461 * @syscap SystemCapability.ArkUI.ArkUI.Full 462 * @crossplatform 463 * @form 464 * @since 10 465 */ 466 /** 467 * Set the indicator item height when selected. 468 * 469 * @param { Length } value - the indicator item height when selected. 470 * @returns { DotIndicator } 471 * @syscap SystemCapability.ArkUI.ArkUI.Full 472 * @crossplatform 473 * @form 474 * @atomicservice 475 * @since 11 476 */ 477 selectedItemHeight(value: Length): DotIndicator; 478 479 /** 480 * Setting indicator style mask. 481 * 482 * @param { boolean } value - the indicator item mask. 483 * @returns { DotIndicator } 484 * @syscap SystemCapability.ArkUI.ArkUI.Full 485 * @crossplatform 486 * @form 487 * @since 10 488 */ 489 /** 490 * Setting indicator style mask. 491 * 492 * @param { boolean } value - the indicator item mask. 493 * @returns { DotIndicator } 494 * @syscap SystemCapability.ArkUI.ArkUI.Full 495 * @crossplatform 496 * @form 497 * @atomicservice 498 * @since 11 499 */ 500 mask(value: boolean): DotIndicator; 501 502 /** 503 * Set the indicator color. 504 * 505 * @param { ResourceColor } value - the indicator item color. 506 * @returns { DotIndicator } 507 * @syscap SystemCapability.ArkUI.ArkUI.Full 508 * @crossplatform 509 * @form 510 * @since 10 511 */ 512 /** 513 * Set the indicator color. 514 * 515 * @param { ResourceColor } value - the indicator item color. 516 * @returns { DotIndicator } 517 * @syscap SystemCapability.ArkUI.ArkUI.Full 518 * @crossplatform 519 * @form 520 * @atomicservice 521 * @since 11 522 */ 523 color(value: ResourceColor): DotIndicator; 524 525 /** 526 * Set the navigation point color. 527 * 528 * @param { ResourceColor } value - the indicator item when selected. 529 * @returns { DotIndicator } 530 * @syscap SystemCapability.ArkUI.ArkUI.Full 531 * @crossplatform 532 * @form 533 * @since 10 534 */ 535 /** 536 * Set the navigation point color. 537 * 538 * @param { ResourceColor } value - the indicator item when selected. 539 * @returns { DotIndicator } 540 * @syscap SystemCapability.ArkUI.ArkUI.Full 541 * @crossplatform 542 * @form 543 * @atomicservice 544 * @since 11 545 */ 546 selectedColor(value: ResourceColor): DotIndicator; 547 548 /** 549 * Set the Indicator maxDisplayCount when selected. 550 * 551 * @param { number } maxDisplayCount - the indicator item maxDisplayCount when selected. 552 * @returns { DotIndicator } return the DotIndicator 553 * @syscap SystemCapability.ArkUI.ArkUI.Full 554 * @crossplatform 555 * @atomicservice 556 * @since 12 557 */ 558 maxDisplayCount(maxDisplayCount: number): DotIndicator; 559} 560 561/** 562 * Set Swiper column count adaptation. 563 * 564 * @typedef { object } SwiperAutoFill 565 * @syscap SystemCapability.ArkUI.ArkUI.Full 566 * @form 567 * @since 10 568 */ 569/** 570 * Set Swiper column count adaptation. 571 * 572 * @typedef { object } SwiperAutoFill 573 * @syscap SystemCapability.ArkUI.ArkUI.Full 574 * @form 575 * @atomicservice 576 * @since 11 577 */ 578declare type SwiperAutoFill = { 579 /** 580 * Set minSize size. 581 * 582 * @syscap SystemCapability.ArkUI.ArkUI.Full 583 * @since 10 584 * @form 585 */ 586 /** 587 * Set minSize size. 588 * 589 * @syscap SystemCapability.ArkUI.ArkUI.Full 590 * @atomicservice 591 * @since 11 592 * @form 593 */ 594 minSize: VP; 595}; 596 597/** 598 * Define DigitIndicator, the indicator type is digit. 599 * 600 * @extends Indicator<DigitIndicator> 601 * @syscap SystemCapability.ArkUI.ArkUI.Full 602 * @crossplatform 603 * @form 604 * @since 10 605 */ 606/** 607 * Define DigitIndicator, the indicator type is digit. 608 * 609 * @extends Indicator<DigitIndicator> 610 * @syscap SystemCapability.ArkUI.ArkUI.Full 611 * @crossplatform 612 * @form 613 * @atomicservice 614 * @since 11 615 */ 616declare class DigitIndicator extends Indicator<DigitIndicator> { 617 /** 618 * Constructor. 619 * 620 * @syscap SystemCapability.ArkUI.ArkUI.Full 621 * @crossplatform 622 * @form 623 * @since 10 624 */ 625 /** 626 * Constructor. 627 * 628 * @syscap SystemCapability.ArkUI.ArkUI.Full 629 * @crossplatform 630 * @form 631 * @atomicservice 632 * @since 11 633 */ 634 constructor(); 635 636 /** 637 * Set font color of the digital indicator. 638 * 639 * @param { ResourceColor } value - the indicator font color. 640 * @returns { DigitIndicator } 641 * @syscap SystemCapability.ArkUI.ArkUI.Full 642 * @crossplatform 643 * @form 644 * @since 10 645 */ 646 /** 647 * Set font color of the digital indicator. 648 * 649 * @param { ResourceColor } value - the indicator font color. 650 * @returns { DigitIndicator } 651 * @syscap SystemCapability.ArkUI.ArkUI.Full 652 * @crossplatform 653 * @form 654 * @atomicservice 655 * @since 11 656 */ 657 fontColor(value: ResourceColor): DigitIndicator; 658 659 /** 660 * Set font color of the digital indicator when selected. 661 * 662 * @param { ResourceColor } value - the indicator font color when selected. 663 * @returns { DigitIndicator } 664 * @syscap SystemCapability.ArkUI.ArkUI.Full 665 * @crossplatform 666 * @form 667 * @since 10 668 */ 669 /** 670 * Set font color of the digital indicator when selected. 671 * 672 * @param { ResourceColor } value - the indicator font color when selected. 673 * @returns { DigitIndicator } 674 * @syscap SystemCapability.ArkUI.ArkUI.Full 675 * @crossplatform 676 * @form 677 * @atomicservice 678 * @since 11 679 */ 680 selectedFontColor(value: ResourceColor): DigitIndicator; 681 682 /** 683 * Set the digital indicator font (just support font size and weight). 684 * 685 * @param { Font } value - the indicator font size and weight. 686 * @returns { DigitIndicator } 687 * @syscap SystemCapability.ArkUI.ArkUI.Full 688 * @crossplatform 689 * @form 690 * @since 10 691 */ 692 /** 693 * Set the digital indicator font (just support font size and weight). 694 * 695 * @param { Font } value - the indicator font size and weight. 696 * @returns { DigitIndicator } 697 * @syscap SystemCapability.ArkUI.ArkUI.Full 698 * @crossplatform 699 * @form 700 * @atomicservice 701 * @since 11 702 */ 703 digitFont(value: Font): DigitIndicator; 704 705 /** 706 * Set the digital indicator font (just support font size and weight). 707 * 708 * @param { Font } value - the indicator font size and weight when selected. 709 * @returns { DigitIndicator } 710 * @syscap SystemCapability.ArkUI.ArkUI.Full 711 * @crossplatform 712 * @form 713 * @since 10 714 */ 715 /** 716 * Set the digital indicator font (just support font size and weight). 717 * 718 * @param { Font } value - the indicator font size and weight when selected. 719 * @returns { DigitIndicator } 720 * @syscap SystemCapability.ArkUI.ArkUI.Full 721 * @crossplatform 722 * @form 723 * @atomicservice 724 * @since 11 725 */ 726 selectedDigitFont(value: Font): DigitIndicator; 727} 728 729/** 730 * Arrow object. 731 * 732 * @interface ArrowStyle 733 * @syscap SystemCapability.ArkUI.ArkUI.Full 734 * @since 10 735 */ 736/** 737 * Arrow object. 738 * 739 * @interface ArrowStyle 740 * @syscap SystemCapability.ArkUI.ArkUI.Full 741 * @crossplatform 742 * @atomicservice 743 * @since 11 744 */ 745declare interface ArrowStyle { 746 /** 747 * Is show the arrow background or not. 748 * 749 * @type { ?boolean } 750 * @default false 751 * @syscap SystemCapability.ArkUI.ArkUI.Full 752 * @since 10 753 */ 754 /** 755 * Is show the arrow background or not. 756 * 757 * @type { ?boolean } 758 * @default false 759 * @syscap SystemCapability.ArkUI.ArkUI.Full 760 * @crossplatform 761 * @atomicservice 762 * @since 11 763 */ 764 showBackground?: boolean; 765 766 /** 767 * When the indicator show, set the arrow position is side of the indicator or in the middle of content area. 768 * The arrow is displayed on side of the indicator, if the value is false. 769 * 770 * @type { ?boolean } 771 * @default false 772 * @syscap SystemCapability.ArkUI.ArkUI.Full 773 * @since 10 774 */ 775 /** 776 * When the indicator show, set the arrow position is side of the indicator or in the middle of content area. 777 * The arrow is displayed on side of the indicator, if the value is false. 778 * 779 * @type { ?boolean } 780 * @default false 781 * @syscap SystemCapability.ArkUI.ArkUI.Full 782 * @crossplatform 783 * @atomicservice 784 * @since 11 785 */ 786 isSidebarMiddle?: boolean; 787 788 /** 789 * The arrow background size. 790 * The size of the arrow is three-quarters of the background size, when the background is displayed. 791 * 792 * @type { ?Length } 793 * @default When isSidebarMiddle is false, the default value is 24vp, Otherwise,the default value is 32vp 794 * @syscap SystemCapability.ArkUI.ArkUI.Full 795 * @since 10 796 */ 797 /** 798 * The arrow background size. 799 * The size of the arrow is three-quarters of the background size, when the background is displayed. 800 * 801 * @type { ?Length } 802 * @default When isSidebarMiddle is false, the default value is 24vp, Otherwise,the default value is 32vp 803 * @syscap SystemCapability.ArkUI.ArkUI.Full 804 * @crossplatform 805 * @atomicservice 806 * @since 11 807 */ 808 backgroundSize?: Length; 809 810 /** 811 * The arrow background background color. 812 * 813 * @type { ?ResourceColor } 814 * @default When isSidebarMiddle is false, the default value is #00000000, Otherwise,the default value is #19182431 815 * @syscap SystemCapability.ArkUI.ArkUI.Full 816 * @since 10 817 */ 818 /** 819 * The arrow background background color. 820 * 821 * @type { ?ResourceColor } 822 * @default When isSidebarMiddle is false, the default value is #00000000, Otherwise, the default value is #19182431 823 * @syscap SystemCapability.ArkUI.ArkUI.Full 824 * @crossplatform 825 * @atomicservice 826 * @since 11 827 */ 828 backgroundColor?: ResourceColor; 829 830 /** 831 * The arrow size. 832 * The arrow size can be set, when the background is not displayed. 833 * The size of the arrow is three-quarters of the background size, when the background is displayed. 834 * 835 * @type { ?Length } 836 * @default When isSidebarMiddle is false, the default value is 18vp, Otherwise, the default value is 24vp 837 * @syscap SystemCapability.ArkUI.ArkUI.Full 838 * @since 10 839 */ 840 /** 841 * The arrow size. 842 * The arrow size can be set, when the background is not displayed. 843 * The size of the arrow is three-quarters of the background size, when the background is displayed. 844 * 845 * @type { ?Length } 846 * @default When isSidebarMiddle is false, the default value is 18vp, Otherwise, the default value is 24vp 847 * @syscap SystemCapability.ArkUI.ArkUI.Full 848 * @crossplatform 849 * @atomicservice 850 * @since 11 851 */ 852 arrowSize?: Length; 853 854 /** 855 * The arrow color. 856 * 857 * @type { ?ResourceColor } 858 * @default #182431 859 * @syscap SystemCapability.ArkUI.ArkUI.Full 860 * @since 10 861 */ 862 /** 863 * The arrow color. 864 * 865 * @type { ?ResourceColor } 866 * @default #182431 867 * @syscap SystemCapability.ArkUI.ArkUI.Full 868 * @crossplatform 869 * @atomicservice 870 * @since 11 871 */ 872 arrowColor?: ResourceColor; 873} 874 875/** 876 * Declare the size of the swiper on the spindle. 877 * 878 * @enum { number } 879 * @syscap SystemCapability.ArkUI.ArkUI.Full 880 * @since 7 881 */ 882/** 883 * Declare the size of the swiper on the spindle. 884 * 885 * @enum { number } 886 * @syscap SystemCapability.ArkUI.ArkUI.Full 887 * @crossplatform 888 * @form 889 * @since 10 890 */ 891/** 892 * Declare the size of the swiper on the spindle. 893 * 894 * @enum { number } 895 * @syscap SystemCapability.ArkUI.ArkUI.Full 896 * @crossplatform 897 * @form 898 * @atomicservice 899 * @since 11 900 */ 901declare enum SwiperDisplayMode { 902 /** 903 * Carousel map extension. 904 * 905 * @syscap SystemCapability.ArkUI.ArkUI.Full 906 * @form 907 * @since 7 908 * @deprecated since 10 909 * @useinstead SwiperDisplayMode#STRETCH 910 */ 911 Stretch, 912 913 /** 914 * The rotation chart is self linear. 915 * 916 * @syscap SystemCapability.ArkUI.ArkUI.Full 917 * @form 918 * @since 7 919 * @deprecated since 10 920 * @useinstead SwiperDisplayMode#AUTO_LINEAR 921 */ 922 AutoLinear, 923 924 /** 925 * Carousel map extension. 926 * 927 * @syscap SystemCapability.ArkUI.ArkUI.Full 928 * @crossplatform 929 * @form 930 * @since 10 931 */ 932 /** 933 * Carousel map extension. 934 * 935 * @syscap SystemCapability.ArkUI.ArkUI.Full 936 * @crossplatform 937 * @form 938 * @atomicservice 939 * @since 11 940 */ 941 STRETCH, 942 943 /** 944 * The rotation chart is self linear. 945 * 946 * @syscap SystemCapability.ArkUI.ArkUI.Full 947 * @crossplatform 948 * @form 949 * @since 10 950 */ 951 /** 952 * The rotation chart is self linear. 953 * 954 * @syscap SystemCapability.ArkUI.ArkUI.Full 955 * @crossplatform 956 * @form 957 * @atomicservice 958 * @since 11 959 * @deprecated since 12 960 * @useinstead Scroller#scrollTo 961 */ 962 AUTO_LINEAR, 963} 964 965/** 966 * Provides an interface for sliding containers. 967 * 968 * @interface SwiperInterface 969 * @syscap SystemCapability.ArkUI.ArkUI.Full 970 * @since 7 971 */ 972/** 973 * Provides an interface for sliding containers. 974 * 975 * @interface SwiperInterface 976 * @syscap SystemCapability.ArkUI.ArkUI.Full 977 * @crossplatform 978 * @form 979 * @since 10 980 */ 981/** 982 * Provides an interface for sliding containers. 983 * 984 * @interface SwiperInterface 985 * @syscap SystemCapability.ArkUI.ArkUI.Full 986 * @crossplatform 987 * @form 988 * @atomicservice 989 * @since 11 990 */ 991interface SwiperInterface { 992 /** 993 * Called when a sliding container is set. 994 * 995 * @param { SwiperController } controller 996 * @returns { SwiperAttribute } 997 * @syscap SystemCapability.ArkUI.ArkUI.Full 998 * @since 7 999 */ 1000 /** 1001 * Called when a sliding container is set. 1002 * 1003 * @param { SwiperController } controller 1004 * @returns { SwiperAttribute } 1005 * @syscap SystemCapability.ArkUI.ArkUI.Full 1006 * @crossplatform 1007 * @form 1008 * @since 10 1009 */ 1010 /** 1011 * Called when a sliding container is set. 1012 * 1013 * @param { SwiperController } controller 1014 * @returns { SwiperAttribute } 1015 * @syscap SystemCapability.ArkUI.ArkUI.Full 1016 * @crossplatform 1017 * @form 1018 * @atomicservice 1019 * @since 11 1020 */ 1021 (controller?: SwiperController): SwiperAttribute; 1022} 1023 1024/** 1025 * Setting indicator style navigation. 1026 * 1027 * @interface IndicatorStyle 1028 * @syscap SystemCapability.ArkUI.ArkUI.Full 1029 * @since 8 1030 * @deprecated since 10 1031 */ 1032declare interface IndicatorStyle { 1033 /** 1034 * Set the indicator to the left. 1035 * 1036 * @type { ?Length } 1037 * @syscap SystemCapability.ArkUI.ArkUI.Full 1038 * @since 8 1039 * @deprecated since 10 1040 */ 1041 left?: Length; 1042 1043 /** 1044 * Set the indicator to the top. 1045 * 1046 * @type { ?Length } 1047 * @syscap SystemCapability.ArkUI.ArkUI.Full 1048 * @since 8 1049 * @deprecated since 10 1050 */ 1051 top?: Length; 1052 1053 /** 1054 * Set the indicator to the right. 1055 * 1056 * @type { ?Length } 1057 * @syscap SystemCapability.ArkUI.ArkUI.Full 1058 * @since 8 1059 * @deprecated since 10 1060 */ 1061 right?: Length; 1062 1063 /** 1064 * Set the indicator to the bottom. 1065 * 1066 * @type { ?Length } 1067 * @syscap SystemCapability.ArkUI.ArkUI.Full 1068 * @since 8 1069 * @deprecated since 10 1070 */ 1071 bottom?: Length; 1072 1073 /** 1074 * Set the indicator size. 1075 * 1076 * @type { ?Length } 1077 * @syscap SystemCapability.ArkUI.ArkUI.Full 1078 * @since 8 1079 * @deprecated since 10 1080 */ 1081 size?: Length; 1082 1083 /** 1084 * Setting indicator style mask. 1085 * 1086 * @type { ?boolean } 1087 * @syscap SystemCapability.ArkUI.ArkUI.Full 1088 * @since 8 1089 * @deprecated since 10 1090 */ 1091 mask?: boolean; 1092 1093 /** 1094 * Set the indicator color. 1095 * 1096 * @type { ?ResourceColor } 1097 * @syscap SystemCapability.ArkUI.ArkUI.Full 1098 * @since 8 1099 * @deprecated since 10 1100 */ 1101 color?: ResourceColor; 1102 1103 /** 1104 * Set the navigation point color. 1105 * 1106 * @type { ?ResourceColor } 1107 * @syscap SystemCapability.ArkUI.ArkUI.Full 1108 * @since 8 1109 * @deprecated since 10 1110 */ 1111 selectedColor?: ResourceColor; 1112} 1113 1114/** 1115 * Provides an interface for swiper animation. 1116 * 1117 * @interface SwiperAnimationEvent 1118 * @syscap SystemCapability.ArkUI.ArkUI.Full 1119 * @crossplatform 1120 * @since 10 1121 */ 1122/** 1123 * Provides an interface for swiper animation. 1124 * 1125 * @interface SwiperAnimationEvent 1126 * @syscap SystemCapability.ArkUI.ArkUI.Full 1127 * @crossplatform 1128 * @atomicservice 1129 * @since 11 1130 */ 1131declare interface SwiperAnimationEvent { 1132 /** 1133 * Offset of the current page to the start position of the swiper main axis. The unit is vp. 1134 * 1135 * @type { number } 1136 * @default 0.0 vp 1137 * @syscap SystemCapability.ArkUI.ArkUI.Full 1138 * @since 10 1139 */ 1140 /** 1141 * Offset of the current page to the start position of the swiper main axis. The unit is vp. 1142 * 1143 * @type { number } 1144 * @default 0.0 vp 1145 * @syscap SystemCapability.ArkUI.ArkUI.Full 1146 * @crossplatform 1147 * @atomicservice 1148 * @since 11 1149 */ 1150 currentOffset: number; 1151 1152 /** 1153 * Offset of the target page to the start position of the swiper main axis. The unit is vp. 1154 * 1155 * @type { number } 1156 * @default 0.0 vp 1157 * @syscap SystemCapability.ArkUI.ArkUI.Full 1158 * @since 10 1159 */ 1160 /** 1161 * Offset of the target page to the start position of the swiper main axis. The unit is vp. 1162 * 1163 * @type { number } 1164 * @default 0.0 vp 1165 * @syscap SystemCapability.ArkUI.ArkUI.Full 1166 * @crossplatform 1167 * @atomicservice 1168 * @since 11 1169 */ 1170 targetOffset: number; 1171 1172 /** 1173 * Start speed of the page-turning animation. The unit is vp/s. 1174 * 1175 * @type { number } 1176 * @default 0.0 vp/s 1177 * @syscap SystemCapability.ArkUI.ArkUI.Full 1178 * @since 10 1179 */ 1180 /** 1181 * Start speed of the page-turning animation. The unit is vp/s. 1182 * 1183 * @type { number } 1184 * @default 0.0 vp/s 1185 * @syscap SystemCapability.ArkUI.ArkUI.Full 1186 * @crossplatform 1187 * @atomicservice 1188 * @since 11 1189 */ 1190 velocity: number; 1191} 1192 1193/** 1194 * Swiper nested scroll nested mode 1195 1196 * @enum { number } SwiperNestedScrollMode 1197 * @syscap SystemCapability.ArkUI.ArkUI.Full 1198 * @atomicservice 1199 * @since 11 1200 */ 1201declare enum SwiperNestedScrollMode { 1202 /** 1203 * Only Self response scrolling. 1204 * 1205 * @syscap SystemCapability.ArkUI.ArkUI.Full 1206 * @atomicservice 1207 * @since 11 1208 */ 1209 SELF_ONLY = 0, 1210 1211 /** 1212 * Self priority response scrolling. 1213 * 1214 * @syscap SystemCapability.ArkUI.ArkUI.Full 1215 * @atomicservice 1216 * @since 11 1217 */ 1218 SELF_FIRST = 1, 1219} 1220 1221/** 1222 * Defines the swiper attribute functions. 1223 * 1224 * @extends CommonMethod<SwiperAttribute> 1225 * @syscap SystemCapability.ArkUI.ArkUI.Full 1226 * @since 7 1227 */ 1228/** 1229 * Defines the swiper attribute functions. 1230 * 1231 * @extends CommonMethod<SwiperAttribute> 1232 * @syscap SystemCapability.ArkUI.ArkUI.Full 1233 * @crossplatform 1234 * @form 1235 * @since 10 1236 */ 1237/** 1238 * Defines the swiper attribute functions. 1239 * 1240 * @extends CommonMethod<SwiperAttribute> 1241 * @syscap SystemCapability.ArkUI.ArkUI.Full 1242 * @crossplatform 1243 * @form 1244 * @atomicservice 1245 * @since 11 1246 */ 1247declare class SwiperAttribute extends CommonMethod<SwiperAttribute> { 1248 /** 1249 * Called when the index value of the displayed subcomponent is set in the container. 1250 * 1251 * @param { number } value 1252 * @returns { SwiperAttribute } 1253 * @syscap SystemCapability.ArkUI.ArkUI.Full 1254 * @since 7 1255 */ 1256 /** 1257 * Called when the index value of the displayed subcomponent is set in the container. 1258 * 1259 * @param { number } value 1260 * @returns { SwiperAttribute } 1261 * @syscap SystemCapability.ArkUI.ArkUI.Full 1262 * @crossplatform 1263 * @form 1264 * @since 10 1265 */ 1266 /** 1267 * Called when the index value of the displayed subcomponent is set in the container. 1268 * 1269 * @param { number } value 1270 * @returns { SwiperAttribute } 1271 * @syscap SystemCapability.ArkUI.ArkUI.Full 1272 * @crossplatform 1273 * @form 1274 * @atomicservice 1275 * @since 11 1276 */ 1277 index(value: number): SwiperAttribute; 1278 1279 /** 1280 * Called when setting whether the subcomponent plays automatically. 1281 * 1282 * @param { boolean } value 1283 * @returns { SwiperAttribute } 1284 * @syscap SystemCapability.ArkUI.ArkUI.Full 1285 * @since 7 1286 */ 1287 /** 1288 * Called when setting whether the subcomponent plays automatically. 1289 * 1290 * @param { boolean } value 1291 * @returns { SwiperAttribute } 1292 * @syscap SystemCapability.ArkUI.ArkUI.Full 1293 * @crossplatform 1294 * @form 1295 * @since 10 1296 */ 1297 /** 1298 * Called when setting whether the subcomponent plays automatically. 1299 * 1300 * @param { boolean } value 1301 * @returns { SwiperAttribute } 1302 * @syscap SystemCapability.ArkUI.ArkUI.Full 1303 * @crossplatform 1304 * @form 1305 * @atomicservice 1306 * @since 11 1307 */ 1308 autoPlay(value: boolean): SwiperAttribute; 1309 1310 /** 1311 * Called when the time interval for automatic playback is set. 1312 * 1313 * @param { number } value 1314 * @returns { SwiperAttribute } 1315 * @syscap SystemCapability.ArkUI.ArkUI.Full 1316 * @since 7 1317 */ 1318 /** 1319 * Called when the time interval for automatic playback is set. 1320 * 1321 * @param { number } value 1322 * @returns { SwiperAttribute } 1323 * @syscap SystemCapability.ArkUI.ArkUI.Full 1324 * @crossplatform 1325 * @form 1326 * @since 10 1327 */ 1328 /** 1329 * Called when the time interval for automatic playback is set. 1330 * 1331 * @param { number } value 1332 * @returns { SwiperAttribute } 1333 * @syscap SystemCapability.ArkUI.ArkUI.Full 1334 * @crossplatform 1335 * @form 1336 * @atomicservice 1337 * @since 11 1338 */ 1339 interval(value: number): SwiperAttribute; 1340 1341 /** 1342 * Called when you set whether the navigation point indicator is enabled. 1343 * 1344 * @param { boolean } value - show indicator of the swiper indicator. 1345 * @returns { SwiperAttribute } 1346 * @syscap SystemCapability.ArkUI.ArkUI.Full 1347 * @since 7 1348 */ 1349 /** 1350 * Set indicator is enabled, or set type style. 1351 * 1352 * @param { DotIndicator | DigitIndicator | boolean } value - the style value or show indicator of the swiper indicator. 1353 * @returns { SwiperAttribute } 1354 * @syscap SystemCapability.ArkUI.ArkUI.Full 1355 * @crossplatform 1356 * @form 1357 * @since 10 1358 */ 1359 /** 1360 * Set indicator is enabled, or set type style. 1361 * 1362 * @param { DotIndicator | DigitIndicator | boolean } value - the style value or show indicator of the swiper indicator. 1363 * @returns { SwiperAttribute } 1364 * @syscap SystemCapability.ArkUI.ArkUI.Full 1365 * @crossplatform 1366 * @form 1367 * @atomicservice 1368 * @since 11 1369 */ 1370 indicator(value: DotIndicator | DigitIndicator | boolean): SwiperAttribute; 1371 1372 /** 1373 * Use indicator component controller. 1374 * 1375 * @param { IndicatorComponentController } controller - indicator component controller. 1376 * @returns { SwiperAttribute } 1377 * @syscap SystemCapability.ArkUI.ArkUI.Full 1378 * @crossplatform 1379 * @form 1380 * @atomicservice 1381 * @since 13 1382 */ 1383 indicator(controller: IndicatorComponentController): SwiperAttribute; 1384 1385 /** 1386 * Set arrow is enabled, or set the arrow style. 1387 * 1388 * @param { ArrowStyle | boolean } value - arrow is displayed or set the arrow style. 1389 * @param { boolean } isHoverShow - arrow is display when mouse hover in indicator hotspot. 1390 * @returns { SwiperAttribute } return the component attribute. 1391 * @syscap SystemCapability.ArkUI.ArkUI.Full 1392 * @since 10 1393 */ 1394 /** 1395 * Set arrow is enabled, or set the arrow style. 1396 * 1397 * @param { ArrowStyle | boolean } value - arrow is displayed or set the arrow style. 1398 * @param { boolean } isHoverShow - arrow is display when mouse hover in indicator hotspot. 1399 * @returns { SwiperAttribute } return the component attribute. 1400 * @syscap SystemCapability.ArkUI.ArkUI.Full 1401 * @crossplatform 1402 * @atomicservice 1403 * @since 11 1404 */ 1405 displayArrow(value: ArrowStyle | boolean, isHoverShow?: boolean): SwiperAttribute; 1406 1407 /** 1408 * Called when setting whether to turn on cyclic sliding. 1409 * 1410 * @param { boolean } value 1411 * @returns { SwiperAttribute } 1412 * @syscap SystemCapability.ArkUI.ArkUI.Full 1413 * @since 7 1414 */ 1415 /** 1416 * Called when setting whether to turn on cyclic sliding. 1417 * 1418 * @param { boolean } value 1419 * @returns { SwiperAttribute } 1420 * @syscap SystemCapability.ArkUI.ArkUI.Full 1421 * @crossplatform 1422 * @form 1423 * @since 10 1424 */ 1425 /** 1426 * Called when setting whether to turn on cyclic sliding. 1427 * 1428 * @param { boolean } value 1429 * @returns { SwiperAttribute } 1430 * @syscap SystemCapability.ArkUI.ArkUI.Full 1431 * @crossplatform 1432 * @form 1433 * @atomicservice 1434 * @since 11 1435 */ 1436 loop(value: boolean): SwiperAttribute; 1437 1438 /** 1439 * Called when the animation duration of the switch is set. 1440 * 1441 * @param { number } value 1442 * @returns { SwiperAttribute } 1443 * @syscap SystemCapability.ArkUI.ArkUI.Full 1444 * @since 7 1445 */ 1446 /** 1447 * Called when the animation duration of the switch is set. 1448 * 1449 * @param { number } value 1450 * @returns { SwiperAttribute } 1451 * @syscap SystemCapability.ArkUI.ArkUI.Full 1452 * @crossplatform 1453 * @since 10 1454 */ 1455 /** 1456 * Called when the animation duration of the switch is set. 1457 * 1458 * @param { number } value 1459 * @returns { SwiperAttribute } 1460 * @syscap SystemCapability.ArkUI.ArkUI.Full 1461 * @crossplatform 1462 * @atomicservice 1463 * @since 11 1464 */ 1465 duration(value: number): SwiperAttribute; 1466 1467 /** 1468 * Called when setting whether to slide vertically. 1469 * 1470 * @param { boolean } value 1471 * @returns { SwiperAttribute } 1472 * @syscap SystemCapability.ArkUI.ArkUI.Full 1473 * @since 7 1474 */ 1475 /** 1476 * Called when setting whether to slide vertically. 1477 * 1478 * @param { boolean } value 1479 * @returns { SwiperAttribute } 1480 * @syscap SystemCapability.ArkUI.ArkUI.Full 1481 * @crossplatform 1482 * @form 1483 * @since 10 1484 */ 1485 /** 1486 * Called when setting whether to slide vertically. 1487 * 1488 * @param { boolean } value 1489 * @returns { SwiperAttribute } 1490 * @syscap SystemCapability.ArkUI.ArkUI.Full 1491 * @crossplatform 1492 * @form 1493 * @atomicservice 1494 * @since 11 1495 */ 1496 vertical(value: boolean): SwiperAttribute; 1497 1498 /** 1499 * Sets the space between child components. 1500 * 1501 * @param { number | string } value 1502 * @returns { SwiperAttribute } 1503 * @syscap SystemCapability.ArkUI.ArkUI.Full 1504 * @since 7 1505 */ 1506 /** 1507 * Sets the space between child components. 1508 * 1509 * @param { number | string } value 1510 * @returns { SwiperAttribute } 1511 * @syscap SystemCapability.ArkUI.ArkUI.Full 1512 * @crossplatform 1513 * @form 1514 * @since 10 1515 */ 1516 /** 1517 * Sets the space between child components. 1518 * 1519 * @param { number | string } value 1520 * @returns { SwiperAttribute } 1521 * @syscap SystemCapability.ArkUI.ArkUI.Full 1522 * @crossplatform 1523 * @form 1524 * @atomicservice 1525 * @since 11 1526 */ 1527 itemSpace(value: number | string): SwiperAttribute; 1528 1529 /** 1530 * Called when setting the size of the swiper container on the spindle. 1531 * 1532 * @param { SwiperDisplayMode } value 1533 * @returns { SwiperAttribute } 1534 * @syscap SystemCapability.ArkUI.ArkUI.Full 1535 * @since 7 1536 */ 1537 /** 1538 * Called when setting the size of the swiper container on the spindle. 1539 * 1540 * @param { SwiperDisplayMode } value 1541 * @returns { SwiperAttribute } 1542 * @syscap SystemCapability.ArkUI.ArkUI.Full 1543 * @crossplatform 1544 * @form 1545 * @since 10 1546 */ 1547 /** 1548 * Called when setting the size of the swiper container on the spindle. 1549 * 1550 * @param { SwiperDisplayMode } value 1551 * @returns { SwiperAttribute } 1552 * @syscap SystemCapability.ArkUI.ArkUI.Full 1553 * @crossplatform 1554 * @form 1555 * @atomicservice 1556 * @since 11 1557 */ 1558 displayMode(value: SwiperDisplayMode): SwiperAttribute; 1559 1560 /** 1561 * Sets the number of child components to be preloaded(cached). 1562 * 1563 * @param { number } value 1564 * @returns { SwiperAttribute } 1565 * @syscap SystemCapability.ArkUI.ArkUI.Full 1566 * @since 8 1567 */ 1568 /** 1569 * Sets the number of child components to be preloaded(cached). 1570 * 1571 * @param { number } value 1572 * @returns { SwiperAttribute } 1573 * @syscap SystemCapability.ArkUI.ArkUI.Full 1574 * @crossplatform 1575 * @form 1576 * @since 10 1577 */ 1578 /** 1579 * Sets the number of child components to be preloaded(cached). 1580 * 1581 * @param { number } value 1582 * @returns { SwiperAttribute } 1583 * @syscap SystemCapability.ArkUI.ArkUI.Full 1584 * @crossplatform 1585 * @form 1586 * @atomicservice 1587 * @since 11 1588 */ 1589 cachedCount(value: number): SwiperAttribute; 1590 1591 /** 1592 * Sets the number of elements to display per page. 1593 * 1594 * @param { number | string } value 1595 * @returns { SwiperAttribute } 1596 * @syscap SystemCapability.ArkUI.ArkUI.Full 1597 * @since 8 1598 */ 1599 /** 1600 * Sets the number of elements to display per page. 1601 * 1602 * @param { number | string | SwiperAutoFill } value 1603 * @returns { SwiperAttribute } 1604 * @syscap SystemCapability.ArkUI.ArkUI.Full 1605 * @crossplatform 1606 * @form 1607 * @since 10 1608 */ 1609 /** 1610 * Sets the number of elements to display per page. 1611 * 1612 * If swipeByGroup is set to true: 1613 * 1、All sub-items are grouped from index 0. 1614 * 2、The number of sub-items in each group is the value of displayCount. 1615 * 3、If the number of sub-items in the last group is less than displayCount, placeholder items are added to supplement the number of last group. 1616 * 4、Placeholder items do not display any content and are only used as placeholders. 1617 * 5、When turning pages, turn pages by group. 1618 * 1619 * @param { number | string | SwiperAutoFill } value 1620 * @param { boolean } [swipeByGroup] - if swipe by group. 1621 * @returns { SwiperAttribute } 1622 * @syscap SystemCapability.ArkUI.ArkUI.Full 1623 * @crossplatform 1624 * @form 1625 * @atomicservice 1626 * @since 11 1627 */ 1628 displayCount(value: number | string | SwiperAutoFill, swipeByGroup?: boolean): SwiperAttribute; 1629 1630 /** 1631 * Invoked when setting the sliding effect 1632 * 1633 * @param { EdgeEffect } value 1634 * @returns { SwiperAttribute } 1635 * @syscap SystemCapability.ArkUI.ArkUI.Full 1636 * @since 8 1637 */ 1638 /** 1639 * Invoked when setting the sliding effect 1640 * 1641 * @param { EdgeEffect } value 1642 * @returns { SwiperAttribute } 1643 * @syscap SystemCapability.ArkUI.ArkUI.Full 1644 * @crossplatform 1645 * @form 1646 * @since 10 1647 */ 1648 /** 1649 * Invoked when setting the sliding effect 1650 * 1651 * @param { EdgeEffect } value 1652 * @returns { SwiperAttribute } 1653 * @syscap SystemCapability.ArkUI.ArkUI.Full 1654 * @crossplatform 1655 * @form 1656 * @atomicservice 1657 * @since 11 1658 */ 1659 effectMode(value: EdgeEffect): SwiperAttribute; 1660 1661 /** 1662 * Sets whether to disable the swipe feature 1663 * 1664 * @param { boolean } value 1665 * @returns { SwiperAttribute } 1666 * @syscap SystemCapability.ArkUI.ArkUI.Full 1667 * @since 8 1668 */ 1669 /** 1670 * Sets whether to disable the swipe feature 1671 * 1672 * @param { boolean } value 1673 * @returns { SwiperAttribute } 1674 * @syscap SystemCapability.ArkUI.ArkUI.Full 1675 * @crossplatform 1676 * @form 1677 * @since 10 1678 */ 1679 /** 1680 * Sets whether to disable the swipe feature 1681 * 1682 * @param { boolean } value 1683 * @returns { SwiperAttribute } 1684 * @syscap SystemCapability.ArkUI.ArkUI.Full 1685 * @crossplatform 1686 * @form 1687 * @atomicservice 1688 * @since 11 1689 */ 1690 disableSwipe(value: boolean): SwiperAttribute; 1691 1692 /** 1693 * Sets the animation curve 1694 * 1695 * @param { Curve | string } value 1696 * @returns { SwiperAttribute } 1697 * @syscap SystemCapability.ArkUI.ArkUI.Full 1698 * @since 8 1699 */ 1700 /** 1701 * Sets the animation curve 1702 * Curve is an enumeration type for common curves 1703 * ICurve is a curve object 1704 * 1705 * @param { Curve | string | ICurve } value 1706 * @returns { SwiperAttribute } 1707 * @syscap SystemCapability.ArkUI.ArkUI.Full 1708 * @crossplatform 1709 * @form 1710 * @since 10 1711 */ 1712 /** 1713 * Sets the animation curve 1714 * Curve is an enumeration type for common curves 1715 * ICurve is a curve object 1716 * 1717 * @param { Curve | string | ICurve } value 1718 * @returns { SwiperAttribute } 1719 * @syscap SystemCapability.ArkUI.ArkUI.Full 1720 * @crossplatform 1721 * @form 1722 * @atomicservice 1723 * @since 11 1724 */ 1725 curve(value: Curve | string | ICurve): SwiperAttribute; 1726 1727 /** 1728 * Called when the index value changes. 1729 * 1730 * @param { function } event 1731 * @returns { SwiperAttribute } 1732 * @syscap SystemCapability.ArkUI.ArkUI.Full 1733 * @since 7 1734 */ 1735 /** 1736 * Called when the index value changes. 1737 * 1738 * @param { function } event 1739 * @returns { SwiperAttribute } 1740 * @syscap SystemCapability.ArkUI.ArkUI.Full 1741 * @crossplatform 1742 * @form 1743 * @since 10 1744 */ 1745 /** 1746 * Called when the index value changes. 1747 * 1748 * @param { function } event 1749 * @returns { SwiperAttribute } 1750 * @syscap SystemCapability.ArkUI.ArkUI.Full 1751 * @crossplatform 1752 * @form 1753 * @atomicservice 1754 * @since 11 1755 */ 1756 onChange(event: (index: number) => void): SwiperAttribute; 1757 1758 /** 1759 * Setting indicator style navigation. 1760 * 1761 * @param { IndicatorStyle } value 1762 * @returns { SwiperAttribute } 1763 * @syscap SystemCapability.ArkUI.ArkUI.Full 1764 * @since 8 1765 * @deprecated since 10 1766 */ 1767 indicatorStyle(value?: IndicatorStyle): SwiperAttribute; 1768 1769 /** 1770 * The previous margin which can be used to expose a small portion of the previous item. 1771 * 1772 * @param { Length } value - The length of previous margin. 1773 * @returns { SwiperAttribute } The attribute of the swiper. 1774 * @syscap SystemCapability.ArkUI.ArkUI.Full 1775 * @since 10 1776 */ 1777 /** 1778 * The previous margin which can be used to expose a small portion of the previous item. 1779 * 1780 * @param { Length } value - The length of previous margin. 1781 * @returns { SwiperAttribute } The attribute of the swiper. 1782 * @syscap SystemCapability.ArkUI.ArkUI.Full 1783 * @crossplatform 1784 * @atomicservice 1785 * @since 11 1786 */ 1787 /** 1788 * The previous margin which can be used to expose a small portion of the previous item. 1789 * When the previous item is empty, do not display blank space. 1790 * 1791 * @param { Length } value - The length of previous margin. 1792 * @param { boolean } [ignoreBlank] - Whether to hide(ignore) the previous margin on the first page in non-loop scenarios. 1793 * @returns { SwiperAttribute } The attribute of the swiper. 1794 * @syscap SystemCapability.ArkUI.ArkUI.Full 1795 * @crossplatform 1796 * @atomicservice 1797 * @since 12 1798 */ 1799 prevMargin(value: Length, ignoreBlank?: boolean): SwiperAttribute; 1800 1801 /** 1802 * The next margin which can be used to expose a small portion of the latter item. 1803 * 1804 * @param { Length } value - The length of next margin. 1805 * @returns { SwiperAttribute } The attribute of the swiper. 1806 * @syscap SystemCapability.ArkUI.ArkUI.Full 1807 * @since 10 1808 */ 1809 /** 1810 * The next margin which can be used to expose a small portion of the latter item. 1811 * 1812 * @param { Length } value - The length of next margin. 1813 * @returns { SwiperAttribute } The attribute of the swiper. 1814 * @syscap SystemCapability.ArkUI.ArkUI.Full 1815 * @crossplatform 1816 * @atomicservice 1817 * @since 11 1818 */ 1819 /** 1820 * The next margin which can be used to expose a small portion of the latter item. 1821 * When the next item is empty, do not display blank space. 1822 * 1823 * @param { Length } value - The length of next margin. 1824 * @param { boolean } [ignoreBlank] - Whether to hide(ignore) the next margin on the last page in non-loop scenarios. 1825 * @returns { SwiperAttribute } The attribute of the swiper. 1826 * @syscap SystemCapability.ArkUI.ArkUI.Full 1827 * @crossplatform 1828 * @atomicservice 1829 * @since 12 1830 */ 1831 nextMargin(value: Length, ignoreBlank?: boolean): SwiperAttribute; 1832 1833 /** 1834 * Called when the swiper animation start. 1835 * 1836 * @param { function } event - the index value of the swiper page that when animation start. 1837 * @returns { SwiperAttribute } 1838 * @syscap SystemCapability.ArkUI.ArkUI.Full 1839 * @since 9 1840 */ 1841 /** 1842 * Called when the swiper animation start. 1843 * 1844 * @param { function } event 1845 * "index": the index value of the swiper page that when animation start. 1846 * "targetIndex": the target index value of the swiper page that when animation start. 1847 * "extraInfo": the extra callback info. 1848 * @returns { SwiperAttribute } 1849 * @syscap SystemCapability.ArkUI.ArkUI.Full 1850 * @crossplatform 1851 * @form 1852 * @since 10 1853 */ 1854 /** 1855 * Called when the swiper animation start. 1856 * 1857 * @param { function } event 1858 * "index": the index value of the swiper page that when animation start. 1859 * "targetIndex": the target index value of the swiper page that when animation start. 1860 * "extraInfo": the extra callback info. 1861 * @returns { SwiperAttribute } 1862 * @syscap SystemCapability.ArkUI.ArkUI.Full 1863 * @crossplatform 1864 * @form 1865 * @atomicservice 1866 * @since 11 1867 */ 1868 onAnimationStart(event: (index: number, targetIndex: number, extraInfo: SwiperAnimationEvent) => void): SwiperAttribute; 1869 1870 /** 1871 * Called when the swiper animation end. 1872 * 1873 * @param { function } event - the index value of the swiper page that when animation end. 1874 * @returns { SwiperAttribute } 1875 * @syscap SystemCapability.ArkUI.ArkUI.Full 1876 * @since 9 1877 */ 1878 /** 1879 * Called when the swiper animation end. 1880 * 1881 * @param { function } event 1882 * "index": the index value of the swiper page that when animation end. 1883 * "extraInfo": the extra callback info. 1884 * @returns { SwiperAttribute } 1885 * @syscap SystemCapability.ArkUI.ArkUI.Full 1886 * @crossplatform 1887 * @form 1888 * @since 10 1889 */ 1890 /** 1891 * Called when the swiper animation end. 1892 * 1893 * @param { function } event 1894 * "index": the index value of the swiper page that when animation end. 1895 * "extraInfo": the extra callback info. 1896 * @returns { SwiperAttribute } 1897 * @syscap SystemCapability.ArkUI.ArkUI.Full 1898 * @crossplatform 1899 * @form 1900 * @atomicservice 1901 * @since 11 1902 */ 1903 onAnimationEnd(event: (index: number, extraInfo: SwiperAnimationEvent) => void): SwiperAttribute; 1904 1905 /** 1906 * Called when the swiper swipe with the gesture. 1907 * 1908 * @param { function } event 1909 * "index": the index value of the swiper page before gesture swipe. 1910 * "extraInfo": the extra callback info. 1911 * @returns { SwiperAttribute } 1912 * @syscap SystemCapability.ArkUI.ArkUI.Full 1913 * @crossplatform 1914 * @since 10 1915 */ 1916 /** 1917 * Called when the swiper swipe with the gesture. 1918 * 1919 * @param { function } event 1920 * "index": the index value of the swiper page before gesture swipe. 1921 * "extraInfo": the extra callback info. 1922 * @returns { SwiperAttribute } 1923 * @syscap SystemCapability.ArkUI.ArkUI.Full 1924 * @crossplatform 1925 * @atomicservice 1926 * @since 11 1927 */ 1928 onGestureSwipe(event: (index: number, extraInfo: SwiperAnimationEvent) => void): SwiperAttribute; 1929 1930 /** 1931 * Called to setting the nested scroll mode. 1932 * 1933 * @param { SwiperNestedScrollMode } value - mode for nested scrolling. 1934 * @returns { SwiperAttribute } the attribute of the swiper. 1935 * @syscap SystemCapability.ArkUI.ArkUI.Full 1936 * @crossplatform 1937 * @atomicservice 1938 * @since 11 1939 */ 1940 nestedScroll(value: SwiperNestedScrollMode): SwiperAttribute; 1941 1942 /** 1943 * Custom swiper content transition animation. 1944 * 1945 * @param { SwiperContentAnimatedTransition } transition - custom content transition animation. 1946 * @returns { SwiperAttribute } the attribute of the swiper. 1947 * @syscap SystemCapability.ArkUI.ArkUI.Full 1948 * @crossplatform 1949 * @atomicservice 1950 * @since 12 1951 */ 1952 customContentTransition(transition: SwiperContentAnimatedTransition): SwiperAttribute; 1953 1954 /** 1955 * Called when the swiper content did scroll. 1956 * 1957 * @param { ContentDidScrollCallback } handler - callback of scroll, 1958 * selectedIndex is the index value of the swiper content selected before animation start. 1959 * index is the index value of the swiper content. 1960 * position is the moving ratio of the swiper content from the start position of the swiper main axis. 1961 * mainAxisLength is the swiper main axis length for calculating position. 1962 * @returns { SwiperAttribute } the attribute of the swiper. 1963 * @syscap SystemCapability.ArkUI.ArkUI.Full 1964 * @crossplatform 1965 * @atomicservice 1966 * @since 12 1967 */ 1968 onContentDidScroll(handler: ContentDidScrollCallback): SwiperAttribute; 1969 1970 /** 1971 * Setting whether the indicator is interactive. 1972 * 1973 * @param { boolean } value - Whether the indicator is interactive. 1974 * @returns { SwiperAttribute } 1975 * @syscap SystemCapability.ArkUI.ArkUI.Full 1976 * @crossplatform 1977 * @atomicservice 1978 * @since 12 1979 */ 1980 indicatorInteractive(value: boolean): SwiperAttribute; 1981} 1982 1983/** 1984 * Defines the swiper content animated transition options. 1985 * 1986 * @interface SwiperContentAnimatedTransition 1987 * @syscap SystemCapability.ArkUI.ArkUI.Full 1988 * @crossplatform 1989 * @atomicservice 1990 * @since 12 1991 */ 1992declare interface SwiperContentAnimatedTransition { 1993 /** 1994 * Defines the timeout of custom content transition animation after the page is moved out of the swiper. The unit is ms. 1995 * If SwiperContentTransitionProxy.finishTransition() is not invoked, use the timeout as animation end time. 1996 * 1997 * @type { ?number } 1998 * @default 0 ms 1999 * @syscap SystemCapability.ArkUI.ArkUI.Full 2000 * @crossplatform 2001 * @atomicservice 2002 * @since 12 2003 */ 2004 timeout?: number; 2005 2006 /** 2007 * Called when custom content transition animation start. 2008 * 2009 * @type { Callback<SwiperContentTransitionProxy> } 2010 * @syscap SystemCapability.ArkUI.ArkUI.Full 2011 * @crossplatform 2012 * @atomicservice 2013 * @since 12 2014 */ 2015 transition: Callback<SwiperContentTransitionProxy>; 2016} 2017 2018/** 2019 * The proxy of SwiperContentAnimatedTransition. 2020 * 2021 * @interface SwiperContentTransitionProxy 2022 * @syscap SystemCapability.ArkUI.ArkUI.Full 2023 * @crossplatform 2024 * @atomicservice 2025 * @since 12 2026 */ 2027declare interface SwiperContentTransitionProxy { 2028 /** 2029 * the index value of the swiper content selected before animation start. 2030 * 2031 * @type { number } 2032 * @syscap SystemCapability.ArkUI.ArkUI.Full 2033 * @crossplatform 2034 * @atomicservice 2035 * @since 12 2036 */ 2037 selectedIndex: number; 2038 2039 /** 2040 * The index value of the swiper content. 2041 * 2042 * @type { number } 2043 * @syscap SystemCapability.ArkUI.ArkUI.Full 2044 * @crossplatform 2045 * @atomicservice 2046 * @since 12 2047 */ 2048 index: number; 2049 2050 /** 2051 * the moving ratio of the swiper content from the start position of the swiper main axis. 2052 * 2053 * @type { number } 2054 * @syscap SystemCapability.ArkUI.ArkUI.Full 2055 * @crossplatform 2056 * @atomicservice 2057 * @since 12 2058 */ 2059 position: number; 2060 2061 /** 2062 * the swiper main axis length for calculating position. 2063 * 2064 * @type { number } 2065 * @syscap SystemCapability.ArkUI.ArkUI.Full 2066 * @crossplatform 2067 * @atomicservice 2068 * @since 12 2069 */ 2070 mainAxisLength: number; 2071 2072 /** 2073 * Notifies Swiper page the custom content transition animation is complete. 2074 * 2075 * @syscap SystemCapability.ArkUI.ArkUI.Full 2076 * @crossplatform 2077 * @atomicservice 2078 * @since 12 2079 */ 2080 finishTransition(): void; 2081} 2082 2083/** 2084 * The callback of onContentDidScroll. 2085 * 2086 * @typedef { Function } ContentDidScrollCallback 2087 * @param { number } selectedIndex - the index value of the swiper content selected before animation start. 2088 * @param { number } index - the index value of the swiper content. 2089 * @param { number } position - the moving ratio of the swiper content from the start position of the swiper main axis. 2090 * @param { number } mainAxisLength - the swiper main axis length for calculating position. 2091 * @syscap SystemCapability.ArkUI.ArkUI.Full 2092 * @crossplatform 2093 * @atomicservice 2094 * @since 12 2095 */ 2096declare type ContentDidScrollCallback = (selectedIndex: number, index: number, position: number, mainAxisLength: number) => void; 2097 2098/** 2099 * Defines Swiper Component. 2100 * 2101 * @syscap SystemCapability.ArkUI.ArkUI.Full 2102 * @since 7 2103 */ 2104/** 2105 * Defines Swiper Component. 2106 * 2107 * @syscap SystemCapability.ArkUI.ArkUI.Full 2108 * @crossplatform 2109 * @form 2110 * @since 10 2111 */ 2112/** 2113 * Defines Swiper Component. 2114 * 2115 * @syscap SystemCapability.ArkUI.ArkUI.Full 2116 * @crossplatform 2117 * @form 2118 * @atomicservice 2119 * @since 11 2120 */ 2121declare const Swiper: SwiperInterface; 2122 2123/** 2124 * Defines Swiper Component instance. 2125 * 2126 * @syscap SystemCapability.ArkUI.ArkUI.Full 2127 * @since 7 2128 */ 2129/** 2130 * Defines Swiper Component instance. 2131 * 2132 * @syscap SystemCapability.ArkUI.ArkUI.Full 2133 * @crossplatform 2134 * @form 2135 * @since 10 2136 */ 2137/** 2138 * Defines Swiper Component instance. 2139 * 2140 * @syscap SystemCapability.ArkUI.ArkUI.Full 2141 * @crossplatform 2142 * @form 2143 * @atomicservice 2144 * @since 11 2145 */ 2146declare const SwiperInstance: SwiperAttribute; 2147