全部產品
Search
文件中心

Mobile Platform as a Service:richtext

更新時間:Nov 18, 2025

<external-richtext> 是螞蟻動態卡片引擎內建的組件,用來渲染富文本。

嵌入組件支援

不可以嵌套任何其他組件。

樣式

<external-richtext>組件支援 通用樣式 中的所有樣式,並且支援部分特殊樣式。

格式

支援 HTML 標籤格式,目前包含以下與字型相關的標籤。

標籤

描述

寫法

備忘

br

換行

<p>

To break<br />lines<br />in a<br />paragraph,<br />use the br tag.

</p>

-

span

用來組合文檔中的行內元素

<p><span>some text.</span>

some other text.</p>

-

div

把文檔分割為獨立的、不同的部分

<div style="color:#00FF00">

<h3>This is a header</h3> <p>This is a paragraph.</p> </div>

-

b

加粗文本

<p>這是普通文本 - <b>這是粗體文本</b>。</p>

-

del

刪除文本

a dozen is <del>20</del>

12 pieces

-

h1

標題 1

<h1>這是標題 1</h1>

-

h2

標題 2

<h2>這是標題 2</h2>

-

h3

標題 3

<h3>這是標題 3</h3>

-

h4

標題 4

<h4>這是標題 4</h4>

-

h5

標題 5

<h5>這是標題 5</h5>

-

h6

標題 6

<h6>這是標題 6</h6>

-

i

斜體文本

<i>郵箱斜體cn42ducn4***@163.comt3@42du.online</i>

-

p

定義段落

<p>This is some text in a very short paragraph</p>

-

img

定義圖片

src:下載連結

width/height:圖片繪製寬/高

<img src='https://gw-office.alipayobjects.com/basement_prod/2e4245df-3518-434c-bac6-244447b6800f.png' width=18rpx height=18rpx />

寬高預設值與字型高度相同。

設定寬高大於行高時,繪製效果上不支援把行高撐開。

a

定義連結

href:連結跳轉地址

<a href='https://www.alipay.com'>

-

字型相關

屬性

描述

實值型別

寫法

備忘

font-size

文字大小

長度單位

<span style=\"font-size:30px;\">內聯30px</span>

-

效果相關

屬性

描述

實值型別

寫法

備忘

color

字型顏色

色彩單位

<span style=\"color:#F00\">內聯#F00</span>

-

font-weight

字重

string

<span style=\"font-weight:100\">內聯#F00</span>

取值和 text 標籤中基礎樣式的 樣式 相同。

font-family

字型

string

<span style=\"font-family:thinFont\">字型瘦體</span>

取值和 text 標籤中基礎樣式的 樣式 相同。

屬性

屬性

描述

實值型別

預設值

寫法

備忘

text

組件的值,常值內容

string

<external-richtext text="richtextContent"></external-richtext>

-

line-space

行間距,如 4px

長度單位

<external-richtext line-space="4px"></external-richtext>

-

detectEmotionEmoji

是否檢測自訂 Emoji 表情

1/0

0

<external-richtext text="richtextContent"

detectEmotionEmoji="1" ></external-richtext>

-

linkColor

設定連結字型顏色(a 標籤)

色彩單位

0xff108ee9

<external-richtext text="richtextContent"

linkColor="#FF0000"></external-richtext>

-

highlightedColor

設定連結點擊醒目提示

色彩單位

0xffa9a9a9

<external-richtext text="richtextContent"

highlightedColor="#0000FF" ></external-richtext>

-

說明
  • 為 img 標籤設定的 height 大於行高時,繪製效果不會把行高撐開,預設與字型高度相同。

  • 為 img 標籤設定 width 和 height,會使圖片壓縮放以填滿。

  • a 標籤連結字型顏色 span 設定優先權高於屬性 linkcolor 設定。

  • highlightedColor 控制醒目提示,包括 a 標籤連結。如果不設定,預設灰色。

  • 表情大小與字型高度相同。

事件

<richtext> 組件支援 通用事件 中的所有事件。

樣本

<external-richtext
:text="richTextContent"
:line-space="4px"
></external-richtext>

data: {
    richTextContent:
      '<span style=\"font-size:30px;\">內聯30px</span><span style=\"font-size:30rpx;\">內聯30rpx</span><span style=\"color:#F00\">內聯#F00</span>
      <span>全域30px,color:#F00</span>
      <span>全域30rpx,color:#0F0</span>
      <span style=\"font-size:30px;color:#00F\">內聯30px,color#0F0</span><span>全域20px,color#0F0</span>
      <div style=\"color:#F00\"><div><div>最外部#F00</div></div></div>
      <div><div><div style=\"color:#F00\">最內部#F00</div></div></div>
      <b>b</b><del>del</del><div>div</div><h1>h1</h1><h2>h2</h2><h3>h3</h3><h4>h4</h4><h5>h5</h5><h6>h6</h6><i>i</i><p>p</p><span>span</span>'
  }

image.png

範例程式碼

單擊此處 detailRichtext.zip 擷取完整範例程式碼。