バージョン2.0(ベータ)
主要パッケージ(@yamato-daiwa/frontend)
新規機能
マークアップ
Pug内のJavaScript
関数・クラス
- @yamato-daiwa/es-extensions (YDEE)との結合
- buildEmailLinkHrefAttributeValue
- buildPhoneNumberLinkHrefAttributeValue
- processObjectTypeParameterOfPugMixin
アセット
スタイル
アセット
破壊的変化
スタイル
アセット
NARROWEST_SCREEN_WIDTH_UNIT
定数の名前は
NARROWEST_SCREEN_WIDTH_UNIT--YDF
に変更された。
- 理由
- 名前コンフリクトの確率を可能な限り減らす為に
--YDF
と言うベンダー語尾が追加された。 - 貴方のコードが編集が必要に成る条件
- コードの中に
NARROWEST_SCREEN_WIDTH_UNIT
が直接使用中。 - 対策
- コードエディター又は結合開発環境の適切な機能を使って、プロジェクト内の全Stylusファイルファイルで
NARROWEST_SCREEN_WIDTH_UNIT
をNARROWEST_SCREEN_WIDTH_UNIT--YDF
に置き換えて下さい。 例えば、IntelliJ IDEAファミリー結合開発環境の場合、当機能をCtrl + Shift + R
ショートカット(規定)で起動可能。
DataTypes
列挙及び此れの一部の要素の名前変更
DataTypes
列挙はDataTypes--YDF
は に名前変更。dimensionalAmount
要素はdimensionalQuantity
に名前変更され、此れの値は"DIMENSIONAL_QUANTITY"
に成った。dimensionlessAmount
要素はdimensionlessQuantity
に名前変更され、此れの値は"DIMENSIONLESS_QUANTITY"
に成った。
- 理由
--YDF
と言うベンダー語尾は名前コンフリクトの確率を可能な限り減らす為 に追加された。- 要素は正式的科学用語と統一する為に名前変更された。
- 貴方のコードが編集が必要に成る条件
- コードの中に
DataTypes
が直接使用中。 - 対策
コードエディター又は結合開発環境の適切な機能を使って、プロジェクト内の全Stylusファイルファイルで下記の置き換えを 実行して下さい。
DataTypes
列挙名をDataTypes--YDF
に。dimensionalAmount
列挙要素をdimensionalQuantity
に.dimensionlessAmount
列挙要素をdimensionlessQuantity
に.
例えば、IntelliJ IDEAファミリー結合開発環境の場合、当機能を
Ctrl + Shift + R
ショートカット(規定)で起動可能。
2段階のPracticalColorCoordinateSystem
オブジェクトの名前変更
名前コンフリクトの確率を可能な限り減らす為にPracticalColorCoordinateSystem
にベンダー語尾が追加された結果、当オブジェクトの名前は
PracticalColorCoordinateSystem--YDF
に成った。
2段階のTemporaryHighlighting
オブジェクトの名前変更
- オブジェクトの名前は
TemporarySemitransparentHighlighting--YDF
に 変更された。 - 資料や出力コードを確認しないと意味が分からい、
o25
の様に超短名前は充実したopacity25Percent
の様な名前に置き換えられた。
英語を含めてインド・ヨーロッパ語族で文法的な単数・複数と言う 形態論が有り、英語が苦手だと言っても、英語はプログラミングにとって独占に成っている限り、 エンジニアにとって単数形・複数計の判別が必須能力、さもなくば混乱の原因に成る (※会話力は一切求められていない、話しの対象に成っているのは翻訳力)。
「percent」に関しては、文法が少し特別。 2以上でも「percents」ではなく、「percent」に成っている事が多い。「english.stackexchange.com」 での説明に依ると、「percent」の最後に「s」の有無は、連想している名詞に依り、「opacity」の様な不可算名詞の場合、 「s」無しでも妥当に成っている。 でも、基本規則を忘れては成らなく、名詞を含めている変数名を決める時に「単一なの?其れとも複数なの?」と自分に聞く事。
- 理由
- 名前の明確性を高める為に、「semitransparent」(「半透明」)と言う単語が追加された。
- 名前コンフリクトの確率を可能な限り減らす為に
--YDF
と言うベンダー語尾が追加された。 - やまとダイワは和訳するだけで理解出来ない名前を許可していない事に成り、
今回は納品版のコードに有るべきではない
TemporarySemitransparentHighlighting--YDF
でも、
- 貴方のコードが編集が必要に成る条件
- 納品版のコードに使わらない方が良い推薦があっても、使った場合か、下書きコードを書いている間にYDFを更新した
- 対策
コードエディターや結合開発環境の専用機能を持ちって、全Stylusファイルで下記の置き換えを行って下さい。
TemporaryHighlighting
➝TemporaryHighlighting--YDF
.o10
➝.opacity10Percent
.o25
➝.opacity25Percent
.o50
➝.opacity50Percent
.o75
➝.opacity75Percent
ShadesOfGray__39ColorsW3C_Palette
配列の名前変更
ShadesOfGray__39ColorsW3C_Palette
配列は
W3C_39_ShadesOfGray--YDF
に名前変更された。
コア
コアの変数をコンフィグレーションオブジェクトへの置き換え
次の基本変数(バージョン1.Xには此の様に呼ばれていた)はYDF_Configurationコンフィグレーションオブジェクトに置き換えられたが、下記の理由で削除された。
- MAIN_FONT_STACK
- YDF_Configuration.fontsStacks.mainに置き換え済み
- MAIN_SANS_SERIF_FONT_STACK
- YDF_Configuration.fontsStacks.mainSansSerifに置き換え済み
- MAIN_SERIF_FONT_STACK
- YDF_Configuration.fontsStacks.mainSerifに置き換え済み
- MAIN_MONOSPACED_FONT_STACK
- YDF_Configuration.fontsStacks.mainMonospacedに置き換え済み
- BASIC_FONT_SIZE
- YDF_Configuration.textGeometry.basicFontSizeに置き換え済み
- BASIC_LINE_HEIGHT
- YDF_Configuration.textGeometry.basicLineHeightに置き換え済み
- BASIC_LINE_HEIGHT_IN_MULTILINE_TEXT_BLOCKS
- YDF_Configuration.textGeometry.basicLineHeightInMultilineTextBlocksに置き換え済み
- BASIC_FONT_SIZE_IN_MULTILINE_TEXT_BLOCKS
- YDF内には
YDF_Configuration.textGeometry.basicFontSize
に加えて複数行の本文系予想には 追加の活字大小を定義する必要は無い事になったので削除された。 - BEM_ELEMENT_SEPARATOR
- YDF内には使用されなく成ったので削除された
- BEM_MODIFIER_SEPARATOR
- YDF内には使用されなく成ったので削除された
- ZIndexes
- YDF_Configuration.zIndexesに置き換え済み
- コンフィグレーションオブジェクトへの置き換え理由
- 変数名が非常に意味も広いし、YDFから来る事には何も指していたなかった。
二つ目の問題だけだと、ベンターポストフィックスを追加されば(例えば、
MAIN_SANS_SERIF_FONT_STACK
をMAIN_SANS_SERIF_FONT_STACK--YDF
にする)解決だが、コンフィグレーションの保管には 単一のオブジェクトの方が良い。 - 貴方のコードが編集が必要に成る条件
- 上記の変数の中から少なくとも一件を直接利用されているまま
- 対策
- 基本変数を以前の名前の儘で続けたい場合、望ましい値で自力で定義すると良い。
- 以前基本変数の値を変えた事が有ったら、代わりに
YDF_Configuration
コンフィグレーションオブジェクトの該当しているプロパティを上書きすれば良い。 YDF_Configuration
を今迄の基本変数の代わりに使っても良いなら、 基本変数がアクセスされる全ヵ所でYDF_Configuration
コンフィグレーションオブジェクトの該当しているプロパティに置き換えれば良い。 とは言え、「YDF」が入っている名前から分かる通り、当ライブラリは貴方のプロジェクトで補助手段に過ぎない。 それで、特殊なデザインの場合、此れの設定をYDFと別当に定義するべきで、YDF_Configuration
のプロパティを当設定に参照させれば良い。