Base Styles
lism-baseレイヤーで定義されるベーススタイルを紹介します。
Reset CSS
Reset CSS をlism-base.reset レイヤーとして定義しています。
/*
方針:
できるだけブラウザの標準スタイルに従いながら、レイアウト崩れを防止し、最低限のアクセシビリティの確保する。
文書構造を壊して読みづらくなるようなスタイルリセットはしない。
@layer で優先度を下げる。
参考:
https://gist.github.com/EllyLoel/4ff8a6472247e6dd2315fd4038926522
https://keithjgrant.com/posts/2024/01/my-css-resets/
https://www.joshwcomeau.com/css/custom-css-reset/
https://piccalil.li/blog/a-modern-css-reset/
https://codepen.io/argyleink/pen/KKvRORE
*/
@layer reset {
*,
::before,
::after {
/* box-sizing は 全要素に対して border-box で統一 */
box-sizing: border-box;
}
/* margin は(dialog以外)全て 0 にリセットする (padding はリセットしない) */
*:not(dialog) {
margin: 0;
}
/* --------------------------------------------------
Documents
-------------------------------------------------- */
html {
/* iOSで横向きにした時のフォントサイズ自動調節をオフにする */
-webkit-text-size-adjust: none;
text-size-adjust: none;
/* 文章の折り返し指定 🔗:https://ics.media/entry/240411/ */
word-break: normal; /* 単語の分割はデフォルトに依存 */
line-break: strict; /* 禁則処理を厳格に適用 */
overflow-wrap: anywhere; /* 収まらない場合に折り返す */
/* デフォルトの 8 はでかすぎる */
tab-size: 4;
/* 要素はみ出しによる横スクロールの発生を防止. (overflow は 継承プロパティではないので両方記述) */
overflow-x: clip;
/* モーダルが開いている時はコンテンツをスクロールさせない */
&:has(:modal[open]) {
overflow: clip; /* sticky 要素がくずれないように clip */
}
}
body {
/* htmlから継承する */
overflow: inherit;
/* bodyの高さを最低限確保する (子要素でheight:100%が効くわけではない) */
min-height: 100dvh;
}
/* --------------------------------------------------
Texts
-------------------------------------------------- */
abbr[title] {
/* Safar で アンダーラインが出ないので明示的に指定して統一する */
text-decoration: underline;
text-decoration-style: dotted;
}
pre {
/* 水平スクロールできるようにする */
overflow-x: auto;
}
/* クラスを持つリストのみスタイルをリセットする。(ブラウザ標準スタイルを利用できる余地を残す) */
menu,
:is(ul, ol)[class] {
list-style: none;
padding: 0;
}
/* --------------------------------------------------
Medias
-------------------------------------------------- */
svg,
img,
video,
audio,
iframe,
object,
canvas {
/* 隙間ができるのを防ぐ。( display はいじらない。) */
vertical-align: middle;
/* 親要素をはみ出さないようにする */
max-inline-size: 100%;
}
img,
video {
/* img,video の縦横比を維持。(svg,iframe や audioは 高さがつぶれるので指定しない */
block-size: auto;
}
iframe {
border: none;
}
/* --------------------------------------------------
Form Fields
-------------------------------------------------- */
input,
button,
textarea,
select,
::file-selector-button {
/* 基本要素のフォントとカラーを本文から継承 */
font: inherit;
color: inherit;
/* iOSで入力時の拡大を防ぐ. ( button には必要ないが、フォーム全体のフォントサイズを揃えるために一括で適用する ) */
font-size: max(16px, 1em);
}
fieldset {
/* デフォルトの min-content によってコンテンツ( colsの大きい textarea など )がはみ出すのを防ぐ */
min-inline-size: 0;
}
textarea {
/* リサイズ方向を制限する. */
resize: block;
max-inline-size: 100%;
}
/* --------------------------------------------------
cursor 初期セット
-------------------------------------------------- */
label[for],
select,
summary,
[type='radio'],
[type='checkbox'] {
cursor: pointer;
}
button,
[role='tab'],
[role='button'],
[role='option'],
[type='button'],
[type='reset'],
[type='submit'],
::file-selector-button {
cursor: pointer;
/* ダブルタップ時のズームアクションを無効化 */
touch-action: manipulation;
}
:disabled {
cursor: not-allowed;
}
/* --------------------------------------------------
その他
-------------------------------------------------- */
[hidden='until-found'] {
/* 意図せず他の要素の上にかぶってしまうのを防ぐ (until-found は stacking context を生成する) */
z-index: -1;
}
} reset.css ではできるだけブラウザの標準スタイルに従うようにしています。
非常にシンプルで、必要最低限な内容になっています。
Lism CSS の reset.css だけを読み込む方法
import 'lism-css/reset.css';または
<link href="https://cdn.jsdelivr.net/npm/lism-css@0.16.0/dist/css/reset.css" rel="stylesheet" />Base styles
Reset CSS のほか、lism-baseレイヤーでは、:rootで定義したトークンを活用しつつHTMLタグのデフォルトベーススタイルを定義しています。
/* --------------------------------------------------
body
-------------------------------------------------- */
body {
--hl: var(--hl--base);
font-size: var(--fz--base);
font-family: var(--ff--base);
letter-spacing: var(--lts--base);
background-color: var(--base);
color: var(--text);
text-underline-offset: var(--under-offset, 0.125em);
}
/* --------------------------------------------------
line-height
-------------------------------------------------- */
* {
line-height: calc(1em + var(--hl) * 2);
}
/* --------------------------------------------------
Heading
-------------------------------------------------- */
:is(h1, h2, h3, h4, h5, h6) {
font-family: var(--headings-ff, inherit);
font-weight: var(--headings-fw, var(--fw--bold));
}
h1 {
font-size: var(--fz--3xl);
}
h2 {
font-size: var(--fz--2xl);
}
h3 {
font-size: var(--fz--xl);
}
h4 {
font-size: var(--fz--l);
}
h5,
h6 {
font-size: var(--fz--m);
}
/* --------------------------------------------------
texts
-------------------------------------------------- */
a {
color: var(--link-c, var(--link));
text-decoration: var(--link-td, underline);
text-decoration-thickness: var(--link-td-thickness, auto);
text-decoration-color: var(--link-td-color, currentColor);
}
small {
--hl: var(--hl--s);
font-size: var(--fz--xs);
}
b,
strong {
font-weight: var(--fw--bold);
}
sup,
sub {
--hl: var(--hl--xs);
font-size: 80%;
}
code,
kbd,
var,
samp {
font-family: var(--ff--mono);
}
blockquote {
background-color: var(--base-2);
padding: var(--s30);
}
legend,
caption,
figcaption {
font-size: var(--fz--s);
}
hr {
border: none;
block-size: 0;
border-block-start: 1px solid var(--divider);
}
/* --------------------------------------------------
list
-------------------------------------------------- */
// classを持たないリスト要素はブラウザ標準のスタイルを復活させる。
// Property Class だけの ul/ol など、明示的に戻したい場合は `.set--revert` を付与する(base/set/_revert.scss)。
:is(ul, ol):where(:not([class])) {
list-style: revert;
padding-inline-start: var(--list-px-s, 1.75em);
}
dt {
font-weight: var(--fw--bold);
}
dd + dt {
margin-block-start: var(--s20);
}
/* --------------------------------------------------
table
-------------------------------------------------- */
table {
--td-c: inherit;
--td-bgc: transparent;
--td-p: var(--s10);
--td-min-sz: initial;
}
td {
color: var(--td-c);
background-color: var(--td-bgc);
padding: var(--td-p);
min-inline-size: var(--td-min-sz);
}
th {
// デフォルト: tdと同じスタイル
color: var(--th-c, var(--td-c));
background-color: var(--th-bgc, var(--td-bgc));
padding: var(--th-p, var(--td-p));
min-inline-size: var(--th-min-sz, var(--td-min-sz));
}
/* --------------------------------------------------
Form fields
-------------------------------------------------- */
input,
button,
textarea,
select,
::file-selector-button {
// フォーム系コントロールの最低限の見た目(テーマ差し替えは --controls-*)
background-color: var(--controls-bgc, var(--base-2));
border: solid 1px var(--controls-bdc, var(--divider));
padding: var(--controls-p, var(--s5) var(--s10));
border-radius: var(--controls-bdrs, var(--bdrs--10));
}
:disabled {
opacity: var(--o--pp);
}
/* --------------------------------------------------
フォーカス要素
-------------------------------------------------- */
:focus-visible {
outline-offset: var(--focus-offset, 0px);
} ここでは各要素に適用されるスタイルをグループごとに紹介します。
各スタイルで使用されているトークン変数(--{token}--{value})の詳細については、デザイントークンのページを参照してください。
body
body にはフォント・色・文字装飾に関する基本設定が適用されます。
body { --hl: var(--hl--base); font-size: var(--fz--base); font-family: var(--ff--base); letter-spacing: var(--lts--base); background-color: var(--base); color: var(--text); text-underline-offset: var(--under-offset, 0.125em);}--hl はハーフレディング(行間の上下余白)を管理するための変数です。body では --hl--base がセットされ、子要素に継承されます。
text-underline-offset はリンクの下線位置を調整するプロパティで、--under-offset 変数で上書き可能です。
全要素の行間
Lism CSS では、全要素に対して以下のスタイルが適用されています。
* { line-height: calc(1em + var(--hl) * 2);}これは一般的な line-height: 1.6 のような指定とは異なり、フォントサイズに依存しない固定量の行間を実現する仕組みです。
ハーフレディング(Half-leading)の量を先に定義しておき、それを文字の高さ(≒1em)の上下に付与するという計算式です。
フォントサイズが大きくなっても行間が過大にならないため、タイポグラフィにおける「縦のリズム」を統一することができ、見出しから本文まで調和の取れた余白でレイアウトを組むことができます。
詳しくは ハーフレディング(line-height) を参照してください。
見出し(h1〜h6)
見出し要素にはフォントファミリー・ウェイト・サイズが設定されます。
:is(h1, h2, h3, h4, h5, h6) { font-family: var(--headings-ff, inherit); font-weight: var(--headings-fw, var(--fw--bold));}h1 { font-size: var(--fz--3xl); }h2 { font-size: var(--fz--2xl); }h3 { font-size: var(--fz--xl); }h4 { font-size: var(--fz--l); }h5, h6 { font-size: var(--fz--m); }--headings-ff と --headings-fw を定義すれば、全見出しのフォントファミリー・ウェイトを一括でカスタマイズできます。
リンク(a)
a タグにはリンクの色と下線に関するCSS変数が設定されています。
a { color: var(--link-c, var(--link)); text-decoration: var(--link-td, underline); text-decoration-thickness: var(--link-td-thickness, auto); text-decoration-color: var(--link-td-color, currentColor);}| 変数 | フォールバック | 用途 |
|---|---|---|
--link-c | var(--link) | リンクテキストの色 |
--link-td | underline | テキスト装飾の種類 |
--link-td-thickness | auto | 下線の太さ |
--link-td-color | currentColor | 下線の色 |
インラインテキスト要素
small { --hl: var(--hl--s); font-size: var(--fz--xs);}b, strong { font-weight: var(--fw--bold);}sup, sub { --hl: var(--hl--xs); font-size: 80%;}code, kbd, var, samp { font-family: var(--ff--mono);}small や sup/sub では --hl を小さめの値に変更し、フォントサイズに合った行間になるよう調整しています。
引用
blockquote { background-color: var(--base-2); padding: var(--s30);}blockquote にはシンプルな背景色と余白が適用されています。
その他のテキスト要素
legend, caption, figcaption { font-size: var(--fz--s);}これらのフォントサイズはデフォルトで少し小さめにセットしています。
区切り
hr { border: none; block-size: 0; border-block-start: 1px solid var(--divider);}hr は方向をblock-startに固定し、 --divider カラーにセットしています。
リスト(ul, ol)
:is(ul, ol):where(:not([class])) { list-style: revert; padding-inline-start: var(--list-px-s, 1.75em);}クラスを一切持たないリストはブラウザデフォルトスタイルを自動で復活させています。
Property Class 付きの ul / ol(例: <ul class="-fz:l">)はリスト表示が消えた状態のままとなります。箇条書き表示を維持したい場合は set--revert を付与してください。
<ul class="-fz:l set--revert"> <li>item 1</li> <li>item 2</li></ul>| 変数 | フォールバック | 用途 |
|---|---|---|
--list-px-s | 1.75em | リストの padding-inline-start |
定義リスト(dl)
dt { font-weight: var(--fw--bold);}dd + dt { margin-block-start: var(--s20);}dt は太字にし、連続する dd + dt の間には余白を設けて項目の区切りを明確にしています。
テーブル
テーブルセルの一部スタイルはCSS変数でカスタマイズ可能です。
table { --td-c: inherit; --td-bgc: transparent; --td-p: var(--s10); --td-min-sz: initial;}td { color: var(--td-c); background-color: var(--td-bgc); padding: var(--td-p); min-inline-size: var(--td-min-sz);}th { color: var(--th-c, var(--td-c)); background-color: var(--th-bgc, var(--td-bgc)); padding: var(--th-p, var(--td-p)); min-inline-size: var(--th-min-sz, var(--td-min-sz));}| 変数 | フォールバック | 用途 |
|---|---|---|
--td-c | inherit | セルのテキスト色 |
--td-bgc | transparent | セルの背景色 |
--td-p | var(--s10) | セルのパディング |
--td-min-sz | initial | セルの最小幅 |
--th-c | var(--td-c) | 見出しセルのテキスト色 |
--th-bgc | var(--td-bgc) | 見出しセルの背景色 |
--th-p | var(--td-p) | 見出しセルのパディング |
--th-min-sz | var(--td-min-sz) | 見出しセルの最小幅 |
th は td の変数をフォールバックとして参照するため、table で --td-* を設定すれば th にも反映されます。
それぞれ個別に変更したい場合は --th-* を指定してください。
フォーム要素
フォームコントロールには、デフォルトで一括で統一的なスタイルが適用されます。
input, button, textarea, select, ::file-selector-button { background-color: var(--controls-bgc, var(--base-2)); border: solid 1px var(--controls-bdc, var(--divider)); padding: var(--controls-p, var(--s5) var(--s10)); border-radius: var(--controls-bdrs, var(--bdrs--10));}| 変数 | フォールバック | 用途 |
|---|---|---|
--controls-bgc | var(--base-2) | 背景色 |
--controls-bdc | var(--divider) | ボーダー色 |
--controls-p | var(--s5) var(--s10) | パディング |
--controls-bdrs | var(--bdrs--10) | 角丸 |
その他
:disabled { opacity: var(--o--pp);}:focus-visible { outline-offset: var(--focus-offset, 0px);}disabled 状態の要素は不透明度を低下させ、
:focus-visible に表示されるアウトラインのオフセットを、 --focus-offset で調整できるようにしています。
HTML基本スタイルのプレビュー
上記のベーススタイルが適用されたHTML要素のプレビューです。
大きい画面で見る