差分
ナビゲーションに移動
検索に移動
ページの作成：「Knockoutの'''text'''バインディングとは、パラメーターの値に応じて関連付けられたDOM要素内のテキストを書き換える。 通常...」
[[Knockout]]の'''text'''バインディングとは、パラメーターの値に応じて関連付けられたDOM要素内のテキストを書き換える。
通常はspanやemといった要素の内容を書き換えるのに使うものだが、技術的には任意の要素で使用できる。
== パラメーター ==
Knockoutは、関連付られたDOM要素内のテキスト（IEであればinnerText、FirefoxであればtextCotnentの値）を、パラメーターの値で上書きする。
このパラメーターが[[Knockout/observable]]の場合は、値を更新するたびにテキストも更新する。パラメーターがobservableでない場合はバインディング適用時（Knockout/applyBindings実行時）に1回だけ更新されて以降は更新されない。
パラメーターの値の[[型]]が数値（number型）または文字列（string型）の場合はそのものを、それ以外の場合はtoString()メソッドを実行した結果でテキストを上書きする。
== 使用例 ==
=== hello world ===
「[[hello, world]]」はこんな感じ。
<source lang="html5">
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<title>knockout.js - text bindding sample 1</title>
<script type="text/javascript" src="jquery-1.5.1.min.js"></script>
<script type="text/javascript" src="knockout-2.0.0.js"></script>
<script type="text/javascript">
jQuery(function() {
// モデル
var AppViewModel = function() {
this.message = ko.observable("hello, world");
}
// バインディング適用
ko.applyBindings(new AppViewModel());
});
</script>
</head>
<body>
<div data-bind="text: message"></div>
</body>
</html></source>
=== HTMLの使用 ===
textバインディングのパラメーターにHTMLを書いてもそのままの文字列として表示される（HTMLエスケープされた文字列が表示される）。HTMLで上書きしたい場合は[[Knockout/html]]バインディングを使用する。
=== 式の使用 ===
textバインディングには簡単な式が使える。
式に関する詳細は[[Knockout]]の項目を参照。
[[3項演算子]]の使用例。
<source lang="html5">
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<title>knockout.js - text bindding sample 1</title>
<script type="text/javascript" src="jquery-1.5.1.min.js"></script>
<script type="text/javascript" src="knockout-2.0.0.js"></script>
<script type="text/javascript">
jQuery(function() {
// モデル
var AppViewModel = function() {
this.price = ko.observable("19800");
}
// バインディング適用
ko.applyBindings(new AppViewModel());
});
</script>
</head>
<body>
<p><span data-bind="text: price"></span>円の商品について</p>
<p>Aさんは <span data-bind="text: price() > 20000 ? '高い' : '安い'"></span> と言いました。</p>
<p>Bさんは <span data-bind="text: price() > 10000 ? '高い' : '安い'"></span> と言いました。</p>
</body>
</html>
</source>
== 関連項目 ==
* [[Knockout]]
== 参考文献 ==
<references/>
== 外部リンク ==
{{stub}}
通常はspanやemといった要素の内容を書き換えるのに使うものだが、技術的には任意の要素で使用できる。
== パラメーター ==
Knockoutは、関連付られたDOM要素内のテキスト（IEであればinnerText、FirefoxであればtextCotnentの値）を、パラメーターの値で上書きする。
このパラメーターが[[Knockout/observable]]の場合は、値を更新するたびにテキストも更新する。パラメーターがobservableでない場合はバインディング適用時（Knockout/applyBindings実行時）に1回だけ更新されて以降は更新されない。
パラメーターの値の[[型]]が数値（number型）または文字列（string型）の場合はそのものを、それ以外の場合はtoString()メソッドを実行した結果でテキストを上書きする。
== 使用例 ==
=== hello world ===
「[[hello, world]]」はこんな感じ。
<source lang="html5">
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<title>knockout.js - text bindding sample 1</title>
<script type="text/javascript" src="jquery-1.5.1.min.js"></script>
<script type="text/javascript" src="knockout-2.0.0.js"></script>
<script type="text/javascript">
jQuery(function() {
// モデル
var AppViewModel = function() {
this.message = ko.observable("hello, world");
}
// バインディング適用
ko.applyBindings(new AppViewModel());
});
</script>
</head>
<body>
<div data-bind="text: message"></div>
</body>
</html></source>
=== HTMLの使用 ===
textバインディングのパラメーターにHTMLを書いてもそのままの文字列として表示される（HTMLエスケープされた文字列が表示される）。HTMLで上書きしたい場合は[[Knockout/html]]バインディングを使用する。
=== 式の使用 ===
textバインディングには簡単な式が使える。
式に関する詳細は[[Knockout]]の項目を参照。
[[3項演算子]]の使用例。
<source lang="html5">
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<title>knockout.js - text bindding sample 1</title>
<script type="text/javascript" src="jquery-1.5.1.min.js"></script>
<script type="text/javascript" src="knockout-2.0.0.js"></script>
<script type="text/javascript">
jQuery(function() {
// モデル
var AppViewModel = function() {
this.price = ko.observable("19800");
}
// バインディング適用
ko.applyBindings(new AppViewModel());
});
</script>
</head>
<body>
<p><span data-bind="text: price"></span>円の商品について</p>
<p>Aさんは <span data-bind="text: price() > 20000 ? '高い' : '安い'"></span> と言いました。</p>
<p>Bさんは <span data-bind="text: price() > 10000 ? '高い' : '安い'"></span> と言いました。</p>
</body>
</html>
</source>
== 関連項目 ==
* [[Knockout]]
== 参考文献 ==
<references/>
== 外部リンク ==
{{stub}}
