组件:窗口标题框

窗口标题框组件用于移动端页面顶部的标题栏,支持设置标题、左侧图标、右侧图标、图标尺寸、置元素被单击回调等特性,常用于手机页面头部导航栏、返回按钮与标题组合场景,注意默认左右两侧图标隐藏。

典型使用场景:

  • 移动端页面标题栏(手机APP页面顶部导航)
  • 返回按钮与标题组合(页面返回功能)
  • 操作按钮组(分享、收藏、设置等操作)
  • 搜索栏(页面搜索功能)
  • 用户信息展示(头像、用户名、状态)

📌 继承自视图的成员速查

本组件继承自 视图 类,可直接使用以下属性和方法:

属性: ID、左边、顶边、右边、底边、宽度、高度、背景、背景颜色、背景图像、文本、文本颜色、字体、字体大小、字体粗细、行高、边框、边框圆角、边框宽度、光标样式、显示模式、透明度、外边距、外边距底、外边距左、外边距右、外边距顶、最大高度、最大宽度、最小高度、最小宽度、内边距、内边距底、内边距左、内边距右、内边距顶、定位、CLASS、InnerHTML、OuterHTML、内容水平对齐方式、首行缩进、可视、显示层级、内联样式、禁用

方法: 追加内联样式(样式文本)、置内联样式(名称,值)、取内联样式值(名称)、取Style对象()、添加事件(事件名称, 回调函数)、删除事件(事件名称, 回调函数)、获取焦点()、清除焦点()、添加样式类(类名称)、移除样式类(类名称)、取样式类列表()、取样式类()、执行单击()、取属性值(属性名)、取属性节点(属性名)、取布局参数()、取渲染宽度()、取渲染高度()、取渲染顶边()、取渲染左边()、左侧对齐到(目标组件,偏移量)、右侧对齐到(目标组件,偏移量)、顶边对齐到(目标组件,偏移量)、底边对齐到(目标组件,偏移量)、右侧对齐到左(目标组件, 偏移量)、左侧对齐到右(目标组件, 偏移量)、底边对齐到顶(目标组件, 偏移量)、顶边对齐到底(目标组件, 偏移量)、有指定属性(属性名)、有属性()、内容可编辑()、包含CSS类(类名)、取命名空间()、取下个节点()、取下个元素()、取节点名称()、取节点类型()、取父节点()、取父元素()、取上个节点()、取上个元素()、销毁()、删除属性(属性名)、删除属性节点(属性名)、置属性值(属性名, 属性值)、置属性节点(属性节点)、取标签名()、移动(左边 顶边, 宽度, 高度)、取原生对象()、置被单击回调(回调函数)、置被双击回调(回调函数)、置鼠标被进入回调(回调函数)、置鼠标被移出回调(回调函数)、置鼠标被移动回调(回调函数)、置鼠标被按下回调(回调函数)、置鼠标被抬起回调(回调函数)、置鼠标滚轮被滚动回调(回调函数)、置键盘被按下回调(回调函数)、置按键被抬起回调(回调函数)、置按键被压下回调(回调函数)、置被失去焦点回调(回调函数)、置被获得焦点回调(回调函数)

事件: 被单击(源对象,事件源)、被双击(源对象,事件源)、鼠标被进入(源对象,事件源)、鼠标被移出(源对象,事件源)、鼠标被移动(源对象,事件源)、鼠标被按下(源对象,事件源)、鼠标被抬起(源对象,事件源)、鼠标滚轮被滚动(源对象,事件源)、键盘被按下(源对象,事件源)、按键被抬起(源对象,事件源)、按键被压下(源对象,事件源)、被失去焦点(源对象,事件源)、被获得焦点(源对象,事件源)

💡 完整成员列表及详细说明请参考:视图

常用操作速查

操作属性/方法示例
设置标题文本标题窗口标题框1.标题 = "首页"
设置左侧图标左侧图标窗口标题框1.左侧图标 = "static/back.png"
设置右侧图标右侧图标窗口标题框1.右侧图标 = "static/menu.png"
设置图标尺寸置图标尺寸(宽度, 高度)窗口标题框1.置图标尺寸(36, 36)
设置元素点击回调置元素被单击回调(回调)窗口标题框1.置元素被单击回调((源对象, 被单击索引) => { ... })
设置背景颜色背景颜色窗口标题框1.背景颜色 = "#ffffff"
设置文本颜色文本颜色窗口标题框1.文本颜色 = "#333333"

