- <ion-side-menus>
- <ion-side-menu-content>...</ion-side-menu-content>
- <ion-side-menu side="left">...</ion-side-menu>
- <ion-side-menu side="right">...</ion-side-menu>
- </ion-side-menus>
上面分别是中间部分、左侧边栏、右侧边栏。
———————————————————————————content——————————————————————————
如:<a menu-toggle="left" class="button ">切换</a> ——一个按钮可以打开左侧边栏
- <!--切换左侧栏显示状态-->
- <any menu-toggle="left"></any>
- <!--切换右侧栏显示状态-->
- <any menu-toggle="right"></any>
- <!--关闭侧边栏状态-->
- <any menu-close=""></any>
- drag-content - 是否允许拖动内容打开侧栏菜单,默认为true。
允许值:true | false。 当设置为false时,将禁止通过拖动内容打开侧栏菜单。
- edge-drag-threshold - 是否启用边距检测。默认为false,可以在内容区域的任何地方拖动来打开侧栏。
允许值:number | true | false。 当设置为true时,使用默认的25px作为边距阈值
—————————————————————————————menu————————————————————————
ion-side-menu指令有以下属性:
- side - 位于内容区的左边或右边 <ion-side-menu side="left">...</ion-side-menu>
side属性是必须的。允许值:left | right。默认值为left。
- width - 侧边栏的宽度 切换的侧边栏显示出来的宽度
width属性是可选的,表示以像素为单位的侧栏菜单宽度。默认为275px。
- is-enabled - 是否可用
is-enabled属性是可选的,声明该侧边栏是否可用,允许值为:true | false ,默认为true。当侧边栏不可用时,拖拽内容或使用切换按钮都无法打开侧栏菜单。
- expose-aside-when - 侧边栏自动显示条件表达式 当手机或平板屏幕大于expose-aside-when 所给的值,则自动显示侧边栏。
默认情况下,侧边栏是隐藏的,需要用户向左或向右拖动内容,或者通过一个切换按钮来打开。但是在有些场景下(比如,横放的平板)屏幕宽度足够大,这时,自动地显示侧
边栏内容会更合理。expose-aside-when属性就是处理这种情况的,和CSS3的@meida类似,expose-aside-when需要一个CSS表达式,例如:expose-aside-when="(min-width:500
px)",这意味着当屏幕宽度大于500px时将自动显示侧栏菜单。
ionic为expose-aside-when提供了一个快捷选项:large , 这等同于 (min-width:768px)。
———————————————————————脚本接口 : $ionicSideMenuDelegate——————————————
如果需要在脚本中控制侧边栏菜单,可以使用服务$ionicSideMenuDelegate:
- toggleLeft([isOpen]) - 是否打开左侧栏菜单
参数isOpen是可选的,默认为true ,表示打开左侧栏菜单。
- toggleRight([isOpen]) - 是否打开右侧栏菜单
参数isOpen是可选的,默认为true ,表示打开右侧栏菜单。
- getOpenRatio() - 侧栏菜单打开的宽度占其总宽度比例
例如,一个100px宽的侧栏菜单,如果打开50px,那么其比例为50%,getOpenRatio()将返回0.5 。
- isOpen() - 当前侧栏菜单是否打开
不管是左侧栏菜单,还是右侧栏菜单,只要处于打开状态,isOpen()都返回 true。
- isOpenLeft() - 左侧栏菜单是否打开
当左侧栏菜单处于打开状态时,isOpenLeft()返回true。
- isOpenRight() - 右侧栏菜单是否打开
当右侧栏菜单处于打开状态时,isOpenRight()返回true。
- canDragContent([canDrag]) - 是否允许拖拽内容以打开侧栏菜单
canDrag参数是可选的,如果canDrag为true,表示允许通过拖拽内容打开侧栏菜单。
- edgeDragThreshold(value) - 设置边框距离阈值
当参数value为false或0时,意味着在内容区域任何位置进行拖拽都可以打开侧栏菜单。如果参数value为一个数值,意味着只有当拖拽发生的位置距边框不大于此数值时,才能打开侧栏菜单。参数value为true等同于将value设置为25。