Avalonia UI - スタイル定義のソースを表示

== 概要 ==
コントロールのスタイルおよびテンプレートを別ファイルとして定義して再利用する<u>"スタイルの外部化"</u>を行う。<br>
<br>
スタイルの外部化を行うことにより、以下に示すようなメリットがある。<br>
* 開発効率の向上
*: デザイナーと開発者の分業が容易になり、並行作業が可能になる。
*: コンポーネントの部品化による再利用性の向上する。
*: デザインシステムの一貫性を保ちやすい。
* コード管理の最適化
*: 関心の分離 (Separation of Concerns) 原則に従った明確な責任分担が可能となる。
*: 整理された階層的なファイル構造により、メンテナンス性が向上する。
*: スタイル定義の集中管理による変更の追跡が容易になる。
* 再利用性の最大化
*: コードの重複を防ぎ、DRY原則を実現
*: 複数の画面での同一スタイルの再利用が容易になる。
*: アプリケーション全体での一貫したデザインの実現できる。
*: コンポーネントライブラリとしての活用が可能になる。
* テーマ対応の柔軟性
*: ダークモード/ライトモードの切り替えが容易になる。
*: 複数のテーマやブランディングへの対応が可能になる。
*: カラーパレットやデザイントークンの一元管理できる。
* 保守性の向上
*: スタイルの変更が1箇所で完結し、影響範囲を制御可能になる。
*: デザインの修正や更新が効率的になる。
*: 品質管理とテストが容易になる。
<br>
 [プロジェクトのトップディレクトリ]
  ├── Styles/
  │   ├── ButtonStyles.axaml     # ボタンスタイル
  │   ├── TextBoxStyles.axaml    # テキストボックススタイル
  │   ├── Colors.axaml           # カラーテーマ
  │   └── Dimensions.axaml       # サイズ定義
  ├── Controls/
  │   └── CustomButton.axaml     # カスタムコントロール
  └── Views/
      └── MainWindow.axaml       # メインウインドウ
<br>
このような構造化により、大規模なプロジェクトでも効率的な開発とメンテナンスが可能となり、チーム開発での生産性が向上する。<br>
また、デザインシステムの構築と進化にも柔軟に対応できる。<br>
<br><br>

