更新时间:2025-08-15 GMT+08:00

设置华为云Astro轻应用标准页面Markdown卡片组件属性

Markdown卡片是用于渲染Markdown内容的组件,能够将文字、符号等信息按照特定格式呈现,例如公告、新闻等。

图1 Markdown卡片

数据绑定

通过建立不同类型的视图模型,将各种数据源和组件的返回值或者属性值进行关联,实现动态数据效果。

属性值绑定:将容器组件的某个属性,如隐藏、样式、弹性布局等与具体的模型字段相绑定,绑定后组件的属性随模型字段的值变化而变化,类似Vue的v-bind。
  1. “数据绑定”中,单击“属性值绑定”后的“+”
  2. “属性”下拉框中,选择对应的属性。
  3. 在模型字段中,单击,进入选择模型页面。
  4. 单击“新增模型”,进入新增模型页面。
  5. 设置模型名称与来源,单击“下一步”。
    华为云Astro轻应用支持自定义、对象、服务和事件四类模型,每类模型都包含参数定义和方法定义。方法是在模型上定义的API,通常会在前台组件关联的事件脚本(例如页面加载事件、鼠标单击事件)中调用这些API,以实现某些功能。详细介绍,请参见表1
    图2 定义模型
    表1 模型来源说明

    分类

    模型说明

    模型参数的定义

    模型方法的定义

    API调用方法

    自定义

    开发者自行定义的模型。

    由开发者自定义,可以添加子节点。

    开发者自定义方法。

    $model.ref("modelName").actionName();

    对象

    由Object对象表映射生成,关于对象模型的详细介绍,请参见对象

    系统自动获取Object所有的字段,开发者可以从中选择部分字段作为参数。

    系统自动生成查询、保存、删除和统计四个方法。

    $model.ref("modelName").query(param);

    $model.ref("modelName").save();

    $model.ref("modelName").delete();

    $model.ref("modelName").count();

    服务

    服务模型由后台服务映射生成,当前支持与服务编排或脚本映射。关于服务模型的详细介绍,请参见服务编排脚本

    参数根据后台服务的入参、出参,映射生成为inputParam和outputParam节点。

    系统自动生成run方法 ,用于执行模型关联的服务编排或脚本。

    $model.ref("modelName").run();

    事件

    事件模型由后台事件的字段映射生成,并且支持websocket刷新模型数据。

    参数根据后台事件的字段映射生成。

    直接使用

    直接使用

  1. 在新建模型“设置”页面,执行如下操作。
    • 上一步来源选择“自定义”,需要添加子节点自定义参数及类型。
    • 上一步来源选择“对象”,需要配置模型关联的对象以及字段。
    • 上一步来源选择“服务”,需要配置模型关联的后台服务,可以是脚本、服务编排或者公共接口。
    • 上一步来源选择“事件”,需要配置模型关联的事件以及事件字段。
  2. 单击“下一步”,设置方法。

    方法一般无需添加,如需添加或修改,可参考对象和服务默认生成的方法。

  3. 设置完成后,单击“确定”。

基本属性

在内容区域输入Markdown语法,可直接在页面渲染出对应样式的内容。Markdown是一种轻量级标记语言,通过简洁的符号语法实现文本格式的排版。

例如,创建标题,请在单词或短语前添加井号(#),井号的数量表示标题的级别,井号后需要加空格。

图3 输入内容

公共

  • 控件名称:当前组件的名称。
  • 隐藏:是否隐藏该组件,此方式为静态配置该组件的隐藏。还可以将该组件属性值“隐藏”配置为布尔类型模型字段,在自定义JS代码中来控制模型字段取值,从而设置该组件是否隐藏,这种动态设置优先级是最高的。

样式

  • 布局:设置组件的宽度、高度等。
  • 字体:设置字体大小、字体样式、颜色等。
  • 背景:设置背景颜色、透明度。
  • 边框:设置边框颜色、宽度等,支持“px”、“em”和“%”三种单位。
  • 阴影:设置阴影颜色、模糊、扩散等,支持“px”、“em”和“%”三种单位。
  • 高级设置
    • 样式源码:组件具体样式代码,组件样式设置后,样式代码将自动显示在“样式源码”中,也可以自定义样式代码,对组件进行详细配置,自定义代码支持多行输入,并高亮显示样式参数。
    • 样式类:当前组件使用的CSS样式类名,可在CSS代码中进行引用。