PopSheet

弹出窗组件 / PopSheet

介绍

PopSheet组件是一个模板组件, 自身只提供弹出载体, 其余业务部分通过slot传入, 且组件本身不对slot内容不作处理, 样式也由业务自己确定, 组件中的内容将自动在页面居中.

组件开闭通过ref获取组件实例并通过下面两个方法操作:

  • present() 开启
  • dismiss() 关闭

如何引入

// 引入
import { PopSheet } from 'vimo'
// 安装
Vue.component(PopSheet.name, PopSheet)
// 或者
export default{
  components: {
    PopSheet
 }
}

关于slot

组件必须具有slot="fixed"属性, 表示固定在页面上. 如果没有的话, 页面滚动样式会产生错误.

如何开启

通过ref获取组件实例, 之后调用present方法开启, 调用dismiss方法关闭.

...
computed: {
   popSheetComponent () {
     return this.$refs.popSheet
   }
 }
methods: {
   openPopSheet () {
     return this.popSheetComponent.present()
   },
   closePopSheet () {
     return this.popSheetComponent.dismiss()
   }
 }
...
源码:

传入属性 / Props:

Name Type Attributes Default Description
enableBackdropDismiss Boolean <optional>
 true 点击背景关闭组件
mode String <optional>
 'ios' 模式
showBackdrop boolean <optional>
 true 是否显示黑色背景
scrollControl boolean <optional>
 false 控制是否禁止滚动

用法 / Usages

<PopSheet ref="popSheet" slot="fixed">
   <section class="popSheet">
       <h2>TITLE</h2>
       <h5>这是内容, 宽度高度自定义</h5>
       <p>
           Lorem ipsum dolor sit amet, consectetur adipisicing elit. Consectetur, eaque earum eum
           ex expedita facere fugit ipsa ipsum minima nemo nostrum, pariatur placeat qui quis quod
           quos repellendus tempora unde.</p>
       <List>
           <Item>
               <Label>名称</Label>
               <Input v-model="name" type="text" placeholder="请输入用户名" clear-input></Input>
           </Item>
           <Item>
               <Label>密码</Label>
               <Input v-model="password" type="password" placeholder="请输入密码" clear-input></Input>
           </Item>
       </List>
       <Button block @click="closePopSheet">确认</Button>
   </section>
</PopSheet>