バージョン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のプロパティを当設定に参照させれば良い。