# AlphabetIndexer The **AlphabetIndexer** component can create a logically indexed array of items in a container for instant location. > **NOTE** > > This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version. ## Child Components Not supported ## APIs AlphabetIndexer(value: AlphabetIndexerOptions) **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type| Mandatory| Description| | -------- | -------- | -------- | -------- | | value | [AlphabetIndexerOptions](#alphabetindexeroptions14) | Yes| Options of the **AlphabetIndexer** component.| ## AlphabetIndexerOptions14+ Defines the options of the **AlphabetIndexer** component. | Name| Type| Mandatory| Description| | -------- | -------- | -------- | -------- | | arrayValue | Array<string> | Yes| Array of strings to be displayed in the alphabetic index bar. The value cannot be null.| | selected | number | Yes | Index of the initially selected item. If the value exceeds the value range, the default value 0 is used.
This parameter supports two-way binding through [$$](../../../quick-start/arkts-two-way-sync.md).| ## Attributes When the [width](ts-universal-attributes-size.md#width) attribute is set to **"auto"**, the width is adaptive. This means that the width will adjust according to the maximum width of the index items. The default value of the [padding](ts-universal-attributes-size.md#padding) attribute is 4 vp. The [maxFontScale](ts-basic-components-text.md#maxfontscale12) and [minFontScale](ts-basic-components-text.md#minfontscale12) attributes are both set to a constant value of 1, which means that they do not change with the system font size. In addition to the [universal attributes](ts-universal-attributes-size.md), the following attributes are supported. ### color color(value: ResourceColor) Sets the font color. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ----------------------------------- | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Font color.
Default value: **0x99182431**| ### selectedColor selectedColor(value: ResourceColor) Sets the font color of the selected item. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ----------------------------------------- | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Font color of the selected item.
Default value: **0xFF007DFF**| ### popupColor popupColor(value: ResourceColor) Sets the font color of the pop-up text. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ------------------------------------------- | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Font color of the pop-up text.
Default value: **0xFF007DFF**| ### selectedBackgroundColor selectedBackgroundColor(value: ResourceColor) Sets the background color of the selected item. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ----------------------------------------- | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Background color of the selected item.
Default value: **0x1A007DFF**| ### popupBackground popupBackground(value: ResourceColor) Sets the background color of the pop-up text. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ------------------------------------------------------------ | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Background color of the pop-up text.
The background blur effect of the pop-up text can affect the background color. You can disable the effect by setting [popupBackgroundBlurStyle](#popupbackgroundblurstyle12) to **NONE**.
Default value:
API version 11 and earlier: **0xFFFFFFFF**
API version 12 and later: **#66808080**| ### usingPopup usingPopup(value: boolean) Sets whether to use pop-up text. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------- | ---- | -------------------------------------- | | value | boolean | Yes | Whether to use pop-up text.
Default value: **false**| ### selectedFont selectedFont(value: Font) Sets the font style of the selected item. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------ | ---- | ------------------------------------------------------------ | | value | [Font](ts-types.md#font) | Yes | Font style of the selected item.
Default value:
API version 11 and earlier:
{
size:'12.0fp',
style:FontStyle.Normal,
weight:FontWeight.Normal,
family:'HarmonyOS Sans'
}
API version 12 and later:
{
size:'10.0vp',
style:FontStyle.Normal,
weight:FontWeight.Medium,
family:'HarmonyOS Sans'
} | ### popupFont popupFont(value: Font) Sets the font style of the pop-up text. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------ | ---- | ------------------------------------------------------------ | | value | [Font](ts-types.md#font) | Yes | Font style of the pop-up text.
Default value:
{
size:'24.0vp',
style:FontStyle.Normal,
weight:FontWeight.Normal,
family:'HarmonyOS Sans'
} | ### font font(value: Font) Sets the default font style of the alphabetic index bar. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------ | ---- | ------------------------------------------------------------ | | value | [Font](ts-types.md#font) | Yes | Default font style of the alphabetic index bar.
Default value:
API version 11 and earlier:
{
size:'12.0fp',
style:FontStyle.Normal,
weight:FontWeight.Normal,
family:'HarmonyOS Sans'
}
API version 12 and later:
{
size:'10.0vp',
style:FontStyle.Normal,
weight:FontWeight.Medium,
family:'HarmonyOS Sans'
} | ### itemSize itemSize(value: string | number) Sets the size for the item in the alphabetic index bar. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | -------------------------- | ---- | ------------------------------------------------------------ | | value | string \| number | Yes | Size of the item in the alphabetic index bar. The item is a square, and the side length needs to be set. This attribute cannot be set in percentage.
Default value: **16.0**
Unit: vp| ### alignStyle alignStyle(value: IndexerAlign, offset?: Length) Sets the alignment style of the alphabetic index bar. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name | Type | Mandatory| Description | | -------------------- | ------------------------------------- | ---- | ------------------------------------------------------------ | | value | [IndexerAlign](#indexeralign) | Yes | Alignment style of the alphabetic index bar. The pop-up window can be displayed on the right or left of the alphabetic index bar.
Default value: **IndexerAlign.END**| | offset10+ | [Length](ts-types.md#length) | No | Spacing between the pop-up window and the alphabetic index bar. A value greater than or equal to **0** is valid. If this parameter is set to a value less than **0** or is not set, the spacing is the same as **popupPosition**. If this parameter and **popupPosition** are set at the same time, **offset** takes effect in the horizontal direction and **popupPosition.y** takes effect in the vertical direction.| ### selected8+ selected(index: number) Sets the index of the selected item. Since API version 10, this attribute supports two-way binding through [$$](../../../quick-start/arkts-two-way-sync.md). **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------ | ---- | ---------------------------- | | index | number | Yes | Index of the selected item.
Default value: **0**| ### popupPosition8+ popupPosition(value: Position) Sets the position of the pop-up window relative to the center of the indexer bar's top border. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | --------------------------------- | ---- | ------------------------------------------------------------ | | value | [Position](ts-types.md#position) | Yes | Position of the pop-up window relative to the center of the indexer bar's top border.
Default value: **{x:60.0, y:48.0}**| ### popupSelectedColor10+ popupSelectedColor(value: ResourceColor) Sets the color of the selected text in the non-alphabetic part in the pop-up window. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ----------------------------------------------------- | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Color of the selected text in the non-alphabetic part in the pop-up window.
Default value: **#FF182431**| ### popupUnselectedColor10+ popupUnselectedColor(value: ResourceColor) Sets the color of the unselected text in the non-alphabetic part in the pop-up window. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ------------------------------------------------------- | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Color of the unselected text in the non-alphabetic part in the pop-up window.
Default value: **#FF182431**| ### popupItemFont10+ popupItemFont(value: Font) Sets the font style of the non-alphabetic part in the pop-up window. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------ | ---- | ------------------------------------------------------------ | | value | [Font](ts-types.md#font) | Yes | Font style of the non-alphabetic part in the pop-up window.
Default value:
{
size:24,
weight:FontWeight.Medium
} | ### popupItemBackgroundColor10+ popupItemBackgroundColor(value: ResourceColor) Sets the background color of the non-alphabetic part in the pop-up window. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------ | ---- | ----------------------------------------------- | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Background color of the non-alphabetic part in the pop-up window.
Default value:
API version 11 and earlier: **#FFFFFFFF**
API version 12 and later: **#00000000**| ### autoCollapse11+ autoCollapse(value: boolean) Sets whether to auto-collapse or expand the indexer bar. If the initial character is **#**, it is excluded. Number of remaining characters $\leq$ 9: The index bar is expanded. 9 < Number of remaining characters $\leq$ 13: The index bar is expanded or partially collapsed, depending on its height. Number of remaining characters > 13: The index bar is fully or partially collapsed, depending on its height. If the initial character is not **#**: Number of all characters $\leq$ 9: The index bar is expanded. 9 < Number of all characters $\leq$ 13: The index bar is expanded or partially collapsed, depending on its height. Number of all characters > 13: The index bar is fully or partially collapsed, depending on its height. **Atomic service API**: This API can be used in atomic services since API version 12. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------- | ---- | ------------------------------------------ | | value | boolean | Yes | Whether to auto-collapse or expand the indexer bar.
Default value:
In versions earlier than API version 12: **false**
API version 12 and later: **true**| ### popupItemBorderRadius12+ popupItemBorderRadius(value: number) Sets the radius of the index border corners in the pop-up window. **Atomic service API**: This API can be used in atomic services since API version 12. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------ | ---- | ------------------------------------------------------------ | | value | number | Yes | Radius of the index background border corners in the pop-up window.
Default value: **24vp**
This parameter cannot be set in percentage. If the value specified is less than **0**, **0** is used.
The radius of the index background border corners in the pop-up window is automatically adaptive (radius of the index rounded corners + 4 vp).| ### itemBorderRadius12+ itemBorderRadius(value: number) Sets the radius of the index background border corners in the alphabetic index bar. **Atomic service API**: This API can be used in atomic services since API version 12. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------ | ---- | ------------------------------------------------------------ | | value | number | Yes | Radius of the index background border corners in the alphabetic index bar.
Default value: **8vp**
This parameter cannot be set in percentage. If the value specified is less than **0**, **0** is used.
The radius of the index background border corners in the alphabetic index bar is automatically adaptive (radius of the index rounded corners + 4 vp).| ### popupBackgroundBlurStyle12+ popupBackgroundBlurStyle(value: BlurStyle) Sets the background blur style of the pop-up window. **Atomic service API**: This API can be used in atomic services since API version 12. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | -------------------------------------------- | ---- | ------------------------------------------------------------ | | value | [BlurStyle](ts-universal-attributes-background.md#blurstyle9) | Yes | Background blur style of the pop-up window.
The background blur effect can affect [popupBackground](#popupbackground). You can disable the effect by setting it to **NONE**.
Default value: **COMPONENT_REGULAR**| ### popupTitleBackground12+ popupTitleBackground(value: ResourceColor) Sets the background color of the first index in the pop-up window. **Atomic service API**: This API can be used in atomic services since API version 12. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------------------------------------------ | ---- | ------------------------------------------------------------ | | value | [ResourceColor](ts-types.md#resourcecolor) | Yes | Background color of the first index in the pop-up window.
Default value:
If the pop-up window has only one index: **#00FFFFFF**.
If the pop-up window has multiple indexes: **#0c182431**.| ### enableHapticFeedback12+ enableHapticFeedback(value: boolean) **Atomic service API**: This API can be used in atomic services since API version 12. **System capability**: SystemCapability.ArkUI.ArkUI.Full | Name | Type | Mandatory| Description | |-------------|-----------------------------------------------------|----|----------------------------| | value | boolean | No | Whether haptic feedback is enabled.
Default value: **true**
| ## IndexerAlign **System capability**: SystemCapability.ArkUI.ArkUI.Full | Name| Description| | -------- | -------- | | Left | The pop-up window is displayed on the right of the alphabetic indexer bar.
**Atomic service API**: This API can be used in atomic services since API version 11.| | Right | The pop-up window is displayed on the left of the alphabetic indexer bar.
**Atomic service API**: This API can be used in atomic services since API version 11.| | START12+ | The pop-up window is displayed on the right of the alphabetic indexer bar for left-to-right scripts, and on the left of the alphabetic indexer bar for right-to-left scripts.
**Atomic service API**: This API can be used in atomic services since API version 12.| | END12+ | The pop-up window is displayed on the left of the alphabetic indexer bar for left-to-right scripts, and on the right of the alphabetic indexer bar for right-to-left scripts.
**Atomic service API**: This API can be used in atomic services since API version 12.| ## Events In addition to the [universal events](ts-universal-events-click.md), the following events are supported. ### onSelected(deprecated) onSelected(callback: (index: number) => void) Invoked when an item in the alphabetic indexer bar is selected. The return value is the index of the selected item. This API is deprecated since API version 8. You are advised to use [onSelect](#onselect8) instead. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------ | ---- | ---------------- | | index | number | Yes | Index of the selected item.| ### onSelect8+ onSelect(callback: OnAlphabetIndexerSelectCallback) Invoked when an item in the alphabetic indexer bar is selected. The return value is the index of the selected item. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------ | ---- | ---------------- | | callback | [OnAlphabetIndexerSelectCallback](#onalphabetindexerselectcallback14) | Yes | Callback invoked when an item in the alphabetic indexer bar is selected.| ### onRequestPopupData8+ onRequestPopupData(callback: OnAlphabetIndexerRequestPopupDataCallback) Invoked when a request for displaying content in the index pop-up window is sent after an item in the alphabetic indexer bar is selected. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------ | ---- | ------------------------------------------------------------ | | callback | [OnAlphabetIndexerRequestPopupDataCallback](#onalphabetindexerrequestpopupdatacallback14) | Yes | Callback invoked when a request for displaying content in the index pop-up window is sent after an item in the alphabetic indexer bar is selected.| ### onPopupSelect8+ onPopupSelect(callback: OnAlphabetIndexerPopupSelectCallback) Invoked when an item in the index pop-up window is selected. **Atomic service API**: This API can be used in atomic services since API version 11. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name| Type | Mandatory| Description | | ------ | ------ | ---- | ---------------- | | callback | [OnAlphabetIndexerPopupSelectCallback](#onalphabetindexerpopupselectcallback14) | Yes | Invoked when an item in the index pop-up window is selected.| ## OnAlphabetIndexerSelectCallback14+ type OnAlphabetIndexerSelectCallback = (index: number) => void Represents a callback invoked when scrolling reaches the edge. **Atomic service API**: This API can be used in atomic services since API version 14. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name | Type | Mandatory| Description | | ------- | ----- | ---- | ------ | | index | number | Yes | Index of the selected item.| ## OnAlphabetIndexerPopupSelectCallback14+ type OnAlphabetIndexerPopupSelectCallback = (index: number) => void Represents a callback invoked when scrolling reaches the edge. **Atomic service API**: This API can be used in atomic services since API version 14. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name | Type | Mandatory| Description | | ------- | ----- | ---- | ------ | | index | number | Yes | Index of the selected item.| ## OnAlphabetIndexerRequestPopupDataCallback14+ type OnAlphabetIndexerRequestPopupDataCallback = (index: number) => Array\ Represents a callback invoked when scrolling reaches the edge. **Atomic service API**: This API can be used in atomic services since API version 14. **System capability**: SystemCapability.ArkUI.ArkUI.Full **Parameters** | Name | Type | Mandatory| Description | | ------- | ----- | ---- | ------ | | index | number | Yes | Index of the selected item.| **Return value** | Type | Description | | ------------- | -------------------- | | Array\ | String array corresponding to the selected index. The string array is displayed vertically in the pop-up window. It can display up to five strings at once and allows scrolling.| ## Example ### Example 1 ```ts // xxx.ets @Entry @Component struct AlphabetIndexerSample { private arrayA:string[] = ['Ann'] private arrayB: string[] = ['Ben', 'Bob'] private arrayC: string[] = ['Calvin', 'Cameron', 'Charlie', 'Charlotte'] private arrayL: string[] = ['Daisy', 'Daniel', 'Darla', 'David', 'Derek', 'Dorothy', 'Duke'] private value: string[] = ['#', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'] build() { Stack({ alignContent: Alignment.Start }) { Row() { List({ space: 20, initialIndex: 0 }) { ForEach(this.arrayA, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayB, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayC, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayL, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) } .width('50%') .height('100%') AlphabetIndexer({ arrayValue: this.value, selected: 0 }) .autoCollapse(false) .selectedColor(0xFFFFFF) // Font color of the selected text. .popupColor(0xFFFAF0) // Font color of the pop-up text. .selectedBackgroundColor(0xCCCCCC) // Background color of the selected item. .popupBackground(0xD2B48C) // Background color of the pop-up text. .usingPopup(true) // Whether to use pop-up text. .selectedFont({size: 16, weight: FontWeight.Bolder}) // Font style of the selected text. .popupFont({ size: 30, weight: FontWeight.Bolder}) // Font style of the pop-up text. .itemSize(28) // Size of an item in the alphabetic index bar. .alignStyle(IndexerAlign.Left) // The pop-up window is displayed on the right of the alphabetic index bar. .popupItemBorderRadius(24) // Set the radius of the index background rounded corners in the pop-up window. .itemBorderRadius(14) // Set the radius of the index background rounded corners in the alphabetic indexer bar. .popupBackgroundBlurStyle(BlurStyle.NONE) // Set the background blur style of the pop-up window. .popupTitleBackground(0xCCCCCC) // Set the background color of the first index in the pop-up window. .popupSelectedColor(0x00FF00) .popupUnselectedColor(0x0000FF) .popupItemFont({ size: 30, style: FontStyle.Normal }) .popupItemBackgroundColor(0xCCCCCC) .onSelect((index: number) => { console.info(this.value[index] + ' Selected!') }) .onRequestPopupData((index: number) => { if (this.value[index] == 'A') { return this.arrayA // When index A is selected, the pop-up window displays arrayA corresponding to index A. The same applies when other indexes are selected. } else if (this.value[index] == 'B') { return this.arrayB } else if (this.value[index] == 'C') { return this.arrayC } else if (this.value[index] == 'L') { return this.arrayL } else { return [] // When no array is available for the selected index, the pop-up window is empty. } }) .onPopupSelect((index: number) => { console.info('onPopupSelected:' + index) }) } .width('100%') .height('100%') } } } ``` ![alphabet](figures/alphabet.gif) ### Example 2 ```ts // xxx.ets @Entry @Component struct AlphabetIndexerSample { private arrayA:string[] = ['Ann'] private arrayB: string[] = ['Ben', 'Bob'] private arrayC: string[] = ['Calvin', 'Cameron', 'Charlie', 'Charlotte'] private arrayJ: string[] = ['Jack', 'James'] private value: string[] = ['#', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'] @State isNeedAutoCollapse: boolean = false; @State indexerHeight: string = '75%'; build() { Stack({ alignContent: Alignment.Start }) { Row() { List({ space: 20, initialIndex: 0 }) { ForEach(this.arrayA, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayB, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayC, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayJ, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) } .width('50%') .height('100%') Column() { Column() { AlphabetIndexer({ arrayValue: this.value, selected: 0 }) .autoCollapse(this.isNeedAutoCollapse) .height(this.indexerHeight) .selectedColor(0xFFFFFF)// Font color of the selected item. .popupColor(0xFFFAF0)// Font color of the pop-up text. .selectedBackgroundColor(0xCCCCCC)// Background color of the selected item. .popupBackground(0xD2B48C)// Background color of the pop-up text. .usingPopup(true)// Whether to use pop-up text. .selectedFont({size: 16, weight: FontWeight.Bolder})// Font style of the selected item. .popupFont({ size: 30, weight: FontWeight.Bolder})// Font style of the pop-up text. .itemSize(28)// Size of an item in the alphabetic index bar. .alignStyle(IndexerAlign.Right)// The pop-up window is displayed on the left of the alphabetic index bar. .popupTitleBackground("#D2B48C") // Background color of the first index in the pop-up window. .popupSelectedColor(0x00FF00) .popupUnselectedColor(0x0000FF) .popupItemFont({ size: 30, style: FontStyle.Normal }) .popupItemBackgroundColor(0xCCCCCC) .onSelect((index: number) => { console.info(this.value[index] + ' Selected!'); }) .onRequestPopupData((index: number) => { if (this.value[index] == 'A') { return this.arrayA; } else if (this.value[index] == 'B') { return this.arrayB; } else if (this.value[index] == 'C') { return this.arrayC; } else if (this.value[index] == 'J') { return this.arrayJ; } else { return []; } }) .onPopupSelect((index: number) => { console.info('onPopupSelected:' + index); }) } .height('80%') .justifyContent(FlexAlign.Center) Column() { Button('Collapse') .margin('5vp') .onClick(() => { this.isNeedAutoCollapse = true; }) Button('30% of Index Bar Height') .margin('5vp') .onClick(() => { this.indexerHeight = '30%'; }) Button('70% of Index Bar Height') .margin('5vp') .onClick(() => { this.indexerHeight = '70%'; }) }.height('20%') } .width('50%') .justifyContent(FlexAlign.Center) } .width('100%') .height('100%') } } } ``` ![alphabetIndexerAutoCollapseSample](figures/alphabetIndexerAutoCollapseSample.gif) ### Example 3 ```ts // This example implements a pop-up window in the custom background blur style. @Entry @Component struct AlphabetIndexerSample { private arrayA:string[] = ['Ann'] private arrayB: string[] = ['Ben', 'Bob'] private arrayC: string[] = ['Calvin', 'Cameron', 'Charlie', 'Charlotte'] private arrayL: string[] = ['Daisy', 'Daniel', 'Darla', 'David', 'Derek', 'Dorothy', 'Duke'] private value: string[] = ['#', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'] @State customBlurStyle: BlurStyle = BlurStyle.NONE; build() { Stack({ alignContent: Alignment.Start }) { Row() { List({ space: 20, initialIndex: 0 }) { ForEach(this.arrayA, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayB, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayC, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) ForEach(this.arrayL, (item: string) => { ListItem() { Text(item) .width('80%') .height('5%') .fontSize(30) .textAlign(TextAlign.Center) } }, (item: string) => item) } .width('30%') .height('100%') Column(){ Column() { Text('Switch Blue Style:') .fontSize(24) .fontColor(0xcccccc) .width('100%') Button('COMPONENT_REGULAR') .margin('5vp') .width(200) .onClick(() => { this.customBlurStyle = BlurStyle.COMPONENT_REGULAR; }) Button('BACKGROUND_THIN') .margin('5vp') .width(200) .onClick(() => { this.customBlurStyle = BlurStyle.BACKGROUND_THIN; }) }.height('20%') Column(){ AlphabetIndexer({ arrayValue: this.value, selected: 0 }) .usingPopup(true) // Whether to use pop-up text. .alignStyle(IndexerAlign.Left) // The pop-up window is displayed on the right of the alphabetic index bar. .popupItemBorderRadius(24) // Set the radius of the index background rounded corners in the pop-up window. .itemBorderRadius(14) // Set the radius of the index background rounded corners in the alphabetic indexer bar. .popupBackgroundBlurStyle(this.customBlurStyle) // Set the background blur style of the pop-up window. .popupTitleBackground(0xCCCCCC) // Set the background color of the first index in the pop-up window. .onSelect((index: number) => { console.info(this.value[index] + ' Selected!') }) .onRequestPopupData((index: number) => { if (this.value[index] == 'A') { return this.arrayA // When index A is selected, the pop-up window displays arrayA corresponding to index A. The same applies when other indexes are selected. } else if (this.value[index] == 'B') { return this.arrayB } else if (this.value[index] == 'C') { return this.arrayC } else if (this.value[index] == 'L') { return this.arrayL } else { return [] // When no array is available for the selected index, the pop-up window is empty. } }) .onPopupSelect((index: number) => { console.info('onPopupSelected:' + index) }) } .height('80%') } .width('70%') } .width('100%') .height('100%') .backgroundImage($r("app.media.image")) } } } ``` ![alphabetIndexerBlurStyleSample](figures/alphabetIndexerBlurStyleSample.gif)