提示块
这是什么
从正文里跳出来的一小块话:补充说明、小技巧、警告、危险。四种,各自一个指令名。
怎么写
方括号里那行是指令标题,可以不写:
四种都不接受任何属性({} 里的东西)。
怎么选
出来是什么样
左边一条 3px 竖线,颜色按类型走 --pf-info / --pf-tip / --pf-warn / --pf-danger;底色四种统一用 --pf-bg-subtle。
不渲染图标
四种的区别只在左边那条线的颜色,没有图标。想加图标目前没有办法。
个别主题会改形态:paper 把它变成页边的旁注,lesson 把 tip 做成一个描边的重点框。
坑
- 没有
callout这个指令。它是这四种的统称,写:::callout会报DIR-201警告,提示里会列出四个真名 - 一页别放五个。四种的区别只在一条线的颜色,满屏提示块等于没有提示块;一屏里最多一个
danger - 四种在无 JavaScript 时表现完全一样——它们本来就是纯 CSS,不带任何交互