文本阅读器

在线编辑

允许将较长的文本部分显示在可折叠窗格中，可切换此窗格来显示更多或更少的数据。

数据绑定

在“常规”属性中设置或修改该视图的数据绑定。 “文本阅读器”可绑定到 String 变量。

配置属性

在“配置”下，设置或修改视图的外观和行为属性。

屏幕大小
在属性名称旁边具有 "屏幕大小" 图标 "屏幕大小" 图标 的配置属性对于每个屏幕大小可以具有不同的值。 如果您未设置值，那么屏幕大小会继承下一个更大的屏幕大小值来作为其缺省值。
主题定义
主题定义指定视图的颜色和样式，并确定视图的外观。 您可以在主题编辑器中预览视图的外观。 请参阅 主题。

下表中显示了“文本阅读器”的外观配置属性：

表 1. “文本阅读器”的外观配置属性
外观配置属性 描述 数据类型
宽度 "屏幕大小" 图标 指定视图的宽度，以像素、百分比或 em 为单位。 例如: 50px ， 20% 或 0.4em。 如果未指定单位类型，那么将使用 px。 String
高度 "屏幕大小" 图标 指定该视图的高度，以 px（像素）或 em 为单位。 如果未指定单位类型，那么将使用 px。 String
大小 "屏幕大小" 图标 指定标签和文本的字号。
  • 缺省值
  • 大
  • 小
 String
标签放置 "屏幕大小" 图标 指定标签相对于文本的位置。
  • 顶部
  • Left
注: 左侧的标签将更改视图的指定宽度。
 String
标签宽度 大屏幕图标 这是标签的宽度。 您可以指定宽度，以 px（像素）、%（百分比）或 em 为单位。 例如，50px、20% 或 0.4em。 如果未指定单位类型，那么将使用 px。 String
下表中列出了“文本阅读器”的行为配置属性：
表 2. “文本阅读器”的行为配置属性
行为配置属性 描述 数据类型
最大文本长度 指定在显示“阅读更多内容”提示之前显示的最大字符数。

如果未指定该数字或该数字小于 1，那么将使用缺省值（128 个字符）。

 Integer
“阅读更多内容”提示 针对“阅读更多内容”提示显示的占位符文本。 String
“阅读更少内容”提示 针对“阅读更少内容”提示显示的占位符文本。 String
初始展开 指定在装入页面时文本部分是否处于展开状态。 Boolean
使用箭头图标 支持您使用箭头图标来展开和折叠文本区域。 Boolean

事件

在“事件”属性中设置或修改该视图的事件处理程序。 可以将事件设置为以编程方式或在用户与该视图交互时触发。 有关如何定义和编码事件的信息，请参阅 用户定义的事件。
“文本阅读器”具有以下类型的事件处理程序：
  • On load：页面装入时激活。 例如：
    if (${DeviceSensor}.getDeviceInfo().isIPhone) {me.setExpanded(false);} else {me.setExpanded(true);}
  • On click: 在单击视图时激活。 例如：
    me.toggleExpanded()
  • On expand: 在用户展开文本时激活。 例如：
    ${TextReader2}.setExpanded(false)
  • On collapse: 在用户折叠文本时激活。 例如：
    ${TextReader2}.setExpanded(true)

方法

有关 "文本阅读器" 的可用方法的详细信息，请参阅 文本阅读器 JavaScript API 。

其他资源

有关如何创建 Coach 或页面的信息，请参阅 构建 Coach。
有关标准属性 (常规， 配置， 定位， 可视性和 HTML 属性) 的信息，请参阅 查看属性。