自动化助手

    折叠布局

    • 更新时间:2026-03-17 19:34:31

    一、常用属性

    dir - 折叠方向

    设置折叠方向

    <expand dir="v" />

    dur - 折叠动画时长

    设置折叠动画时长

    <expand dur="500" />

    exp - 默认展开状态

    设置默认展开状态

    <expand exp="true" />

    minW - 最小宽度

    设置最小宽度

    <expand minW="100" />

    minH - 最小高度

    设置最小高度

    <expand minH="100" />

    bg - 背景颜色

    设置背景颜色

    <expand bg="red" />

    bgImg - 背景图片

    设置背景图片

    <expand bgImg="res/bg.png" />

    二、常用函数

    setDur(dur)

    设置动画时长

    • 参数 : dur {Number} 动画时长
    //解析布局
let ui = $ui.layout("main.xml");
//找到折叠布局
let exp = ui.id("mExp");
//设置动画时长
exp.setDur(500);

    setDir(dir)

    设置折叠方向

    默认是竖向折叠

    • 参数 : dir {String} 折叠方向(可选:h、v)
    //解析布局
let ui = $ui.layout("main.xml");
//找到折叠布局
let exp = ui.id("mExp");
//设置折叠方向
exp.setDir("h");

    setBg(color)

    设置背景颜色

    • 参数 : color {String} 背景颜色
    //解析布局
let ui = $ui.layout("main.xml");
//找到折叠布局
let exp = ui.id("mExp");
//设置背景颜色
exp.setBg("#549159");

    open()

    打开折叠面板

    //解析布局
let ui = $ui.layout("main.xml");
//找到折叠布局
let exp = ui.id("mExp");
//打开折叠面板
exp.open();

    close()

    关闭折叠面板

    //解析布局
let ui = $ui.layout("main.xml");
//找到折叠布局
let exp = ui.id("mExp");
//关闭折叠面板
exp.close();

    change()

    切换折叠面板状态

    如果面板处于关闭状态，那么调用此函数就会打开，反之：如果面板处于打开状态，那么调用此函数就会关闭面板。

    //解析布局
let ui = $ui.layout("main.xml");
//找到折叠布局
let exp = ui.id("mExp");
//切换折叠面板状态
exp.change();

    子控件属性表

    被折叠布局包裹的子控件可以使用如下属性：

    中文名英文名描述
    布局方向dir设置子视图的排列方向，可选值为“rtl”（右到左）或“ltr”（左到右）
    解决方向resolveDir确定视图应遵循的实际布局方向，可选值为“rtl”（右到左）或“ltr”（左到右）
    宽w设置视图的宽度，可选值为“auto”（自动，即WRAP_CONTENT）、“max”（最大，即MATCH_PARENT）或具体整数（单位为dp）
    高h设置视图的高度，可选值为“auto”（自动，即WRAP_CONTENT）、“max”（最大，即MATCH_PARENT）或具体整数（单位为dp）
    布局重力layout_gravity设置视图的布局重力，通过GravityAdd获取对应的重力值
    外边距margin设置视图的外边距，可传入单个整数（四边外边距相同）或四个整数（分别对应左、上、右、下外边距），单位为dp
    左外边距margin_left单独设置视图的左外边距，单位为dp
    上外边距margin_top单独设置视图的上外边距，单位为dp
    右外边距margin_right单独设置视图的右外边距，单位为dp
    下外边距margin_bottom单独设置视图的下外边距，单位为dp