Text
タイポグラフィのデザイントークンを使ってテキストを表示するためのコンポーネントです。本文や説明文、ラベルテキストにデザイントークン準拠のフォントサイズ・ウェイト・色・行送り・見出しスタイルなどを適用するときに使います。
使用上の注意
入れ子にしたときの出力要素に注意する
デフォルトの出力要素は<span>になるため、入れ子にしたときにValidなHTMLになるように注意してください。
種類
フォントサイズ
size propsで指定できます。値はタイポグラフィのフォントサイズのデザイントークンを参照してください。
ウェイト
weight propsで指定できます。
強調、イタリック体
emphasis props、italic propsで指定できます。
色
color propsで指定できます。値は色の文字のデザイントークンを参照してください。
行送り
leading propsで指定できます。値は行送りのデザイントークンを参照してください。
折り返し
whiteSpace propsで指定できます。
見出しスタイル
styleType propsで指定できます。
Headingの種類に合わせた見た目(フォントサイズ、ウェイト、色)を提供しますが、見出しとして使う場合はTextではなくHeadingを使用してください。
使い方チェックリスト
Text
参照元:使用上の注意 > 入れ子にしたときの出力要素に注意する 「使用上の注意 > 入れ子にしたときの出力要素に注意する」の本文へ移動
- MustText を入れ子にする場合は Valid な HTML になるよう出力要素に注意する
参照元:種類 > 見出しスタイル 「種類 > 見出しスタイル」の本文へ移動
- Must見出しとして使う場合は Text ではなく Heading を使う
Props
size
"XXS""XS""S""M""L""XL""XXL"
color
"inherit""TEXT_BLACK""TEXT_WHITE""TEXT_GREY""TEXT_DISABLED""TEXT_LINK"
weight
"bold""normal"
italic
falsetrue
leading
"NONE""TIGHT""NORMAL""LOOSE"
whiteSpace
"pre""normal""nowrap""pre-line""pre-wrap"
maxLines
123456
emphasis
falsetrue
強調するかどうかの真偽値。指定すると em 要素になる
styleType
"screenTitle""sectionTitle""blockTitle""subBlockTitle""subSubBlockTitle"
見た目の種類
icon
stringnumberfalsetrueReactElement<any, string | JSXElementConstructor<any>>Iterable<ReactNode>ReactPortal{ prefix?: ReactNode; suffix?: ReactNode; gap?: 0 | 1 | 2 | 0.25 | 0.5 | 0.75 | 1.25 | 1.5 | 2.5 | 3 | 3.5 | 4 | 8 | -0.25 | -0.5 | -0.75 | -1 | -1.25 | -1.5 | -2 | -2.5 | ... 4 more ... | keyof CreatedSpacingTheme; }
設置するアイコン