> 文档中心 > HarmonyOS第二次培训

HarmonyOS第二次培训

1.自定义组件的创建

    

JS UI框架支持自定义组件,用户可根据业务需求将已有的组件进行扩展,增加自定义的私有属性和事件,封装成新的组件,方便在工程中多次调用,提高页面布局代码的可读性。

  1. 定义一个专门存放自定义组件的文件夹 components.tabbar 并设置3个基础文件 tabbar.hml、tabbar.js、tabbar.css,需要注意的是:3个文件的文件名必须保持一致,不然会存在找不到文件的情况。该自定义组件的目的是给页面底部配置一个 tabbar 选项卡体验。
  2. 设置底部选项卡对应的 json 数据源,用来保存 icon 图片、标题,以及点击选中后的 icon 图片。
  3. 使用 toolbar + toolbar-item 内置组件构建底部 tabbar 选项卡服务「tabbar.hml」
  4. 导入 tabbarItem 数据,并设置对应 data ,同时设置点击事件 动态设置点击对应 icon 选中。
  5. 设置 CSS 样式 将 tabbar 选项卡置底「tabbar.css」

2.自定义组件的调用

自定义组件是用户根据业务需求,将已有的组件组合,封装成的新组件,可以在工程中多次调用,提高代码的可读性。

自定义组件通过element引入到宿主页面,使用方法:

首页
  1. name 属性指自定义组件名称(非必填),组件名称对大小写不敏感,默认使用小写,src 属性指自定义组件hml 文件路径(必填),若没有设置 name 属性,则默认使用 hml 文件名作为组件名。

  2. 事件绑定:自定义组件中绑定子组件事件使用 (on|@)child1 语法,子组件中通过 this.$emit('child1', { params: '传递参数' }) 触发事件并进行传值,父组件执行 bindParentVmMethod 方法并接收子组件传递的参数。

父子组件功能的实现

1.父组件通过props向子组件传值

  1. Props 自定义组件可以通过 props 声明属性,父组件通过设置属性向子组件传递参数,camelCase(驼峰命名法)的 prop 名,在外部父组件传递参数时需要使用 kebab-case (短横线分隔命名)形式,即当属性compProp 在父组件引用时需要转换为 comp-prop。

  2. 添加默认值,子组件可以通过固定值 default 设置默认值,当父组件没有设置该属性时,将使用其默认值。此情况下 props 属性必须为对象形式,不能用数组形式。

  3. 数据单向性,父子组件之间数据的传递是单向的,只能从父组件传递给子组件,子组件不能直接修改父组件传递下来的值,可以将 props 传入的值用 data 接收后作为默认值,再对 data 的值进行修改。

  • 子组件的定义
我是子组件 {{ name }}
export default {    // props:[ "name" ],    props:{ name:{     default: '默认内容' }    }}
  • 父组件的调用

2.父组件通过slot向子组件分发内容

  1. 普通 slot 插槽分发内容
  • 父组件调用
    默认 slot 分发内容
  • 子组件接收
  1. 具名插槽分发内容
  • 父组件调用
    具名 slot 分发的内容
  • 子组件接收

3.子组件通过自定义事件改变父组件状态

  1. 子组件也可以通过绑定的事件向上传递参数,在自定义事件上添加传递参数。
  2. 子组件向上传递参数text,父组件接收时通过 e.detail 来获取参数。
  3. 需要注意的是 父组件中自定义的事件名因为 hml 限制,对大小写不敏感,需要使用 - 进行拼接,但是,在子组件中调用则需要使用「驼峰式」进行 $emit 调用。
  • 父组件调用传递自定义事件
{{title}} {{num}}
export default {    data: { title: "我是父组件", num: 0    },    changeTitle(e){ console.log("父组件的方法被子组件模拟触发了");      // 这里需要注意的是:使用 e.detial 来接收传递的参数  this.title = "我被子组件改变了," + e.detail.text; this.num ++;    }}
  • 子组件模拟触发父组件传递的自定义事件,实现数据传递
我是子组件
export default {    // props:[ "name" ],    props:{ name:{     default: '默认内容' }    },    changeFather(){ console.log("子组件的Button被点击了") // 请务必注意,传递的参数必须是一个对象 this.$emit("changeFatherTitle", {     text:"传递的参数" })    }}

3. 路由功能的实现

1.页面的定义

  1. 在 Pages 文件夹下面新建一个文件夹代表需要的路由,当然,我们也可以新建一个 Ablity 体验,这里演示 Pages.Name。

  2. 在 新建的文件夹下面务必需要注意新建三个文件 index.hml、index.js、index.css 三个文件,该文件名必须使用 index 来进行命名,使用其他命名会造成文件依赖无法找到。

    快捷方式,可以选择到对应的 Ability Pages 文件夹下面,然后 new page 直接添加页面,并会自动注册好路由,这是比较方便的

  3. 在 config.json 文件中

"js": [      { "pages": [   "pages/index/index" ], "name": "default", "window": {   "designWidth": 720,   "autoDesignWidth": true }      }]

 2.路由的使用

  1. 导入路由模块
import router from '@system.router';
  1. router.push(OBJECT),跳转到应用内的指定页面。
  2. router.replace(OBJECT),用应用内的某个页面替换当前页面,并销毁被替换的页面。
  3. router.back(OBJECT),返回上一页面或指定的页面。
// index页面,uri字段是页面路由,由配置文件中的pages列表指定。router.push({  uri: 'pages/detail/detail',});// detail页面router.push({  uri: 'pages/mall/mall',});// mall页面通过back,将返回detail页面router.back();// detail页面通过back,将返回index页面router.back();// 通过back,返回到detail页面router.back({uri:'pages/detail/detail'});
  1. router.clear(),清空页面栈中的所有历史页面,仅保留当前页面作为栈顶页面。
  2. router.getLength(),获取当前在页面栈内的页面数量。
  3. router.getState(),获取当前页面的状态信息。

PS:页面路由需要在页面渲染完成之后才能调用,在onInit和onReady生命周期中页面还处于渲染阶段,禁止调用页面路由方法。