group - Maixbxp/salt-ui GitHub Wiki

group

Group是列表容器组件。封装了以下功能:

  • 灵活配置间隔线和子元素的缩进值,而且间隔线和子元素的缩进值是相互独立的,使IOSMaterial风格的多样式列表更加容易实现。
  • 在支持hairline显示的设备上自动优化显示成极细的线。

效果预览:

Props

Group.List

className

描述:自定义样式的class名称。

类型:String

默认:''

必选:否

示例:

<Group>
    <Group.List className="customClass">...</Group.List>
</Group>

lineIndent

描述:配置间隔线的缩进值。

类型:Number|String|Array

  • Number:设置左缩进,默认追加px作为单位,如:lineIndent={10}
  • String:设置左缩进,自定义长度单位,如:lineIndent={'1rem'}
  • Array:设置左右缩进,数组成员的类型为NumberString,默认处理如上。如:lineIndent={[10, 10]}

默认:无

必选:否

示例:

<Group>
    <Group.List lineIndent={10}>...</Group.List>
</Group>

itemIndent

描述:配置列表子元素的缩进值。

类型:Number|String|Array

  • Number:设置左缩进,默认追加px作为单位,如:itemIndent={10}
  • String:设置左缩进,自定义长度单位,如:itemIndent={'1rem'}
  • Array:设置左右缩进,数组成员的类型为NumberString,默认处理如上。如:itemIndent={[10, 10]}

默认:无

必选:否

示例:

<Group>
    <Group.List itemIndent={[10, 10]}>...</Group.List>
</Group>

borderTopNone

描述:不显示顶部边线,通常在和其他组件一起使用时使用 类型:Boolean 默认:false 必选:否

Demos

首先引入Group,其中Group下面包含HeadList两个子组件。

项目环境下,SaltUI是全局变量:

// ES5
var Group = SaltUI.Group;
// ES2015
let {Group} = SaltUI;
...
render() {
    return (<Group>
        <Group.Head>title</Group.Head>
        <Group.List>
            <div>content</div>
            <div>content</div>
        </Group.List>
    </Group>);
}
⚠️ **GitHub.com Fallback** ⚠️