diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-alphabet-indexer.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-alphabet-indexer.md index 751ac18174e53a00b24f84192503ae637c6d9c08..9d90b27886e63a7126717f3672fa77effbfe7e01 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-alphabet-indexer.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-alphabet-indexer.md @@ -1,6 +1,6 @@ # AlphabetIndexer -字母索引条。 +可以与容器组件联动用于按逻辑结构快速定位容器显示区域的组件。 > **说明:** > @@ -18,40 +18,44 @@ AlphabetIndexer(value: {arrayValue: Array<string>, selected: number}) **参数:** -| 参数名 | 参数类型 | 必填 | 参数描述 | -| ---------- | ------------------- | ---- | ---------- | -| arrayValue | Array<string> | 是 | 字母索引字符串数组。 | -| selected | number | 是 | 初始选中项索引值。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| -------- | -------- | -------- | -------- | +| arrayValue | Array<string> | 是 | 字母索引字符串数组,不可设置为空。 | +| selected | number | 是 | 初始选中项索引值,若超出索引值范围,则取默认值0。 | ## 属性 -| 名称 | 参数类型 | 描述 | -| ----------------------- | ---------------------------------------- | ----------------------------------- | -| color | [ResourceColor](ts-types.md#resourcecolor8) | 设置文字颜色。 | -| selectedColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置选中项文字颜色。 | -| popupColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置提示弹窗文字颜色。 | -| selectedBackgroundColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置选中项背景颜色。 | -| popupBackground | [ResourceColor](ts-types.md#resourcecolor8) | 设置提示弹窗背景色。 | -| usingPopup | boolean | 设置是否使用提示弹窗。 | -| selectedFont | [Font](ts-types.md#font) | 设置选中项文字样式。 | -| popupFont | [Font](ts-types.md#font) | 设置提示弹窗字体样式。 | -| font | [Font](ts-types.md#font) | 设置字母索引条默认字体样式。 | -| itemSize | string \| number | 设置字母索引条字母区域大小,字母区域为正方形,即正方形边长。 | -| alignStyle | IndexerAlign | 设置字母索引条弹框的对齐样式,支持弹窗显示在索引条右侧和左侧。
默认值:IndexerAlign.Right | -| selected | number | 设置选中项索引值。 | -| popupPosition | [Position](ts-types.md#position8) | 设置弹出窗口相对于索引器条上边框中点的位置。 | +除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性: + +| 名称 | 参数类型 | 描述 | +| ----------------------- | --------------- | ----------------------------------------------------------- | +| color | [ResourceColor](ts-types.md#resourcecolor) | 设置文字颜色。
默认值:0x99000000。 | +| selectedColor | [ResourceColor](ts-types.md#resourcecolor) | 设置选中项文字颜色。
默认值:0xFF254FF7。 | +| popupColor | [ResourceColor](ts-types.md#resourcecolor) | 设置提示弹窗文字颜色。
默认值:0xFF254FF7。 | +| selectedBackgroundColor | [ResourceColor](ts-types.md#resourcecolor) | 设置选中项背景颜色。
默认值:0x1F0A59F7。 | +| popupBackground | [ResourceColor](ts-types.md#resourcecolor) | 设置提示弹窗背景色。
默认值:0xFFF1F3F5。 | +| usingPopup | boolean | 设置是否使用提示弹窗。
默认值:false。 | +| selectedFont | [Font](ts-types.md#font) | 设置选中项文字样式。
默认值:
{
fontSize:10,
fontStyle:FontStyle.Normal,
fontWeight:FontWeight.Normal,
fontFamily:HarmonyOS Sans
} | +| popupFont | [Font](ts-types.md#font) | 设置提示弹窗字体样式。
默认值:
{
fontSize:10,
fontStyle:FontStyle.Normal,
fontWeight:FontWeight.Normal,
fontFamily:HarmonyOS Sans
} | +| font | [Font](ts-types.md#font) | 设置字母索引条默认字体样式。
默认值:
{
fontSize:10,
fontStyle:FontStyle.Normal,
fontWeight:FontWeight.Normal,
fontFamily:HarmonyOS Sans
} | +| itemSize | string \| number | 设置字母索引条字母区域大小,字母区域为正方形,即正方形边长。
默认值:24.0。 | +| alignStyle | IndexerAlign | 设置字母索引条弹框的对齐样式,支持弹窗显示在索引条右侧和左侧。
默认值:IndexerAlign.Right。 | +| selected | number | 设置选中项索引值。
默认值:0。 | +| popupPosition | [Position](ts-types.md#position8) | 设置弹出窗口相对于索引器条上边框中点的位置。
默认值:{x:96.0, y:48.0}。 | ## IndexerAlign枚举说明 -| 名称 | 描述 | -| ----- | ----------- | -| Left | 弹框显示在索引条右侧。 | +| 名称 | 描述 | +| -------- | -------- | +| Left | 弹框显示在索引条右侧。 | | Right | 弹框显示在索引条左侧。 | ## 事件 -| 名称 | 功能描述 | -| ---------------------------------------- | ---------------------------------------- | +仅支持以下事件: + +| 名称 | 功能描述 | +| -------- | -------- | | onSelected(callback: (index: number) => void)(deprecated) | 索引条选中回调,返回值为当前选中索引。 | | onSelect(callback: (index: number) => void)8+ | 索引条选中回调,返回值为当前选中索引。 | | onRequestPopupData(callback: (index: number) => Array<string>)8+ | 选中字母索引后,请求索引提示弹窗显示内容回调。
返回值:索引对应的字符串数组,此字符串数组在弹窗中竖排显示,字符串列表最多显示5个,超出部分可以滑动显示。 |