@lism-css/mcp 0.27.0 → 0.28.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/data/docs-index.json +14 -14
- package/dist/data/guides/SKILL.md +1 -1
- package/dist/data/guides/antipatterns.md +2 -2
- package/dist/data/guides/components-ui.md +3 -3
- package/dist/data/guides/css-rules.md +1 -1
- package/dist/data/guides/customize.md +1 -1
- package/dist/data/guides/naming.md +7 -3
- package/dist/data/guides/property-class/all-props.md +1 -1
- package/dist/data/guides/property-class/hov.md +1 -0
- package/dist/data/guides/property-class.md +1 -1
- package/dist/data/guides/references/page-sections.md +1 -1
- package/dist/data/guides/set-class.md +1 -1
- package/dist/data/guides/tokens.md +11 -9
- package/dist/data/guides/utility-class.md +1 -9
- package/package.json +1 -1
|
@@ -150,7 +150,7 @@
|
|
|
150
150
|
"max-",
|
|
151
151
|
"min-"
|
|
152
152
|
],
|
|
153
|
-
"snippet": "Lism CSS の命名規則をまとめたページ。CSS変数はトークン変数 `--{prop}--{token}`、Property Class 用変数 `--{prop}` / `--{prop}_{bp}
|
|
153
|
+
"snippet": "Lism CSS の命名規則をまとめたページ。CSS変数はトークン変数 `--{prop}--{token}`、Property Class 用変数 `--{prop}` / `--{prop}_{bp}`、上書きを想定しない内部処理用の変数・状態判定用の変数 `--_{varName}` などの形式で統一。クラスはプレフィックス(`b--`, `c--`, `a--`, `l--`, `is--`, `set--`, `u--`)で分類を示し、続く名称は camelCase。Prop 名は Emmet を参考に 1 文字プロパティ(p, m, g, c, f, w, h, d, o, v, i, t, b, l, r, z)やグループ略称 + サブプロパティ形式(fz, bgc, gtc 等)で省略。方向サフィックスは `-t` / `-b` / `-l` / `-r` / `-x` / `-y` / `-s` / `-e` を使用し、p/m のみ最初のハイフンを省略(pt, px, my 等)。値は基本的に CSS の実値をそのまま使用し、トークン値を使う場合は `--{prop}--{value}` の `{value}` 部分を採用。"
|
|
154
154
|
},
|
|
155
155
|
{
|
|
156
156
|
"sourcePath": "tokens.mdx",
|
|
@@ -173,7 +173,7 @@
|
|
|
173
173
|
"--s-unit",
|
|
174
174
|
"typography"
|
|
175
175
|
],
|
|
176
|
-
"snippet": "デザイントークンの一覧ページ。COLOR, Typography, RADIUS, SHADOW, SPACE, OPACITY, SIZE トークンを掲載。SPACEはフィボナッチ数列ベースの余白スケール --s5〜--
|
|
176
|
+
"snippet": "デザイントークンの一覧ページ。COLOR, Typography, RADIUS, SHADOW, SPACE, OPACITY, SIZE トークンを掲載。SPACEはフィボナッチ数列ベースの余白スケール --s5〜--s70(s25/s35/s45 を含む12段階)で、--s-unit(デフォルト 0.5rem ≒ 8px)を基準単位として算出。SHADOWは --bxsh--10〜--bxsh--50(5段階)、OPACITYは音楽強弱記号に由来するセマンティック命名(mp/p/pp/ppp)を採用。カラー・タイポグラフィは個別ページでも詳細を解説。"
|
|
177
177
|
},
|
|
178
178
|
{
|
|
179
179
|
"sourcePath": "tokens/colors.mdx",
|
|
@@ -462,7 +462,7 @@
|
|
|
462
462
|
"full_no_layer.css",
|
|
463
463
|
"!important"
|
|
464
464
|
],
|
|
465
|
-
"snippet": "lism-css パッケージに同梱された複数のビルド済みCSSの使い分けを解説。main.css(標準)/ main_no_layer.css(@layerなし)/ full.css(全部入り、purge前提)/ full_no_layer.css から選択可能。@layer なし版は既存サイト・WordPress テーマなどカスケードを制御できない環境向けで、Property Class は常に !important 付き、u--trim / u--trimAll / u--cbox
|
|
465
|
+
"snippet": "lism-css パッケージに同梱された複数のビルド済みCSSの使い分けを解説。main.css(標準)/ main_no_layer.css(@layerなし)/ full.css(全部入り、purge前提)/ full_no_layer.css から選択可能。@layer なし版は既存サイト・WordPress テーマなどカスケードを制御できない環境向けで、Property Class は常に !important 付き、u--trim / u--trimAll / u--cbox はセレクタ二重化(.u--trim.u--trim = 0-2-0)で出力され「Property Class > Utility Class > 単一クラス」の序列を再現する(lism.config.js の defaultImportant: false・$default_important: 0・props の個別 important: 0 でも !important は外れない)。full.css には main.css 非収録の Property Class ブレイクポイント対応クラス(isVar 系・border ショートハンド系を除く。border は bds / bdc のサブプロパティで BP 対応)と、カラー系 Property Class(bgc / c / bdc)の全カラートークン分のクラス(-bgc:red など。main.css は厳選したセマンティックカラーと keycolor のみ)を含む。スペーシング系(padding / margin / gap)のトークンユーティリティは main.css に収録済み。コンポーネント出力も full.css に合わせるには lism.config.js の isFullMode を使う(詳細は customize/config.mdx)。"
|
|
466
466
|
},
|
|
467
467
|
{
|
|
468
468
|
"sourcePath": "customize/config.mdx",
|
|
@@ -561,7 +561,7 @@
|
|
|
561
561
|
"title": "Utility Class",
|
|
562
562
|
"description": "スタイルや装飾をまとめて適用できる Lism CSS のユーティリティクラスについて解説します。",
|
|
563
563
|
"category": "guide",
|
|
564
|
-
"headings": ["u--cbox", "u--trim & u--trimAll", "u--srOnly", "u--
|
|
564
|
+
"headings": ["u--cbox", "u--trim & u--trimAll", "u--srOnly", "u--clipText", "Opt-in", "u--inlineCenter", "u--divide / u--enclose"],
|
|
565
565
|
"keywords": [
|
|
566
566
|
"utility",
|
|
567
567
|
"ユーティリティ",
|
|
@@ -576,7 +576,7 @@
|
|
|
576
576
|
"u--clipText",
|
|
577
577
|
"u--inlineCenter"
|
|
578
578
|
],
|
|
579
|
-
"snippet": "用途が明確な装飾・機能をまとめてセットするユーティリティクラス (.u--{style}) の一覧。u--cbox(keycolorベースの色自動生成), u--trim/u--trimAll(ハーフレディング余白調整), u--srOnly(スクリーンリーダー専用), u--
|
|
579
|
+
"snippet": "用途が明確な装飾・機能をまとめてセットするユーティリティクラス (.u--{style}) の一覧。u--cbox(keycolorベースの色自動生成), u--trim/u--trimAll(ハーフレディング余白調整), u--srOnly(スクリーンリーダー専用), u--clipText(テキストで背景クリッピング)を解説。Opt-in(コア外・追加CSS例)として u--inlineCenter(絵文字・インラインアイコン中央揃え)と u--divide/u--enclose(区切り線・セル枠)も紹介。"
|
|
580
580
|
},
|
|
581
581
|
{
|
|
582
582
|
"sourcePath": "set-class.mdx",
|
|
@@ -1676,10 +1676,10 @@
|
|
|
1676
1676
|
"Markup",
|
|
1677
1677
|
"Examples",
|
|
1678
1678
|
"チェックマークのリスト(b--list--check)",
|
|
1679
|
-
"アイコンを差し替える(--
|
|
1679
|
+
"アイコンを差し替える(--icon-c / --icon-img)"
|
|
1680
1680
|
],
|
|
1681
1681
|
"keywords": ["List", "b--list", "リスト", "箇条書き", "アイコン", "チェックマーク", "checklist"],
|
|
1682
|
-
"snippet": "行頭にアイコンを表示する装飾リストUIの実装例。primitivesと少量のCSS(b--list)で構成し、CSSをlism-blockレイヤーへコピーして利用。b--list--checkでチェックマークに切り替え、--
|
|
1682
|
+
"snippet": "行頭にアイコンを表示する装飾リストUIの実装例。primitivesと少量のCSS(b--list)で構成し、CSSをlism-blockレイヤーへコピーして利用。b--list--checkでチェックマークに切り替え、--icon-c / --icon-imgでアイコンの色・画像を変更できる。"
|
|
1683
1683
|
},
|
|
1684
1684
|
{
|
|
1685
1685
|
"sourcePath": "ui/components/Others.mdx",
|
|
@@ -1811,12 +1811,12 @@
|
|
|
1811
1811
|
},
|
|
1812
1812
|
{
|
|
1813
1813
|
"sourcePath": "utility-class.mdx",
|
|
1814
|
-
"title": "u--divide
|
|
1815
|
-
"description": "
|
|
1814
|
+
"title": "u--divide / u--enclose(Opt-in)",
|
|
1815
|
+
"description": "グリッド・フレックス子要素間の区切り線・セル枠を表示する、コア外(Opt-in)のユーティリティクラス例。",
|
|
1816
1816
|
"category": "guide",
|
|
1817
|
-
"headings": ["u--divide
|
|
1818
|
-
"keywords": ["u--divide", "u--enclose", "グリッド区切り", "ボーダー", "テーブル風", "カレンダー", "box-shadow"],
|
|
1819
|
-
"snippet": "u--divide
|
|
1817
|
+
"headings": ["u--divide / u--enclose"],
|
|
1818
|
+
"keywords": ["u--divide", "u--enclose", "opt-in", "グリッド区切り", "ボーダー", "テーブル風", "カレンダー", "box-shadow"],
|
|
1819
|
+
"snippet": "コアには含まれない追加CSSの例。@layer lism-utility に追加して使う(@layer なし版のビルドでは @layer で囲まず .u--divide.u--divide のようにセレクタを二重化する)。u--divide は子要素間にのみ区切り線を表示(外周なし)、u--enclose は各セルを枠で囲む。gap と子要素の box-shadow で実装するため border より描画が粗く、並び方向が切り替わるレイアウトでは bdw のブレイクポイント切り替えを推奨。"
|
|
1820
1820
|
},
|
|
1821
1821
|
{
|
|
1822
1822
|
"sourcePath": "trait-class.mdx",
|
|
@@ -1893,11 +1893,11 @@
|
|
|
1893
1893
|
{
|
|
1894
1894
|
"sourcePath": "set-class.mdx",
|
|
1895
1895
|
"title": "set--s",
|
|
1896
|
-
"description": "余白トークン(--s5〜--
|
|
1896
|
+
"description": "余白トークン(--s5〜--s70)を現在のフォントサイズ基準で再計算するSetクラス。",
|
|
1897
1897
|
"category": "guide",
|
|
1898
1898
|
"headings": ["set--s"],
|
|
1899
1899
|
"keywords": ["set--s", "余白", "フォントサイズ", "--s-unit", "spacing", "スペーシング", "em", "ボタン", "バッジ"],
|
|
1900
|
-
"snippet": "set--s クラスを使うと --s-unit が 0.5em に切り替わり、--s10〜--
|
|
1900
|
+
"snippet": "set--s クラスを使うと --s-unit が 0.5em に切り替わり、--s10〜--s70 がフォントサイズ基準で再計算される。Button や Badge など、内部余白を要素自身の font-size に追従させたい部品で活用。"
|
|
1901
1901
|
},
|
|
1902
1902
|
{
|
|
1903
1903
|
"sourcePath": "set-class.mdx",
|
|
@@ -9,7 +9,7 @@ Lism CSSでUI・ページ・コンポーネントを実装する時の判断の
|
|
|
9
9
|
|
|
10
10
|
公式ドキュメント: https://lism-css.com/docs/overview.md
|
|
11
11
|
|
|
12
|
-
**バージョン:** `lism-css@0.
|
|
12
|
+
**バージョン:** `lism-css@0.28.0`/`@lism-css/ui@0.28.0`時点の情報。プロジェクトのバージョンが異なる場合はユーザーに伝え、パッケージ更新またはこのスキルの更新を案内する。
|
|
13
13
|
|
|
14
14
|
## 実装フロー(厳守)
|
|
15
15
|
|
|
@@ -124,8 +124,8 @@ Lism CSS側が用意しているトークン値と異なるものを書かない
|
|
|
124
124
|
| --- | --- | --- |
|
|
125
125
|
| `p="8"` | `p="10"` | スペーストークンは離散値のみ。tailwindのような4の倍数で連続するスケールではない |
|
|
126
126
|
| `g="6"` | `g="5"` | 同上 |
|
|
127
|
-
| `m="
|
|
128
|
-
| `m="100"` | `m="
|
|
127
|
+
| `m="55"`, `m="65"` | `m="50"` or `m="60"` | `50` 以降の中間値は用意されていない(5 刻みは `45` まで) |
|
|
128
|
+
| `m="100"` | `m="70"` | 上限は `70`(ユーザーが追加定義している可能性はある) |
|
|
129
129
|
|
|
130
130
|
### フォントサイズ(`fz`)
|
|
131
131
|
|
|
@@ -223,7 +223,7 @@ HTML の `details/summary` 要素をラップしたコンポーネント。Accor
|
|
|
223
223
|
| --- | --- | --- | --- | --- |
|
|
224
224
|
| `hovBgc` | Root | `string` | — | ホバー時の背景カラー。`--hov-bgc` 変数として出力 |
|
|
225
225
|
| `hovC` | Root | `string` | — | ホバー時のテキストカラー。`--hov-c` 変数として出力 |
|
|
226
|
-
| `itemP` | Root | `string` | — | 各アイテムのパディング。`--
|
|
226
|
+
| `itemP` | Root | `string` | — | 各アイテムのパディング。`--item-p` 変数として出力 |
|
|
227
227
|
| `href` | Link | `string` | — | リンク先URL(Link は常に `a` 要素として出力) |
|
|
228
228
|
| `hov` | Link | `string` | `-bgc` | ホバー時のスタイル。デフォルトで背景色が変化 |
|
|
229
229
|
|
|
@@ -342,8 +342,8 @@ HTML の `details/summary` 要素をラップしたコンポーネント。Accor
|
|
|
342
342
|
| `viewBox` | `string` | — | SVG の viewBox |
|
|
343
343
|
| `level` | `number` | `5` | シェイプの高さレベル。`0` で非表示 |
|
|
344
344
|
| `flip` | `'X' \| 'Y' \| 'XY'` | — | 反転方向。`data-flip` 属性として出力 |
|
|
345
|
-
| `stretch` | `string` | — | 水平方向の引き伸ばし量。`--
|
|
346
|
-
| `offset` | `string` | — | 水平方向のオフセット。`--
|
|
345
|
+
| `stretch` | `string` | — | 水平方向の引き伸ばし量。`--inner-stretch` 変数として出力 |
|
|
346
|
+
| `offset` | `string` | — | 水平方向のオフセット。`--inner-offset` 変数として出力 |
|
|
347
347
|
| `isEmpty` | `boolean` | — | シェイプを非表示にしてスペーサーとして使用 |
|
|
348
348
|
| `isAnimation` | `boolean` | — | アニメーションを有効化。`data-has-animation` 属性として出力 |
|
|
349
349
|
|
|
@@ -56,7 +56,7 @@ Lism CSSで定義されるクラスは、その役割とレイヤーの所属が
|
|
|
56
56
|
| Custom Class | Lism 本体に含まれない、ユーザーが自由に定義するカスタムクラス | `c--` | `c--featureList`, `c--header` |
|
|
57
57
|
| `is--` Trait | 要素に役割(〜である)を宣言 | `is--` | `is--container`, `is--wrapper`, `is--layer`, `is--boxLink` |
|
|
58
58
|
| `has--` Trait | 要素に機能(〜を持つ)を付与 | `has--` | `has--transition`, `has--gutter`, `has--snap`, `has--mask` |
|
|
59
|
-
| Utility Class | 用途が明確な装飾系ユーティリティ | `u--` | `u--cbox`, `u--trim`, `u--
|
|
59
|
+
| Utility Class | 用途が明確な装飾系ユーティリティ | `u--` | `u--cbox`, `u--trim`, `u--trimAll`, `u--clipText` |
|
|
60
60
|
| Property Class | 単一プロパティの制御 | `-` | `-fz:l`, `-p:20`, `-d:none` |
|
|
61
61
|
|
|
62
62
|
**併用ルール:**
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
## `@layer` をオフにする
|
|
23
23
|
|
|
24
24
|
`lism-css/main.css` の代わりに `lism-css/main_no_layer.css` を読み込むだけで、`@layer` を使わない CSS に切り替えられます。
|
|
25
|
-
no-layer版は既存サイトや WordPress テーマなど、カスケードを制御できない環境向けです。レイヤーの代わりに、Property Class は常に `!important` 付き、`u--trim` / `u--trimAll` / `u--cbox`
|
|
25
|
+
no-layer版は既存サイトや WordPress テーマなど、カスケードを制御できない環境向けです。レイヤーの代わりに、Property Class は常に `!important` 付き、`u--trim` / `u--trimAll` / `u--cbox` はセレクタ二重化(`.u--trim.u--trim` = 0-2-0)で出力され、「Property Class > Utility Class > 単一クラス」の序列を再現します。`lism.config.js` の `defaultImportant: false`・`$default_important: 0`・`props` の個別 `important: 0` を指定しても `!important` は外れません。`b--` など上記以外のクラス同士の優先度は読み込み順・詳細度に依存します。
|
|
26
26
|
|
|
27
27
|
```js
|
|
28
28
|
// 通常
|
|
@@ -45,10 +45,14 @@
|
|
|
45
45
|
|
|
46
46
|
| 形式 | 用途 | 例 |
|
|
47
47
|
| --- | --- | --- |
|
|
48
|
-
| `--{target}-{prop}` |
|
|
48
|
+
| `--{target}-{prop}` | 特定のセレクタを起点に、子要素へ設定するプロパティ | `--link-td`, `--headings-ff`, `--icon-size` |
|
|
49
49
|
| `--{propName}` | クラス自身の主要機能を制御する変数。要素側で値が初期化され、`:root` からは初期値の定義ができないもの | `--sideW`, `--mainW` |
|
|
50
|
-
| `--_{
|
|
51
|
-
|
|
50
|
+
| `--_{varName}` | 上書きを想定しない内部処理用の変数・状態判定用の変数 | `--_panelH`、`--_flipX`、`--_isHov` |
|
|
51
|
+
|
|
52
|
+
`--{target}-{prop}`は、`:root`を起点にする場合も、`.b--*`や`.c--*`を起点にする場合も同じ形式です。`:root`以外を起点にする変数は、次のルールで外部からの影響を閉じます。
|
|
53
|
+
|
|
54
|
+
- 起点のセレクタで必ず初期値をセットする(例: `.b--list { --icon-size: 1em; }`)。祖先や他のコンポーネントから同名の値を継承しないため。
|
|
55
|
+
- 値を変えるときは`:root`ではなく、起点の要素にインラインstyleやpropsで指定する。
|
|
52
56
|
|
|
53
57
|
## クラスの命名規則
|
|
54
58
|
|
|
@@ -153,7 +153,7 @@
|
|
|
153
153
|
| `pt` | `padding-top` | `-pt:5`, `-pt:10`, `-pt:20`, ... (SPACEトークン) | ✔ |
|
|
154
154
|
| `pb` | `padding-bottom` | `-pb:5`, `-pb:10`, `-pb:20`, ... (SPACEトークン) | ✔ |
|
|
155
155
|
|
|
156
|
-
SPACEトークンの全値(`5`〜`
|
|
156
|
+
SPACEトークンの全値(`5`〜`70`の離散値)は [tokens.md の余白 (space)](../tokens.md#余白-space) を参照。
|
|
157
157
|
|
|
158
158
|
### 余白 — Margin
|
|
159
159
|
|
|
@@ -31,6 +31,7 @@ hover 時の挙動を制御する Property Class。`:hover` 擬似クラスで
|
|
|
31
31
|
| `-hov:-bgc` | `background-color` | `var(--hov-bgc, var(--hov-bgc--default, color-mix(in srgb, var(--bgc, var(--base)), var(--neutral) 25%)))` |
|
|
32
32
|
| `-hov:-o` | `opacity` | `var(--hov-o, var(--o--p))` |
|
|
33
33
|
| `-hov:-bxsh` | `box-shadow` | `var(--hov-bxsh, var(--bxsh--50))` |
|
|
34
|
+
| `-hov:-transform` | `transform` | `var(--hov-transform, translate(0, -4px))` |
|
|
34
35
|
|
|
35
36
|
任意の値へ変化させたい場合は、`--hov-{prop}` 変数で値を指定する。
|
|
36
37
|
|
|
@@ -107,7 +107,7 @@ Lism CSS のボーダーは CSS 変数(`--bds` / `--bdw` / `--bdc`)で管理
|
|
|
107
107
|
| `-hov:{preset}` | hover 時のスタイルをプリセットで適用 | `:hover`(同上) |
|
|
108
108
|
| `-hov:in:{preset}` | 親の `set--hov` を起点に子のスタイルを変化させる | 親に `set--hov` が必要 |
|
|
109
109
|
|
|
110
|
-
**標準クラス:** `-hov:-c`, `-hov:-bgc`, `-hov:-bdc`, `-hov:-o`, `-hov:-bxsh`, `-hov:underline`, `-hov:in:hide`, `-hov:in:show`, `-hov:in:zoom`
|
|
110
|
+
**標準クラス:** `-hov:-c`, `-hov:-bgc`, `-hov:-bdc`, `-hov:-o`, `-hov:-bxsh`, `-hov:-transform`, `-hov:underline`, `-hov:in:hide`, `-hov:in:show`, `-hov:in:zoom`
|
|
111
111
|
|
|
112
112
|
**`<Lism>` の `hov` prop:** 文字列指定(`hov="-c"` → `-hov:-c`。自動変換なし、カンマ区切りで複数可)とオブジェクト指定(`hov={{ c: 'red' }}` → `-hov:-c` + `--hov-c: var(--red)`。値 `true` でクラスのみ出力)が可能。
|
|
113
113
|
|
|
@@ -40,7 +40,7 @@ import { Group, Wrapper, Cluster, Link } from 'lism-css/astro';
|
|
|
40
40
|
```jsx
|
|
41
41
|
import { Group, Wrapper, Stack, Cluster, Heading, Text } from 'lism-css/astro';
|
|
42
42
|
|
|
43
|
-
<Group as="section" className="c--frontHero" bgc="base-2" py={['60', null, '
|
|
43
|
+
<Group as="section" className="c--frontHero" bgc="base-2" py={['60', null, '70']} hasGutter isContainer>
|
|
44
44
|
<Wrapper contentSize="l">
|
|
45
45
|
<Stack g="30" ai="center" ta="center">
|
|
46
46
|
<Heading level="1" fz={['3xl', null, '5xl']}>キャッチコピー</Heading>
|
|
@@ -191,7 +191,7 @@ Lism CSSでは、クラスを持つリスト(`ul` / `ol`)ではスタイル
|
|
|
191
191
|
|
|
192
192
|
## `set--s`
|
|
193
193
|
|
|
194
|
-
余白トークン(`--s5`〜`--
|
|
194
|
+
余白トークン(`--s5`〜`--s70`)を現在のフォントサイズ基準で再計算するためのクラスです。ButtonやBadgeなど、内部余白を要素自身のfont-sizeに追従させたい時に利用します。
|
|
195
195
|
|
|
196
196
|
詳細なスケールと使い方は[tokens.mdの`set--s`ユーティリティ](./tokens.md#set--s-ユーティリティ)を参照してください。
|
|
197
197
|
|
|
@@ -30,7 +30,7 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
|
|
|
30
30
|
|
|
31
31
|
| カテゴリ | トークン値 | CSS変数パターン | 例 |
|
|
32
32
|
| --- | --- | --- | --- |
|
|
33
|
-
| 余白 (space) | `5`, `10`, `15`, `20`, `25`, `30`, `35`, `40`, `50`, `60`, `70
|
|
33
|
+
| 余白 (space) | `5`, `10`, `15`, `20`, `25`, `30`, `35`, `40`, `45`, `50`, `60`, `70` | `--s{N}` | `--s20` |
|
|
34
34
|
| フォントサイズ (fz) | `base`, `2xs`, `xs`, `s`, `m`, `l`, `xl`, `2xl`, `3xl`, `4xl`, `5xl` | `--fz--{key}` | `--fz--l` |
|
|
35
35
|
| ハーフレディング (hl) | `base`, `xs`, `s`, `l`, `xl` | `--hl--{key}` | `--hl--s` |
|
|
36
36
|
| 行間比率 (lh) | `xs`, `s`, `m`, `l`, `xl` | `--lh--{key}` | `--lh--m` |
|
|
@@ -64,16 +64,16 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
|
|
|
64
64
|
| `--s30` | `calc(var(--s-unit) * 3)` | ≒ 24px |
|
|
65
65
|
| `--s35` | `calc(var(--s-unit) * 4)` | ≒ 32px |
|
|
66
66
|
| `--s40` | `calc(var(--s-unit) * 5)` | ≒ 40px |
|
|
67
|
+
| `--s45` | `calc(var(--s-unit) * 6.5)` | ≒ 52px |
|
|
67
68
|
| `--s50` | `calc(var(--s-unit) * 8)` | ≒ 64px |
|
|
68
69
|
| `--s60` | `calc(var(--s-unit) * 13)` | ≒ 104px |
|
|
69
70
|
| `--s70` | `calc(var(--s-unit) * 21)` | ≒ 168px |
|
|
70
|
-
| `--s80` | `calc(var(--s-unit) * 34)` | ≒ 272px |
|
|
71
71
|
|
|
72
|
-
|
|
72
|
+
10 刻みの主軸は係数 `1, 2, 3, 5, 8, 13, 21`(フィボナッチ数列)に基づき、タイポグラフィの縦のリズムを作る。5 刻み(`--s5`〜`--s45`)は主軸トークン間のちょうど中間値(4px / 12px / 20px / 32px / 52px 相当)で、縦のリズムに縛られない水平方向の gap / padding 用。中間値は `50` まで。`--s-unit` を上書きするとスケール全体を比例的に調整できる。`--fz--base` を流体値にしていて余白も連動させたい場合は、`:root` で `--s-unit: calc(var(--fz--base) * 0.5)` に上書きする。
|
|
73
73
|
|
|
74
74
|
### `set--s` ユーティリティ
|
|
75
75
|
|
|
76
|
-
`set--s` クラスを当てた要素のスコープ内では `--s-unit` が `0.5em` に切り替わり、`--s10`〜`--
|
|
76
|
+
`set--s` クラスを当てた要素のスコープ内では `--s-unit` が `0.5em` に切り替わり、`--s10`〜`--s70` が現在のフォントサイズ基準で再計算される。Button / Badge / インライン要素など、内部余白をフォントサイズに追従させたい部品で使う。
|
|
77
77
|
|
|
78
78
|
```html
|
|
79
79
|
<!-- ボタンの padding が button 自身の font-size に追従する -->
|
|
@@ -139,11 +139,13 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
|
|
|
139
139
|
|
|
140
140
|
| CSS変数 | 値 | 説明 |
|
|
141
141
|
| --- | --- | --- |
|
|
142
|
-
| `--lts--base` | `
|
|
143
|
-
| `--lts--xs` |
|
|
144
|
-
| `--lts--s` |
|
|
145
|
-
| `--lts--l` | `0.05em` | 広めの文字間隔 |
|
|
146
|
-
| `--lts--xl` | `0.1em` | より広い文字間隔 |
|
|
142
|
+
| `--lts--base` | `0em` | 基本の文字間隔。長さで指定(`normal` 不可) |
|
|
143
|
+
| `--lts--xs` | `calc(var(--lts--base) - 0.05em)` | より狭い文字間隔 |
|
|
144
|
+
| `--lts--s` | `calc(var(--lts--base) - 0.025em)` | 狭めの文字間隔 |
|
|
145
|
+
| `--lts--l` | `calc(var(--lts--base) + 0.05em)` | 広めの文字間隔 |
|
|
146
|
+
| `--lts--xl` | `calc(var(--lts--base) + 0.1em)` | より広い文字間隔 |
|
|
147
|
+
|
|
148
|
+
`xs`〜`xl` は `--lts--base` からの相対値。`:root` で `--lts--base` を変えると全体が連動する(子孫要素での上書きは `xs`〜`xl` に伝わらない)。
|
|
147
149
|
|
|
148
150
|
|
|
149
151
|
## フォント (ff)
|
|
@@ -29,8 +29,6 @@ Lism コンポーネントでの `util` prop による指定方法は [component
|
|
|
29
29
|
| `u--trim` | ハーフレディングのネガティブマージンでテキスト上下の余白を詰める | [`_trim.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_trim.scss) |
|
|
30
30
|
| `u--trimAll` | 直下の子要素(`:empty`, `figure`, `picture`, `video`, `button`, `textarea`, `table` を除く)にハーフレディングトリムを一括適用する除外方式のクラス | [`_trim.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_trim.scss) |
|
|
31
31
|
| `u--cbox` | `--keycolor` を使い `color-mix()` で `--c` / `--bgc` / `--bdc` を自動生成する色付きボックス | [`_cbox.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_cbox.scss) |
|
|
32
|
-
| `u--divide` | Grid / Flex の子要素**間**にのみ `box-shadow` で区切り線を表示する | [`_divide.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_divide.scss) |
|
|
33
|
-
| `u--enclose` | Grid / Flex の各子要素を `box-shadow` で枠囲みし、table セル風に表示する | [`_divide.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_divide.scss) |
|
|
34
32
|
| `u--srOnly` | スクリーンリーダー専用(視覚的に非表示)。`clip-path: inset(50%)` で実装 | [`_srOnly.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_srOnly.scss) |
|
|
35
33
|
| `u--clipText` | テキストで背景をクリッピング(`background-clip: text`) | [`_clipText.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_clipText.scss) |
|
|
36
34
|
|
|
@@ -43,19 +41,12 @@ Lism コンポーネントでの `util` prop による指定方法は [component
|
|
|
43
41
|
|
|
44
42
|
<!-- u--trim: テキスト余白の詰め -->
|
|
45
43
|
<p class="u--trim">テキスト...</p>
|
|
46
|
-
|
|
47
|
-
<!-- u--divide: グリッド子要素間の区切り線 -->
|
|
48
|
-
<div class="l--grid u--divide" style="--gtc: 1fr 1fr">
|
|
49
|
-
<div>A</div>
|
|
50
|
-
<div>B</div>
|
|
51
|
-
</div>
|
|
52
44
|
```
|
|
53
45
|
|
|
54
46
|
```jsx
|
|
55
47
|
// JSX での使用(className で指定)
|
|
56
48
|
<Lism className="u--cbox" keycolor="red" bd p="20">...</Lism>
|
|
57
49
|
<Text className="u--trim">テキスト...</Text>
|
|
58
|
-
<Grid className="u--divide" gtc="1fr 1fr">...</Grid>
|
|
59
50
|
```
|
|
60
51
|
|
|
61
52
|
|
|
@@ -64,6 +55,7 @@ Lism コンポーネントでの `util` prop による指定方法は [component
|
|
|
64
55
|
コアには含まれないが、ドキュメントで紹介されている追加ユーティリティの例:
|
|
65
56
|
|
|
66
57
|
- `u--inlineCenter`: 絵文字やインラインアイコンをテキスト中央に揃える
|
|
58
|
+
- `u--divide` / `u--enclose`: Grid / Flex の子要素間の区切り線・セル枠を `gap` と子要素の `box-shadow` で描く。描画が `border` より粗く、並び方向が切り替わるレイアウトでは `bdw` のブレイクポイント切り替えを優先する
|
|
67
59
|
|
|
68
60
|
これらは必要に応じて自分で CSS を追加して使用します。
|
|
69
61
|
|