样式美化参考

标题栏样式变体:

  • 简约标题栏:背景颜色 = "#ffffff"边框 = "none",`高度 = 56
  • 卡片标题栏:背景颜色 = "#ffffff"边框 = "none"阴影 = "0 2px 8px rgba(0,0,0,0.1)",`高度 = 64
  • 渐变标题栏:背景颜色 = "linear-gradient(135deg, #1890ff, #096dd9)"边框 = "none",`高度 = 60

标题样式:

  • 主标题:文本颜色 = "#333333"字体大小 = "18px"字体粗细 = "粗体"
  • 副标题:文本颜色 = "#666666"字体大小 = "16px"字体粗细 = "正常"
  • 链接标题:文本颜色 = "#1890ff"字体大小 = "16px"下划线 = "none"

图标样式:

  • 返回图标:左侧图标 = "static/back.png"图标尺寸 = (32, 32)文本颜色 = "#333333"
  • 菜单图标:右侧图标 = "static/menu.png"图标尺寸 = (24, 24)文本颜色 = "#333333"
  • 搜索图标:右侧图标 = "static/search.png"图标尺寸 = (24, 24)文本颜色 = "#666666"

布局样式:

  • 固定定位:定位 = "固定"顶边 = 0宽度 = "100%",`高度 = 56
  • 相对定位:定位 = "相对"外边顶 = 0宽度 = "100%",`高度 = 56
  • 粘性定位:定位 = "粘性"顶边 = 0宽度 = "100%",`高度 = 56

状态样式:

  • 正常状态:背景颜色 = "#ffffff"文本颜色 = "#333333"图标颜色 = "#333333"
  • 悬停状态:背景颜色 = "#f0f0f0"文本颜色 = "#1890ff"图标颜色 = "#1890ff"
  • 按下状态:背景颜色 = "#e6f7ff"文本颜色 = "#096dd9"图标颜色 = "#096dd9"

响应式样式:

  • 移动端适配:高度 = 56字体大小 = "16px"图标尺寸 = (32, 32)
  • 平板端适配:高度 = 64字体大小 = "18px"图标尺寸 = (36, 36)
  • 桌面端适配:高度 = 72字体大小 = "20px"图标尺寸 = (40, 40)

特殊样式:

  • 透明背景:背景颜色 = "透明"文本颜色 = "#ffffff"图标颜色 = "#ffffff"
  • 深色主题:背景颜色 = "#1f1f1f"文本颜色 = "#ffffff"图标颜色 = "#ffffff"
  • 半透明:背景颜色 = "rgba(255,255,255,0.9)"边框 = "1px solid rgba(0,0,0,0.1)"阴影 = "0 2px 8px rgba(0,0,0,0.1)"

示例代码

' 示例:完整的窗口标题框使用演示
' 1. 创建窗口标题框
变量 窗口标题框1 = 创建 窗口标题框()
' 2. 设置属性
窗口标题框1.左边 = 0
窗口标题框1.顶边 = 0
窗口标题框1.宽度 = 400
窗口标题框1.高度 = 56
窗口标题框1.标题 = "首页"
窗口标题框1.左侧图标 = "static/back.png"
窗口标题框1.右侧图标 = "static/menu.png"
窗口标题框1.置图标尺寸(36, 36)
' 3. 设置事件回调
窗口标题框1.置元素被单击回调((源对象, 被单击索引) => {
	调试输出("被点击索引:" + 被单击索引)
})
' 4. 添加到父容器
添加组件(窗口标题框1)

属性:标题

  • 类型: 文本型
  • 说明: 设置或获取窗口标题框的标题文本内容,支持设置纯文本及HTML内容。

属性:右侧图标

  • 类型: 文本型
  • 说明: 设置或获取窗口标题框的右侧图标,支持本地图片及网络图片。

属性:左侧图标

  • 类型: 文本型
  • 说明: 设置或获取窗口标题框的左侧图标,支持本地图片及网络图片。

函数:置图标尺寸(宽, 高)

设置窗口标题框左右两侧的图标尺寸,默认宽, 高均为36像素。

函数:置元素被单击回调(回调函数)

设置当窗口标题框中的图标或标题文本被单击时要回调的函数对象,系统回调函数时返回索引参数,0左侧图标,1标题文本,2右侧图标。

事件:元素被单击(源对象,被单击索引)

当窗口标题框中的图标或标题文本被单击时触发,被单击索引:0左侧图标,1标题文本,2右侧图标。