目录三种场景一览Text 文本换行演示代码关键逻辑解析适用场景注意点Text 文本省略演示代码关键逻辑解析适用场景注意点Text 字体自适应演示代码关键逻辑解析适用场景注意点对比表格运行验证扩展复用方向小结实际项目里文本长度和容器尺寸往往是不确定的。列表项标题可能超长、卡片宽度会随窗口变化、大屏上的数字需要自动撑满空间。Text提供了三组属性来应对这些问题换行、省略和字体自适应。这篇把这三组属性的用法和注意点一次讲清楚。三种场景一览需求关键属性解决的问题控制换行wrapMode长文本在有限宽度内如何折行截断显示elidemaximumLineCount超出范围的文本用省略号收尾自动缩放fontSizeModeminimumPixelSize文字随容器大小自动调整字号这三个能力经常组合使用比如新闻列表的摘要需要两行省略大屏 KPI 数字需要自适应容器。Text 文本换行wrapMode决定长文本如何折行。这个 demo 展示了NoWrap、WordWrap、Wrap三种模式的区别。演示代码import QtQuick import QtQuick.Layouts FadeInAnimation { ColumnLayout { anchors.fill: parent anchors.margins: 20 spacing: 15 // ... 省略标题组件 TitleSeparator ... ColumnLayout { Layout.leftMargin: 20 spacing: 15 Text { Layout.preferredWidth: 250 text: NoWrap: This is a very long text that will not wrap by default wrapMode: Text.NoWrap font.pointSize: 12 } Text { Layout.preferredWidth: 250 text: WordWrap: This is a very long text that only wraps at word boundaries wrapMode: Text.WordWrap font.pointSize: 12 } Text { Layout.preferredWidth: 250 text: Wrap: This is a very long text that prefers word boundaries but can break anywhere if needed wrapMode: Text.Wrap font.pointSize: 12 } } Item { Layout.fillHeight: true } } }关键逻辑解析Text.NoWrap不换行超出部分直接绘制出去Text.WordWrap只在单词边界换行阅读体验最好Text.Wrap优先单词边界必要时可在任意位置断行常用搭配wrapMode: Text.WordWrapLayout.fillWidth: true适用场景WordWrap适合文章正文、说明文字Wrap适合路径、URL、代码片段这类需要严格填满宽度的内容NoWrap适合配合elide做单行截断标题。注意点中文没有明显的单词边界WordWrap和Wrap在中文下的表现差异不大。但在英文界面里两者区别很明显不要乱用。Text 文本省略列表、卡片里经常需要把过长的文字截断显示。这个 demo 展示了右侧省略、左侧省略、中间省略以及多行省略的写法。演示代码import QtQuick import QtQuick.Layouts FadeInAnimation { ColumnLayout { anchors.fill: parent anchors.margins: 20 spacing: 15 // ... 省略标题组件 TitleSeparator ... ColumnLayout { Layout.leftMargin: 20 spacing: 12 Text { Layout.preferredWidth: 250 text: ElideRight: 这是一段需要被省略的长文本 elide: Text.ElideRight font.pointSize: 11 } Text { Layout.preferredWidth: 250 text: ElideLeft: 这是一段需要被省略的长文本 elide: Text.ElideLeft font.pointSize: 11 } Text { Layout.preferredWidth: 250 text: ElideMiddle: 这是一段需要被省略的长文本 elide: Text.ElideMiddle font.pointSize: 11 } Text { Layout.preferredWidth: 250 text: 多行省略: 这是一段很长的文本用来演示 maximumLineCount 属性的效果。当文本超过指定行数时会被省略。 maximumLineCount: 2 elide: Text.ElideRight wrapMode: Text.WordWrap font.pointSize: 10 } } Item { Layout.fillHeight: true } } }关键逻辑解析elide省略模式ElideRight/ElideLeft/ElideMiddlemaximumLineCount最多显示几行配合wrapMode使用多行省略必须同时设置wrapMode: Text.WordWrap和elide: Text.ElideRight适用场景ElideRight适合大多数列表标题ElideMiddle适合文件路径保留开头和结尾ElideLeft适合显示日志时间戳后面的关键信息。多行省略适合新闻摘要、商品简介等场景。注意点单行省略只需要设置elide和固定宽度多行省略必须同时开启wrapMode否则maximumLineCount不会生效。另外elide对富文本RichText的支持有限复杂场景建议用TextMetrics自己截断。Text 字体自适应做响应式布局或大屏展示时希望文字自动填满容器。fontSizeMode就是干这个的。这个 demo 展示了HorizontalFit、VerticalFit、Fit三种模式最后一个容器还可以拖动改变大小来观察效果。演示代码import QtQuick import QtQuick.Layouts FadeInAnimation { ColumnLayout { anchors.fill: parent anchors.margins: 20 spacing: 15 // ... 省略标题组件 TitleSeparator ... ColumnLayout { Layout.fillWidth: true Layout.leftMargin: 20 Layout.rightMargin: 20 spacing: 15 Rectangle { Layout.preferredWidth: 300 Layout.preferredHeight: 40 color: #fff3e0 border.color: #ffb74d radius: 4 Text { anchors.fill: parent anchors.margins: 4 text: HorizontalFit 适配宽度 fontSizeMode: Text.HorizontalFit font.pixelSize: 72 horizontalAlignment: Text.AlignHCenter verticalAlignment: Text.AlignVCenter } } Rectangle { Layout.preferredWidth: 300 Layout.preferredHeight: 50 color: #e3f2fd border.color: #42a5f5 radius: 4 Text { anchors.fill: parent anchors.margins: 4 text: VerticalFit 适配高度 fontSizeMode: Text.VerticalFit font.pixelSize: 72 horizontalAlignment: Text.AlignHCenter verticalAlignment: Text.AlignVCenter } } Rectangle { Layout.preferredWidth: 300 Layout.preferredHeight: 60 color: #e8f5e9 border.color: #66bb6a radius: 4 Text { anchors.fill: parent anchors.margins: 4 text: Fit 适配宽高 fontSizeMode: Text.Fit minimumPixelSize: 10 font.pixelSize: 72 horizontalAlignment: Text.AlignHCenter verticalAlignment: Text.AlignVCenter } } Rectangle { id: resizableBox Layout.preferredWidth: 300 Layout.preferredHeight: 60 color: #f3e5f5 border.color: #ab47bc border.width: 2 radius: 4 Text { anchors.fill: parent anchors.margins: 4 text: 拖动改变大小 fontSizeMode: Text.Fit minimumPixelSize: 10 font.pixelSize: 72 horizontalAlignment: Text.AlignHCenter verticalAlignment: Text.AlignVCenter } MouseArea { anchors.right: parent.right anchors.bottom: parent.bottom width: 24 height: 24 cursorShape: Qt.SizeFDiagCursor preventStealing: true property real startX property real startY onPressed: (mouse) { startX mouse.x startY mouse.y } onPositionChanged: (mouse) { var newW resizableBox.width (mouse.x - startX) var newH resizableBox.height (mouse.y - startY) if (newW 80) resizableBox.width newW if (newH 30) resizableBox.height newH startX mouse.x startY mouse.y } } } } Item { Layout.fillHeight: true } } }关键逻辑解析fontSizeMode: Text.HorizontalFit宽度变化时字体跟着变高度固定fontSizeMode: Text.VerticalFit高度变化时字体跟着变宽度固定fontSizeMode: Text.Fit同时适配宽高minimumPixelSize限制最小字号避免容器太小时字缩到看不见font.pixelSize设一个较大值作为上限实际大小由容器决定适用场景Text.Fit最适合大屏数字展示、欢迎页标题、广告牌文字。HorizontalFit适合宽度会变化但高度固定的标签栏。VerticalFit适合竖向布局里的标题。注意点fontSizeMode只在文字内容较短时效果最好。如果文字很长字号会缩到很小才能塞进容器这时应该改用wrapMode或elide。另外自适应模式下建议始终设置minimumPixelSize避免极端情况下文字不可读。对比表格需求关键属性注意点控制换行wrapMode多行用WordWrap截断显示elide单行省略只需elide多行需加maximumLineCountwrapMode自动缩放fontSizeMode配合minimumPixelSize使用运行验证Qt Creator 打开qml_text/CMakeLists.txt按CtrlR运行在左侧导航切换文本换行、文本省略、字体自适应扩展复用方向封装EllipsisText组件默认开启ElideRight支持设置最大行数在大屏 KPI 展示中用Text.Fit让数字自动撑满卡片新闻列表用maximumLineCount: 2elide: ElideRight做两行摘要做响应式卡片时结合Layout.fillWidth和WordWrap让正文随窗口自动换行小结换行、省略、自适应是Text处理动态内容的三把利器。wrapMode解决文本折行elide解决超长截断fontSizeMode解决字号适配。三者可以单独使用也可以组合比如一个响应式新闻卡片标题用elide单行省略摘要用wrapModemaximumLineCount多行省略核心数据用fontSizeMode自动撑满。掌握这些属性就能让文本在不同尺寸下都保持良好的阅读体验。已验证环境Qt 版本Qt 6.11.1操作系统Windows 11完整代码https://gitcode.com/u011186532/qml_demo/tree/main/qml_text
企业数字化 ERP 产品动态
相关推荐
GodotDetour插件实战:基于RecastDetour的3D导航系统集成与优化 1. 项目概述:为什么我们需要GodotDetour?如果你正在用Godot引擎开发3D游戏,尤其是涉及大量NPC寻路、动态障碍物或者群体移动的场景,那么你很可能已经对引擎内置的导航系统感到头疼了。Godot 3.x版本的3D导航功能,坦白说… · 2026/9/1 15:08:12
TM4C123软件复位机制详解:从原理到实战避坑指南 1. 为什么我们需要软件复位外设?在嵌入式开发里,尤其是基于ARM Cortex-M内核的微控制器,比如TI的Tiva™ TM4C123BE6PM,我们经常会遇到一个场景:某个外设,比如UART串口或者定时器,工作着工作着就… · 2026/8/2 18:12:05
OpenVLA:开源机器人通用大脑,以7B参数超越谷歌RT-2-X 1. 项目概述:一个开源的“机器人通用大脑”最近,机器人圈子里有个消息挺让人兴奋的:一个叫OpenVLA的开源模型,在多项通用机器人操作任务上,性能居然超过了谷歌那个参数规模大得多的闭源模型RT-2-X。这感觉就像是一个开… · 2026/7/27 23:57:05
泉州电工证怎么申请全国通用电工证实操考试怎么准备 泉州电工证怎么申请全国通用电工证实操考试怎么准备 实操考试心里没底怕挂科,这几乎是每个准备报考泉州电工证的人心里都有的疑问。别担心,这其实是一个很常见的问题,关键是要找对方法。泉州电工证是全国通用的,也就是说无论你在哪个省、哪个城市工作,这… · 2026/11/19 17:25:49
色弱电工证体检能过吗?郑州报考避坑指南全解析 色弱电工证体检能过吗?郑州报考避坑指南全解析 之前考的证在外省能不能转过来?这个问题我听得太多了。说实话,很多老电工在外地考的证,回郑州后发现根本用不上,不仅不能跨省使用,连复审都麻烦。今天就从 色弱电工证体检 这个核心点切入,结合… · 2026/11/19 17:25:49
电工证是当场发吗全国通用吗这些事你必须知道 电工证是当场发吗全国通用吗这些事你必须知道 之前考的证在外省能不能转过来?这是很多特种作业人员最关心的问题。特别是现在全国通用的电工证,很多人担心在外省考的证回到本地能不能用,会不会遇到麻烦。其实,电工证是全国通用的,这是国家明文规定的。不… · 2026/11/19 17:25:49
赣榆区电工证多少钱?郑州报考避坑指南,实操考试心理没底怕挂科? 赣榆区电工证多少钱?郑州报考避坑指南,实操考试心理没底怕挂科? 实操考试心里没底怕挂科?赣榆区电工证多少钱?报名前别踩坑,郑州报考避坑指南帮你避雷,让你轻松过关。很多人第一次接触特种作业证,对考试内容、流程、费用都不太清楚,尤其是实操考试部… · 2026/11/19 17:25:49
工地太忙根本没时间复习考试?曲阜电工证考试地方值不值得考 工地太忙根本没时间复习考试?曲阜电工证考试地方值不值得考 工地太忙根本没时间复习考试,这几乎是所有一线工人的共同心声。尤其是像电工证这种需要考试的证件,更是让人头疼。很多人在问: 曲阜电工证考试地方值不值得考… · 2026/11/19 17:25:49
龙泉高压电工证培训机构怎么选?通过率揭秘告诉你真相 龙泉高压电工证培训机构怎么选?通过率揭秘告诉你真相 之前考的证在外省能不能转过来?这个问题困扰了很多人,尤其是在像你这样在南阳从事建筑行业的在职工人。今天我们就来聊聊龙泉高压电工证培训机构怎么选, 通过率揭秘… · 2026/11/19 17:24:48
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/19 16:06:02
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/18 8:19:53
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/18 14:38:14
姑苏区哪里考电工证好考前押题怎么找 姑苏区哪里考电工证好考前押题怎么找 工地太忙根本没时间复习考试,电工证考前还总找不到靠谱的 考前押题 资源,真让人头疼。如果你也是在苏州姑苏区从事建筑或电力行业的,那这些建议你一定要看完。 为什么姑苏区考电工证的人这么多?… · 2026/11/19 0:00:12
罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 之前考的证在外省能不能转过来?这几乎是每个特种作业证书持有者都会遇到的问题,特别是像你这样已经在外地工作多年,想回老家罗定发展或者重新规划职业路径的人。别急,今天就给你一条清晰的路… · 2026/11/19 0:00:12
罗定能考电工证吗 电工证含金量到底有多少? 罗定能考电工证吗 电工证含金量到底有多少? 之前考的证在外省能不能转过来,这几乎是每个准备考电工证的朋友最先想到的问题。特别是在罗定这样的地方,很多人的电工证都是在外地考的,现在想在当地继续使用,但不知道怎么办。实际上,电工证的 含金量… · 2026/11/19 0:00:12
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38