== スタイル定義ファイルの作成 ==
リソースディクショナリとして定義する。<br>
<br>
スタイル定義ファイルは.axamlまたは.axaml.csとして作成する。<br>
<br>
==== リソースディクショナリの基本構造 ====
<center>
{| class="wikitable" | style="background-color:#fefefe;"
! style="background-color:#66CCFF;" | タグ / 属性
! style="background-color:#66CCFF;" | 説明
! style="background-color:#66CCFF;" | 備考
|-
| style="text-align: center;" | ResourceDictionary
| スタイルやリソースを定義するためのルート要素
| アプリケーション全体で使用可能なリソースを格納する。<br>複数のリソースディクショナリを結合可能にする。
|-
| style="text-align: center;" | xmlns="https://github.com/avaloniaui"
| Avalonia UIの名前空間を定義する。
| Avalonia UIの基本コントロールと機能へのアクセスを提供する。
|-
| style="text-align: center;" | xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
| XAMLの基本名前空間を定義する。
| XAML言語の基本機能へのアクセスを提供する。
|}
</center>
<br>
==== スタイル定義の構造 ====
<center>
{| class="wikitable" | style="background-color:#fefefe;"
! style="background-color:#66CCFF;" | タグ / 属性
! style="background-color:#66CCFF;" | 説明
! style="background-color:#66CCFF;" | 使用例
|-
| style="text-align: center;" | Style Selector="<コントロール名>.<クラスセレクタ名>"
| スタイルを適用するターゲットを指定する。
| 例えば、<code>Style Selector="Button.modern"</code>は、modernクラスが指定されたボタンを選択する。<br>CSSセレクタに似た構文である。
|-
| style="text-align: center;" | Setter
| プロパティの値を設定する。
| 
* Property
*: プロパティ名
* Value
*: プロパティの値
|-
| style="text-align: center;" | Transitions
| アニメーション遷移を定義する。
| 複数のトランジションをグループ化する。<br>プロパティ変更時の動的な変化を定義
|-
| style="text-align: center;" | TransformOperationsTransition
| 変形アニメーションを定義する。
| 
例:
* Property="RenderTransform"
* Duration="0.2"
* Easing="CubicEaseOut"
|-
| style="text-align: center;" | BrushTransition
| 色の変化アニメーションを定義する。
| 
例:
* Property="Background"
* Duration="0.2"
* Easing="CubicEaseOut"
|-
| style="text-align: center;" | Style Selector="^:pointerover"
| マウスホバー時のスタイルを定義する。
| <code>^</code>は、親セレクタを参照する。<br><code>:pointerover</code>は、マウスホバー状態を示す。
|-
| style="text-align: center;" | Style Selector="^:pressed"
| ボタン押下時のスタイルを定義する。
| <code>:pressed</code>は、ボタンが押下された状態を示す。
|}
</center>
<br>
==== Setterプロパティの詳細 ====
<center>
{| class="wikitable" | style="background-color:#fefefe;"
! style="background-color:#66CCFF;" | プロパティ
! style="background-color:#66CCFF;" | 設定値
! style="background-color:#66CCFF;" | 説明
|-
| style="text-align: center;" | Background
| カラー名または#xxxxxx<br>例1 : White<br>例2: #2196F3 (マテリアルデザインのブルー)
| 背景色
|-
| style="text-align: center;" | Foreground
| カラー名または#xxxxxx<br>例1 : White<br>例2: #2196F3 (マテリアルデザインのブルー)
| 文字色
|-
| style="text-align: center;" | CornerRadius
| 整数値
| 角の丸み (ピクセル単位)
|-
| style="text-align: center;" | Padding
| <整数値>,<整数値><br>例: 16,8　(左右16px, 上下8px)
| 内部余白
|-
| style="text-align: center;" | BorderThickness
| <整数値>
| 境界線の太さ
|-
| style="text-align: center;" | HorizontalContentAlignment
| Center
| 水平方向の配置
|-
| style="text-align: center;" | VerticalContentAlignment
| Center
| 垂直方向の配置
|-
| style="text-align: center;" | RenderTransform
| 例. 102%にする場合 : scale(1.02)<br>例. 98%にする場合 : scale(0.98)
| ホバー時の拡大率および縮小率
|}
</center>
<br>
==== 使用例 ====
 <syntaxhighlight lang="xml">
 <!-- /Styles/ButtonStyles.axaml -->
 
 <ResourceDictionary xmlns="https://github.com/avaloniaui"
                     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <Style Selector="Button.modern">
       <Setter Property="Background" Value="#2196F3"/>
       <Setter Property="Foreground" Value="White"/>
       <Setter Property="CornerRadius" Value="4"/>
       <Setter Property="Padding" Value="16,8"/>
       <Setter Property="BorderThickness" Value="0"/>
       <Setter Property="HorizontalContentAlignment" Value="Center"/>
       <Setter Property="VerticalContentAlignment" Value="Center"/>
 
       <Setter Property="Transitions">
          <Transitions>
             <TransformOperationsTransition Property="RenderTransform" Duration="0.2" Easing="CubicEaseOut"/>
             <BrushTransition Property="Background" Duration="0.2" Easing="CubicEaseOut"/>
          </Transitions>
       </Setter>
 
       <Style Selector="^:pointerover">
          <Setter Property="Background" Value="#1976D2"/>
          <Setter Property="RenderTransform" Value="scale(1.02)"/>
       </Style>
 
       <Style Selector="^:pressed">
          <Setter Property="RenderTransform" Value="scale(0.98)"/>
       </Style>
    </Style>
 </ResourceDictionary>
 </syntaxhighlight>
<br><br>

