HarmonyOS第二次培训
JS UI框架支持自定义组件,用户可根据业务需求将已有的组件进行扩展,增加自定义的私有属性和事件,封装成新的组件,方便在工程中多次调用,提高页面布局代码的可读性。
- 定义一个专门存放自定义组件的文件夹 components.tabbar 并设置3个基础文件 tabbar.hml、tabbar.js、tabbar.css,需要注意的是:3个文件的文件名必须保持一致,不然会存在找不到文件的情况。该自定义组件的目的是给页面底部配置一个 tabbar 选项卡体验。
- 设置底部选项卡对应的 json 数据源,用来保存 icon 图片、标题,以及点击选中后的 icon 图片。
- 使用 toolbar + toolbar-item 内置组件构建底部 tabbar 选项卡服务「tabbar.hml」
- 导入 tabbarItem 数据,并设置对应 data ,同时设置点击事件 动态设置点击对应 icon 选中。
- 设置 CSS 样式 将 tabbar 选项卡置底「tabbar.css」
2.自定义组件的调用
自定义组件是用户根据业务需求,将已有的组件组合,封装成的新组件,可以在工程中多次调用,提高代码的可读性。
自定义组件通过element引入到宿主页面,使用方法:
首页
-
name 属性指自定义组件名称(非必填),组件名称对大小写不敏感,默认使用小写,src 属性指自定义组件hml 文件路径(必填),若没有设置 name 属性,则默认使用 hml 文件名作为组件名。
-
事件绑定:自定义组件中绑定子组件事件使用 (on|@)child1 语法,子组件中通过 this.$emit('child1', { params: '传递参数' }) 触发事件并进行传值,父组件执行 bindParentVmMethod 方法并接收子组件传递的参数。
父子组件功能的实现
1.父组件通过props向子组件传值
-
Props 自定义组件可以通过 props 声明属性,父组件通过设置属性向子组件传递参数,camelCase(驼峰命名法)的 prop 名,在外部父组件传递参数时需要使用 kebab-case (短横线分隔命名)形式,即当属性compProp 在父组件引用时需要转换为 comp-prop。
-
添加默认值,子组件可以通过固定值 default 设置默认值,当父组件没有设置该属性时,将使用其默认值。此情况下 props 属性必须为对象形式,不能用数组形式。
-
数据单向性,父子组件之间数据的传递是单向的,只能从父组件传递给子组件,子组件不能直接修改父组件传递下来的值,可以将 props 传入的值用 data 接收后作为默认值,再对 data 的值进行修改。
- 子组件的定义
我是子组件 {{ name }}
export default { // props:[ "name" ], props:{ name:{ default: '默认内容' } }}
- 父组件的调用
2.父组件通过slot向子组件分发内容
- 普通 slot 插槽分发内容
- 父组件调用
默认 slot 分发内容
- 子组件接收
- 具名插槽分发内容
- 父组件调用
具名 slot 分发的内容
- 子组件接收
3.子组件通过自定义事件改变父组件状态
- 子组件也可以通过绑定的事件向上传递参数,在自定义事件上添加传递参数。
- 子组件向上传递参数text,父组件接收时通过 e.detail 来获取参数。
- 需要注意的是 父组件中自定义的事件名因为 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.页面的定义
-
在 Pages 文件夹下面新建一个文件夹代表需要的路由,当然,我们也可以新建一个 Ablity 体验,这里演示 Pages.Name。
-
在 新建的文件夹下面务必需要注意新建三个文件
index.hml、index.js、index.css
三个文件,该文件名必须使用 index 来进行命名,使用其他命名会造成文件依赖无法找到。快捷方式,可以选择到对应的 Ability Pages 文件夹下面,然后 new page 直接添加页面,并会自动注册好路由,这是比较方便的
-
在 config.json 文件中
"js": [ { "pages": [ "pages/index/index" ], "name": "default", "window": { "designWidth": 720, "autoDesignWidth": true } }]
2.路由的使用
- 导入路由模块
import router from '@system.router';
- router.push(OBJECT),跳转到应用内的指定页面。
- router.replace(OBJECT),用应用内的某个页面替换当前页面,并销毁被替换的页面。
- 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'});
- router.clear(),清空页面栈中的所有历史页面,仅保留当前页面作为栈顶页面。
- router.getLength(),获取当前在页面栈内的页面数量。
- router.getState(),获取当前页面的状态信息。
PS:页面路由需要在页面渲染完成之后才能调用,在onInit和onReady生命周期中页面还处于渲染阶段,禁止调用页面路由方法。