1{ 2 "name": "list", 3 "version": [ 4 { 5 "name": "v3.0" 6 } 7 ], 8 "syscap": [ 9 "SystemCapability.ArkUI.ArkUI.Full", 10 "SystemCapability.ArkUI.ArkUI.Lite" 11 ], 12 "description": [ 13 { 14 "name": "The <list> component provides a list container that presents a series of list items arranged in a column with the same width. Lists support presentations of the same data in a multiple and coherent row style, for example, images and texts." 15 } 16 ], 17 "attributes": [ 18 { 19 "name": "scrollpage", 20 "syscap": [ 21 "SystemCapability.ArkUI.ArkUI.Full" 22 ], 23 "required": false, 24 "description": [ 25 { 26 "name": "Whether to scroll the non-list part on the top of the list page out of the visible area with the list. The value can be true (scrolls the non-list part out) or false (does not scroll the non-list part out). This attribute is not available when the direction is row.", 27 "syscap": [ 28 "SystemCapability.ArkUI.ArkUI.Full" 29 ] 30 } 31 ], 32 "type": "enum", 33 "options": [ 34 { 35 "name": "true" 36 }, 37 { 38 "name": "false" 39 } 40 ] 41 }, 42 { 43 "name": "cachedcount", 44 "syscap": [ 45 "SystemCapability.ArkUI.ArkUI.Full" 46 ], 47 "required": false, 48 "description": [ 49 { 50 "name": "Minimum number of cached list-items when the long list is loaded with delay. When the number of list-items cached outside the visible area is less than the value of this attribute, a requestitem event is triggered.", 51 "syscap": [ 52 "SystemCapability.ArkUI.ArkUI.Full" 53 ] 54 } 55 ], 56 "type": "number" 57 }, 58 { 59 "name": "scrollbar", 60 "syscap": [ 61 "SystemCapability.ArkUI.ArkUI.Full" 62 ], 63 "required": false, 64 "description": [ 65 { 66 "name": "Display mode of the side scroll bar. (Currently, only the vertical scroll bar is supported.) off: No display; auto: Displayed on demand (The side scroll bar is displayed when you touch it and disappears 2s later.); on: Always displayed.", 67 "syscap": [ 68 "SystemCapability.ArkUI.ArkUI.Full" 69 ] 70 } 71 ], 72 "type": "enum", 73 "options": [ 74 { 75 "name": "off", 76 "syscap": [ 77 "SystemCapability.ArkUI.ArkUI.Full" 78 ] 79 }, 80 { 81 "name": "auto", 82 "syscap": [ 83 "SystemCapability.ArkUI.ArkUI.Full" 84 ] 85 }, 86 { 87 "name": "on", 88 "syscap": [ 89 "SystemCapability.ArkUI.ArkUI.Full" 90 ] 91 } 92 ] 93 }, 94 { 95 "name": "scrolleffect", 96 "syscap": [ 97 "SystemCapability.ArkUI.ArkUI.Full" 98 ], 99 "required": false, 100 "description": [ 101 { 102 "name": "Scroll effect. Available values are as follows: spring: Similar to the physical dynamic effect of a spring. After scrolling to the edge, you can continue to scroll for a distance based on the initial speed or by using a touch event. After you release your hand, the screen is rebounded; fade: Similar to the physical dynamic effect of fade. When you scroll to the edge, a wave shape fades. The fade changes according to the speed and scrolling distance; no: No effect after the scroll bar is moved to the edge.", 103 "syscap": [ 104 "SystemCapability.ArkUI.ArkUI.Full" 105 ] 106 } 107 ], 108 "type": "enum", 109 "options": [ 110 { 111 "name": "spring", 112 "syscap": [ 113 "SystemCapability.ArkUI.ArkUI.Full" 114 ] 115 }, 116 { 117 "name": "fade", 118 "syscap": [ 119 "SystemCapability.ArkUI.ArkUI.Full" 120 ] 121 }, 122 { 123 "name": "no", 124 "syscap": [ 125 "SystemCapability.ArkUI.ArkUI.Full" 126 ] 127 } 128 ] 129 }, 130 { 131 "name": "indexer", 132 "syscap": [ 133 "SystemCapability.ArkUI.ArkUI.Full" 134 ], 135 "required": false, 136 "description": [ 137 { 138 "name": "Whether to display the alphabetical index scroll bar at a side of the list. This parameter is used together with the section attribute of item, and is valid only when flex-direction is set to column.Example values:'indexer' : 'true' indicates the default alphabetical index.'indexer' : 'false' indicates no index.", 139 "syscap": [ 140 "SystemCapability.ArkUI.ArkUI.Full" 141 ] 142 } 143 ], 144 "type": "enum", 145 "options": [ 146 { 147 "name": "true" 148 }, 149 { 150 "name": "false" 151 } 152 ] 153 }, 154 { 155 "name": "indexercircle", 156 "syscap": [ 157 "SystemCapability.ArkUI.ArkUI.Full" 158 ], 159 "version": [ 160 { 161 "name": "v5.0" 162 } 163 ], 164 "required": false, 165 "description": [ 166 { 167 "name": "Indicates whether the index is a ring index.\nThe default value is true for wearable devices and false for other devices. This parameter does not take effect when indexer is set to false.", 168 "syscap": [ 169 "SystemCapability.ArkUI.ArkUI.Full" 170 ] 171 } 172 ], 173 "type": "enum", 174 "options": [ 175 { 176 "name": "true" 177 }, 178 { 179 "name": "false" 180 } 181 ] 182 }, 183 { 184 "name": "indexermulti", 185 "syscap": [ 186 "SystemCapability.ArkUI.ArkUI.Full" 187 ], 188 "version": [ 189 { 190 "name": "v5.0" 191 } 192 ], 193 "required": false, 194 "description": [ 195 { 196 "name": "Indicates whether to enable the multi-language function of the index bar. This parameter does not take effect when indexer is set to false.", 197 "syscap": [ 198 "SystemCapability.ArkUI.ArkUI.Full" 199 ] 200 } 201 ], 202 "type": "enum", 203 "options": [ 204 { 205 "name": "true" 206 }, 207 { 208 "name": "false" 209 } 210 ] 211 }, 212 { 213 "name": "indexerbubble", 214 "syscap": [ 215 "SystemCapability.ArkUI.ArkUI.Full" 216 ], 217 "version": [ 218 { 219 "name": "v5.0" 220 } 221 ], 222 "required": false, 223 "description": [ 224 { 225 "name": "Indicates whether to enable the bubble prompt for index switching.\nThis parameter does not take effect when indexer is set to false.", 226 "syscap": [ 227 "SystemCapability.ArkUI.ArkUI.Full" 228 ] 229 } 230 ], 231 "type": "enum", 232 "options": [ 233 { 234 "name": "true" 235 }, 236 { 237 "name": "false" 238 } 239 ] 240 }, 241 { 242 "name": "divider", 243 "syscap": [ 244 "SystemCapability.ArkUI.ArkUI.Full" 245 ], 246 "version": [ 247 { 248 "name": "v5.0" 249 } 250 ], 251 "required": false, 252 "description": [ 253 { 254 "name": "Indicates whether an item has a separator. For details about the style, see divider-color, divider-height, divider-length, and divider-origin in the style list.", 255 "syscap": [ 256 "SystemCapability.ArkUI.ArkUI.Full" 257 ] 258 } 259 ], 260 "type": "enum", 261 "options": [ 262 { 263 "name": "true" 264 }, 265 { 266 "name": "false" 267 } 268 ] 269 }, 270 { 271 "name": "shapemode", 272 "syscap": [ 273 "SystemCapability.ArkUI.ArkUI.Full" 274 ], 275 "required": false, 276 "description": [ 277 { 278 "name": "Shape of the side scroll bar. default: Not specified (following the theme); rect: Rectangle; round: Circle.", 279 "syscap": [ 280 "SystemCapability.ArkUI.ArkUI.Full" 281 ] 282 } 283 ], 284 "type": "enum", 285 "options": [ 286 { 287 "name": "default", 288 "syscap": [ 289 "SystemCapability.ArkUI.ArkUI.Full" 290 ] 291 }, 292 { 293 "name": "rect", 294 "syscap": [ 295 "SystemCapability.ArkUI.ArkUI.Full" 296 ] 297 }, 298 { 299 "name": "round", 300 "syscap": [ 301 "SystemCapability.ArkUI.ArkUI.Full" 302 ] 303 } 304 ] 305 }, 306 { 307 "name": "itemscale", 308 "syscap": [ 309 "SystemCapability.ArkUI.ArkUI.Full" 310 ], 311 "required": false, 312 "description": [ 313 { 314 "name": "Whether to cancel the zoom-in and zoom-out effects of the focus. (This attribute applies only to smart watches and smart TVs.).", 315 "syscap": [ 316 "SystemCapability.ArkUI.ArkUI.Full" 317 ] 318 } 319 ], 320 "type": "enum", 321 "options": [ 322 { 323 "name": "true" 324 }, 325 { 326 "name": "false" 327 } 328 ] 329 }, 330 { 331 "name": "itemcenter", 332 "syscap": [ 333 "SystemCapability.ArkUI.ArkUI.Full" 334 ], 335 "required": false, 336 "description": [ 337 { 338 "name": "Whether there is always an item at the center of the cross axis of the view for the initialization page and a page after scrolling. (This attribute applies only to smart watches.).", 339 "syscap": [ 340 "SystemCapability.ArkUI.ArkUI.Full" 341 ] 342 } 343 ], 344 "type": "enum", 345 "options": [ 346 { 347 "name": "true" 348 }, 349 { 350 "name": "false" 351 } 352 ] 353 }, 354 { 355 "name": "updateeffect", 356 "syscap": [ 357 "SystemCapability.ArkUI.ArkUI.Full" 358 ], 359 "required": false, 360 "description": [ 361 { 362 "name": "Whether a dynamic effect is displayed when an item in the list is deleted or added. false: No dynamic effect is displayed; true: A dynamic effect is displayed when an item is added or deleted.", 363 "syscap": [ 364 "SystemCapability.ArkUI.ArkUI.Full" 365 ] 366 } 367 ], 368 "type": "enum", 369 "options": [ 370 { 371 "name": "true" 372 }, 373 { 374 "name": "false" 375 } 376 ] 377 }, 378 { 379 "name": "chainanimation", 380 "syscap": [ 381 "SystemCapability.ArkUI.ArkUI.Full" 382 ], 383 "version": [ 384 { 385 "name": "v5.0" 386 } 387 ], 388 "required": false, 389 "description": [ 390 { 391 "name": "This parameter specifies whether to enable the chain linkage effect for the current list. After this function is enabled, the chain linkage effect is displayed when the list slides and the top and bottom drags. Chain linkage effect: List-items in a list are separated by a certain distance. Under the basic sliding interaction behavior, the active object drives the driven object to perform linkage. The driving effect follows the physical dynamic effect of the spring.\nfalse: disable chain linkage. true: enable chain linkage.", 392 "syscap": [ 393 "SystemCapability.ArkUI.ArkUI.Full" 394 ] 395 } 396 ], 397 "type": "enum", 398 "options": [ 399 { 400 "name": "true" 401 }, 402 { 403 "name": "false" 404 } 405 ] 406 }, 407 { 408 "name": "scrollvibrate", 409 "syscap": [ 410 "SystemCapability.ArkUI.ArkUI.Full" 411 ], 412 "required": false, 413 "description": [ 414 { 415 "name": "Whether the device vibrates when the list is scrolled. This attribute takes effect only for smart watches. false: The device vibrates when the list is scrolled; true: The device does not vibrate when the list is scrolled.", 416 "syscap": [ 417 "SystemCapability.ArkUI.ArkUI.Full" 418 ] 419 } 420 ], 421 "type": "enum", 422 "options": [ 423 { 424 "name": "true" 425 }, 426 { 427 "name": "false" 428 } 429 ] 430 }, 431 { 432 "name": "initialindex", 433 "syscap": [ 434 "SystemCapability.ArkUI.ArkUI.Full" 435 ], 436 "required": false, 437 "description": [ 438 { 439 "name": "Item displayed at the start position of the viewport when the current list is loaded for the first time. The default value is 0, indicating that the first item is displayed. If the number you set is greater than the index of the last item, the setting does not take effect. When the initialoffset attribute is set, the current attribute does not take effect.", 440 "syscap": [ 441 "SystemCapability.ArkUI.ArkUI.Full" 442 ] 443 } 444 ], 445 "type": "number" 446 }, 447 { 448 "name": "initialoffset", 449 "syscap": [ 450 "SystemCapability.ArkUI.ArkUI.Full" 451 ], 452 "required": false, 453 "description": [ 454 { 455 "name": "The start offset of the viewport when the current list is loaded for the first time. The offset cannot exceed the scrolling range of the current list. Otherwise, the offset is truncated to the maximum value of the scrolling range.", 456 "syscap": [ 457 "SystemCapability.ArkUI.ArkUI.Full" 458 ] 459 } 460 ], 461 "type": "length" 462 }, 463 { 464 "name": "selected", 465 "syscap": [ 466 "SystemCapability.ArkUI.ArkUI.Full" 467 ], 468 "version": [ 469 { 470 "name": "v5.0" 471 } 472 ], 473 "required": false, 474 "description": [ 475 { 476 "name": "Specifies the selected and activated items in the current list. The optional value is the value of the section attribute of list-item.", 477 "syscap": [ 478 "SystemCapability.ArkUI.ArkUI.Full" 479 ] 480 } 481 ], 482 "type": "string" 483 }, 484 { 485 "name": "shareid", 486 "syscap": [ 487 "SystemCapability.ArkUI.ArkUI.Full" 488 ], 489 "required": false, 490 "description": [ 491 { 492 "name": "Used for the transition of shared elements and takes effect only when it is configured. This attribute cannot be modified after being set. list-item, image, text, button, label components are supported for the transition of shared elements.", 493 "syscap": [ 494 "SystemCapability.ArkUI.ArkUI.Full" 495 ] 496 } 497 ], 498 "type": "string" 499 }, 500 { 501 "name": "id", 502 "required": false, 503 "version": [ 504 { 505 "name": "v4.0" 506 } 507 ], 508 "description": [ 509 { 510 "name": "Unique ID of a component." 511 } 512 ], 513 "type": "string" 514 }, 515 { 516 "name": "style", 517 "required": false, 518 "version": [ 519 { 520 "name": "v4.0" 521 } 522 ], 523 "description": [ 524 { 525 "name": "Style declaration of a component." 526 } 527 ], 528 "type": "string" 529 }, 530 { 531 "name": "class", 532 "required": false, 533 "version": [ 534 { 535 "name": "v4.0" 536 } 537 ], 538 "description": [ 539 { 540 "name": "Style class of a component, which is used to refer to a style table." 541 } 542 ], 543 "type": "string" 544 }, 545 { 546 "name": "ref", 547 "required": false, 548 "version": [ 549 { 550 "name": "v4.0" 551 } 552 ], 553 "description": [ 554 { 555 "name": "Used to register reference information of child elements or child components. The reference information is registered with the parent component on $refs." 556 } 557 ], 558 "type": "string" 559 }, 560 { 561 "name": "disabled", 562 "syscap": [ 563 "SystemCapability.ArkUI.ArkUI.Full" 564 ], 565 "required": false, 566 "version": [ 567 { 568 "name": "v4.0" 569 } 570 ], 571 "description": [ 572 { 573 "name": "Whether a component is disabled. If it is disabled, it cannot respond to user interaction.", 574 "syscap": [ 575 "SystemCapability.ArkUI.ArkUI.Full" 576 ] 577 } 578 ], 579 "type": "enum", 580 "options": [ 581 { 582 "name": "true" 583 }, 584 { 585 "name": "false" 586 } 587 ] 588 }, 589 { 590 "name": "focusable", 591 "syscap": [ 592 "SystemCapability.ArkUI.ArkUI.Full" 593 ], 594 "required": false, 595 "version": [ 596 { 597 "name": "v4.0" 598 } 599 ], 600 "description": [ 601 { 602 "name": "Whether a component can gain focus. When focusable is set to true, the component can respond to focus events and key events. If a key event or click event is set for the component, this attribute is set to true automatically.", 603 "syscap": [ 604 "SystemCapability.ArkUI.ArkUI.Full" 605 ] 606 } 607 ], 608 "type": "enum", 609 "options": [ 610 { 611 "name": "true" 612 }, 613 { 614 "name": "false" 615 } 616 ] 617 }, 618 { 619 "name": "data-*", 620 "syscap": [ 621 "SystemCapability.ArkUI.ArkUI.Full" 622 ], 623 "required": false, 624 "version": [ 625 { 626 "name": "v4.0" 627 } 628 ], 629 "description": [ 630 { 631 "name": "Attribute set for a component to facilitate data storage and reading.", 632 "syscap": [ 633 "SystemCapability.ArkUI.ArkUI.Full" 634 ] 635 } 636 ], 637 "type": "string" 638 }, 639 { 640 "name": "click-effect", 641 "syscap": [ 642 "SystemCapability.ArkUI.ArkUI.Full" 643 ], 644 "required": false, 645 "version": [ 646 { 647 "name": "v5.0" 648 } 649 ], 650 "description": [ 651 { 652 "name": "Click effect complying with spring physics. Available values are as follows:\nspring-small: The button icon scales down to 90% of its size when it is selected. This is appropriate for small icons.\nspring-medium: The component scales down to 95% of its size when it is selected. This is appropriate for medium-sized components.spring-large: The button icon scales down and up by 95% of its size, which is appropriate to large icons.", 653 "syscap": [ 654 "SystemCapability.ArkUI.ArkUI.Full" 655 ] 656 } 657 ], 658 "type": "enum", 659 "options": [ 660 { 661 "name": "spring-small" 662 }, 663 { 664 "name": "spring-medium" 665 }, 666 { 667 "name": "spring-large" 668 } 669 ] 670 }, 671 { 672 "name": "voicelabel", 673 "syscap": [ 674 "SystemCapability.ArkUI.ArkUI.Full" 675 ], 676 "required": false, 677 "version": [ 678 { 679 "name": "v4.0" 680 } 681 ], 682 "description": [ 683 { 684 "name": "Voice label. When a voice label is triggered, the click event of the component is triggered.", 685 "syscap": [ 686 "SystemCapability.ArkUI.ArkUI.Full" 687 ] 688 } 689 ], 690 "type": "string" 691 }, 692 { 693 "name": "subscriptflag", 694 "syscap": [ 695 "SystemCapability.ArkUI.ArkUI.Full" 696 ], 697 "required": false, 698 "version": [ 699 { 700 "name": "v4.0" 701 } 702 ], 703 "description": [ 704 { 705 "name": "Voice subscript switch. Available values are as follows:\nauto: For the <image> and <list-item> components, if subscriptflag is set to auto, the voice subscript is turned on. For other components, if subscriptflag is set to auto, the voice subscript is turned off.\non: Turn on the voice subscript.\noff: Turn off the voice subscript.If no customized subscript is set, the subscript is automatically accumulated from 1.", 706 "syscap": [ 707 "SystemCapability.ArkUI.ArkUI.Full" 708 ] 709 } 710 ], 711 "type": "enum", 712 "options": [ 713 { 714 "name": "auto" 715 }, 716 { 717 "name": "on" 718 }, 719 { 720 "name": "off" 721 } 722 ] 723 }, 724 { 725 "name": "subscriptlabel", 726 "syscap": [ 727 "SystemCapability.ArkUI.ArkUI.Full" 728 ], 729 "required": false, 730 "version": [ 731 { 732 "name": "v4.0" 733 } 734 ], 735 "description": [ 736 { 737 "name": "Custom subscript. After it is set, the subscript is displayed in the way you specified. To make this attribute take effect, you need to turn on the voice subscript.", 738 "syscap": [ 739 "SystemCapability.ArkUI.ArkUI.Full" 740 ] 741 } 742 ], 743 "type": "string" 744 }, 745 { 746 "name": "scenelabel", 747 "syscap": [ 748 "SystemCapability.ArkUI.ArkUI.Full" 749 ], 750 "required": false, 751 "version": [ 752 { 753 "name": "v4.0" 754 } 755 ], 756 "description": [ 757 { 758 "name": "Available values are as follows:\nvideo: Video scenario. For example, to watch a video, a user can say the voiceLabel (usually the video name), play voiceLabel, see voiceLabel, or watch voiceLabel, etc.\naudio: Music scenario. For example, to listen to a song, a user can say the voiceLabel (usually the song name), play voiceLabel, or listen voiceLabel, etc.\npage: Page scenario. For example, to go to a page, a user can say the voiceLabel (usually the page name), switch to voiceLabel, go to voiceLabel, or jump to voiceLabel, etc.\nswitch: Switch scenario. For example, to turn on or turn off a switch, a user can say the voiceLabel (usually the switch name), turn on voiceLabel, open voiceLabel, turn off voiceLabel, close voiceLabel, etc.common: Common scenario, which is triggered by the voiceLabel.", 759 "syscap": [ 760 "SystemCapability.ArkUI.ArkUI.Full" 761 ] 762 } 763 ], 764 "type": "enum", 765 "options": [ 766 { 767 "name": "video" 768 }, 769 { 770 "name": "audio" 771 }, 772 { 773 "name": "page" 774 }, 775 { 776 "name": "switch" 777 }, 778 { 779 "name": "common" 780 } 781 ] 782 }, 783 { 784 "name": "accessibilitygroup", 785 "syscap": [ 786 "SystemCapability.ArkUI.ArkUI.Full" 787 ], 788 "required": false, 789 "version": [ 790 { 791 "name": "v4.0" 792 } 793 ], 794 "description": [ 795 { 796 "name": "Accessibility group. If this attribute is set to true, the component and all its child components form an entire selectable component, and the accessibility service will no longer available for the content of its child components.", 797 "syscap": [ 798 "SystemCapability.ArkUI.ArkUI.Full" 799 ] 800 } 801 ], 802 "type": "enum", 803 "options": [ 804 { 805 "name": "true" 806 }, 807 { 808 "name": "false" 809 } 810 ] 811 }, 812 { 813 "name": "accessibilitytext", 814 "syscap": [ 815 "SystemCapability.ArkUI.ArkUI.Full" 816 ], 817 "required": false, 818 "version": [ 819 { 820 "name": "v4.0" 821 } 822 ], 823 "description": [ 824 { 825 "name": "Accessibility text. If a component does not contain text information, it will not be read when the component is selected by the screen reader. In this case, the screen reader user cannot know which component is selected. To solve this problem, you can set this attribute for components without text information. When the component is selected by the screen reader, the specified accessibility text will be read, informing the user which component is selected. If a component with this attribute set contains text information, only the accessibility text will be read.", 826 "syscap": [ 827 "SystemCapability.ArkUI.ArkUI.Full" 828 ] 829 } 830 ], 831 "type": "string" 832 }, 833 { 834 "name": "accessibilitydescription", 835 "syscap": [ 836 "SystemCapability.ArkUI.ArkUI.Full" 837 ], 838 "required": false, 839 "version": [ 840 { 841 "name": "v4.0" 842 } 843 ], 844 "description": [ 845 { 846 "name": "Accessibility description. You can specify further explanation of the current component, for example, possible operation consequences, especially those cannot be learned from component attributes and accessibility text. You can set a detailed description text for the attribute of the component to help users understand the operation to be performed. If a component contains both text information and the accessibility description, the text is read first and then the accessibility description, when the component is selected.", 847 "syscap": [ 848 "SystemCapability.ArkUI.ArkUI.Full" 849 ] 850 } 851 ], 852 "type": "string" 853 }, 854 { 855 "name": "accessibilityimportance", 856 "syscap": [ 857 "SystemCapability.ArkUI.ArkUI.Full" 858 ], 859 "required": false, 860 "version": [ 861 { 862 "name": "v4.0" 863 } 864 ], 865 "description": [ 866 { 867 "name": "Accessibility importance, which is used to decide whether a component can be identified by the accessibility service. The value can be auto, yes, no, or no-hide-descendants. The last value forces the screen reader to ignore the current component and all its subcomponents.\nyes: The current component is selectable for the accessibility service.no: The current component is not selectable for the accessibility service.", 868 "syscap": [ 869 "SystemCapability.ArkUI.ArkUI.Full" 870 ] 871 } 872 ], 873 "type": "string" 874 }, 875 { 876 "name": "for", 877 "required": false, 878 "version": [ 879 { 880 "name": "v4.0" 881 } 882 ], 883 "description": [ 884 { 885 "name": "Expands the current element based on the configured data list." 886 } 887 ], 888 "type": "string" 889 }, 890 { 891 "name": "tid", 892 "required": false, 893 "version": [ 894 { 895 "name": "v4.0" 896 } 897 ], 898 "description": [ 899 { 900 "name": "The tid attribute accelerates the for loop and improves the re-rendering efficiency when data in a loop changes.\nThe tid attribute specifies the unique ID of each element in the array. If it is not specified, the index of each element in the array is used as the ID. For example, tid=\"id\" indicates that the id attribute of each element is its unique ID." 901 } 902 ], 903 "type": "string" 904 }, 905 { 906 "name": "if", 907 "required": false, 908 "version": [ 909 { 910 "name": "v4.0" 911 } 912 ], 913 "description": [ 914 { 915 "name": "Whether the element is added or removed." 916 } 917 ], 918 "type": "enum", 919 "options": [ 920 { 921 "name": "true" 922 }, 923 { 924 "name": "false" 925 } 926 ] 927 }, 928 { 929 "name": "dir", 930 "syscap": [ 931 "SystemCapability.ArkUI.ArkUI.Full" 932 ], 933 "version": [ 934 { 935 "name": "v6.0" 936 } 937 ], 938 "required": false, 939 "description": [ 940 { 941 "name": "Sets the element layout mode. The rtl, ltr, and auto attributes can be set.", 942 "syscap": [ 943 "SystemCapability.ArkUI.ArkUI.Full" 944 ] 945 } 946 ], 947 "type": "enum", 948 "options": [ 949 { 950 "name": "ltr" 951 }, 952 { 953 "name": "rtl" 954 }, 955 { 956 "name": "auto" 957 } 958 ] 959 }, 960 { 961 "name": "elif", 962 "required": false, 963 "version": [ 964 { 965 "name": "v4.0" 966 } 967 ], 968 "description": [], 969 "type": "enum", 970 "options": [ 971 { 972 "name": "true" 973 }, 974 { 975 "name": "false" 976 } 977 ] 978 }, 979 { 980 "name": "else", 981 "required": false, 982 "version": [ 983 { 984 "name": "v4.0" 985 } 986 ], 987 "description": [], 988 "type": "string" 989 }, 990 { 991 "name": "show", 992 "required": false, 993 "version": [ 994 { 995 "name": "v4.0" 996 } 997 ], 998 "description": [ 999 { 1000 "name": "Whether the element is displayed or hidden." 1001 } 1002 ], 1003 "type": "enum", 1004 "options": [ 1005 { 1006 "name": "true" 1007 }, 1008 { 1009 "name": "false" 1010 } 1011 ] 1012 } 1013 ], 1014 "events": [ 1015 { 1016 "name": "indexerchange", 1017 "syscap": [ 1018 "SystemCapability.ArkUI.ArkUI.Full" 1019 ], 1020 "description": [ 1021 { 1022 "name": "Multi-language index bar switch event. This parameter is valid only when indexer is set to true and indexermulti is set to true. booleanValue can be true or false.", 1023 "syscap": [ 1024 "SystemCapability.ArkUI.ArkUI.Full" 1025 ] 1026 } 1027 ] 1028 }, 1029 { 1030 "name": "scroll", 1031 "syscap": [ 1032 "SystemCapability.ArkUI.ArkUI.Full" 1033 ], 1034 "description": [ 1035 { 1036 "name": "Triggered to indicate the offset and status of list scrolling. stateValue: 0: The list is not scrolling. stateValue: 1: The list is scrolling along with user's touches. stateValue: 2: The list is scrolling after the user lifts their fingers.", 1037 "syscap": [ 1038 "SystemCapability.ArkUI.ArkUI.Full" 1039 ] 1040 } 1041 ] 1042 }, 1043 { 1044 "name": "scrollbottom", 1045 "syscap": [ 1046 "SystemCapability.ArkUI.ArkUI.Full" 1047 ], 1048 "description": [ 1049 { 1050 "name": "Triggered when the list is scrolled to the bottom.", 1051 "syscap": [ 1052 "SystemCapability.ArkUI.ArkUI.Full" 1053 ] 1054 } 1055 ] 1056 }, 1057 { 1058 "name": "scrolltop", 1059 "syscap": [ 1060 "SystemCapability.ArkUI.ArkUI.Full" 1061 ], 1062 "description": [ 1063 { 1064 "name": "Triggered when the list is scrolled to the top.", 1065 "syscap": [ 1066 "SystemCapability.ArkUI.ArkUI.Full" 1067 ] 1068 } 1069 ] 1070 }, 1071 { 1072 "name": "scrollend", 1073 "description": [ 1074 { 1075 "name": "Triggered when the list stops scrolling." 1076 } 1077 ] 1078 }, 1079 { 1080 "name": "scrolltouchup", 1081 "syscap": [ 1082 "SystemCapability.ArkUI.ArkUI.Full" 1083 ], 1084 "description": [ 1085 { 1086 "name": "Triggered when the list continues scrolling after the user lifts their fingers.", 1087 "syscap": [ 1088 "SystemCapability.ArkUI.ArkUI.Full" 1089 ] 1090 } 1091 ] 1092 }, 1093 { 1094 "name": "requestitem", 1095 "syscap": [ 1096 "SystemCapability.ArkUI.ArkUI.Full" 1097 ], 1098 "description": [ 1099 { 1100 "name": "Triggered for a request to create a list-item. This event is triggered when the number of cached list-items outside the visible area is less than the value of cachedcount during long list loading with delay.", 1101 "syscap": [ 1102 "SystemCapability.ArkUI.ArkUI.Full" 1103 ] 1104 } 1105 ] 1106 }, 1107 { 1108 "name": "rotation", 1109 "syscap": [ 1110 "SystemCapability.ArkUI.ArkUI.Full" 1111 ], 1112 "version": [ 1113 { 1114 "name": "v7.0" 1115 } 1116 ], 1117 "description": [ 1118 { 1119 "name": "Triggered when crown rotates and returns the angle of rotation", 1120 "syscap": [ 1121 "SystemCapability.ArkUI.ArkUI.Full" 1122 ] 1123 } 1124 ] 1125 }, 1126 { 1127 "name": "touchstart", 1128 "syscap": [ 1129 "SystemCapability.ArkUI.ArkUI.Full" 1130 ], 1131 "version": [ 1132 { 1133 "name": "v4.0" 1134 } 1135 ], 1136 "description": [ 1137 { 1138 "name": "The tapping starts", 1139 "syscap": [ 1140 "SystemCapability.ArkUI.ArkUI.Full" 1141 ] 1142 } 1143 ] 1144 }, 1145 { 1146 "name": "touchmove", 1147 "syscap": [ 1148 "SystemCapability.ArkUI.ArkUI.Full" 1149 ], 1150 "version": [ 1151 { 1152 "name": "v4.0" 1153 } 1154 ], 1155 "description": [ 1156 { 1157 "name": "The tapping moves.", 1158 "syscap": [ 1159 "SystemCapability.ArkUI.ArkUI.Full" 1160 ] 1161 } 1162 ] 1163 }, 1164 { 1165 "name": "touchcancel", 1166 "syscap": [ 1167 "SystemCapability.ArkUI.ArkUI.Full" 1168 ], 1169 "version": [ 1170 { 1171 "name": "v4.0" 1172 } 1173 ], 1174 "description": [ 1175 { 1176 "name": "The tapping is interrupted.", 1177 "syscap": [ 1178 "SystemCapability.ArkUI.ArkUI.Full" 1179 ] 1180 } 1181 ] 1182 }, 1183 { 1184 "name": "touchend", 1185 "syscap": [ 1186 "SystemCapability.ArkUI.ArkUI.Full" 1187 ], 1188 "version": [ 1189 { 1190 "name": "v4.0" 1191 } 1192 ], 1193 "description": [ 1194 { 1195 "name": "The tapping ends.", 1196 "syscap": [ 1197 "SystemCapability.ArkUI.ArkUI.Full" 1198 ] 1199 } 1200 ] 1201 }, 1202 { 1203 "name": "click", 1204 "version": [ 1205 { 1206 "name": "v4.0" 1207 } 1208 ], 1209 "description": [ 1210 { 1211 "name": "A component is clicked." 1212 } 1213 ] 1214 }, 1215 { 1216 "name": "longpress", 1217 "version": [ 1218 { 1219 "name": "v4.0" 1220 } 1221 ], 1222 "description": [ 1223 { 1224 "name": "A component is long pressed." 1225 } 1226 ] 1227 }, 1228 { 1229 "name": "doubleclick", 1230 "version": [ 1231 { 1232 "name": "v4.0" 1233 } 1234 ], 1235 "description": [ 1236 { 1237 "name": "A component is double clicked." 1238 } 1239 ] 1240 }, 1241 { 1242 "name": "pinchstart", 1243 "version": [ 1244 { 1245 "name": "v4.0" 1246 } 1247 ], 1248 "description": [ 1249 { 1250 "name": "The pinch starts." 1251 } 1252 ] 1253 }, 1254 { 1255 "name": "pinchupdate", 1256 "version": [ 1257 { 1258 "name": "v4.0" 1259 } 1260 ], 1261 "description": [ 1262 { 1263 "name": "The pinch updates." 1264 } 1265 ] 1266 }, 1267 { 1268 "name": "pinchend", 1269 "version": [ 1270 { 1271 "name": "v4.0" 1272 } 1273 ], 1274 "description": [ 1275 { 1276 "name": "The pinch ends." 1277 } 1278 ] 1279 }, 1280 { 1281 "name": "pinchcancel", 1282 "version": [ 1283 { 1284 "name": "v4.0" 1285 } 1286 ], 1287 "description": [ 1288 { 1289 "name": "The pinch is interrupted." 1290 } 1291 ] 1292 }, 1293 { 1294 "name": "drag", 1295 "version": [ 1296 { 1297 "name": "v7.0" 1298 } 1299 ], 1300 "description": [ 1301 { 1302 "name": "The duration of drag." 1303 } 1304 ] 1305 }, 1306 { 1307 "name": "dragstart", 1308 "version": [ 1309 { 1310 "name": "v7.0" 1311 } 1312 ], 1313 "description": [ 1314 { 1315 "name": "The drag starts." 1316 } 1317 ] 1318 }, 1319 { 1320 "name": "dragend", 1321 "version": [ 1322 { 1323 "name": "v7.0" 1324 } 1325 ], 1326 "description": [ 1327 { 1328 "name": "The drag ends." 1329 } 1330 ] 1331 }, 1332 { 1333 "name": "dragenter", 1334 "version": [ 1335 { 1336 "name": "v7.0" 1337 } 1338 ], 1339 "description": [ 1340 { 1341 "name": "The drag enters." 1342 } 1343 ] 1344 }, 1345 { 1346 "name": "dragover", 1347 "version": [ 1348 { 1349 "name": "v7.0" 1350 } 1351 ], 1352 "description": [ 1353 { 1354 "name": "The drag overs." 1355 } 1356 ] 1357 }, 1358 { 1359 "name": "dragleave", 1360 "version": [ 1361 { 1362 "name": "v7.0" 1363 } 1364 ], 1365 "description": [ 1366 { 1367 "name": "The drag leaves." 1368 } 1369 ] 1370 }, 1371 { 1372 "name": "drop", 1373 "version": [ 1374 { 1375 "name": "v7.0" 1376 } 1377 ], 1378 "description": [ 1379 { 1380 "name": "The drag drops." 1381 } 1382 ] 1383 }, 1384 { 1385 "name": "focus", 1386 "syscap": [ 1387 "SystemCapability.ArkUI.ArkUI.Full" 1388 ], 1389 "version": [ 1390 { 1391 "name": "v4.0" 1392 } 1393 ], 1394 "description": [ 1395 { 1396 "name": "A component gains focus. The <span> component cannot gain focus.", 1397 "syscap": [ 1398 "SystemCapability.ArkUI.ArkUI.Full" 1399 ] 1400 } 1401 ] 1402 }, 1403 { 1404 "name": "blur", 1405 "syscap": [ 1406 "SystemCapability.ArkUI.ArkUI.Full" 1407 ], 1408 "version": [ 1409 { 1410 "name": "v4.0" 1411 } 1412 ], 1413 "description": [ 1414 { 1415 "name": "A component loses focus. The <span> component cannot lose focus.", 1416 "syscap": [ 1417 "SystemCapability.ArkUI.ArkUI.Full" 1418 ] 1419 } 1420 ] 1421 }, 1422 { 1423 "name": "key", 1424 "syscap": [ 1425 "SystemCapability.ArkUI.ArkUI.Full" 1426 ], 1427 "version": [ 1428 { 1429 "name": "v4.0" 1430 } 1431 ], 1432 "description": [ 1433 { 1434 "name": "A user presses a key on the remote control. Available return values are as follows:\ntrue: returned if the page processes the key event.\nfalse: returned if the default logic is used to process the key event.\nIf no value is returned, false is used as the return value.", 1435 "syscap": [ 1436 "SystemCapability.ArkUI.ArkUI.Full" 1437 ] 1438 } 1439 ] 1440 }, 1441 { 1442 "name": "swipe", 1443 "version": [ 1444 { 1445 "name": "v5.0" 1446 } 1447 ], 1448 "description": [ 1449 { 1450 "name": "A user quickly swipes on a component." 1451 } 1452 ] 1453 }, 1454 { 1455 "name": "attached", 1456 "syscap": [ 1457 "SystemCapability.ArkUI.ArkUI.Full" 1458 ], 1459 "version": [ 1460 { 1461 "name": "v6.0" 1462 } 1463 ], 1464 "description": [ 1465 { 1466 "name": "The current component is mounted to the render tree.", 1467 "syscap": [ 1468 "SystemCapability.ArkUI.ArkUI.Full" 1469 ] 1470 } 1471 ] 1472 }, 1473 { 1474 "name": "detached", 1475 "syscap": [ 1476 "SystemCapability.ArkUI.ArkUI.Full" 1477 ], 1478 "version": [ 1479 { 1480 "name": "v6.0" 1481 } 1482 ], 1483 "description": [ 1484 { 1485 "name": "The current component is removed from the render tree.", 1486 "syscap": [ 1487 "SystemCapability.ArkUI.ArkUI.Full" 1488 ] 1489 } 1490 ] 1491 }, 1492 { 1493 "name": "accessibility", 1494 "syscap": [ 1495 "SystemCapability.ArkUI.ArkUI.Full" 1496 ], 1497 "version": [ 1498 { 1499 "name": "v4.0" 1500 } 1501 ], 1502 "description": [ 1503 { 1504 "name": "Event dispatched by the accessibility service.", 1505 "syscap": [ 1506 "SystemCapability.ArkUI.ArkUI.Full" 1507 ] 1508 } 1509 ] 1510 } 1511 ], 1512 "supportedSubComponents": true, 1513 "supportedSubComponentsRestriction": [ 1514 { 1515 "name": "list-item-group", 1516 "syscap": [ 1517 "SystemCapability.ArkUI.ArkUI.Full" 1518 ], 1519 "level": 1 1520 }, 1521 { 1522 "name": "list-item", 1523 "syscap": [ 1524 "SystemCapability.ArkUI.ArkUI.Full" 1525 ], 1526 "level": 2 1527 }, 1528 { 1529 "name": "block", 1530 "syscap": [ 1531 "SystemCapability.ArkUI.ArkUI.Full" 1532 ] 1533 } 1534 ], 1535 "unSupportSubComponentsRestriction": [], 1536 "parentComponentsRestriction": [] 1537}