== スタイル定義の読み込み ==
App.axamlでスタイルを読み込むことにより、アプリケーション全体で使用可能になる。<br>
複数のStyleIncludeを定義することにより、複数のスタイルファイルを読み込むことが可能となる。<br>
<br>
<u>※注意</u><br>
<u>読み込み順序において、後に読み込まれたスタイルが優先される。</u><br>
<u>リソースディクショナリとして定義されたスタイルを読み込む。</u><br>
<br>
 <syntaxhighlight lang="xml">
 <Application xmlns="https://github.com/avaloniaui"
              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <Application.Styles>
       <FluentTheme />
 
       <!-- スタイルの読み込み -->
       <StyleInclude Source="/Styles/ButtonStyles.axaml"/>
       <StyleInclude Source="/Styles/TextBoxStyles.axaml"/>
       <StyleInclude Source="/Styles/Colors.axaml"/>
    </Application.Styles>
 </Application>
 </syntaxhighlight>
<br>
<center>
{| class="wikitable" 
! タグ / 属性名
! 説明
! 備考
|-
| StyleInclude
| スタイルを読み込むためのタグ
| Avalonia UIの組み込み要素である。<br>外部スタイルファイルを参照する時に使用する。
|-
| Source
| スタイルファイルのパスを指定する。<br>これは、プロジェクトルートからの相対パスである。
| 先頭の"/"はプロジェクトルートを示す。<br>これは、ビルド時に自動的に解決される。
|-
| /xxx/yyy.axaml<br><br>例: /Styles/ButtonStyles.axaml
| スタイルファイルのパス
| xxxディレクトリのyyy.axamlを参照する。<br>axaml拡張子は、Avalonia XAMLファイルを示す。<br><br>これは、プロジェクトのトップディレクトリからのパスである。
|}
</center>
<br>
その他、指定可能なプロパティを下表に示す。<br>
<center>
{| class="wikitable" | style="background-color:#fefefe;"
! style="background-color:#66CCFF;" | タグ / 属性名
! style="background-color:#66CCFF;" | 説明
! style="background-color:#66CCFF;" | 使用例
|-
| Mode
| スタイルの読み込みモードを指定する。
| 
* <code>Mode="Append"</code>
*: 既存のスタイルに追加 (デフォルト)
* <code>Mode="Replace"</code>
*: 既存のスタイルを置き換え
<br>
<u>※注意</u><br><u>Mode属性 (特に、Replace) は慎重に使用する必要がある。</u>
|-
| ResourceType
| リソースの型を明示的に指定する。
| <code>ResourceType="{x:Type local:CustomStyles}"</code>
<br>
<u>※注意</u><br><u>ResourceTypeは必要な場合のみ指定する。</u>
|-
| DynamicResource
| 動的リソース参照を指定する。
| <code>DynamicResource="CustomThemeStyles"</code>
<br>
<u>※注意</u><br><u>DynamicResourceを使用する場合は、パフォーマンスへの影響を考慮する必要がある。</u>
|-
| IsEnabled
| スタイルの有効 / 無効を制御する。
| <code>IsEnabled="{Binding IsCustomStyleEnabled}"</code>
<br>
<u>※注意</u><br>IsEnabled属性をバインディングで制御する場合は、適切なデータコンテキストが必要となる。<br>
|-
| x:Key
| スタイルのキーを指定する。
| <code>x:Key="CustomButtonStyle"</code>
|-
| x:Shared
| リソースの共有状態を指定する。
| <code>x:Shared="False"</code>
|}
</center>
<br>
 <syntaxhighlight lang="xml">
 <!-- 基本的な使用例 -->
 <StyleInclude Source="/Styles/ButtonStyles.axaml"
               Mode="Append"
               IsEnabled="True"/>
 
 <!-- リソースタイプを指定する例 -->
 <StyleInclude Source="/Styles/CustomStyles.axaml"
               ResourceType="{x:Type local:CustomStyles}"
               x:Key="CustomStyle"/>
 
 <!-- 動的リソース参照の例 -->
 <StyleInclude Source="{DynamicResource ThemeStylesPath}"
               Mode="Replace"/>
 </syntaxhighlight>
<br><br>

