Lynx

属性

`android-fullscreen-mode`

Android

3.4

// @默认值: true
'android-fullscreen-mode'?: boolean;

在横屏时是否进入全屏输入模式，在此模式下键盘和输入框将占据整个屏幕

`bounces`

iOS

3.4

// @默认值: true
bounces?: boolean;

iOS 的反弹效果

`confirm-type`

iOS

Harmony

3.4

// @默认值: 'done'
'confirm-type'?: 'search' | 'send' | 'go' | 'done' | 'next';

确认按钮的类型

`disabled`

Android

iOS

Harmony

3.5

// @默认值: false
disabled?: boolean;

是否启用交互

`enable-scroll-bar`

Android

iOS

3.6

// @默认值: false
'enable-scroll-bar'?: boolean;

是否显示滚动条，在鸿蒙系统上，滚动条将始终显示

`input-filter`

Android

iOS

Harmony

3.4

// @默认值: undefined
'input-filter'?: string;

过滤输入内容，并以正则表达式的形式进行处理

`ios-auto-correct`

iOS

3.4

// @默认值: true
'ios-auto-correct'?: boolean;

在 iOS 上自动纠正输入内容

`ios-spell-check`

iOS

3.4

// @默认值: true
'ios-spell-check'?: boolean;

在 iOS 上检查拼写问题

`line-spacing`

Android

iOS

3.4

// @默认值: undefined
'line-spacing'?: number | any | any;

行间距

`maxlength`

Android

iOS

Harmony

3.4

// @默认值: 140
maxlength?: number;

最大输入长度

`maxlines`

Android

iOS

Harmony

3.4

// @默认值: undefined
maxlines?: number;

最大输入行数

`placeholder`

Android

iOS

Harmony

3.4

placeholder?: string;

占位符

`readonly`

Android

iOS

Harmony

3.4

// @默认值: false
readonly?: boolean;

只读

`show-soft-input-on-focus`

Android

iOS

3.4

// @默认值: true
'show-soft-input-on-focus'?: boolean;

聚焦时显示软输入键盘

`type`

Android

iOS

Harmony

3.4

// @默认值: "text"
type?: 'number' | 'text' | 'digit' | 'tel' | 'email';

输入内容类型

事件

前端可以绑定相应的事件回调来监听元素的运行时行为，如下所示。

`bindblur`

Android

iOS

Harmony

3.4

bindblur = (e: TextAreaBlurEvent) => {};

字段	类型	是否可选	默认值	平台	版本	描述
value	string	否	–	Android iOS Harmony 3.4	3.4	输入内容

失去焦点

`bindconfirm`

Android

iOS

Harmony

3.4

bindconfirm = (e: TextAreaConfirmEvent) => {};

字段	类型	是否可选	默认值	平台	版本	描述
value	string	否	–	Android iOS Harmony 3.4	3.4	输入内容

点击确认按钮，仅在定义了 confirm-type 时生效

`bindfocus`

Android

iOS

Harmony

3.4

bindfocus = (e: TextAreaFocusEvent) => {};

字段	类型	是否可选	默认值	平台	版本	描述
value	string	否	–	Android iOS Harmony 3.4	3.4	输入内容

获得焦点

`bindinput`

Android

iOS

Harmony

3.4

bindinput = (e: TextAreaInputEvent) => {};

字段	类型	是否可选	默认值	平台	版本	描述
isComposing	boolean	是	–	Android iOS Harmony 3.4	3.4	是否正在输入
selectionEnd	number	否	–	Android iOS Harmony 3.4	3.4	选中文本的结束位置
selectionStart	number	否	–	Android iOS Harmony 3.4	3.4	选中文本的起始位置
value	string	否	–	Android iOS Harmony 3.4	3.4	输入内容

输入内容改变

`bindselection`

Android

iOS

Harmony

3.4

bindselection = (e: TextAreaSelectionChangeEvent) => {};

字段	类型	是否可选	默认值	平台	版本	描述
selectionEnd	number	否	–	Android iOS Harmony 3.4	3.4	选中文本的结束位置
selectionStart	number	否	–	Android iOS Harmony 3.4	3.4	选中文本的起始位置

输入选中文本改变

方法

前端可以通过 SelectorQuery API 调用组件方法。

`blur`

Android

iOS

Harmony

3.4


lynx.createSelectorQuery()
     .select('#id')
     .invoke({
      method: 'blur',
      success: function (res) {},
      fail: function (res) {},
    })
    .exec();

释放焦点

`focus`

Android

iOS

Harmony

3.4


lynx.createSelectorQuery()
     .select('#id')
     .invoke({
      method: 'focus',
      success: function (res) {},
      fail: function (res) {},
    })
    .exec();

请求焦点

`getValue`

Android

iOS

Harmony

3.4

interface GetValueResult {
  /**
   * 是否正在输入，仅 iOS 支持
   * @Android
   * @iOS
   * @Harmony
   * @Web
   * @since 3.4
   */
  isComposing: boolean;
  /**
   * 光标结束位置
   * @Android
   * @iOS
   * @Harmony
   * @Web
   * @since 3.4
   */
  selectionEnd: number;
  /**
   * 光标开始位置
   * @Android
   * @iOS
   * @Harmony
   * @Web
   * @since 3.4
   */
  selectionStart: number;
  /**
   * 输入内容
   * @Android
   * @iOS
   * @Harmony
   * @Web
   * @since 3.4
   */
  value: string;
}

lynx.createSelectorQuery()
     .select('#id')
     .invoke({
      method: 'getValue',
      success: function (res: GetValueResult) {},
      fail: function (res) {},
    })
    .exec();

获取输入内容

`setSelectionRange`

Android

iOS

Harmony

3.4


lynx.createSelectorQuery()
     .select('#id')
     .invoke({
      method: 'setSelectionRange',
      params: {
        /**
         * 选择区域的结束位置
         * @Android
         * @iOS
         * @Harmony
         * @Web
         * @since 3.4
         */
        selectionEnd: 5,
        /**
         * 选择区域的开始位置
         * @Android
         * @iOS
         * @Harmony
         * @Web
         * @since 3.4
         */
        selectionStart: 0,
      },
      success: function (res) {},
      fail: function (res) {},
    })
    .exec();

设置选择区域

`setValue`

Android

iOS

Harmony

3.4


lynx.createSelectorQuery()
     .select('#id')
     .invoke({
      method: 'setValue',
      params: {
        /**
         * 输入内容
         * @Android
         * @iOS
         * @Harmony
         * @Web
         * @since 3.4
         */
        value: 'hello',
      },
      success: function (res) {},
      fail: function (res) {},
    })
    .exec();

设置输入内容

#属性

#android-fullscreen-mode

#bounces

#confirm-type

#disabled

#enable-scroll-bar

#input-filter

#ios-auto-correct

#ios-spell-check

#line-spacing

#maxlength

#maxlines

#placeholder

#readonly

#show-soft-input-on-focus

#type

#事件

#bindblur

#bindconfirm

#bindfocus

#bindinput

#bindselection

#方法

#blur

#focus

#getValue

#setSelectionRange

#setValue

属性

`android-fullscreen-mode`

`bounces`

`confirm-type`

`disabled`

`enable-scroll-bar`

`input-filter`

`ios-auto-correct`

`ios-spell-check`

`line-spacing`

`maxlength`

`maxlines`

`placeholder`

`readonly`

`show-soft-input-on-focus`

`type`

事件

`bindblur`

`bindconfirm`

`bindfocus`

`bindinput`

`bindselection`

方法

`blur`

`focus`

`getValue`

`setSelectionRange`

`setValue`