使いやすいWordPressのためのCSSのつくりかた

使いやすいWordPress
のためのCSSのつくりかた
2015.09.12 @WordBench Osaka
2015.09.12 @WordBench Osaka 1

whoami
じこしょうかい

Toro_Unit
占部紘 (うらべひろし)
Frontend Engineer / Plugin Developer /
Web Designer
Github: @torounit
Twitter: @Toro_Unit
Faceboo...

Profile
• 福島県郡山市生まれ。
• 群馬県太田市育ち。
• にじゅうろくさい。
source:
https://commons.wikimedia.org/wiki/
File:Gunma-
NaganoPrefecturalRoad...

今日は

長野県松本市からはる
ばるやってきました。
source:
https://commons.wikimedia.org/wiki/
File:
130608MatsumotoCastleMatsumotoNa
ganoprefJapan02bs...

WordBench大阪初参加です！！
初参加は緊張するものです。
2回目以降の参加の方は、自分の知らない人最低2人、話しかけ
てみましょう！
とのことなので、みなさんよろしくお願いします。
2015.09.12 @WordBench Osaka...

WordPressとの関わり

WordCamp Kansai 2015 Speaker
その節はお世話になりました。

WordPress 4.3 Core
Contributer
追いつけ追い越せKiteさん。

Plugin Development
• Custom Post Type Permalinks
• Simple Post Type Permalinks
• Powerful Post Per Page
• etc...
2015.09.1...

WordCamp Tokyoでは
CIの話をする予定。(仮)

ですが

今年のWordBench大阪
はテーマの年らしい。

というわけで

全力でCSSの話をします!!!

Today's Agenda.
1. Editor Styleの話
2. CSSの設計について

§1.Editor Styleの話

WordPressでブログを
書いてる人！

テキストエディタでHTMLとか書いて
る人！挙手！

もったいない!!!

もったいない!!!
• 最近のWordPressのビジュアルエディタへの力の入れ方が尋
常じゃない。
• Markdownライクな書き方が出来るようになって、かなり書
きやすくなった。
• HTMLとかCSS大好きですけど、正直書かなくて済むな...

そんなあなたたちにおくります。

Do you know Editor Style?
おまえはエディタースタイルを知っているか

Editor Style とは。
WordPressのビジュアルエディタに適用されるCSSのこと。
<?php
add_editor_style('./editor-style.css');
?>
2015.09.12 @WordBench O...

これを使うと

これが

こうなる

これは作るしかない!
（デフォルトテーマにも入ってる!）

But...

めんどくさい。

めんどくさい。
• ビジュアルエディタとテーマのHTML構造の違う。
• デザイン変更のたびにeditor-styleも確認する必要。。
• 二重管理だるい。

どうすれば。。。

じゃぁ、テーマで使っているCSSをそ
のまま Editor Style にできれば・・・

add_editor_style('./style.css');

But...

ビジュアルエディタとテーマでは
HTML構造が違う。

ビジュアルエディタのHTML
<html>
<body>
本文
</body>
</html>

テーマのHTML
<html>
<body>
<header>
</header>
<main>
<article>
<h1>タイトル</h1>
本文
</article>
</main>
</body>
</html>
2015.09.12 ...

じゃぁどうしよう？

the_contentで挿入される本文から
CSSを作る。

ブログ本文からCSSを作ると。
• ブログ本文からCSSを作ると、本文欄からクラスや、div等を
ある程度減らせる。
• 見出しとかリストとかにいちいちClassを付けたりするとか
が発生しない！
2015.09.12 @WordBench O...

具体的な方法

1.HTML要素へのCSSを、本文のもの
にする。