== スタイル定義の使用 ==
例えば、MainWindow.axamlファイルでカスタムスタイル定義 (以下の例ではボタン) を使用する。<br>
<br>
 <syntaxhighlight lang="xml">
 <Button Classes="modern"
         Name="BtnStart" 
         Width="200" 
         Height="50"
         Click="btnStart_Click">
    Start
 </Button>
 </syntaxhighlight>
<br>
<center>
{| class="wikitable" | style="background-color:#fefefe;"
! style="background-color:#66CCFF;" | 属性名
! style="background-color:#66CCFF;" | 説明
! style="background-color:#66CCFF;" | 備考
|-
| style="text-align: center;" | Classes="<スタイルクラス名>"<br>Classes="<スタイルクラス名 1> <スタイルクラス名 2>"  
| スタイルクラスの指定
| ResourceDictionaryで定義されたスタイルクラス名を適用する。<br>複数のクラスを空白区切りで指定可能 (例: Classes="modern primary")
|-
| style="text-align: center;" | Name="<コントロールの識別子>"
| コントロールの一意な識別子
| コードビハインドからコントロールを参照する場合は定義する。<br>XAMLとコードの橋渡しとなる重要な属性である。
|-
| style="text-align: center;" | Width="<数値>"<br>Width="Auto"
| ボタンの幅をピクセル単位で指定する。
| 固定値での指定、あるいは、他の単位 (Width="Auto") や相対値も使用できる。
|-
| style="text-align: center;" | Height="<数値>"<br>Height="Auto"
| ボタンの高さをピクセル単位で指定する。
| 固定値での指定、あるいは、他の単位 (Width="Auto") や相対値も使用できる。
|-
| style="text-align: center;" | Click="<イベントハンドラメソッド名>"
| コントロールのイベントハンドラメソッド名を指定する。
| 例えば、ボタンの場合は、クリックイベントハンドラメソッド名を指定する。<br>ただし、コードビハインド (.cs) ファイルに定義が必要となる。
|-
| style="text-align: center;" | コンテンツ名 (キャプション名)
| コントロールに表示されるテキストを指定する。
| 開始タグと終了タグの間に配置する。<br>他のコントロールや画像等も配置可能である。
|}
</center>
<br>
その他、指定可能なプロパティを下表に示す。<br>
<center>
{| class="wikitable" | style="background-color:#fefefe; width: 50%;"
! style="background-color:#66CCFF;" | プロパティ名
! style="background-color:#66CCFF;" | 説明
! style="background-color:#66CCFF;" | 備考
|-
| style="text-align: center;" | IsEnabled
| ボタンの有効 / 無効状態
| true / falseで指定する。<br>falseの場合、ボタンは押下不可でグレーアウト表示される。
|-
| style="text-align: center;" | Background
| 背景色
| Color型での指定が可能である。<br><br>ブラシ (SolidColorBrush等) での指定も可能。<br>また、透明度 (Alpha) の指定も可能。
|-
| style="text-align: center;" | Foreground
| 文字色
| Backgroundと同様、Color型やブラシでの指定が可能である。<br>ボタン内のテキストやアイコンの色に適用する。
|-
| style="text-align: center;" | Padding
| 内部の余白
| 4辺個別に指定が可能である。(左,上,右,下)<br>一括指定も可能 (例 : Padding="10")<br><br>単位はピクセルであることに注意する。
|-
| style="text-align: center;" | Margin
| 外部の余白
| Paddingと同様に4辺個別に指定が可能である。<br>コントロール間の間隔を調整する場合に使用する。<br><br>単位はピクセルであることに注意する。
|-
| style="text-align: center;" | HorizontalAlignment
| 水平方向の配置
| 親コンテナ内での配置位置を指定する。<br>Left, Center, Right, Stretchから選択可能である。
|-
| style="text-align: center;" | VerticalAlignment
| 垂直方向の配置
| 親コンテナ内での配置位置を指定する。<br>Top, Center, Bottom, Stretchから選択可能である。
|}
</center>
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:C_Sharp]]