生活随笔
收集整理的這篇文章主要介紹了
HarmonyOS之组件通用的XML属性总览
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
一、Component
- Component 是所有組件的基類。
- Component 支持的 XML 屬性,其它組件都支持。
二、基礎屬性
- Component 支持的 XML 的基礎屬性如下所示:
屬性名稱中文描述取值取值說明使用案例
id控件identity,用以識別不同控件對象,每個控件唯一integer類型僅可用于配置控件的idohos:id="$+id:component_id"
theme樣式引用僅可引用pattern資源ohos:theme="$pattern:button_pattern"
width寬度,必填項float類型可以配置表示尺寸的float類型。
可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源 ohos:width="20"
ohos:width="10vp"
ohos:width="$float:size_value"
match_parent表示控件寬度與其父控件去掉內部邊距后的寬度相同ohos:width="match_parent"
match_content表示控件寬度由其包含的內容決定,包括其內容的寬度以及內部邊距的總和ohos:width="match_content"
height高度,必填項float類型可以配置表示尺寸的float類型。
可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:height="20"
ohos:height="20vp"
ohos:height="$float:size_value"
match_parent表示控件高度與其父控件去掉內部邊距后的高度相同ohos:height="match_parent"
match_content表示控件高度由其包含的內容決定,包括其內容的高度以及內部邊距的總和ohos:height="match_content"
min_width最小寬度float類型可以配置表示尺寸的float類型。
可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:min_width="20"
ohos:min_width="20vp"
ohos:min_width="$float:size_value"
min_height最小高度float類型可以配置表示尺寸的float類型
可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:min_height="20"
ohos:min_height="20vp"
ohos:min_height="$float:size_value"
alpha透明度float類型可以直接設置浮點數值,也可以引用float浮點數資源,取值范圍在0~1ohos:alpha="0.86"
ohos:alpha="$float:value"
clickable是否可點擊boolean類型可以直接設置true/false,也可以引用boolean資源ohos:clickable="true"
ohos:clickable="$boolean:true"
long_click_enabled是否支持長點擊boolean類型可以直接設置true/false,也可以引用boolean資源ohos:long_click_enabled="true"
ohos:long_click_enabled="$boolean:true"
enabled是否啟用boolean類型可以直接設置true/false,也可以引用boolean資源ohos:enabled="true"
ohos:enabled="$boolean:true"
visibility可見性visible表示控件可見ohos:visibility="visible"
invisible表示控件不可見,但仍然占用布局空間ohos:visibility="invisible"
hide表示控件不可見,且不占用布局空間ohos:visibility="hide"
layout_direction定義水平布局方向ltr表示布局方向為水平方向從左到右ohos:layout_direction="ltr"
rtl表示布局方向為水平方向從右到左ohos:layout_direction="rtl"
inherit表示繼承水平布局方向ohos:layout_direction="inherit"
locale表示布局方向跟隨系統設置ohos:layout_direction="locale"
background_element背景圖層Element類型可直接配置色值,也可引用color資源或引用media/graphic下的圖片資源ohos:background_element="#FF000000" ohos:background_element="$color:black" ohos:background_element="$media:media_src" ohos:background_element="$graphic:graphic_src"
foreground_element前景圖層Element類型可直接配置色值,也可引用color資源或引用media/graphic下的圖片資源ohos:foreground_element="#FF000000" ohos:foreground_element="$color:black" ohos:foreground_element="$media:media_src" ohos:foreground_element="$graphic:graphic_src"
component_description描述string類型可以直接設置文本字串,也可以引用string資源ohos:component_description="test"
ohos:component_description="$string:test_str"
三、間距
- Component 支持的 XML 的間距如下所示:
屬性名稱中文描述取值取值說明使用案例
padding內間距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源 ohos:padding="20"
ohos:padding="20vp"
ohos:padding="$float:padding_value"
left_padding左間距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:left_padding="20"
ohos:left_padding="20vp"
ohos:left_padding="$float:padding_value"
start_padding前內間距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:start_padding="20" ohos:start_padding="20vp" ohos:start_padding="$float:padding_value"
right_padding右內間距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:right_padding="20" ohos:right_padding="20vp" ohos:right_padding="$float:padding_value"
end_padding后內間距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源。ohos:end_padding="20" ohos:end_padding="20vp" ohos:end_padding="$float:padding_value"
top_padding上內間距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:top_padding="20" ohos:top_padding="20vp" ohos:top_padding="$float:padding_value"
bottom_padding下內間距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:bottom_padding="20" ohos:bottom_padding="20vp" ohos:bottom_padding="$float:padding_value"
margin外邊距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:margin="20" ohos:margin="20vp" ohos:margin="$float:margin_value"
left_margin左外邊距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源。與margin同時配置時,margin優先級高于left_marginohos:left_margin="20" ohos:left_margin="20vp" ohos:left_margin="$float:margin_value"
start_margin前外邊距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源。與margin同時配置時,margin優先級高于start_marginohos:start_margin="20" ohos:start_margin="20vp" ohos:start_margin="$float:margin_value"
right_margin右外邊距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源。與margin同時配置時,margin優先級高于right_marginohos:right_margin="20" ohos:right_margin="20vp" ohos:right_margin="$float:margin_value"
end_margin后外邊距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源。與margin同時配置時,margin優先級高于end_marginohos:end_margin="20" ohos:end_margin="20vp" ohos:end_margin="$float:margin_value"
top_margin上外邊距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源。與margin同時配置時,margin優先級高于top_marginohos:top_margin="20" ohos:top_margin="20vp" ohos:top_margin="$float:margin_value"
bottom_margin下外邊距float類型表示間距尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源。與margin同時配置時,margin優先級高于bottom_margin。ohos:bottom_margin="20" ohos:bottom_margin="20vp" ohos:bottom_margin="$float:margin_value"
四、滾動條
- Component 支持的 XML 的滾動條屬性如下所示:
屬性名稱中文描述取值取值說明使用案例
| scrollbar_thickness | 滾動條的厚度 | float類型 | 表示尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源 | ohos:scrollbar_thickness=“30” ohos:scrollbar_thickness=“10vp” ohos:scrollbar_thickness="$float:size_value" |
| scrollbar_start_angle | 滾動條的起始角度 | float類型 | 可以直接設置浮點數值,也可以引用float浮點數資源 | ohos:scrollbar_start_angle=“30" ohos:scrollbar_start_angle=”$float:value" |
| scrollbar_sweep_angle | 滾動條的掃描角度 | float類型 | 可以直接設置浮點數值,也可以引用float浮點數資源 | ohos:scrollbar_sweep_angle=“30" ohos:scrollbar_sweep_angle=”$float:value" |
| scrollbar_background_color | 滾動條背景顏色 | color類型 | 可以直接設置色值,也可以引用color資源 | ohos:scrollbar_background_color="#A8FFFFFF" ohos:scrollbar_background_color="$color:black" |
| scrollbar_color | 滾動條顏色 | color類型 | 可以直接設置色值,也可以引用color資源 | ohos:scrollbar_color="#A8FFFFFF" ohos:scrollbar_color="$color:black" |
| scrollbar_fading_enabled | 滾動條是否會漸隱 | boolean類型 | 可以直接設置true/false,也可以引用boolean資源 | ohos:scrollbar_fading_enabled=“true" ohos:scrollbar_fading_enabled=”$boolean:true" |
| scrollbar_overlap_enabled | 滾動條是否可以重疊 | boolean類型 | 可以直接設置true/false,也可以引用boolean資源 | ohos:scrollbar_overlap_enabled=“true" ohos:scrollbar_overlap_enabled=”$boolean:true" |
| scrollbar_fading_delay | 滾動條漸隱前的延遲時間,單位ms | integer類型 | 可以直接設置整型數值,也可以引用integer資源 | ohos:scrollbar_fading_delay=“1000" ohos:scrollbar_fading_delay=”$integer:delay" |
| scrollbar_fading_duration | 滾動條漸隱時長,單位ms | integer類型 | 可以直接設置整型數值,也可以引用integer資源 | ohos:scrollbar_fading_duration=“1000" ohos:scrollbar_fading_duration=”$integer:duration" |
五、旋轉縮放
- Component 支持的 XML 的旋轉縮放屬性如下所示:
屬性名稱中文描述取值取值說明使用案例
pivot_x旋轉點X位置float類型可以配置表示尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:pivot_x="20" ohos:pivot_x="$float:value"
pivot_y旋轉點Y位置float類型可以配置表示尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:pivot_y="20" ohos:pivot_y="$float:value"
rotate圍繞其中心點旋轉的角度float類型可以直接設置浮點數值,也可以引用float浮點數資源ohos:rotate="30" ohos:rotate="$float:value"
scale_xX方向的縮放級別float類型可以直接設置浮點數值,也可以引用float浮點數資源ohos:scale_x="1.2" ohos:scale_x="$float:value"
scale_yY方向的縮放級別float類型可以直接設置浮點數值,也可以引用float浮點數資源ohos:scale_y="1.2" ohos:scale_y="$float:value"
translation_xX方向移動的距離float類型可以配置表示尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:translation_x="20" ohos:translation_x="20vp" ohos:translation_x="$float:value"
translation_yY方向移動的距離float類型可以配置表示尺寸的float類型,可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:translation_y="20" ohos:translation_y="20vp" ohos:translation_y="$float:value"
六、獲焦
屬性名稱中文描述取值取值說明使用案例
focusable是否可獲焦focus_disable表示控件不可獲焦ohos:focusable="focus_disable"
focus_adaptable表示控件獲焦狀態跟隨控件自身默認特性ohos:focusable="focus_adaptable"
focus_enable表示控件可以獲焦ohos:focusable="focus_enable"
focus_border_radius焦點邊框圓角半徑float類型可以配置表示尺寸的float類型。可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:focus_border_radius="10" ohos:focus_border_radius="10vp" ohos:focus_border_radius="$float:value"
focus_border_enable是否有焦點邊框boolean類型可以直接設置true/false,也可以引用boolean資源ohos:focus_border_enable="true" ohos:focus_border_enable="$boolean:true"
focus_border_width焦點邊框寬度float類型可以配置表示尺寸的float類型。可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:focus_border_width="20" ohos:focus_border_width="10vp" ohos:focus_border_width="$float:size_value"
focus_border_padding焦點邊框的邊距float類型表示間距尺寸的float類型。可以是浮點數值,其默認單位為px;也可以是帶px/vp/fp單位的浮點數值;也可以引用float資源ohos:focus_border_padding="20" ohos:focus_border_padding="20vp" ohos:focus_border_padding="$float:padding_value"
focusable_in_touch觸摸狀態下boolean類型可以直接設置true/false,也可以引用boolean資源ohos:focusable_in_touch="true" ohos:focusable_in_touch="$boolean:true"
總結
以上是生活随笔為你收集整理的HarmonyOS之组件通用的XML属性总览的全部內容,希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔網站內容還不錯,歡迎將生活随笔推薦給好友。