BubbleDialog气泡弹窗组件V1.2.6 最新版

编辑点评：BubbleDialog是一款让弹窗设计更省心的气泡组件，最新版V1.2.6在自定义灵活度上又做了提升。不管是尖角位置、圆角弧度，还是背景边框，都能通过属性快速配置，不用写一堆复杂代码。它本质是ViewGroup容器，常规控件往里一放就能变成气泡样式，适配各种UI规范很顺手

BubbleDialog是气泡布局与智能弹窗组件，支持全方位自定义，适配各类UI规范。有高度灵活的方向控制、智能坐标锚定技术等亮点，全维度视觉可定制，使用时通过简单属性配置即可，还介绍了尖角、边框等控制及对齐方式。

BubbleDialog特色

1、全维度视觉定制，支持自由调整气泡背景颜色、边框粗细等，让气泡样式更精美。

2、位置偏移灵活，尖角可在气泡任意边设置并精确控制偏移量。

3、形态修饰独特，能自定义尖角宽高及圆角弧度，使气泡更圆润自然。

4、作为标准ViewGroup容器，可包裹多种View控件转化为气泡样式，兼容性强。

BubbleDialog使用说明

尖角控制：hl_arrowWidth(宽)、hl_arrowHeight(高)、hl_arrowRadius(尖角圆润度)。

边框控制：hl_strokeColor(颜色)、hl_strokeWidth(粗细)。

对齐方式：setPosition支持LEFT、RIGHT、TOP、BOTTOM四个维度，弹窗会自动计算剩余空间防止溢出。

BubbleDialog怎么样

1. 支持全方位自定义，能对气泡样式尖角位置、圆角弧度、背景色等进行全方位自定义，适配各类UI设计规范。

2. 方向控制灵活，支持上下左右全方位弹出选择，感应屏幕边缘防止内容溢出或被遮挡。

3. 告别繁琐代码绘图，通过简单属性配置快速生成精美气泡效果，代码结构精简，兼容性强。

BubbleDialog亮点

1. 全方位自定义：支持对气泡样式尖角位置、圆角弧度、背景色、边框间距及动画效果进行全方位自定义，可灵活适配各类UI设计规范，让设计还原度更高，样式统一性更强。

2. 高度灵活的方向控制：支持上下左右全方位的弹出选择，并能感应屏幕边缘，有效防止弹窗内容溢出或被遮挡。

3. 智能坐标锚定技术：内置精准的定位逻辑，弹窗可根据被点击控件View的屏幕位置自动对齐，实现指哪弹哪的直观交互。

4. 轻量化与低侵入性：代码结构精简，作为布局容器使用时兼容性极强，能够无缝集成到现有的Android项目中。

BubbleDialog气泡弹窗组件特别说明

【安装技巧】 请将bubble-dialog文件夹完整复制至components目录，首次使用需在app.json中声明"usingComponents": {"bubble-dialog": "/components/bubble-dialog/index"}。V1.2.6版本已适配深色模式，建议同步更新基础库至2.19.0以上。

【使用注意事项】 ① 弹窗箭头方向默认自动计算，若定位元素靠近屏幕边缘，建议手动指定arrow-direction属性避免遮挡；② 气泡内容区最大高度限制为屏幕70%，超长内容请开启scrollable属性；③ 同时存在多个弹窗时，z-index层级遵循后创建优先原则，可通过priority参数手动调整。

【常见问题】 Q：弹窗闪烁或位置偏移？A：检查父元素是否设置transform/animation导致定位上下文变化，建议为锚点元素添加position: relative。Q：自定义主题色不生效？A：V1.2.6改用CSS变量控制，需覆盖--bubble-primary而非旧版background-color。Q：真机调试箭头错位？A：开启safe-area-inset-bottom适配全面屏，并在onReady中延迟100ms调用show()确保节点渲染完成。