HBuilder中常用组件及用法

1.view基本视图容器

它类似于传统html中的div,用于包裹各种元素内容。

如果使用nvue,则需注意,包裹文字应该使用<text>组件。

属性名类型默认值说明
hover-classStringnone指定按下去的样式类。
hover-stop-propagationBooleanfalse点击子组件是否阻止父组件出现点击样式
hover-start-timeNumber50按住后多久出现点击样式
hover-stay-timeNumber400手指松开后点击样式保留的时间

用法

2.scroll-view可滚动视图容器

可滚动视图区域。用于区域滚动。

需注意在webview渲染的页面中,区域滚动的性能不及页面滚动。

属性名类型默认值说明
scroll-xBooleanfalse允许横向滚动
scroll-yBooleanfalse允许纵向滚动

3.image图片组件

image支持的格式有bmp,gif,ico,jpg,png,webp,heic。可以通过插件来扩展app平台nvue/uvue的图片支持。小程序上只支持网络地址的svg图;

<image>组件未设置宽高时,默认宽度320px、高度240px。app-nvue平台,暂时默认为屏幕宽度、高度 240px,src 仅支持相对路径、绝对路径。

自定义组件里面使用 <image>时,若src使用相对路径可能出现路径查找失败的情况,故建议使用绝对路径。

属性名类型默认值说明平台差异说明
srcString图片资源地址
modeString'scaleToFill'图片裁剪、缩放的模式
模式说明
缩放scaleToFill不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素
缩放aspectFit保持纵横比缩放图片,使图片的长边能完全显示出来。也就是说,可以完整地将图片显示出来。
缩放aspectFill保持纵横比缩放图片,只保证图片的短边能完全显示出来。
缩放widthFix宽度不变,高度自动变化,保持原图宽高比不变
缩放heightFix高度不变,宽度自动变化,保持原图宽高比不变

4.swiper滑块视图容器

注意滑动切换和滚动的区别,滑动切换是一屏一屏的切换。swiper下的每个swiper-item是一个滑动切换区域,不能停留在2个滑动区域之间。

属性名类型默认值说明
indicator-dotsBooleanfalse是否显示面板指示点
indicator-colorColorrgba(0, 0, 0, 3)指示点颜色
indicator-active-colorColor#000000当前选中的指示点颜色
autoplayBooleanfalse是否自动切换
intervalNumber5000自动切换时间间隔
durationNumber500滑动动画时长
circularBooleanfalse播放到末尾后重新回到开头
verticalBooleanfalse滑动方向是否为纵向

5.text文本组件用于包裹文本内容 

在app-uvue和app-nvue中,文本只能写在text中,而不能写在view的text区域。

属性名类型默认值说明
selectableBooleanfalse文本是否可选
user-selectBooleanfalse文本是否可选(微信小程序)
spaceString显示连续空格(钉钉不支持)
space值说明
ensp中文字符空格一半大小
emsp中文字符空格大小
nbsp根据字体设置的空格大小

6.navigator页面跳转

属性名类型默认值说明
urlString应用内的跳转链接,值为相对路径或绝对路径
open-typeStringnavigate跳转方式
open-type值说明
navigate保留当前页面,跳转到应用内的某个页面
redirect关闭当前页面,跳转到应用内的某个页面

7.button按钮组件

属性名类型默认值说明
sizeStringdefault按钮的大小
typeStringdefault按钮的样式类型
plainBooleanfalse按钮是否镂空,背景色透明
disabledBooleanfalse是否禁用

8.input输入框

属性名类型默认值说明
valueString输入框的初始内容
typeStringtextinput 的类型有效值(手机上键盘的值)
passwordBooleanfalse是否是密码类型(不能输入中文)
maxlengthNumber140最大输入长度,设置为 -1 的时候不限制最大长度

### HBuilder 中滑块组件的使用方法 HBuilder 是一款强大的跨平台开发工具,支持多种框架和技术栈。对于滑块组件(`slider`),其主要用途在于提供一种直观的方式让用户调整数值范围内的参数,比如音量、亮度等[^2]。 以下是 `slider` 组件的基本属性和常用配置: #### 属性列表 | 属性名 | 类型 | 默认值 | 描述 | |--------|------|---------|-------| | min | Number | 0 | 滑动条最小值 | | max | Number | 100 | 滑动条最大值 | | value | Number | 0 | 当前值 | | step | Number | 1 | 步长 | 这些属性可以通过 HTML 和 JavaScript 动态设置或修改。 --- #### 示例代码 以下是一个完整的 `slider` 组件示例代码,基于 uni-app 框架实现[^3]: ```html <template> <view class="content"> <!-- Slider 组件 --> <slider :min="minValue" :max="maxValue" :value="currentValue" :step="stepSize" @changing="onChanging" @change="onChange" /> <text>当前值: {{ currentValue }}</text> </view> </template> <script> export default { data() { return { minValue: 0, // 最小值 maxValue: 100, // 最大值 currentValue: 50, // 初始值 stepSize: 1 // 步长 }; }, methods: { onChanging(e) { // 实时变化回调函数 console.log('正在改变:', e.detail.value); }, onChange(e) { // 变化结束后的回调函数 this.currentValue = e.detail.value; console.log('最终值:', e.detail.value); } } }; </script> <style scoped> .content { padding: 20px; } </style> ``` 上述代码展示了如何通过 `@changing` 和 `@change` 事件监听器捕获用户的操作行为,并实时更新界面显示的内容。 --- ### 关于 HBuilder 的推荐实践 为了更好地体验 `slider` 组件的功能,建议按照以下步骤操作: 1. 安装并启动 **HBuilderX** 开发工具。 2. 新建一个 **uni-app** 项目,选择官方提供的模板(如 hello uni-app)。 3. 在页面中引入 `slider` 组件,并尝试自定义其样式与交互逻辑。 此外,如果需要更复杂的滑块效果(例如带删除功能的滑动手势),可以参考开源社区中的相关案例[^5]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值