とりあえずこんな順番でCSSを書いてると思うんです。
1. Reset.css / Normalize
2. HTML要素へのCSS (h1,h2,h3,a,table,ul,li, etc...)
3. クラスとかIDとか (.alignle...

本文（the_contentの中身）のCSS =
サイトのデフォルトのスタイルとして
設計する！

めんどくさい？

そうでもない。

• テーマ側のHTMLには大抵Classとか当ててCSSを書いてる。
そのClassでやれば済む話。
• 最初のタイプセレクタへのCSSをちゃんとサイトのデフォル
トのデザインにしようぜ！ということ。Classで上書きしてた
らあんまり意味が無...

それでも面倒?

そうか･･･じゃぁ

Sass等で解決。

こんなmixin作っておけば便利かも。
@mixin box-reset() {
display: block;
margin: 0;
padding: 0;
border: none;
color: inherit;
&::before,
&...

とりあえず、見出し周りをちゃんとや
れば何とかなること多い。

2.body_class, post_classを使った
CSSは避ける

• ビジュアルエディターには存在しないクラスを出力する。こ
れらを使うと、編集画面と本番で表示が異なる事態が発生し
がち。
• これに依存すると、同じHTMLを書いたのに挙動がページご
とに変わるというCSSが大量生産される。つらい。
2015...

ページごとにCSSを作るという発想を
止めて、モジュールを組み合わせてペ
ージを作るという発想に転換しよう。

3.その他の細かいノウハウ

• トップページや複雑なページから作るとだいたいやらかす。
テーマユニットテストを活用しよう。その後にシンプルな文
章だけのページなどから作ってテストをしていくと良い。プ
ライバシーポリシーとか、法律上の表記とか。
• 見出し周りは複雑になりが...

• モジュールの組み合わせで作ると、「TinyMCE Template等
で、特定のパーツを挿入できるようにする」などの拡張も行
いやすい。
• CSSをしっかり設計すると当然、管理画面からの更新もやり
やすくなるよ！
• ブログ書くのがめんど...

第一部完
第二部につづく。

§2.CSSの設計について

初めに言っておきますが･･･

「Web制作者のためのCSS設
計の教科書」(メロン本)にだ
いたい全部書いてあります！
みんな読もう！

突然ですが

CSSって簡単？難しい？

その１

CSSって簡単!
たとえばこんなHTML
<h1 class="title">サイトのタイトル</h1>
<main id="main-contents">
<h1 class="title">ブログのタイトル</h1>
<article cl...

CSSって簡単!
.title {
color: red;
}

CSSって簡単!
.title {
color: red;
}
.post .title {
color: orange;
}

CSSって簡単?????
.title {
color: red;
}
#main-contents .title {
color: green;
}
.post .title {
color: orange; /*上書きされる。。。*/
}
...

CSSって簡単????????????????
.title {}
#main-contents .title {}
.post .title {}
h1.title {}
main#main-contents article .title {...

CHAOSの予感!!!

その２

CSSって簡単!
.title {
border-left: 10px solid #CCC;
font-size: 2em;
}

CSSって簡単!??
.title {
padding: 0 0 0 5px;
font-size: 2em;
}
.sidebar .title {
background-color...

CSSって簡単!??????????
.title {
padding: 0 0 0 5px;
font-size: 2em;
}
.title::before {
content: ...

スパゲッティな予感!!!

CSSは簡単に書けるけ
ど、ちゃんとしたCSSっ
て難しい。

ちゃんとしたCSSって？

ちゃんとしたCSSって？
CSS Architecture — Philip Walton
• 原文：http://philipwalton.com/articles/css-architecture/
• 日本語訳：http://articl...

良いCSSとは？
• 予測しやすい
• 再利用しやすい
• 保守しやすい
• 拡張しやすい

というわけで

ちゃんとCSSも設計しよう
「とりあえずデザインが実現できればOK」は卒業しよう。

どうやるの？

1.マークアップに依存しない

たとえばこんなHTML
<article>
<p>本文</p>
</article>

たとえばこんなCSS
article {
border: 1px solid #666;
padding: 16px;
}
article h1 {
margin: 0 0 0.5em;
font-size: 1.7em;
}
2015.09....

HTMLが変更になった！
<div>
<p>本文</p>
</div>
CSSが効かない!!

こうしよう。

HTML
<article class="post">
<h1 class="post-title">タイトル</h1>
<p>本文</p>
</article>
CSS
.post {
}
.post-title {
}
2015.09.12...

文書構造とCSSをしっか
り分離する。

2.コンポーネント志向な
CSSを作る。

さっきの例ですが、こうでも良さそうですよね。
.post {
}
.post .title {
}

でも。

.widget {
hoge: piyo;
}
.widget .title {
hoge: piyo;
}

<div class="widget">
<h1 class="title">最近のエントリー</h1>
<article class="post">
<h1 class="title">タイトル</h1>
</article>
</div>
...

クラス名 ≒ グローバル変数

.widget {
}
.widget-title {
}
.post {
}
.post-title {
}
No conflict!!!

3.親セレクタに依存しない

.main-contents {
float: left;
}
.home .main-contents {
float: none;
}
一見良さそうだけど。

.main-contents {
float: left;
display: block;
}
.home .main-contents,
.page .main-contents {
float: none;
}
.blog .main-co...

同じクラスがHTMLの書き方で次第で
全く別の挙動をする!
とても解りづらい!! 混乱する!
バグの原因になりやすい。
HTMLの祖先要素とか何個あると思ってんの？

こうしよう

.main-contents {
float: left;
}
.main-contents--single-column {
float: none;
}
HTMLのコンテキストを考えなくて済む。
2015.09.12 @WordBench ...

モジュールのことはモジュールに解決
させよう。

ここら辺の話を体系化したものが
所謂CSSアーキテクチャー
と呼ばれているもの。

CSSアーキテクチャー

1.OOCSS
すべてはここからはじまった

OOCSS
元Yahoo!の Nicole Sullivan氏
(@stubbornella)が提唱したCSSの設計原
則。
https://github.com/stubbornella/
oocss/wiki
2015.09.12 @Wor...

OOCSSの２大原則
1. 構造と見た目を分離。
2. コンテナとコンテンツの分離。

構造と見た目の分離

.submit-btn {
display: inline-block;
padding: 10px;
color: #FFF;
background: #66C;
}
.link-btn {
pa...

構造と見た目の分離すると・・・

/*ボタンの構造*/
.btn {
padding: 10px;
}
/*ボタンの見た目*/
.btn-submit {
color: #FFF;
background: #66C;
}
.btn-...

構造と見た目の分離するメリット
1.コードの重複が避けられる。保守性が上がる。
2.拡張がとても用意になる。

コンテナとコンテンツの分離
<aside class="sidebar">
<div>
<img class="avatar" />
</div>
</aside>
.sidebar .avatar {
width: 200px;
border...

コンテナとコンテンツの分離すると。

<aside class="sidebar">
<div class="sidebar-widget">
</div>
</aside>
.sidebar-widget { /** コンテナ **/...

コンテナとコンテンツの分離するメリット
1.場所、コンテキストに依存しないコードが増える。
2.再利用しやすい！

再利用の例

<article class="comment">
<div class="comment-user">
</div>
</article>
.comment-user {
position: ab...

OOCSSの例
• Bootstrap
• Foundation

2.SMACSS
元Yahoo!の Jonathan Snook氏
(@snookca)によって提唱されたCSSの設
計方針。
https://smacss.com/

SMACSSの基本
CSSを５種類に分類。
• Base
• Layout
• Module
• State
• Theme

Base
プロジェクトのデフォルトのCSS定義する。class等は使わず
HTML要素に対してCSSを定義する。
例
• Reset / Normalize
• タイプセレクタへのスタイル。プロジェクトのデフォルトの
デザイン。
2015.09...

Layout

Layout
サイトのレイアウトを定義するCSS群。クラスには、.l-main等
のプリフィックスをつける。
例
• メインカラム/サイドバー
• ヘッダー・フッター

Module

Module
ページ内を構成するコンポーネント群。レイアウト以外は基本
的に全てここに属する。SMACSSでCSSを書くと基本的には
Moduleが大量に作られる。
• ボタン
• メディアオブジェクト
• その他もろもろ
2015.09.12...

Moduleの命名規約
モジュールに属するスタイルの命名は、.{モジュール名}-{スタイ
ル名}とする。
.widget {
}
.widget-title {
}
.widget-body {
}
2015.09.12 @WordBench ...

State

State
.is-active等のJavaScript変更されたりするような、状態を表す
CSS。他のCSSを上書きできるように設計する必要がある。
.navigation-item {
}
.navigation-item.is-activ...

Theme

Theme
名前の通り、テーマを切り替えたりするときに使う。ブログサ
ービスなどでCSSを切り替えるとか。
• ぶっちゃけあまり使ったことが無い。
• オルタネイトスタイルシートなど。
• 他には、多言語対応でフォントや文字方向を使ったり。。。...

SMACSSの採用例
• Pure: Yahoo!が作ったCSSフレームワーク
http://purecss.io/
• 昔の web-starter-kit

3.BEM(MindBEMding)

BEM
ロシアのYandexが作った、CSSのセレクタの命名規約、設計方
針。
CSSを Block, Element, Modiﬁerの3つに分類して考える。
MindBEMding – getting your head ’round BE...

Block
所謂、SMACSSで言うところのModule。HTMLを構成するコン
ポーネントの単位。
.block {
}

Element
Blockの子要素。
.block__element {
}

Modifier
BlockやElementの拡張。
.block--modifier {
}
.block__element--modifier {
}

BEMの例
.post { /* Block */
}
.post__title { /* Element */
}
.post--sticky { /* Modifier */
}
.post__title--new {
}
2015.09....

__とか--がきもちわる
い。

• プロジェクトの中で一貫性がとれていれば、なんでも良い。
• ただWordPressはハイフン区切りの命名が多いので、そのま
ま使うのが無難。そのまま使うとBEMなフレームワークとか
も扱いやすい。
• 気持ち悪い分わかりやすい。
2015....

• EmmetだとBEMモードがある。それだと、
Block__Element_Modiﬁerになってる。
EmmetのBEMフィルターでBEMるときのHTMLをサクッと書
く | clear sky source:
http://maboro...

BEMのメリット
• とにかくわかりやすい。SMACSSと違い、elementと
modiﬁerの区別が明確。
• 特徴的な命名なので、HTML側で間違ったClassの使い方など
を発見しやすい。
参考：BEMという命名規則とSass 3.3の...

BEMの例
• Material Design Lite
• Comico http://www.comico.jp/
• NBA.COMの各チームのスケジュール。http://www.nba.com/
spurs/schedule
2015....

注意事項
• block__elem1__elem2 とかやらない。マークアップへの依存
を深めることになるので、block__elem1, block__elem2とか
にする。
• もしくは別のBlockに分割する。
2015.09.12 ...

応用編

FLOCSS

FLOCSS
日本でCSSと言えばこの人！なサイバー
エージェントの谷拓樹氏（@hiloki）に
よるCSSの構成案.
ドキュメント(日本語):
https://github.com/hiloki/ﬂocss
2015.09.12 @Word...

FLOCSSのCSSのカテゴリー
• Foundation
• Layout
• Object
• Component
• Project
• Utility

FLOCSSのCSSの原則
他のモジュールへのカスケーディングは原則禁止
.c-card > .c-media__title { /* NG!!!!!! */
}
SMACSS等でもこれをやり出すとモジュール同士が密結合にな
ってCSSが腐海化...

Foundation
• Normalize.css / Reset.css
• プロジェクトのデフォルトスタイル.
• 要はSMACSSで言うところのBase.
Layout
• ヘッダー・フッター・メインカラム・サイドバー等
2015.09...

Object

Component
• 再利用出来るパターン。Bootstrap等で出てくるコンポーネン
トなど。
• Media Object / Button / Card / etc..
• 抽象化されたモジュール群。
2015.09.12 @WordB...

Project
• プロジェクト固有のパターン。具体的なモジュール群。
• Projectから、Componentへのカスケーディングは許可
• それでもやっぱりセレクタの詳細度が上がるので、モディフ
ァイアで事足りるならそちらでやる方が無難な...

Utility
• いわゆる、ヘルパークラス、便利クラス。
• show・hide / 文字サイズとか。
• WordPressの.alignleftとかはここに所属。
• 同じようなモディファイアが大量生産されるときは、ここに
突っ込むと良い...

事例
• http://torounit.com
Repository: https://github.com/torounit/torounit2015

補足
• ざっくり言うと、SMACSS + MCSS(Multilayer CSS).
• 内容がかぶるので紹介しませんが、日本語ドキュメントもあ
るので、一見の価値あり。http://operatino.github.io/MCSS/
ja/...

ITCSS

ITCSS
CSS界のアイドル、CSS Wizardryこと、
Harry Roberts(@csswizardry)氏による
CSS設計案。
• 情報すくなめ。日本語情報あんまり
ない。たぶん谷さんのスライドくら
い。ただし、元のスライドが素...

カオスなCSS
引用元: https://speakerdeck.com/dafed/
managing-css-projects-with-itcss

おまえのセレクタで地球がやばい

こうしよう！

ITCSSのレイヤー

Setting: グローバルな変数
Tools: Mixin、Function
Generic: Normalize、Reset
Base: デフォルトのスタイル。要素セレクタ。
Objects: 装飾のないパターン。FLOCSSでいうComp...

事例
http://csswizardry.com/
• https://github.com/csswizardry/csswizardry.github.com

公式サイト・ドキュメント

スライドを読もう。
サイトは1ページしか無いけど、スライドはかなり詳細なのでわ
かりやすい。英語だけだけど結構わかりやすい。
https://speakerdeck.com/dafed/managing-css-projects-with-
i...

フレームワーク

inuit.css

一応レポジトリはある。
割とコミットされてる。

Others
• MCSS (http://operatino.github.io/MCSS/ja/)
• SUIT CSS (https://suitcss.github.io/)
• AMCSS (https://amcss.github....

これらをちゃんと運用するために。

• CSSは文法がゆるふわなので、強い自制心が必要!!!
• CSSはすぐ壊れる。常にリファクタリングしながら進める。
• 後でやろうとするとだいたいスパゲッティなCSSになってて
手遅れになる。
• 使わなくなったらいつでも削除出来るような設...

• 巨大なモジュールを作ると大抵使い回しが辛い。スクロール
しないで読めるようなモジュールが一番使い勝手が良かった
りする。1つのモジュールの仕事なのかをよく考えること。
• 疎結合大事。モノリシックなCSSを管理できるほど人間は賢
くない。
...

• 基本的にはOOCSSからの派生物。とりあえず、OOCSSの考
え方は身体にたたき込む。
• ドキュメントの整備は重要。それが面倒ならFLOCSSを使う
のが無難。

• IDセレクタは滅ぼそう。IDにはページ内リンクのアンカーと
いう仕事もある。一つのセレクタにいろんな仕事を持たせる
とリファクタリングが大変。
• Sass等を使うと、"&"を使うことでだいぶ書きやすくなる。
• モジュールごとにファイルを...

強い心・クソコードへの憎しみ・CSSへの愛が大事

CSSの設計はまだ発展途上。
柔軟な頭で考えよう。
ドキュメントは大事。せめてコメントに命名規約とか採用する設計を記述しておくのが良いかと。

とりあえず

おまえらCSSもちゃんと設計しろ!!!

余談

• 個人的にはITCSS押し。inuit.cssが小さな単位で独立したレポ
ジトリになっていてnpmで取ってこれるのは楽。
• AMCSSは良いと思うけどセレクタが書きづらい。ここら辺を
解消できるツールがあれば。
2015.09.12 @Wo...

• 「Every Declaration Just Once」とかいう話もあるけど、
CMSのように最初にCSSを用意してHTMLを追加していくも
のにはつらいと思う。
• CMSは基本的に、ページが容量の許す限り増やせる。なので
プロジェクト...

• WebComponentsの夢は忘れよう。(Scoped Styleとか)
• でもモジュラーなHTML/CSSというのはこれからもっと必要
な考え方。(ex. React.js)
• プリプロセッサは悩むならSCSS使えば良いと思う。ツー...

参考資料
• 谷拓樹氏のスライド全般。http://www.slideshare.net/hiloki/
• 昨今のCSS設計事情からみるCSS設計のあり方とは |
HTML5Experts.jp https://html5experts.jp...

参考資料
• CSS 設計の長い夢 - ペパボのフロントエンドスタンダード
http://pepabo.github.io/docs/frontend/standard/css-
architecture/
• なんでCSSすぐ死んでしまうん ...

おわり。

使いやすいWordPressのためのCSSのつくりかた

Hiroshi Urabe

使いやすいWordPressのためのCSSのつくりかた

A particular slide catching your eye?