欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Angular实现双向折叠列表组件的示例代码

程序员文章站 2022-03-02 08:11:17
最近在做一个双向折叠组件,如下图所示,页面是分为两组,左边页面是summary panel,主要是一组列表,右边页面是detail panel,展示左边列表中某一项的具体信...

最近在做一个双向折叠组件,如下图所示,页面是分为两组,左边页面是summary panel,主要是一组列表,右边页面是detail panel,展示左边列表中某一项的具体信息,我们把它记作“middle state”。

Angular实现双向折叠列表组件的示例代码

我们还看到有“<”和“>”两组按钮,这就是我们要做的“双向折叠组件”。点击左边的“<”,summary panel折叠起来,detail panel铺满整个页面,我们把它记作“left state”,如下图:

Angular实现双向折叠列表组件的示例代码

在summary panel折叠状态下,点击“>”,又回到“middle state”。点击“>”,detail panel折叠起来,summary panel铺满整个页面,我们把它记作“right state”,如下图:

Angular实现双向折叠列表组件的示例代码

我们通过以上的需求分析可知,

1.页面的总体布局是一个summary的div,两个箭头buttons,一个detail的div。

2.页面总共有三种state:“middle”、“left”、“right”,有两个button:“<”和“>”,也就是两个button去控制三个state。

因此我们需要定义一个枚举来记录页面的三种状态(注意,定义枚举要用export导出,否则后面会出错)

export enum collapseexpandstate {
  middle = 1,
  left,
  right
}

页面的结构如下,并且通过一个变量_collapseexpandstate去控制“left”和“right”两个button,具体为“<”会在页面状态为“middle”和“right”的情况下出现,“>”会在页面状态为“middle”和“left”状态下出现,从需求图中即可得知:

<div id="container">
  <div id="summary"></div>
  <div id="buttons">
    <div id="left" *ngif="_collapseexpandstate === collapseexpandstate.middle || collapseexpandstate.right" (click)="_onhandleleft($event)">《</div>
    <div id="right"> *ngif="_collapseexpandstate === collapseexpandstate.middle || collapseexpandstate.left" (click)="_onhandleleft($event)">》</div>
  </div>
  <div id="detail"></div>
</div>

这里在angular的template中用到了枚举,遭遇了一些麻烦,如果我们按上述定义了枚举,并且在angular component的template中用了枚举,我们会得到以下的错误提示:

typeerror: cannot read property 'middle' of undefined

也就是说,在angular2的template中无法识别定义的枚举类型collapseexpandstate,这是因为你写的angular component的template模板的执行环境是你定义的component class,但是在class中并没有关于collapseexpandstate枚举的任何引用,所以angular在为你的component生成模板的时候认为collapseexpandstate是undefined的。知道了原因,解决方案就很容易了,只需要在component class中加入这个枚举的引用即可:

@component(...)
export class containerwidget {
  public collpaseexpandstate: any = collapseexpandstate;
}

我们通过枚举状态来控制了两个buttons是否在恰当的页面状态显示与否,但是即使是同一个buttons,在不同的页面状态下所用到的样式也会不同,这里的样式其实最主要的就是位置了。我们先来考虑如何去控制button的样式,再来考虑如何去正确定位不同页面状态下button的位置。

对于控制button的样式,我们需要控制三个样式:"left button"、"right button"还有“buttons”。能够想到有三种方案:

i、用ng-class

ng-class一般的用法如下:

<some-element [ngclass]="{'first': true, 'second': true, 'third': false}">...</some-element>

因此它需要用boolean去控制,每一种样式需要一个boolean去控制,left和right各有两种样式,buttons有三种样式,这样就需要用5个boolean去控制,略显麻烦。

ii、 用elementref.nativeelement.classname

分别在buttons、left和right上用模板变量,然后在class中定义:

@viewchild("buttons") buttons: elementref;
@viewchild("left") left: elementref;
@viewchild("right") right: elementref;

在处理函数中这样去给class赋值从而改变样式:

this.left.nativeelement.classname = "xxxxx";

这样的话,我们需要从元素的角度出发,只需要3个元素变量,从而改变元素上的classname即可。但是这样做有个隐患,注意到我们是用的ngif来控制left和right在不同状态下是否存在,因为每一次事件处理都需要对三个元素的样式进行赋值,但是如果某个页面状态下ngif为false从而元素不存在,那么就会报“null pointer”的错误,所以如果所引用的元素受到了ngif的控制,不确定是否一定存在的情况下,要慎用该方法为元素赋予样式。

iii、 用class="{{}}"

为了ii中的尴尬,我们采用在html元素上对class进行直接赋值的方式,但是需要借用插值表达式{{}}。我们在css中用class的形式定义好样式,并且在compoennt class中定义三个字符串变量记录classname,然后在事件处理函数中把相应的classname赋予变量即可。这样我们就不用担心元素是否存在而导致的空指针了。

考虑完如何控制样式,下面我们进入css样式的讨论,这里其实主要考虑的就是位置。

我们采用flex布局,从左到右依次排列summary panel, buttons和detail panel。我们希望buttons向左移,但是空出的位置被detail panel来填充。首先来看一下不设样式的效果图:

Angular实现双向折叠列表组件的示例代码

显然buttons是占据了文档流的位置的,如果这时候我们用relative定位buttpms,并且设置left的值为-74px(注意到left为负数就会把元素往左推):

.buttons{
  display: flex;
  position: relative;
  margin-top: 23px;
  left: -74px;
}

效果图为:

Angular实现双向折叠列表组件的示例代码

发现如果用left的话,buttons原来的文档流位置依然存在,只是buttons相对于原来的位置移动了一定的位移。

如果我们用margin-left来设置呢:

.buttons{
  display: flex;
  position: relative;
  margin-top: 23px;
  margin-left: -74px;
}

效果图为:

Angular实现双向折叠列表组件的示例代码

它和left不同之处在于,left会留住原来的文档流位置,但是用margin-left原来的文档流位置会消失,而由后面的元素补充过来,而我们想要的效果,正好是用margin-left来实现的。

所以用css定位的时候,要明白left和margin-left的区别,从而选择正确的方式来定位。

总结一下,从这个案例中我们学习到了:

  1. 双向折叠可以用“3种页面状态去控制2个按钮”来实现
  2. enum在angular component的template中用到时,需要在compnent class中添加它的引用
  3. 控制元素样式有很多方法,要选择合适的方法
  4. css定位中left和margin-left虽然都能把元素推向左边,但是left保留原来文档流位置,margin-left不保留原来文档流位置。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。