讲师中心 微信公众号
AI工具推荐 视频效率加速

Android shape stroke dashGap XML虚线间隔

秋浩君_4016

秋浩君_4016

发布时间:2026-02-18 05:39:36

|

503人浏览过

|

来源于php中文网

原创

dashGap是虚线间隙而非长度,必须与dashWidth成对设置且单位统一为dp;单独设置dashGap无效,缺一不可;Android 4.4–7.1下dashGap

android shape stroke dashgap xml虚线间隔

dashGap 是虚线间隙,不是虚线长度

很多人调 dashGap 发现线条没变化,或者“越调越大反而变实了”,根本原因是把它和 dashWidth 搞混了:dashGap 控制的是每一段虚线之间的空白距离,不是虚线本身的长短。虚线长度由 dashWidth 决定,两者必须同时设置才生效。

常见错误现象:android:dashGap="5" 单独写,没配 dashWidth → XML 解析失败或直接忽略虚线属性,退化为实线。

  • dashWidth 和 dashGap 必须成对出现,缺一不可
  • 两个值都为 0 时,Android 会当作实线处理(不是无限细的虚线)
  • 单位统一用 dp,别混用 px,否则在高密度屏上间隙会缩得太小,看起来像实线

XML 中 stroke 虚线必须用 shape 容器包裹

直接在 View 的 background 里写虚线是不可能的,Android 不支持内联虚线样式。必须通过 shape drawable 定义,再作为 background 引入。

使用场景:给 TextView 加下划线、FrameLayout 边框、自定义分割线等。

Android SMS Gateway
Android SMS Gateway

自托管短信服务,使用 Android 手机作为网关提供 HTTP API,支持发送/接收短信,兼容主流短信网关。

下载
  • 根节点必须是 <shape android:shape="rectangle"></shape>(即使画线也得用 rectangle,line 类型不支持 dash 属性)
  • <stroke></stroke> 标签里才能写 android:dashWidth 和 android:dashGap
  • 漏掉 android:width 和 android:color 会导致 stroke 不显示,哪怕 dash 参数全对也没用
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <stroke
        android:width="2dp"
        android:color="#666"
        android:dashWidth="10dp"
        android:dashGap="6dp" />
</shape>

dashGap 太小会导致虚线“粘连”或渲染异常

在 Android 4.4–7.1 系统上,如果 dashGap 小于约 1.5dp,部分机型(尤其三星、华为旧款)会出现虚线连成一片、抖动甚至崩溃。这不是你代码写错,是底层 Skia 渲染的精度限制。

性能影响:过小的 dashGap 会让系统尝试绘制极高频次的短线段,GPU 渲染压力上升,低端机可能出现掉帧。

  • 安全下限建议设为 2dp,兼顾视觉节奏和兼容性
  • 若设计稿要求极密虚线(如 0.5pt 间隔),改用 BitmapDrawable 或自定义 Drawable 绘制,绕过 XML stroke 限制
  • 测试时务必在 Android 5.0 和 6.0 真机上验证,模拟器常掩盖该问题

Java/Kotlin 动态修改 dashGap 几乎不可行

XML 里设好的虚线参数,运行时不能通过 getGradient().setStroke() 或类似方式动态改 dashGap —— GradientDrawable 的 dash 属性是只读的,调用 setStroke() 会清空所有 dash 配置,变回实线。

使用场景:需要根据状态切换实线/虚线,或响应用户操作调整间隔。

  • 唯一可靠做法是预置多套 shape XML 文件(如 border_dashed_2dp.xml、border_dashed_8dp.xml),用 setBackgroundResource() 切换
  • 想完全动态控制?只能继承 Drawable 自己重写 draw(),用 Path + Paint.setPathEffect(new DashPathEffect(...))
  • 注意:DashPathEffect 在硬件加速开启时可能失效,需调用 setLayerType(LAYER_TYPE_SOFTWARE, null)
虚线间隔这事,看着就俩参数,但真要跨机型、跨版本稳住,得卡死单位、绕开 API 限制、还得给老系统留余量。最容易被忽略的,其实是那个“必须成对出现”的硬约束——少写一个,整条线就静默退化,连报错都没有。

热门AI工具

更多
SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

相关专题

更多
Kotlin协程编程与Spring Boot集成实践
Kotlin协程编程与Spring Boot集成实践

本专题围绕 Kotlin 协程机制展开,深入讲解挂起函数、协程作用域、结构化并发与异常处理机制,并结合 Spring Boot 展示协程在后端开发中的实际应用。内容涵盖异步接口设计、数据库调用优化、线程资源管理以及性能调优策略,帮助开发者构建更加简洁高效的 Kotlin 后端服务架构。

371

2026.02.12

Java Kotlin协程与异步编程实战
Java Kotlin协程与异步编程实战

本专题围绕 Kotlin 协程与异步编程展开,讲解挂起函数、协程作用域、异步任务调度及并发控制方法。通过实际项目案例,帮助开发者提升后端服务性能,实现高效异步任务处理与稳定性保障。

179

2026.04.13

Kotlin Android开发教程大全
Kotlin Android开发教程大全

系统讲解 Google 官方推荐的 Android 开发首选语言 Kotlin 的核心知识与工程实践,涵盖 Kotlin 简洁语法(空安全/数据类/扩展函数/解构声明/作用域函数)与 Java 互操作、集合操作与函数式编程、协程(Coroutines)异步编程(suspend/launch/async/Flow)、Jetpack Compose 声明式 UI 开发(状态管理/组合函数/导航/动画)、MVVM / MVI 架构设计与 Vi

268

2026.06.03

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4784

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

6197

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2522

2024.11.28

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

40

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Excel 教程
Excel 教程

共162课时 | 44.9万人学习

Java 教程
Java 教程

共578课时 | 194.6万人学习

Uniapp从零开始实现新闻资讯应用
Uniapp从零开始实现新闻资讯应用

共64课时 | 9.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn