From 4ace0769da3bc823dd8a3d86211cefa850ce3007 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Tue, 5 Oct 2021 01:44:43 +0900 Subject: CSS Text モジュールの文書を更新 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 2021/08/13 時点の英語版に同期 - Web/CSS/CSS_Text/Wrapping_Text を新規翻訳 --- files/ja/web/css/white-space/index.md | 328 +++++++++++++++++----------------- 1 file changed, 164 insertions(+), 164 deletions(-) (limited to 'files/ja/web/css/white-space') diff --git a/files/ja/web/css/white-space/index.md b/files/ja/web/css/white-space/index.md index f87e4ccb14..095ad06c5c 100644 --- a/files/ja/web/css/white-space/index.md +++ b/files/ja/web/css/white-space/index.md @@ -3,27 +3,31 @@ title: white-space slug: Web/CSS/white-space tags: - CSS - - CSS テキスト - CSS プロパティ + - CSS テキスト - Reference + - recipe:css-property - white-space +browser-compat: css.properties.white-space translation_of: Web/CSS/white-space --- -
{{CSSRef}}
+{{CSSRef}} -

CSS の white-space プロパティは、要素内の{{Glossary("whitespace", "ホワイトスペース")}}をどのように扱うかを設定します。

+**`white-space`** は CSS のプロパティで、要素内の{{Glossary("whitespace", "ホワイトスペース")}}をどのように扱うかを設定します。 -
{{EmbedInteractiveExample("pages/css/white-space.html")}}
+{{EmbedInteractiveExample("pages/css/white-space.html")}} - +このプロパティは 2 つのことを指定します。 -
-

メモ: 要素の内部で折り返しを行うには、代わりに {{CSSxRef("overflow-wrap")}}, {{CSSxRef("word-break")}}, {{CSSxRef("hyphens")}} を使用してください。

-
+- ホワイトスペースを折り畳むかどうか、およびその方法。 +- 行を自動折り返しの場面で折り返すことができるかどうか。 + +> **Note:** *要素の内部で*折り返しを行うには、代わりに {{CSSxRef("overflow-wrap")}}, {{CSSxRef("word-break")}}, {{CSSxRef("hyphens")}} を使用してください。 -

構文

+## 構文 -
/* キーワード値 */
+```css
+/* キーワード値 */
 white-space: normal;
 white-space: nowrap;
 white-space: pre;
@@ -34,136 +38,161 @@ white-space: break-spaces;
 /* グローバル値 */
 white-space: inherit;
 white-space: initial;
+white-space: revert;
 white-space: unset;
-
- -

white-space プロパティは、以下の値の一覧から選択した単一のキーワードで指定します。

- -

値

- -
-
normal
-
連続するホワイトスペースはまとめられます。ソース内の改行文字もホワイトスペースとして扱われます。行ボックスを埋めるために、必要なら行を折り返します。
-
nowrap
-
normal と同じくホワイトスペースを詰めますが、行の折り返しは行いません。
-
pre
-
連続するホワイトスペースはそのまま残され、行の折り返しは、ソース内の改行文字と、 {{HTMLElement("br")}} 要素でのみ行います。
-
pre-wrap
-
連続するホワイトスペースはそのまま残されます。行の折り返しは、改行文字や {{HTMLElement("br")}} 要素のあるときか、行ボックスを埋めるのに必要なときに行います。
-
pre-line
-
連続するホワイトスペースは詰められて 1 つになります。行の折り返しは、改行文字や {{HTMLElement("br")}} 要素のあるときか、行ボックスを埋めるのに必要なときに行われます。
-
break-spaces
-
下記の点を除いて、動作は pre-wrap と同じです。 -
    -
  • そのまま残された連続するホワイトスペースは、行末にあるものを含め、空間を占有します。
    • -
  • 残されたそれぞれのホワイトスペースの後で、ホワイトスペースの間を含め、改行する可能性があります。
    • -
  • そのような残された空白は空間を占有し、ぶら下がらず、ボックスの固有の寸法に (min-content size および max-content size に) 影響します。
    • -
-
-
- -

次の表に、white-space 値の動作をまとめます。

+``` + +`white-space` プロパティは、以下の値の一覧から選択した単一のキーワードで指定します。 + +### 値 + +- `normal` + - : 連続するホワイトスペースがまとめられます。ソース内の改行文字もホワイトスペースとして扱われます。行ボックスを埋めるために、必要なら行を折り返します。 +- `nowrap` + - : `normal` と同じくホワイトスペースを詰めますが、行の折り返しは行いません。 +- `pre` + - : 連続するホワイトスペースはそのまま残され、行の折り返しは、ソース内の改行文字と、 {{HTMLElement("br")}} 要素でのみ行います。 +- `pre-wrap` + - : 連続するホワイトスペースはそのまま残されます。行の折り返しは、改行文字や {{HTMLElement("br")}} 要素のあるときか、行ボックスを埋めるのに必要なときに行います。 +- `pre-line` + - : 連続するホワイトスペースは詰められて 1 つになります。行の折り返しは、改行文字や {{HTMLElement("br")}} 要素のあるときか、行ボックスを埋めるのに必要なときに行われます。 +- `break-spaces` + + - : 下記の点を除いて、動作は `pre-wrap` と同じです。 + + - そのまま残された連続するホワイトスペースは、行末にあるものを含め、空間を占有します。 + - 残されたそれぞれのホワイトスペースの後で、ホワイトスペースの間を含め、改行する可能性があります。 + - そのような残された空白は空間を占有し、ぶら下がらず、ボックスの内在の寸法 (min-content および max-content の大きさ) に影響します。 + +次の表に、`white-space` 値の動作をまとめます。 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
改行空白とタブ文字テキストの折り返し行末の空白
normalまとめるまとめる折り返す除去
nowrapまとめるまとめる折り返さない除去
preそのままそのまま折り返さないそのまま
pre-wrapそのままそのまま折り返すぶら下げ
pre-lineそのまままとめる折り返す除去
break-spacesそのままそのまま折り返す折り返す
改行空白とタブ文字テキストの折り返し行末の空白行末のその他の空白区切り
normalまとめるまとめる折り返す除去ぶら下げる
nowrapまとめるまとめる折り返さない除去ぶら下げる
preそのままそのまま折り返さないそのまま折り返さない
pre-wrapそのままそのまま折り返すぶら下げるぶら下げる
pre-lineそのまままとめる折り返す除去ぶら下げる
break-spacesそのままそのまま折り返す折り返す折り返す
-

形式文法

+> **Note:** **空白**と**その他の空白区切り**には違いがあります。以下のように定義されています。 +> +> - 空白 +> - : 空白 (U+0020)、タブ (U+0009)、区切り文字 (改行など)。 +> - その他の空白区切り +> - : Unicode で定義されているその他の区切り文字で、空白として定義されているもの意外。 +> +> ホワイトスペースが*ぶら下げる*とある場合、内在サイズを計算するときにボックスの大きさに影響することがあります。 + +## 公式定義 + +{{CSSInfo}} + +## 形式文法 {{CSSSyntax}} -

例

+## 例 -

基本的な例

+### 基本的な例 -
code {
+```css
+code {
   white-space: pre;
-}
+} +``` -

<pre> 要素内での改行

+### \
 要素内での改行
 
-
pre {
-  word-wrap: break-word;      /* IE 5.5-7 */
-  white-space: pre-wrap;      /* 現行ブラウザー */
-}

+```css
+pre {
+  white-space: pre-wrap;
+}
+```
 
-
操作して確認する

+
操作

 
-
+```
 
-
.box {
+```css hidden
+.box {
   width: 300px;
   padding: 16px;
   border-radius: 10px;
@@ -185,62 +214,33 @@ white-space: unset;
   height: 400px;
   white-space: normal;
   font-size: 14px;
-}

+}
+```
 
-
var select  = document.querySelector("#css-code select");
+```js hidden
+var select  = document.querySelector("#css-code select");
 var results = document.querySelector("#results p");
 select.addEventListener("change", function(e) {
   results.setAttribute("style", "white-space: "+e.target.value);
-})

-
-
-
ソース

-
-
<p>    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
+})
+```
 
-    Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
-
-    Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
-
-    Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
-

+```html
+
 Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

+```
 
-
CSS を加えた結果

+#### 結果
 
-
{{EmbedLiveSample("See_it_in_action_LiveSample", "100%", 500)}}

+{{EmbedLiveSample("In_action", "100%", 500)}}
 
-
仕様書

-
-
- 
-  
-   
-   
-   
-  
- 
- 
-  
-   
-   
-   
-  
-  
-   
-   
-   
-  
- 
-
仕様書状態備考
{{SpecName("CSS3 Text", "#propdef-white-space", "white-space")}}{{Spec2("CSS3 Text")}}折り返しアルゴリズムの詳細を記述。
{{SpecName("CSS2.1", "text.html#white-space-prop", "white-space")}}{{Spec2("CSS2.1")}}初回定義

+## 仕様書
 
-
{{CSSInfo}}

+{{Specifications}}
 
-
ブラウザーの互換性

+## ブラウザーの互換性
 
-
{{Compat("css.properties.white-space")}}

+{{Compat}}
 
-
関連情報

+## 関連情報
 
-
+- *内部での*折り返しを定義するプロパティ: {{CSSxRef("overflow-wrap")}}, {{CSSxRef("word-break")}}, {{CSSxRef("hyphens")}}
-- 
cgit v1.2.3-54-g00ecf