harmonyos自定义组件如何导入

一.自定义组件使用

（1）自定义组件创建

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

1.创建新的模板

2. 修改首页，通过C:\Users\86156\DevEcoStudioProjects\HMstudy\entry\src\main\js\default\pages路径复制两个页面

3.在config.json中写上新建的页面

4.在default下创建components文件，在components文件夹下新建tabbar文件夹，在tabbar文件夹下新建tabbar.html tabbar.css tabbar.js

5.在common下创建datas文件夹，在datas下创建tabbarItem.js文件

 6.写好代码，将图标图片导入images

 7.写入代码

<div class="container">
    <toolbar class="tabbar">
        <toolbar-item for="{{tabbarItems}}" icon='{{$item.img}}' value='{{$item.name}}' onclick="jump($idx)" ></toolbar-item>
    </toolbar>
</div>


import tabbarItems from '../../common/datas/tabbarItem.js';
export default {
    data:{
        tabbarItems
    },
    jump(index){
        this.tabbarItems.forEach((item,index) => {
            item.img = tabbarItems[index].img;
        });
        this.tabbarItems[index].img = this.tabbarItems[index].simg;
    }
}


.tabbar {
    position: fixed;
    left: 0;
    bottom: 0;
}

小结：

1. 定义一个专门存放自定义组件的文件夹 components.tabbar 并设置3个基础文件 tabbar.hml、tabbar.js、tabbar.css，需要注意的是：3个文件的文件名必须保持一致，不然会存在找不到文件的情况。该自定义组件的目的是给页面底部配置一个 tabbar 选项卡体验。
2. 设置底部选项卡对应的 json 数据源，用来保存 icon 图片、标题，以及点击选中后的 icon 图片。

（2）自定义组件调用

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

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

<element name='comp' src='../../components/tabbar/tabbar.hml'></element>
<div class="container">
    <text class="title">
        首页
    </text>
    <comp></comp>
</div>

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 的值进行修改。

• 子组件的定义

<!-- 务必需要注意的是：子组件的 hml、js、css 三个文件名必须保持一致 -->
<div class="ctest">
    <text class="title">我是子组件</text>
    <text>{{ name }}</text>
</div>


export default {
    // props:[ "name" ],
    props:{
        name:{
            default: '默认内容'
        }
    }
}

• 父组件的调用

<element name="ctest" src="../../components/ctest/ctest.hml"></element>
<div class="container">
    <ctest name="父传子内容"></ctest>
</div>

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

1. 普通 slot 插槽分发内容

• 父组件调用

<ctest>
    <text>默认 slot 分发内容</text>
</ctest>

• 子组件接收

<slot></slot>

     2.具名插槽分发内容

• 父组件调用

<ctest>
    <text slot="hasname">具名 slot 分发的内容</text>
</ctest>

• 子组件接收

<slot name="hasname"></slot>

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

1. 子组件也可以通过绑定的事件向上传递参数，在自定义事件上添加传递参数。
2. 子组件向上传递参数text，父组件接收时通过 e.detail 来获取参数。
3. 需要注意的是 父组件中自定义的事件名因为 hml 限制，对大小写不敏感，需要使用 - 进行拼接，但是，在子组件中调用则需要使用「驼峰式」进行 $emit 调用。

• 父组件调用传递自定义事件

<element name="ctest" src="../../components/ctest/ctest.hml"></element>
<div class="container">
    <!--  父组件的 title 和 num 可以被子组件修改  -->
    <text>{{title}}</text>
    <text>{{num}}</text>
    <!--    务必注意事件名对大小写不敏感，需要使用 - 进行拼接-->
    <ctest name="父传子内容" @change-father-title="changeTitle"></ctest>
</div>


export default {
    data: {
        title: "我是父组件",
        num: 0
    },
    changeTitle(e){
        console.log("父组件的方法被子组件模拟触发了");
             // 这里需要注意的是：使用 e.detial 来接收传递的参数 
        this.title = "我被子组件改变了," + e.detail.text;
        this.num ++;
    }
}

• 子组件模拟触发父组件传递的自定义事件，实现数据传递

<div class="ctest">
    <text class="title">我是子组件</text>
    <button @click="changeFather()">
        点击改变父组件内容
    </button>
</div>


export default {
    // props:[ "name" ],
    props:{
        name:{
            default: '默认内容'
        }
    },
    changeFather(){
        console.log("子组件的Button被点击了")
        // 请务必注意，传递的参数必须是一个对象
        this.$emit("changeFatherTitle", {
            text:"传递的参数"
        })
    }
}

三.路由功能的实现

        （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生命周期中页面还处于渲染阶段，禁止调用页面路由方法。