使用文本常见问题
========

本文档介绍使用文本的常见问题并提供参考。

#### 文本显示（Text/Span）常见问题

以下内容介绍了使用[Text](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text)和[Span](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-span)组件进行文本显示时可能遇到的常见问题，包括文本截断、添加标签、显示表情等场景的处理方法。

#### \[h2\]Text组件尾部省略号后为什么还有一段空白，没有占满组件宽度

**问题现象**

在Text组件上未设置宽度，当内容过长时，省略号与组件边缘之间会留有较大空白，且内容更新时省略号的位置会发生变化。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0/v3/2kzcJrKFTKegHlUskWFbyQ/zh-cn_image_0000002634008798.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=FE25CA30A55C6B9358EA3376DE8BFD09829352CC92230A7F2C092C4A003142FC)

**原因分析**

当Text组件未设置宽度且内容超长时，组件宽度将采用父组件传递的布局约束的最大宽度。不同内容、不同的断词模式导致排版塑型结果不同，因此省略开始位置也会不同。

**解决措施**

设置[wordBreak](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#wordbreak11)属性为WordBreak.BREAK\_ALL，任意2个字符间断行使文本内容尽量占满组件区域。

示例代码如下：

import { common } from '@kit.AbilityKit';
@Entry
@Component
struct WordBreakd {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  private manager = this.context.resourceManager;

  // 'Text\_WordBreak'资源文件中的value值为'混合Hello World! honorificabilitudinitatibus'
  @State message: string = this.manager.getStringByNameSync('Text\_WordBreak');
  build() {
    NavDestination() {
    Column() {
      Text(this.message)
        .id('HelloWorld')
        .fontSize('25fp')
        .maxLines(1)
        .textOverflow({ overflow: TextOverflow.Ellipsis})
        .onClick(() => {
          this.message = 'Welcome try try try 1235628327434348';
        })
        .border({ width: 1})
        .wordBreak(WordBreak.BREAK\_ALL) // 修改断词模式
    }
    .width(300)
    .border({ width: 1, color: Color.Blue})
    .margin({left: 30, top: 50})
    }
    // ...
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3f/v3/34koMSXYS2ul7i62h57Yww/zh-cn_image_0000002664207945.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=C46C9683DFAA1B2A9C818C9AE9FCCFBFA90E03F837255B57B756DA5EAA619668)

#### \[h2\]Text组件如何实现行末展开样式

**解决措施**

自行测算截断字符，并在行末添加...展开或者...图标作为组件内容。实现方式请参考[getParagraphs](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-measureutils#getparagraphs20)的示例、[文本展开折叠](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-text-expand-collapse)。

#### \[h2\]Text组件如何实现内容超长时自动显示省略样式

**问题现象**

在固定尺寸的组件区域内，不同字号的内容显示的最大行数会有所不同。期望实现内容超长时自动显示省略样式，则无需设置固定的maxLines值。

**解决措施**

设置[heightAdaptivePolicy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#heightadaptivepolicy10)为TextHeightAdaptivePolicy.LAYOUT\_CONSTRAINT\_FIRST，该模式会删除超过布局约束的行，从而实现类似设置maxLines的效果。

示例代码如下：

import { common } from '@kit.AbilityKit';

@Entry
@Component
struct HeightAdaptivePolicy {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  private manager = this.context.resourceManager;

  // 'Text\_Adaptive\_Layout'资源文件中的value值为'混合Hello World! 多行文本 中英文数字混合 1282378283 ~'
  @State message: string = this.manager.getStringByNameSync('Text\_Adaptive\_Layout');
  @State fontSize: number = 25;
  build() {
    NavDestination() {
      Column({ space: 10 }) {
        Text(this.message)
          .id('HelloWorld')
          .fontSize(this.fontSize)
          .textOverflow({ overflow: TextOverflow.Ellipsis })
          .border({ width: 1 })
          .heightAdaptivePolicy(TextHeightAdaptivePolicy.LAYOUT\_CONSTRAINT\_FIRST) // 调整自适应布局策略
          .width(300)
          .height(200)
        Row() {
          Button('fontSize+5')
            .onClick(() => {
              this.fontSize += 5;
            })
          Button('fontSize-5')
            .onClick(() => {
              this.fontSize -= 5;
            })
        }
      }
      .margin({ left: 30, top: 50 })
    }
    // ...
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e0/v3/r9t-q4pQTRufuVSPTWE2rQ/zh-cn_image_0000002664328005.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=5A28A467121C8C29ACBD7481E3FFA9B08BB716CB9D626D423B5AE091C81FB232)

#### \[h2\]在文本前后添加自定义标签

**问题现象**

如何在文本的前后各添加一个标签，例如“专题”或“Top1”，且这些标签的[背景设置](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-background)、[尺寸设置](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-size)需要能够自定义。

**解决措施一**

如果标签和中间的长文本需在同一行显示，开发者可能会考虑使用[Span](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-span)实现，但是Span不支持设置尺寸。此时，可以在[弹性布局 (Flex)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-layout-development-flex-layout)或者[Row](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-row)中放置标签和长文本，并为长文本设置[textOverflow](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#textoverflow)属性，以确保文本超长时能够自适应截断，显示在一行之内。

实现步骤：

1.将标签和长文本放在同一个沿水平方向布局的容器Row中。

2.中间长文本设置textOverflow属性为TextOverflow.Ellipsis，空间不足时截断文本，显示省略号。

实现案例请参考[实现热搜榜](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-common-components-text-display#实现热搜榜)，该示例中，文字“1”、“爆”就是“我是热搜词条”的两个标签。这种实现方式写法简便，适合单行文本添加标签的场景。

**解决措施二**

如果需在多行文本前后添加标签并且不截断文本，上述方案会导致三个Text中的文本不能对齐，因为多行文本会在Row的宽度内折行。此时，可以在[层叠布局 (Stack)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-layout-development-stack-layout)中放置标签和长文本，给中间多行文本设置首行文本缩进距离[textIndent](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#textindent10)。多行文本后面的标签则需要通过[offset](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-location#offset)属性调整位置。这种实现方式，可以让三个Text组件中的文字水平对齐。实现步骤如下：

实现步骤：

1.将标签和长文本放在Stack中。

2.在组件显示之前的回调[aboutToAppear](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-custom-component-lifecycle#abouttoappear)中，使用[measureTextSize](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-measureutils#measuretextsize12)计算前标签的宽度，作为中间多行文本的首行缩进距离。

3.在组件显示之前的回调aboutToAppear中，通过[getParagraphs](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-uicontext-measureutils#getparagraphs20)计算中间多行文本最后一行的宽度、除最后一行文本之外的高度，作为后标签的偏移量offset。

4.设置后标签相对于Stack左上角的偏移量。

示例：

import { LengthMetrics } from '@kit.ArkUI';
import { common } from '@kit.AbilityKit';

@Entry
@Component
struct LengthMetric {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  private manager = this.context.resourceManager;

  // 'Text\_Add\_Tags\_Front\_and\_Post'资源文件中的value值为'这是一段长文本，超长部分折行，前后添加标签'
  @State message: string = this.manager.getStringByNameSync('Text\_Add\_Tags\_Front\_and\_Post');
  // 'Text\_Add\_Tags\_Front'资源文件中的value值为'前标签'
  @State frontTag: string = this.manager.getStringByNameSync('Text\_Add\_Tags\_Front');
  // 'Text\_Add\_Tags\_Post'资源文件中的value值为'后标签'
  @State backTag: string = this.manager.getStringByNameSync('Text\_Add\_Tags\_Post');
  @State frontPaddingVp: number = 20;
  @State backPaddingVp: number = 10;
  @State fontTagWidthVp: Length = 0;
  @State backOffsetVpX: Length = 0;
  @State backOffsetVpY: Length = 0;
  @State stackWidthVp: number = 300;

  // 显示之前，测算前后标签的位置，中间文本的缩进距离
  aboutToAppear(): void {
    // 计算前标签的宽度fontTagWidthVp，作为message的首行缩进距离
    let frontTagSize: SizeOptions = this.getUIContext().getMeasureUtils().measureTextSize({
      textContent: this.frontTag,
    });
    this.fontTagWidthVp = this.getUIContext().px2vp(Number(frontTagSize.width)) + this.frontPaddingVp \* 2

    // 计算frontTag+message占据的行数
    let linesFrontTagPlusMessage = 0;
    let mutableStr = new MutableStyledString(this.message,
      \[{
        start: 0,
        length: 1,
        styledKey: StyledStringKey.PARAGRAPH\_STYLE,
        styledValue: new ParagraphStyle({ textIndent: LengthMetrics.vp(this.fontTagWidthVp) })
      }\]
    )
    let paragraphArr = this.getUIContext()
      .getMeasureUtils()
      .getParagraphs(mutableStr, { constraintWidth: LengthMetrics.vp(this.stackWidthVp) });
    for (let i = 0; i < paragraphArr.length; ++i) {
      linesFrontTagPlusMessage += paragraphArr\[i\].getLineCount();
    }

    // 后标签offsetX的偏移量backOffsetVpX=frontTag+message最后一行的宽度
    this.backOffsetVpX =
      this.getUIContext().px2vp((paragraphArr\[paragraphArr.length-1\].getLineWidth(linesFrontTagPlusMessage - 1)))
    // 后标签offsetY的偏移量backOffsetVpY=frontTag+message总高度-最后一行的高度
    let heightFrontTagPlusMessageVp = 0;
    for (let i = 0; i < paragraphArr.length; ++i) {
      heightFrontTagPlusMessageVp += this.getUIContext().px2vp(paragraphArr\[i\].getHeight());
    }
    let lastLineHeight =
      this.getUIContext().px2vp(paragraphArr\[paragraphArr.length-1\].getLineHeight(linesFrontTagPlusMessage - 1))
    this.backOffsetVpY = heightFrontTagPlusMessageVp - lastLineHeight
  }

  build() {
    NavDestination() {
      Column({ space: 20 }) {
        Blank()
          .height(200)
        Stack() {
          Text(this.frontTag)
            .padding({ left: this.frontPaddingVp, right: this.frontPaddingVp })
            .backgroundColor('rgb(39, 135, 217)')
          Text(this.message)
            .textIndent(this.fontTagWidthVp)
            .padding(0)
          Text(this.backTag)
            .padding({ left: this.backPaddingVp, right: this.backPaddingVp })
            .backgroundColor('rgb(0, 74, 175)')
            .offset({
              x: this.backOffsetVpX,
              y: this.backOffsetVpY
            })
        }
        .alignContent(Alignment.TopStart) // 顶部起始端对齐
        .width(this.stackWidthVp)
      }
      .height('100%')
      .width('90%')
      .padding('5%')
    }
    // ...
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c2/v3/ltjYG1peTOOCths5At-hHA/zh-cn_image_0000002633848896.png?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=E6D024332C33DE29E0E53082516269C6620988F0AC128B1046D84E139B4DBA5F)

#### \[h2\]Text组件如何实现表情与文字一起显示

**问题现象**

emoji表情有时以表情符号的形式表示，如何将表情符号转换为emoji表情，并在Text组件中与文字一同显示？

**解决措施**

使用正则表达式解析表情符号，再将表情符号与图片资源建立映射，通过[Span](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-span)和[ImageSpan](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-imagespan)同时展示表情和文字。

// 请将$r('app.media.xxx')替换为实际资源文件
import { common } from '@kit.AbilityKit';
@Entry
@Component
struct DisplayedTogether {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  private manager = this.context.resourceManager;

  // 'Text\_Full\_Text'资源文件中的value值为
  // '你好我是Text\[grin\]，你好我\[rolling\_on\_the\_floor\_laughing\]是Text，\[slightly\_smiling\_face\]你好我是Text\[grin\]'
  @State fulltext: string = this.manager.getStringByNameSync('Text\_Full\_Text');

  static classifyTextAndEmojis(input: string): Map<string, string\[\]> {
    const emojiRegex = /\\\[(\[a-zA-Z\_\]+)\\\]/g; // 根据实际情况编写正则表达式
    const resultMap = new Map<string, string\[\]>(); // 用map记录普通文本和表情
    resultMap.set('text', \[\]);
    resultMap.set('emojis', \[\]);

    let lastIndex = 0;
    let match: RegExpExecArray | null = null;

    while ((match = emojiRegex.exec(input)) !== null) {
      // 添加普通文本
      if (match.index >= lastIndex) {
        resultMap.get('text')?.push(input.substring(lastIndex, match.index));
      }
      // 添加匹配到的表情
      resultMap.get('emojis')?.push(match\[1\]);
      lastIndex = match.index + match\[0\].length;
    }
    // 添加最后一段文本
    if (lastIndex < input.length) {
      resultMap.get('text')?.push(input.substring(lastIndex));
    }
    return resultMap;
  }

  static getEmojiImg(emojis: string\[\]): Resource\[\] { // 根据正则匹配结果返回自定义表情资源
    let emojisImg: Resource\[\] = \[\]
    for (let i = 0; i < emojis.length; i++) {
      switch (emojis\[i\]) {
        case 'rolling\_on\_the\_floor\_laughing':
          emojisImg.push($r('app.media.rolling\_on\_the\_floor\_laughing'))
          break;
        case 'slightly\_smiling\_face':
          emojisImg.push($r('app.media.slightly\_smiling\_face'))
          break;
        case 'grin':
          emojisImg.push($r('app.media.grin'))
          break;
        default:
          break;
      }
    }
    return emojisImg
  }

  build() {
    NavDestination() {
      Column() {
        TextInput({
          // 请将$r('app.string.Text\_emoji')替换为实际资源文件，在本示例中该资源文件的value值为"用户输入带表情的文本，例如：你好\[grin\]"
          placeholder: $r('app.string.Text\_emoji')
        })
          .width('80%')
          .padding(10)
          .border({ width: 1, color: '#EEEEEE' })
          .onChange((value: string) => {
            // 输入变化时，更新 fulltext
            this.fulltext = value;
          });

        Text() {
          ForEach(DisplayedTogether.classifyTextAndEmojis(this.fulltext).get('text'),
            (item: string, index: number) => { // 展示文本和自定义表情资源
              Span(item)
                .fontSize(18)
                .fontColor('#666666')
                .fontWeight(FontWeight.Regular)

              ImageSpan(DisplayedTogether.getEmojiImg(
                DisplayedTogether.classifyTextAndEmojis(this.fulltext).get('emojis'))\[index\])
                .verticalAlign(ImageSpanAlignment.BOTTOM)
                .height(24)
            })
        }
        .width('80%')
        .padding(15)
      }
      .width('100%')
      .height('100%')
      .justifyContent(FlexAlign.Center)
      .alignItems(HorizontalAlign.Center)
      .padding(20)
    }
    // ...
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2e/v3/vywtM5nvQIC5cTaG26AZaA/zh-cn_image_0000002634008800.png?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=FCD44A22CB1ED0D09E5AB67B9F5CADD82665CEF73A4CB2DC84007D20F634B70B)

#### \[h2\]文本超长时如何展示

**问题现象**

Text组件中内容过多，超出父组件容器[Column](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-column)的高度，会导致文本溢出容器边界，如何让文本显示在父组件容器的区域内？

**解决措施一**

Text文本是自动折行的，当没有限制Text高度[height](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-size#height)时，Text高度在文本的行数增加时自动调整。可以通过设置[maxLines](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#maxlines)属性限制文本的最大行数，如果有多余的文本默认会被截断。也可以通过[textOverflow](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#textoverflow)属性来指定截断方式。

以下示例展示了限制Text组件不超过三行的场景。

import { common } from '@kit.AbilityKit';

@Entry
@Component
struct TextLong {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  private manager = this.context.resourceManager;

  // 'Text\_Long\_String'资源文件中的value值为'这是一段超长文本'
  @State message: string = this.manager.getStringByNameSync('Text\_Long\_String').repeat(50);

  build() {
    NavDestination() {
      Column() {
        Text(this.message)
          .height('auto')
          .maxLines(3)
      }
      .height(200)
      .width('80%')
      .margin('10%')
      .borderWidth(1)
      .justifyContent(FlexAlign.Center)
    }
    // ...
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e4/v3/uFesuJL0TUanlvwOM7MXJQ/zh-cn_image_0000002664207947.png?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=732F2F3B5A5E3F5E1B81CA898F71B95EAFC326925297B13768D7138D5F353C29)

**解决措施二**

上述方法会导致部分文本被裁剪掉，如果需要保留全部文本，可以把Text组件放在滚动容器[Scroll](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-container-scroll)内，再通过手势滑动来浏览全部文本，具体示例如下：

import { common } from '@kit.AbilityKit';

@Entry
@Component
struct TextLongTow {
  private context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  private manager = this.context.resourceManager;

  // 'Text\_Long\_String'资源文件中的value值为'这是一段超长文本'
  @State message: string = this.manager.getStringByNameSync('Text\_Long\_String').repeat(50);

  build() {
    NavDestination() {
      Column() {
        Scroll() {
          Text(this.message)
        }
        .scrollBar(BarState.Off)
      }
      .height(200)
      .width('80%')
      .margin('10%')
      .borderWidth(1)
      .justifyContent(FlexAlign.Center)
    }
    // ...
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/39/v3/hGrcgihaSo6hWlTYNNZtUA/zh-cn_image_0000002664328007.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=3B21D4151AB0036EE2FF4BA79713F2FADC595AAB81DA235DE5F354E19C229F45)

#### \[h2\]selection如何触发弹出自定义菜单并设置菜单字体大小

**问题现象**

在[bindSelectionMenu](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#bindselectionmenu11)自定义选择菜单中，可通过TextResponseType设置文本选择菜单的响应类型。通过[selection](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#selection11)如何触发弹出自定义菜单并设置菜单字体大小。

**解决措施**

若希望由selection触发自定义菜单，可将TextResponseType设置为DEFAULT。同时，在[Menu](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-menu)组件上通过配置font属性，即可自定义菜单的字体大小，灵活适配界面设计需求。

@Entry
@Component
export struct HowToSetCustomSelectionMenuExample {
  @State selectStart: number = 0;
  @State selectEnd: number = 0;

  build() {
    NavDestination() {
      Column() {
        Column() {
          // 请将$r('app.string.Set\_Custom\_Selection\_Menu\_Example\_String')替换为实际资源文件，在本示例中该资源文件的value值为"TextTextTextText"
          Text($r('app.string.Set\_Custom\_Selection\_Menu\_Example\_String'))
            .fontSize(14)
            .selection(this.selectStart, this.selectEnd)
            .copyOption(CopyOptions.InApp)
            .bindSelectionMenu(TextSpanType.TEXT, this.CustomMenu, TextResponseType.DEFAULT, {
              onDisappear: () => {
                this.selectStart = -1;
                this.selectEnd = -1;
              },
            })
            .textAlign(TextAlign.Center)
            .borderWidth(1)
            .borderColor(Color.Red)
          Button('Set selection')
            .onClick(() => {
              this.selectStart = 0;
              this.selectEnd = 10;
            })
            .fontSize(14)
            .margin({ top: 20 })
        }
        .width('100%')
        .padding({ top: 300 })
      }
      .height('100%')
    }
  }

  @Builder
  CustomMenu() {
    Column() {
      Menu() {
        // 请将$r('app.string.Menu\_Item\_String')替换为实际资源文件，在本示例中该资源文件的value值为"Item Content"
        MenuItem({ content: $r('app.string.Menu\_Item\_String') })
        MenuItem({ content: $r('app.string.Menu\_Item\_String') })
        MenuItem({ content: $r('app.string.Menu\_Item\_String') })
      }
      .font({ size: 14 })
      .radius($r('sys.float.ohos\_id\_corner\_radius\_card'))
      .clip(true)
      .backgroundColor('#F0F0F0')
    }
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2c/v3/9ZKwE38GS-y_nx76IU_hCg/zh-cn_image_0000002633848898.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=13B76DB407687A3B17098B29A3A3B8D3EB0366CDB83A3386E5ABCF667B607A3F)

#### \[h2\]如何屏蔽文本的长按手势

**问题现象**

配置[CopyOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-appendix-enums#copyoptions9)将文本设置为可选择，此时长按文本会选择文字内容并弹出系统菜单，如何使长按手势不生效。

**解决措施**

想要使长按手势对文本不生效，可以设置触发时间小于系统菜单触发时间（500ms）的自定义长按手势。

// xxx.ets
@Entry
@Component
struct TextExample8 {
  build() {
    Column() {
      Text("TextTextTextText")
        .copyOption(CopyOptions.InApp)
        .gesture(LongPressGesture({ repeat: false, duration: 400 })
          .onAction(() => {
          }))
        .margin({
          top: 100,
          bottom: 100,
          left: 100,
          right: 100
        })
    }
    .height('100%')
  }
}

#### \[h2\]设置enableVariableFontWeight为true后字重不能跟随设置调节

**问题现象**

Text组件调用[fontWeight](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-text#fontweight12)接口，[FontSettingOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-text-common#fontsettingoptions12对象说明)类型的入参options设置enableVariableFontWeight值为true之后，在系统设置的“字体大小和界面缩放”页面中调节字体粗细，Text组件的字重不跟随变化。

**解决措施**

1.  如果需要Text组件字重跟随系统设置变化，需要在[configuration标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#configuration标签)设置followSystem。
    
2.  字体配置项options控制是否启用可变字重调节。
    

*   当options的参数enableVariableFontWeight取值true时，启用可变字重调节。weight取值为\[100, 900\]范围内任意整数时，字重取值为weight。此时如果在设置中调节字体粗细，字重始终是开发者设置的数值weight，字体粗细不会变化。
    
*   当options的参数enableVariableFontWeight取值false时，禁用可变字重调节。weight取值为\[100, 900\]范围内的整百数值时，字重取值为weight。weight是非整百数值时，字重取默认值400。此时更改设置中的字体粗细，字重会随设置变化。此时如果在设置中调节字体粗细，字重会随设置变化。
    

#### 文本输入（TextInput/TextArea/Search）常见问题

以下内容介绍了使用[TextInput](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput)、[TextArea](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textarea)和[Search](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-search)组件输入文本时可能遇到的问题。

#### \[h2\]TextInput被遮挡时光标仍然不消失

**问题现象**

在Stack中堆叠了多个组件，包含一个输入框（TextInput），当TextInput组件被遮挡时，偶尔会出现带有小圆圈的手柄，显示在其他组件上。

**解决措施**

当TextInput组件处于选中状态并显示操作手柄时，选中区域和操作手柄可能不在同一图层渲染。其中，选中区域与输入框在同一图层，而操作手柄则在更高的图层上。因此，当输入框被其他元素遮挡时，选中区域也会被遮挡，但操作手柄仍然可见。

TextInput被遮挡时，如果通过[TextInputController](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput#textinputcontroller8)设置焦点和选中区域会出现上述现象。涉及的选中区域设置接口包括[selectAll](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput#selectall11)和[setTextSelection](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput#settextselection10)。建议检查应用代码中以下接口的调用时机，在输入框被遮挡后避免设置选中区域。

| 组件 | 接口 |
| :-- | :-- |
| Search | [setTextSelection](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-search#settextselection12) |
| TextArea | [setTextSelection](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textarea#settextselection10) |
| TextInput | [selectAll](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput#selectall11) |
| TextInput | [setTextSelection](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-basic-components-textinput#settextselection10) |

以下示例展示了一个典型的问题场景，存在一个内容为“TextInput被遮挡不显示”的TextInput组件被隐藏，但点击按钮后，图片上会出现TextInput操作手柄。此时，开发者需要检查应用代码，确保在输入框被遮挡时没有设置选中区域。移除设置输入框选中区域的代码逻辑，即可解决操作手柄出现的问题。

@Entry
@Component
export struct CursorPersistsWhenTextInputIsCoveredExample {
  controller: TextInputController = new TextInputController();
  @State message1: string = 'TextInput被遮挡不显示';

  build() {
    NavDestination() {
      Column({ space: 50 }) {
        Stack() {
          TextInput({ text: this.message1, controller: this.controller })
            .copyOption(CopyOptions.LocalDevice)
            .backgroundColor(Color.Green)
            .width(200)
            .id('textInput\_1')

          // $r('app.media.foreground')需要替换为开发者所需的图像资源文件。
          Image($r('app.media.foreground'))
            .width(200)
            .height(200)
            .backgroundColor('rgb(213,213,213)')
        }

        Button('点击出现手柄')
          .onClick(() => {
            this.getUIContext().getFocusController().requestFocus('textInput\_1')
            this.controller.setTextSelection(0, 5, { menuPolicy: MenuPolicy.HIDE })
          })
      }
      .padding('10%')
      .alignItems(HorizontalAlign.Center)
      .height('100%')
      .width('90%')
    }
    .backgroundColor('#f1f2f3')
    .title($r('app.string.Cursor\_Persists\_When\_TextInput\_Is\_Covered'))
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fd/v3/sahRloqCQ3GFlgjHhsN5MQ/zh-cn_image_0000002634008802.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132325Z&HW-CC-Expire=86400&HW-CC-Sign=CF491A53CD4B26FF6C42E71D582FD42CBAD4F65CFD9BB0421B9A4071A7235E66)