扩展小组件

小组件扩展,是在七巧板官方默认组件外,扩展一些通用的组件。

config.propertiesid 的定义:

  • 0 - 9999 以下是官方默认的
  • 10000 - 29999 是平台原生扩展的组件
  • 30000 - 59999 是第三方扩展的组件

扩展场景

初步设想的方案,是将小组件 id 扩展放到运营平台工作台去维护,有一下几种情况:

  • 移动端、后台均为公有

    • 统一在运营平台修改更新即可
  • 移动端为私有,后台为公有

    • 可能会存在兼容问题,后台新增的扩展组件 id,移动端不能识别;
    • 第三方组件 id 定义区间需要在 30000 - 59999 之间,小于30000 会被平台的扩展组件覆盖;
    • 官方默认、平台 的组件 id 将在运营平台维护;
    • 第三方组件定义好后,到开放平台 > 开发者中心中维护第三方组件 id ;
    • 更新 Pai 工具时,会将 官方默认平台第三方 的组件数据更新到开发人员本地;
    • 然后使用 Pai 命令,将第三方 .XML 编译成 .out 文件;
    • 然后使用 Pai 命令,发布第三方 .out 文件到自定义套件中,上架套件后,即可在工作台看到发布的组件。
  • 移动端为公有,后台为私有

    • 可能会需要移动端适配多版本后台。OA 7.0 就这样的模式,过多的兼容,导致代码维护繁琐。

    • 当公有版移动端要扩展组件时,需要注意组件 id 需要定义在 10000 - 29999 之间,防止覆盖其它版本定义的组件。

  • 移动端、后台均为私有

    • 统一在运营平台修改更新即可

平台扩展的小组件

ChartView

扩展图表组件,主要是提供用户自定义图表,更加灵活的开发工作台。

名称 类型 默认值 描述
title string null 标题
chartHeight int 30 图标高度
chartType enum(line|bar|pie) line line:折线图表;bar:矩形图表;pie:饼状图
chartList array null 图表参数

chartList -> list

名称 类型 默认值 描述
name string null 参数描述
numValue int 0 参数值
color string 图表默认颜色 颜色值
<ChartView
    layoutHeight="120"
    layoutWidth="200"
    title="图表"
    chartHeight="120"
    chartType="line"
    chartList="${chartPieData}"/>
{
 "chartPieData":"[{\"name\": \"待跟进\",\"numValue\": \"16\",\"color\": \"#54EB7E\"},{\"name\": \"跟进中\",\"numValue\": \"50\",\"color\": \"#15A6FD\"},{\"name\": \"已签约\",\"numValue\": \"34\",\"color\": \"#FDCC17\"}]",
}

CarouselView

扩展轮播小组件,可实现更多组合效果

名称 类型 默认值 描述
autoScroll int 1500(毫秒) 自动滚动时间间隔
isInside boolean true 下标位置
carouseHeight int 50 轮播高度
imgList array null 轮播图片,字符串数组
<CarouselView
    layoutHeight="160"
    layoutWidth="match_parent"
    autoScroll="5000"
    isInside="true"
    carouseHeight="160"
    imgList="${carouselData}"/>
{
"carouselData":"[\"https://image.huanghepiao.com/d/file/20201003/30c1c8847ac11fff3329aac30a9f7b99.jpg\",\"https://img1.qunarzz.com/travel/d6/1701/c3/ad1a5ce13c3e2bb5.jpg\",\"https://p9-xg.byteimg.com/img/tos-cn-p-0000/5d16c2cae5c047bdaa8ca8a01389e8e8~tplv-crop-center:422:236.jpg\",\"https://256vimg1.xpghost.cn/uploads/2018/1225/20181225030438610.jpg\",\"https://images.ladymetro.com/file/youjia/mingxing/2019-07-26/5158bd8b960f991542cfa9922af89ead.jpg\"]"
}

PiImageView

扩展原生图片,支持 Gif 动图、本地图片、网络图片,所有 .out 中的图片显示,均使用此组件,七巧板推荐的图片组件,将不再支持。

imageData

名称 类型 默认值 描述
isLocal boolean false 是否为本地图片
isGif boolean false 是否为 Gif 动图
imgSrc string null 图片地址,支持本地、网络、附件 Id 加载。
imgRadius int 0 图片圆角大小
<PiImageView
    layoutGravity="v_center"
    layoutHeight="12"
    layoutWidth="12"
    layoutMarginRight="16"
    imgRadius="2"
    isLocal="true"
    imgSrc="${imgSwitch}"/>
{
"imgSwitch":"core_arrow_right_blue",
}

LottieView

扩展原生 Lottie 动图支持本地 Lottie、网络 Lottie 图片。

名称 类型 默认值 描述
isLocal boolean false 是否为本地 Lottie文件
lottieSrc string null Lottie 地址,支持本地、网络 Lottie、附件 Id 加载。
<LottieView
    layoutHeight="60"
    layoutWidth="60"
    layoutGravity="v_center"
    isLocal="false"
    lottieSrc="${lottieData1}"/>
{
 "lottieData": "https://gitee.com/WorkTool/WorkImage/raw/master/gif/34847-dgah-moped-animation.json"
}

平台扩展本地资源

image

名称 描述 示例 支持组件
core_icon_back_black 黑色返回箭头 < PiImageView
core_arrow_right_black 黑色朝右边箭头 > PiImageView
core_arrow_right_blue 蓝色朝右边箭头 > PiImageView
core_title_add_icon 黑色加号图标 PiImageView
core_title_mesage_icon 黑色铃铛图标 🔔 PiImageView
core_title_switch_icon 灰色查下实体三角形 PiImageView
core_switch_down_icon 黑色查下箭头 PiImageView
core_switch_up_icon 黑色朝上箭头 PiImageView
core_shaded_white_large 带阴影的白色背景-大 PiImageView
core_shaded_white_small 带阴影的白色背景-小 PiImageView
core_shaded_white_height 带阴影的白色背景-高 PiImageView

Lottie

名称 描述 示例 支持组件
gif/core_lottie_loading_gif 加载的 lottie 动图 LottieView
文档更新时间: 2021-05-13 10:17   作者:陈冕