@lism-css/mcp 0.15.0 → 0.15.1
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 +53 -32
- package/dist/data/guides/SKILL.md +20 -10
- package/dist/data/guides/antipatterns.md +147 -0
- package/dist/data/guides/base-styles.md +1 -1
- package/dist/data/guides/components-core.md +4 -4
- package/dist/data/guides/components-ui.md +2 -2
- package/dist/data/guides/css-rules.md +26 -26
- package/dist/data/guides/customize.md +1 -1
- package/dist/data/guides/naming.md +13 -8
- package/dist/data/guides/primitive-class.md +79 -4
- package/dist/data/guides/primitives/a--decorator.md +1 -1
- package/dist/data/guides/primitives/a--divider.md +1 -1
- package/dist/data/guides/primitives/a--icon.md +1 -1
- package/dist/data/guides/primitives/a--spacer.md +1 -1
- package/dist/data/guides/primitives/l--autoColumns.md +71 -0
- package/dist/data/guides/primitives/l--box.md +1 -1
- package/dist/data/guides/primitives/l--center.md +1 -1
- package/dist/data/guides/primitives/l--cluster.md +2 -2
- package/dist/data/guides/primitives/l--columns.md +3 -3
- package/dist/data/guides/primitives/l--flex.md +1 -1
- package/dist/data/guides/primitives/l--flow.md +4 -4
- package/dist/data/guides/primitives/l--frame.md +1 -1
- package/dist/data/guides/primitives/l--grid.md +2 -2
- package/dist/data/guides/primitives/l--stack.md +1 -1
- package/dist/data/guides/primitives/{l--switchCols.md → l--switchColumns.md} +18 -18
- package/dist/data/guides/primitives/l--tileGrid.md +2 -2
- package/dist/data/guides/primitives/{l--sideMain.md → l--withSide.md} +41 -19
- package/dist/data/guides/prop-responsive.md +1 -1
- package/dist/data/guides/property-class/bd.md +4 -4
- package/dist/data/guides/property-class/hov.md +18 -18
- package/dist/data/guides/property-class/max-sz.md +5 -5
- package/dist/data/guides/property-class.md +8 -8
- package/dist/data/guides/set-class.md +2 -2
- package/dist/data/guides/tokens.md +8 -5
- package/dist/data/guides/trait-class/has--gutter.md +2 -2
- package/dist/data/guides/trait-class/has--mask.md +2 -2
- package/dist/data/guides/trait-class/has--snap.md +2 -2
- package/dist/data/guides/trait-class/has--transition.md +2 -2
- package/dist/data/guides/trait-class/is--boxLink.md +2 -2
- package/dist/data/guides/trait-class/is--container.md +11 -5
- package/dist/data/guides/trait-class/is--layer.md +5 -5
- package/dist/data/guides/trait-class/is--wrapper.md +8 -8
- package/dist/data/guides/trait-class.md +2 -2
- package/dist/data/guides/utility-class.md +9 -8
- package/dist/data/meta.js +2 -2
- package/dist/tools/get-guide.js +8 -1
- package/package.json +1 -1
- package/dist/data/guides/primitives/l--fluidCols.md +0 -71
|
@@ -7,32 +7,32 @@ hover 時の挙動を制御する Property Class。`:hover` 擬似クラスで
|
|
|
7
7
|
- クラス名: `-hov:-{prop}` / `-hov:{preset}` / `-hov:in:{preset}`
|
|
8
8
|
- Lism props: `hov`(`<Lism hov="-c">` / `<Box hov={{ bgc: 'brand' }}>` 等)
|
|
9
9
|
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/props/_hover.scss
|
|
10
|
-
-
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/property-class/hov.md
|
|
11
11
|
|
|
12
12
|
## 3 つの形式
|
|
13
13
|
|
|
14
14
|
| 形式 | 役割 |
|
|
15
15
|
|------|------|
|
|
16
|
-
|
|
|
17
|
-
|
|
|
18
|
-
|
|
|
16
|
+
| `-hov:-{prop}` | `--hov-{prop}` 変数を受け取り、hover 時に該当プロパティを変化させる |
|
|
17
|
+
| `-hov:{preset}` | hover 時のスタイルセットをプリセット名でまとめて適用する |
|
|
18
|
+
| `-hov:in:{preset}` | 親要素の `set--var:hov` を起点に、子要素のスタイルを変化させる |
|
|
19
19
|
|
|
20
20
|
`-hov:-{prop}` と `-hov:{preset}` は `@media (any-hover: hover)` 内で定義されるため、タッチデバイスでは無効。
|
|
21
21
|
`-hov:in:*` はメディアクエリ外で、親の `set--var:hov` がセットする `--_isHov` / `--_notHov` 変数で動作する。
|
|
22
22
|
|
|
23
23
|
トランジションを付けたい場合は [`has--transition`](../trait-class/has--transition.md) クラスを併用する。
|
|
24
24
|
|
|
25
|
-
##
|
|
25
|
+
## `-hov:-{prop}` — プロパティ変更
|
|
26
26
|
|
|
27
27
|
`:hover` で直接動作する。クラスを付けるだけで初期値で変化する。
|
|
28
28
|
|
|
29
29
|
| クラス | 変化するプロパティ | 初期値 |
|
|
30
30
|
|--------|----------------------|--------|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
34
|
-
|
|
|
35
|
-
|
|
|
31
|
+
| `-hov:-c` | `color` | `var(--hov-c, var(--link))` |
|
|
32
|
+
| `-hov:-bdc` | `border-color` | `var(--hov-bdc, currentColor)` |
|
|
33
|
+
| `-hov:-bgc` | `background-color` | `var(--hov-bgc, var(--base-2))` |
|
|
34
|
+
| `-hov:-o` | `opacity` | `var(--hov-o, var(--o--p))` |
|
|
35
|
+
| `-hov:-bxsh` | `box-shadow` | `var(--hov-bxsh, var(--bxsh--50))` |
|
|
36
36
|
|
|
37
37
|
任意の値へ変化させたい場合は、`--hov-{prop}` 変数で値を指定する。
|
|
38
38
|
|
|
@@ -45,14 +45,14 @@ hover 時の挙動を制御する Property Class。`:hover` 擬似クラスで
|
|
|
45
45
|
style="--hov-bgc: var(--brand); --hov-c: var(--white)" href="###">...</a>
|
|
46
46
|
```
|
|
47
47
|
|
|
48
|
-
##
|
|
48
|
+
## `-hov:{preset}` — プリセット
|
|
49
49
|
|
|
50
50
|
hover 時のスタイルセットをプリセット名でまとめて適用する。
|
|
51
51
|
|
|
52
52
|
| クラス | 内容 |
|
|
53
53
|
|--------|------|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
54
|
+
| `-hov:underline` | テキストに下線を表示 |
|
|
55
|
+
| `-hov:neutral` | 背景色にニュートラルグレーをブレンド |
|
|
56
56
|
|
|
57
57
|
プロジェクト固有のプリセットは、以下のように自作して追加できる。
|
|
58
58
|
|
|
@@ -65,15 +65,15 @@ hover 時のスタイルセットをプリセット名でまとめて適用す
|
|
|
65
65
|
}
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
##
|
|
68
|
+
## `-hov:in:{preset}` — 親連動
|
|
69
69
|
|
|
70
70
|
親要素に `set--var:hov` を付けると、`--_isHov` / `--_notHov` 変数が hover 状態に応じて切り替わる。`-hov:in:*` はこの変数を参照する仕組み。
|
|
71
71
|
|
|
72
72
|
| クラス | 効果 | 仕組み |
|
|
73
73
|
|--------|------|--------|
|
|
74
|
-
|
|
|
75
|
-
|
|
|
76
|
-
|
|
|
74
|
+
| `-hov:in:hide` | 親 hover 時にフェードアウト | `opacity: var(--_isHov, 0)` |
|
|
75
|
+
| `-hov:in:show` | 親 hover 時にフェードイン | `opacity: var(--_notHov, 0)` / `visibility: var(--_notHov, hidden)` |
|
|
76
|
+
| `-hov:in:zoom` | 親 hover 時にズーム | `scale: var(--_isHov, 1.1)` |
|
|
77
77
|
|
|
78
78
|
```jsx
|
|
79
79
|
<Frame set="var:hov" isBoxLink href="#" ar="16/9">
|
|
@@ -103,7 +103,7 @@ hover 時のスタイルセットをプリセット名でまとめて適用す
|
|
|
103
103
|
|
|
104
104
|
### オブジェクト指定
|
|
105
105
|
|
|
106
|
-
主に
|
|
106
|
+
主に `-hov:-{prop}` に任意の値を渡す用途。`hov={{ prop: value }}` で `-hov:-{prop}` クラス + `--hov-{prop}` 変数を出力。
|
|
107
107
|
|
|
108
108
|
```jsx
|
|
109
109
|
<Lism hov={{ c: 'red' }}>...</Lism>
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
- クラス名: `-max-sz:{xs|s|m|l|xl|full|container}`
|
|
8
8
|
- Lism props: `max-sz`(`<Lism max-sz="m">` 等)
|
|
9
9
|
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/props/_size.scss
|
|
10
|
-
-
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/property-class/max-sz.md
|
|
11
11
|
|
|
12
12
|
## トークン対応クラス
|
|
13
13
|
|
|
@@ -25,7 +25,7 @@
|
|
|
25
25
|
|
|
26
26
|
### `-max-sz:full`
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
**親要素のサイズいっぱいに広がる**クラス。`has--gutter` の直下では、その gutter 分を**追加で外側に**拡張する(= gutter を無視して端まで広がる)。
|
|
29
29
|
|
|
30
30
|
```scss
|
|
31
31
|
.-max-sz\:full {
|
|
@@ -38,11 +38,11 @@
|
|
|
38
38
|
}
|
|
39
39
|
```
|
|
40
40
|
|
|
41
|
-
|
|
41
|
+
`has--gutter` の内側で全幅画像・全幅バナーなどを配置したい時に使う。
|
|
42
42
|
|
|
43
43
|
### `-max-sz:container`
|
|
44
44
|
|
|
45
|
-
|
|
45
|
+
**コンテナ要素を基準としたサイズ**まで広がる。`is--container` ごとに `--sz--container` が更新されるため、直近の container を基準にサイズ決定される。
|
|
46
46
|
|
|
47
47
|
```scss
|
|
48
48
|
.-max-sz\:container {
|
|
@@ -64,7 +64,7 @@
|
|
|
64
64
|
<div class="-max-sz:m -mx:auto" style="max-inline-size: var(--sz--m)">...</div>
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
-
###
|
|
67
|
+
### `has--gutter` 内の全幅要素
|
|
68
68
|
|
|
69
69
|
```html
|
|
70
70
|
<div class="has--gutter">
|
|
@@ -16,7 +16,7 @@ CSS Layer の外(最も高い詳細度)に配置され、`-{prop}(:{value})`
|
|
|
16
16
|
- [Property Class の特殊な出力タイプ](#property-class-の特殊な出力タイプ)
|
|
17
17
|
- [Property Class の検索・一括修正](#property-class-の検索一括修正)
|
|
18
18
|
|
|
19
|
-
[詳細](https://lism-css.com/docs/property-class
|
|
19
|
+
[詳細](https://lism-css.com/docs/property-class.md)
|
|
20
20
|
|
|
21
21
|
個別ドキュメント:
|
|
22
22
|
|
|
@@ -84,7 +84,7 @@ CSS Layer の外(最も高い詳細度)に配置され、`-{prop}(:{value})`
|
|
|
84
84
|
| Prop | CSS プロパティ | プリセット値クラス | BP クラス |
|
|
85
85
|
|------|--------------|-------------|-----|
|
|
86
86
|
| `d` | `display` | `-d:none`, `-d:block`, `-d:flex`, `-d:inline-flex`, `-d:grid`, `-d:inline-grid`, `-d:inline`, `-d:inline-block` | `-d_sm`, `-d_md` |
|
|
87
|
-
| `o` | `opacity` | `-o:0`, `-o
|
|
87
|
+
| `o` | `opacity` | `-o:0`, `-o:mp`, `-o:p`, `-o:pp`, `-o:ppp` | — |
|
|
88
88
|
| `v` | `visibility` | `-v:hidden` | — |
|
|
89
89
|
| `ov` | `overflow` | `-ov:hidden`, `-ov:auto`, `-ov:clip` | — |
|
|
90
90
|
| `ov-x` | `overflow-x` | `-ov-x:clip`, `-ov-x:auto`, `-ov-x:scroll` | — |
|
|
@@ -109,7 +109,7 @@ CSS Layer の外(最も高い詳細度)に配置され、`-{prop}(:{value})`
|
|
|
109
109
|
| `max-bsz` | `max-block-size` | — | — |
|
|
110
110
|
|
|
111
111
|
**`max-sz` の特殊クラス:**
|
|
112
|
-
- `-max-sz:full` —
|
|
112
|
+
- `-max-sz:full` — `has--gutter` 内では gutter 分を含めた全幅に拡張
|
|
113
113
|
- `-max-sz:container` — コンテナ幅に合わせる(`margin-inline` で中央配置)
|
|
114
114
|
|
|
115
115
|
→ 詳細は [property-class/max-sz.md](./property-class/max-sz.md) 参照
|
|
@@ -275,7 +275,7 @@ SPACE トークン(全値): `5`, `10`, `15`, `20`, `30`, `40`, `50`, `60`, `
|
|
|
275
275
|
|
|
276
276
|
## 特殊な Property Class
|
|
277
277
|
|
|
278
|
-
以下は通常の
|
|
278
|
+
以下は通常の `-{prop}:{value}` パターンとは異なる特殊な仕組みを持つ Prop です。
|
|
279
279
|
|
|
280
280
|
### ボーダー(`bd` 系)
|
|
281
281
|
|
|
@@ -296,11 +296,11 @@ Lism CSS のボーダーは CSS 変数(`--bds` / `--bdw` / `--bdc`)で管理
|
|
|
296
296
|
|
|
297
297
|
| 形式 | 役割 | 動作条件 |
|
|
298
298
|
|------|------|---------|
|
|
299
|
-
|
|
|
300
|
-
|
|
|
301
|
-
|
|
|
299
|
+
| `-hov:-{prop}` | `--hov-{prop}` 変数で hover 時の値を変化させる | `:hover`(`@media (any-hover: hover)` 内) |
|
|
300
|
+
| `-hov:{preset}` | hover 時のスタイルをプリセットで適用 | `:hover`(同上) |
|
|
301
|
+
| `-hov:in:{preset}` | 親の `set--var:hov` を起点に子のスタイルを変化させる | 親に `set--var:hov` が必要 |
|
|
302
302
|
|
|
303
|
-
**標準プリセット:**
|
|
303
|
+
**標準プリセット:** `-hov:-c`, `-hov:-bgc`, `-hov:-bdc`, `-hov:-o`, `-hov:-bxsh`, `-hov:underline`, `-hov:neutral`, `-hov:in:hide`, `-hov:in:show`, `-hov:in:zoom`
|
|
304
304
|
|
|
305
305
|
**`<Lism>` の `hov` prop:** 文字列指定(`hov="-c"` → `-hov:-c`。自動変換なし、カンマ区切りで複数可)とオブジェクト指定(`hov={{ c: 'red' }}` → `-hov:-c` + `--hov-c: var(--red)`。値 `true` でクラスのみ出力)が可能。
|
|
306
306
|
|
|
@@ -22,7 +22,7 @@ set-- は目的別に 2 カテゴリに分かれます。
|
|
|
22
22
|
- [`set--var:hov`](#set--varhov)
|
|
23
23
|
- [`set--var:bdrsInner`](#set--varbdrsinner)
|
|
24
24
|
|
|
25
|
-
[詳細](https://lism-css.com/docs/set-class
|
|
25
|
+
[詳細](https://lism-css.com/docs/set-class.md)
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
|
@@ -114,7 +114,7 @@ Lism CSSでは、クラスを持つリスト(`ul` / `ol`)ではスタイル
|
|
|
114
114
|
.-hov\:test {
|
|
115
115
|
color: var(--_isHov, green) var(--_notHov, red); /* hover時はgreen, 非hover時はred*/
|
|
116
116
|
box-shadow: var(--_isHov, var(--bxsh--30)); /* hover時はshadowをつける(非hover時は無効な値) */
|
|
117
|
-
opacity: var(--_notHov, var(--o
|
|
117
|
+
opacity: var(--_notHov, var(--o--pp)); /* 非hover時は不透明度を下げる(hover時は無効な値) */
|
|
118
118
|
}
|
|
119
119
|
```
|
|
120
120
|
|
|
@@ -20,7 +20,7 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
|
|
|
20
20
|
- [カラー](#カラー)
|
|
21
21
|
- [トークン値の命名規則](#トークン値の命名規則)
|
|
22
22
|
|
|
23
|
-
[詳細](https://lism-css.com/docs/tokens
|
|
23
|
+
[詳細](https://lism-css.com/docs/tokens.md)
|
|
24
24
|
|
|
25
25
|
---
|
|
26
26
|
|
|
@@ -34,7 +34,7 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
|
|
|
34
34
|
| 字間 (lts) | `base`, `s`, `l` | `--lts--{key}` | `--lts--s` |
|
|
35
35
|
| フォント (ff) | `base`, `accent`, `mono` | `--ff--{key}` | `--ff--mono` |
|
|
36
36
|
| ウェイト (fw) | `light`, `normal`, `bold` | `--fw--{key}` | `--fw--bold` |
|
|
37
|
-
| 透明度 (o) |
|
|
37
|
+
| 透明度 (o) | `mp`, `p`, `pp`, `ppp` | `--o--{key}` | `--o--p` |
|
|
38
38
|
| 角丸 (bdrs) | `10`, `20`, `30`, `40`, `99`, `inner` | `--bdrs--{key}` | `--bdrs--20` |
|
|
39
39
|
| 影 (bxsh) | `10`, `20`, `30`, `40`, `50` | `--bxsh--{N}` | `--bxsh--20` |
|
|
40
40
|
| サイズ (sz) | `xs`, `s`, `m`, `l`, `xl`, `container` | `--sz--{key}` | `--sz--l` |
|
|
@@ -132,11 +132,14 @@ CSSコードを書く場合やコンポーネントのPropsに値を指定する
|
|
|
132
132
|
|
|
133
133
|
## 透明度 (o)
|
|
134
134
|
|
|
135
|
+
音楽の強弱記号(piano 系列)に由来するセマンティック命名を採用。`p`(piano / 弱く)の反復回数が多いほど透明度が増す。Lism 内で「文字の反復回数で段階を表す」命名は opacity のみの例外。
|
|
136
|
+
|
|
135
137
|
| CSS変数 | 値 | 説明 |
|
|
136
138
|
|---------|-----|------|
|
|
137
|
-
| `--o
|
|
138
|
-
| `--o
|
|
139
|
-
| `--o
|
|
139
|
+
| `--o--mp` | `0.9` | mezzo-piano: ごく軽い減衰 |
|
|
140
|
+
| `--o--p` | `0.75` | piano: hover fade, 補助テキスト等 |
|
|
141
|
+
| `--o--pp` | `0.5` | pianissimo: disabled, divider, decorator 等 |
|
|
142
|
+
| `--o--ppp` | `0.25` | pianississimo: 最も強く減衰 |
|
|
140
143
|
|
|
141
144
|
|
|
142
145
|
## 角丸 (bdrs)
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `has--gutter`
|
|
8
8
|
- Lism props: `hasGutter`(`<Lism hasGutter>` 等)
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/has/_gutter.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class.md#has--gutter
|
|
11
11
|
|
|
12
12
|
## SCSS 定義
|
|
13
13
|
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `has--mask`
|
|
8
8
|
- Lism props: `hasMask`(`<Lism hasMask>` 等)
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/has/_mask.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class.md#has--mask
|
|
11
11
|
|
|
12
12
|
## SCSS 定義
|
|
13
13
|
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `has--snap`
|
|
8
8
|
- Lism props: `hasSnap`(`<Lism hasSnap>` 等)
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/has/_snap.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class.md#has--snap
|
|
11
11
|
|
|
12
12
|
## SCSS 定義
|
|
13
13
|
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `has--transition`
|
|
8
8
|
- Lism props: `hasTransition`(`<Lism hasTransition>` / `<Box hasTransition>` 等)
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/has/_transition.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class.md#has--transition
|
|
11
11
|
|
|
12
12
|
## SCSS 定義
|
|
13
13
|
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `is--boxLink`
|
|
8
8
|
- コンポーネント: `<BoxLink>`
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/_boxLink.scss
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_boxLink.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--boxLink.md
|
|
11
11
|
|
|
12
12
|
## 専用Props
|
|
13
13
|
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `is--container`
|
|
8
8
|
- コンポーネント: `<Container>`
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/_container.scss
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_container.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--container.md
|
|
11
11
|
|
|
12
12
|
## 使い方
|
|
13
13
|
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
|
|
16
16
|
| Prop | 出力 |
|
|
17
17
|
|------|------|
|
|
18
|
-
| `isContainer` |
|
|
18
|
+
| `isContainer` | `is--container` |
|
|
19
19
|
|
|
20
20
|
## Usage
|
|
21
21
|
|
|
@@ -39,8 +39,14 @@
|
|
|
39
39
|
|
|
40
40
|
子要素側は `p={['10', '30']}` のようなブレイクポイント配列指定にすることで、親の `is--container` を基準としたコンテナクエリで値が切り替わります。
|
|
41
41
|
|
|
42
|
+
## `--sz--container` の提供
|
|
43
|
+
|
|
44
|
+
`is--container` は直下の子要素に `--sz--container: 100cqi` をセットします。`-max-sz:container` はこの値を参照しており、`is--container` 基準の幅まで広がります。
|
|
45
|
+
|
|
46
|
+
`has--gutter` と併用した場合は `calc(100cqi + var(--gutter-size) * 2)` に自動調整され、gutter 分を含めた端〜端の幅になります。
|
|
47
|
+
|
|
42
48
|
## 関連プリミティブ
|
|
43
49
|
|
|
44
50
|
- [is--wrapper](./is--wrapper.md) — コンテンツ幅ラッパー(`isContainer` と併用可)
|
|
45
|
-
- [l--flow](
|
|
46
|
-
- [l--box](
|
|
51
|
+
- [l--flow](../primitives/l--flow.md) — 記事コンテンツ向けフローレイアウト
|
|
52
|
+
- [l--box](../primitives/l--box.md) — 汎用ボックス
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `is--layer`
|
|
8
8
|
- コンポーネント: `<Layer>`
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/_layer.scss
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_layer.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--layer.md
|
|
11
11
|
|
|
12
12
|
## 使い方
|
|
13
13
|
|
|
@@ -66,6 +66,6 @@
|
|
|
66
66
|
|
|
67
67
|
## 関連プリミティブ
|
|
68
68
|
|
|
69
|
-
- [l--frame](
|
|
70
|
-
- [l--grid](
|
|
71
|
-
- [l--center](
|
|
69
|
+
- [l--frame](../primitives/l--frame.md) — `isLayer` 併用でメディア背景のレイヤー化
|
|
70
|
+
- [l--grid](../primitives/l--grid.md) — `ga="1/1"` で position を使わずに重ね配置する代替パターン
|
|
71
|
+
- [l--center](../primitives/l--center.md) — レイヤー内のコンテンツ中央寄せ
|
|
@@ -6,8 +6,8 @@
|
|
|
6
6
|
|
|
7
7
|
- クラス名: `is--wrapper`
|
|
8
8
|
- コンポーネント: `<Wrapper>`
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/_wrapper.scss
|
|
10
|
-
-
|
|
9
|
+
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/trait/is/_wrapper.scss
|
|
10
|
+
- 公式ドキュメント: https://lism-css.com/docs/trait-class/is--wrapper.md
|
|
11
11
|
|
|
12
12
|
## 使い方
|
|
13
13
|
|
|
@@ -15,10 +15,10 @@
|
|
|
15
15
|
|
|
16
16
|
| 指定 | 出力 |
|
|
17
17
|
|------|------|
|
|
18
|
-
| `isWrapper` |
|
|
19
|
-
| `isWrapper="s"` |
|
|
20
|
-
| `isWrapper="l"` |
|
|
21
|
-
| `isWrapper="20rem"`(任意値) |
|
|
18
|
+
| `isWrapper` | `is--wrapper` |
|
|
19
|
+
| `isWrapper="s"` | `is--wrapper -contentSize:s` |
|
|
20
|
+
| `isWrapper="l"` | `is--wrapper -contentSize:l` |
|
|
21
|
+
| `isWrapper="20rem"`(任意値) | `is--wrapper` + `style="--contentSize: 20rem"` |
|
|
22
22
|
|
|
23
23
|
## 専用Props
|
|
24
24
|
|
|
@@ -83,5 +83,5 @@
|
|
|
83
83
|
## 関連プリミティブ
|
|
84
84
|
|
|
85
85
|
- [is--container](./is--container.md) — コンテナクエリ基準(`isContainer` と併用可)
|
|
86
|
-
- [l--flow](
|
|
87
|
-
- [l--box](
|
|
86
|
+
- [l--flow](../primitives/l--flow.md) — 記事フローレイアウト(`layout="flow"` で結合)
|
|
87
|
+
- [l--box](../primitives/l--box.md) — 汎用ボックス
|
|
@@ -9,7 +9,7 @@ Lism CSS では、要素に対して宣言的に「役割」や「機能」を
|
|
|
9
9
|
- [`is--` Trait(役割宣言)](#is-- trait役割宣言)
|
|
10
10
|
- [`has--` Trait(機能付与)](#has-- trait機能付与)
|
|
11
11
|
|
|
12
|
-
[詳細](https://lism-css.com/docs/trait-class
|
|
12
|
+
[詳細](https://lism-css.com/docs/trait-class.md)
|
|
13
13
|
|
|
14
14
|
---
|
|
15
15
|
|
|
@@ -35,7 +35,7 @@ Lism CSS では、要素に対して宣言的に「役割」や「機能」を
|
|
|
35
35
|
| `is--boxLink` | ボックス全体をクリッカブルなリンク領域にする。自身を`a`タグにして利用するか、もしくは自身を`div`にして内部の`a`タグに`is--coverLink`を付与して使う |
|
|
36
36
|
| `is--coverLink` | 親要素全体に被さるクリック領域を持つリンク(`::before` を `inset: 0` で広げる)。`is--boxLink` と併用する |
|
|
37
37
|
| `is--skipFlow` | `l--flow` 直下で使用し、次の兄弟要素のフロー余白をゼロにする。`l--flow`の中にあるが`position:absolute`にしたい要素などに使用する |
|
|
38
|
-
| `is--side` | `l--
|
|
38
|
+
| `is--side` | `l--withSide` 直下で使用し、サイド側の要素であることを示す |
|
|
39
39
|
|
|
40
40
|
Lism コンポーネントでは `isContainer`, `isLayer` 等の Props として利用できます(例: `<Lism isContainer>`)。
|
|
41
41
|
|
|
@@ -16,7 +16,7 @@ Lism コンポーネントでの `util` prop による指定方法は [component
|
|
|
16
16
|
- [Opt-in ユーティリティ](#opt-in-ユーティリティ)
|
|
17
17
|
- [ユーザー定義のユーティリティクラス](#ユーザー定義のユーティリティクラス)
|
|
18
18
|
|
|
19
|
-
[詳細](https://lism-css.com/docs/utility-class
|
|
19
|
+
[詳細](https://lism-css.com/docs/utility-class.md)
|
|
20
20
|
|
|
21
21
|
---
|
|
22
22
|
|
|
@@ -26,11 +26,12 @@ Lism コンポーネントでの `util` prop による指定方法は [component
|
|
|
26
26
|
|
|
27
27
|
| クラス | 用途 | ソースファイル |
|
|
28
28
|
|--------|------|---------------|
|
|
29
|
-
| `u--trim` | ハーフレディングのネガティブマージンでテキスト上下の余白を詰める | [`
|
|
30
|
-
| `u--
|
|
29
|
+
| `u--trim` | ハーフレディングのネガティブマージンでテキスト上下の余白を詰める | [`_trim.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_trim.scss) |
|
|
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--
|
|
33
|
-
| `u--
|
|
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--cells` | 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
|
+
| `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) |
|
|
34
35
|
| `u--clipText` | テキストで背景をクリッピング(`background-clip: text`) | [`_clipText.scss`](https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/utility/_clipText.scss) |
|
|
35
36
|
|
|
36
37
|
|
|
@@ -43,8 +44,8 @@ Lism コンポーネントでの `util` prop による指定方法は [component
|
|
|
43
44
|
<!-- u--trim: テキスト余白の詰め -->
|
|
44
45
|
<p class="u--trim">テキスト...</p>
|
|
45
46
|
|
|
46
|
-
<!-- u--
|
|
47
|
-
<div class="l--grid u--
|
|
47
|
+
<!-- u--divide: グリッド子要素間の区切り線 -->
|
|
48
|
+
<div class="l--grid u--divide" style="--gtc: 1fr 1fr">
|
|
48
49
|
<div>A</div>
|
|
49
50
|
<div>B</div>
|
|
50
51
|
</div>
|
|
@@ -54,7 +55,7 @@ Lism コンポーネントでの `util` prop による指定方法は [component
|
|
|
54
55
|
// JSX での使用(className で指定)
|
|
55
56
|
<Lism className="u--cbox" keycolor="red" bd p="20">...</Lism>
|
|
56
57
|
<Text className="u--trim">テキスト...</Text>
|
|
57
|
-
<Grid className="u--
|
|
58
|
+
<Grid className="u--divide" gtc="1fr 1fr">...</Grid>
|
|
58
59
|
```
|
|
59
60
|
|
|
60
61
|
|
package/dist/data/meta.js
CHANGED
package/dist/tools/get-guide.js
CHANGED
|
@@ -15,10 +15,17 @@ const GUIDE_TOPICS = {
|
|
|
15
15
|
},
|
|
16
16
|
'base-styles': { file: 'base-styles.md', label: 'Base styling, reset CSS, HTML element styles' },
|
|
17
17
|
'set-class': { file: 'set-class.md', label: 'Set classes (set--plain, set--var:bxsh, set--var:hov, etc.)' },
|
|
18
|
-
'primitive-class': {
|
|
18
|
+
'primitive-class': {
|
|
19
|
+
file: 'primitive-class.md',
|
|
20
|
+
label: 'Primitive class prefixes (is--, l--, a--) and Component class (c--), with column-layout primitive selection guide',
|
|
21
|
+
},
|
|
19
22
|
'utility-class': { file: 'utility-class.md', label: 'Utility classes (u--trim, u--cbox, etc.)' },
|
|
20
23
|
'css-rules': { file: 'css-rules.md', label: 'CSS methodology, layer structure, naming conventions' },
|
|
21
24
|
responsive: { file: 'prop-responsive.md', label: 'Responsive design, breakpoints, container queries' },
|
|
25
|
+
antipatterns: {
|
|
26
|
+
file: 'antipatterns.md',
|
|
27
|
+
label: 'AI code-generation antipatterns: token typos, prop type mistakes, layout choice errors, responsive omissions',
|
|
28
|
+
},
|
|
22
29
|
};
|
|
23
30
|
const TOPIC_DESCRIPTION = Object.entries(GUIDE_TOPICS)
|
|
24
31
|
.map(([key, { label }]) => `- ${key}: ${label}`)
|
package/package.json
CHANGED
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
# l--fluidCols / `<FluidCols>`
|
|
2
|
-
|
|
3
|
-
カラム要素が指定した幅より小さくならないように自動で折り返す、**ブレイクポイント非依存の段組みクラス**。`auto-fit` / `auto-fill` を使った流動カラムを簡潔に記述できます。
|
|
4
|
-
|
|
5
|
-
## 基本情報
|
|
6
|
-
|
|
7
|
-
- クラス名: `l--fluidCols`
|
|
8
|
-
- コンポーネント: `<FluidCols>`
|
|
9
|
-
- SCSSソース: https://raw.githubusercontent.com/lism-css/lism-css/main/packages/lism-css/src/scss/primitives/layout/_fluidCols.scss
|
|
10
|
-
- ドキュメント(人間向け): https://lism-css.com/docs/primitives/l--fluidCols/
|
|
11
|
-
|
|
12
|
-
## 専用Props
|
|
13
|
-
|
|
14
|
-
| Prop | CSS変数 | 説明 |
|
|
15
|
-
|------|--------|------|
|
|
16
|
-
| `cols` | `--cols` | カラムが維持する最小幅を指定(`16em`, `320px` など) |
|
|
17
|
-
| `autoFill` | `--autoMode` | `auto-fill` モードに切り替え(デフォルトは `auto-fit`) |
|
|
18
|
-
|
|
19
|
-
## Usage
|
|
20
|
-
|
|
21
|
-
### `--cols`でサイズを指定する
|
|
22
|
-
|
|
23
|
-
```jsx
|
|
24
|
-
<FluidCols cols="16em" g="20">
|
|
25
|
-
<Lism as="div" p="20" bd>Item A</Lism>
|
|
26
|
-
<Lism as="div" p="20" bd>Item B</Lism>
|
|
27
|
-
<Lism as="div" p="20" bd>Item C</Lism>
|
|
28
|
-
<Lism as="div" p="20" bd>Item D</Lism>
|
|
29
|
-
</FluidCols>
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
```html
|
|
33
|
-
<div class="l--fluidCols -g:20" style="--cols: 16em">
|
|
34
|
-
<div class="-p:20 -bd">Item A</div>
|
|
35
|
-
<div class="-p:20 -bd">Item B</div>
|
|
36
|
-
<div class="-p:20 -bd">Item C</div>
|
|
37
|
-
<div class="-p:20 -bd">Item D</div>
|
|
38
|
-
</div>
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
### `auto-fill`を使用する
|
|
42
|
-
|
|
43
|
-
`l--fluidCols` では、`grid-template-columns` の `repeat()` 関数の第一引数を `--autoMode` で指定できます(デフォルトは `auto-fit`)。`--autoMode:auto-fill`(`autoFill`)を指定することで、要素数が少ない時の挙動が変わります。
|
|
44
|
-
|
|
45
|
-
```jsx
|
|
46
|
-
<FluidCols cols="12em" autoFill g="20" fz="s">
|
|
47
|
-
<Lism as="div" p="20" bd>auto-fill</Lism>
|
|
48
|
-
<Lism as="div" p="20" bd>auto-fill</Lism>
|
|
49
|
-
</FluidCols>
|
|
50
|
-
<FluidCols cols="12em" g="20" fz="s">
|
|
51
|
-
<Lism as="div" p="20" bd>auto-fit</Lism>
|
|
52
|
-
<Lism as="div" p="20" bd>auto-fit</Lism>
|
|
53
|
-
</FluidCols>
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
```html
|
|
57
|
-
<div class="l--fluidCols -g:20 -fz:s" style="--cols:12em; --autoMode:auto-fill">
|
|
58
|
-
<div class="-p:20 -bd">auto-fill</div>
|
|
59
|
-
<div class="-p:20 -bd">auto-fill</div>
|
|
60
|
-
</div>
|
|
61
|
-
<div class="l--fluidCols -g:20 -fz:s" style="--cols:12em">
|
|
62
|
-
<div class="-p:20 -bd">auto-fit</div>
|
|
63
|
-
<div class="-p:20 -bd">auto-fit</div>
|
|
64
|
-
</div>
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
## 関連プリミティブ
|
|
68
|
-
|
|
69
|
-
- [l--columns](./l--columns.md) — ブレイクポイント指定の等幅カラム
|
|
70
|
-
- [l--switchCols](./l--switchCols.md) — 複数列 ↔ 1列の2段階切り替え
|
|
71
|
-
- [l--sideMain](./l--sideMain.md) — メイン幅ベースの2カラム自動切替
|