1# LocationButton 2 3安全控件的位置控件，用户通过点击该位置按钮，可以临时获取精准定位权限，而不需要权限弹框授权确认。 4 5> **说明：** 6> 7> - 该组件从API Version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8> 9> - 从API Version 15开始，位置控件不再维护，推荐调用[requestPermissionsFromUser](../../apis-ability-kit/js-apis-abilityAccessCtrl.md#requestpermissionsfromuser9-1)拉起权限弹窗，请求用户授权。 10 11## 子组件 12 13不支持。 14 15## 接口 16 17### LocationButton 18 19LocationButton() 20 21默认创建带有图标、文本、背景的位置按钮。 22 23为避免控件样式不合法导致授权失败，请开发者先了解安全控件样式的[约束与限制](../../../security/AccessToken/security-component-overview.md#约束与限制)。 24 25**原子化服务API：** 从API version 11开始，该接口支持在元服务中使用。 26 27**系统能力：** SystemCapability.ArkUI.ArkUI.Full 28 29### LocationButton 30 31LocationButton(options:LocationButtonOptions) 32 33创建包含指定元素的位置按钮。 34 35为避免控件样式不合法导致授权失败，请开发者先了解安全控件样式的[约束与限制](../../../security/AccessToken/security-component-overview.md#约束与限制)。 36 37**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 38 39**系统能力：** SystemCapability.ArkUI.ArkUI.Full 40 41**参数：** 42 43| 参数名 | 类型 | 必填 | 说明 | 44| -------- | -------- | -------- | -------- | 45| options | [LocationButtonOptions](#locationbuttonoptions) | 是 | 创建包含指定元素的位置按钮。 | 46 47## LocationButtonOptions 48 49用于指定位置按钮的图标、文本等指定元素。 50 51> **说明：** 52> 53> - icon或text需至少传入一个。<br> 54> - 如果icon、text都不传入，[LocationButton](#locationbutton-1)中的options参数不起效，创建的LocationButton为默认样式，默认样式： 55> 56> LocationIconStyle默认样式为LINES； 57> 58> LocationDescription默认样式为CURRENT_LOCATION； 59> 60> ButtonType默认样式为Capsule。 61> - icon、text、buttonType不支持动态修改。 62 63**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 64 65**系统能力：** SystemCapability.ArkUI.ArkUI.Full 66 67| 名称 | 类型 | 必填 | 说明 | 68| -------- | -------- | -------- | -------- | 69| icon | [LocationIconStyle](#locationiconstyle枚举说明) | 否 | 设置位置按钮的图标风格。<br/>不传入该参数表示没有图标。 | 70| text | [LocationDescription](#locationdescription枚举说明) | 否 | 设置位置按钮的文本描述。<br/>不传入该参数表示没有文字描述。 | 71| buttonType | [ButtonType](ts-basic-components-button.md#buttontype枚举说明) | 否 | 设置位置按钮的背景样式。<br/>不传入该参数，系统默认提供Capsule类型按钮。 | 72 73## LocationIconStyle枚举说明 74 75**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 76 77**系统能力：** SystemCapability.ArkUI.ArkUI.Full 78 79| 名称 | 值 | 说明 | 80| -------- | -------- | -------- | 81| FULL_FILLED | 0 | 位置按钮展示填充样式图标。 | 82| LINES | 1 | 位置按钮展示线条样式图标。 | 83 84## LocationDescription枚举说明 85 86**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 87 88**系统能力：** SystemCapability.ArkUI.ArkUI.Full 89 90| 名称 | 值 | 说明 | 91| -------- | -------- | -------- | 92| CURRENT_LOCATION | 0 | 位置按钮的文字描述为“当前位置”。 | 93| ADD_LOCATION | 1 | 位置按钮的文字描述为“添加位置”。 | 94| SELECT_LOCATION | 2 | 位置按钮的文字描述为“选择位置”。 | 95| SHARE_LOCATION | 3 | 位置按钮的文字描述为“共享位置”。 | 96| SEND_LOCATION | 4 | 位置按钮的文字描述为“发送位置”。 | 97| LOCATING | 5 | 位置按钮的文字描述为“定位”。 | 98| LOCATION | 6 | 位置按钮的文字描述为“位置”。 | 99| SEND_CURRENT_LOCATION | 7 | 位置按钮的文字描述为“发送实时位置”。 | 100| RELOCATION | 8 | 位置按钮的文字描述为“重定位”。 | 101| PUNCH_IN | 9 | 位置按钮的文字描述为“打卡定位”。 | 102| CURRENT_POSITION | 10 | 位置按钮的文字描述为“所在位置”。 | 103 104## LocationButtonOnClickResult枚举说明 105 106**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 107 108**系统能力：** SystemCapability.ArkUI.ArkUI.Full 109 110| 名称 | 值 | 说明 | 111| -------- | -------- | -------- | 112| SUCCESS | 0 | 位置按钮点击成功。 | 113| TEMPORARY_AUTHORIZATION_FAILED | 1 | 位置按钮点击后位置权限授权失败。 | 114 115## 属性 116 117不支持通用属性，仅继承[安全控件通用属性](ts-securitycomponent-attributes.md#属性)。 118 119## 事件 120 121不支持通用事件，仅支持以下事件： 122 123### onClick 124 125onClick(event: (event: ClickEvent, result: LocationButtonOnClickResult) => void) 126 127点击动作触发该回调。 128 129**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 130 131**系统能力：** SystemCapability.ArkUI.ArkUI.Full 132 133**参数：** 134 135| 参数名 | 类型 | 必填 | 说明 | 136|------------|------|-------|---------| 137| event | [ClickEvent](ts-universal-events-click.md#clickevent对象说明) |是 |见ClickEvent对象说明| 138| result | [LocationButtonOnClickResult](#locationbuttononclickresult枚举说明)| 是 | 位置权限的授权结果。| 139 140## 示例 141 142```ts 143// xxx.ets 144@Entry 145@Component 146struct Index { 147 build() { 148 Row() { 149 Column({ space: 10 }) { 150 // 默认参数下，图标、文字、背景都存在。 151 LocationButton().onClick((event: ClickEvent, result: LocationButtonOnClickResult) => { 152 console.info("result " + result) 153 }) 154 // 传入参数即表示元素存在，不传入的参数表示元素不存在，如果不传入buttonType，会默认添加ButtonType.Capsule配置，显示图标+背景。 155 LocationButton({ icon: LocationIconStyle.LINES }) 156 // 只显示图标+背景，如果设置背景色高八位的α值低于0x1A，则会被系统强制调整为0xFF。 157 LocationButton({ icon: LocationIconStyle.LINES, buttonType: ButtonType.Capsule }) 158 .backgroundColor(0x10007dff) 159 // 图标、文字、背景都存在，如果设置背景色高八位的α值低于0x1A，则会被系统强制调整为0xFF。 160 LocationButton({ 161 icon: LocationIconStyle.LINES, 162 text: LocationDescription.CURRENT_LOCATION, 163 buttonType: ButtonType.Capsule 164 }) 165 // 图标、文字、背景都存在，如果设置宽度小于当前属性组合下允许的最小宽度时，宽度仍为设置值，此时按钮文本信息会自动换行，以保证安全控件显示的完整性。 166 LocationButton({ 167 icon: LocationIconStyle.LINES, 168 text: LocationDescription.CURRENT_LOCATION, 169 buttonType: ButtonType.Capsule 170 }) 171 .fontSize(16) 172 .width(30) 173 // 图标、文字、背景都存在，如果设置宽度小于当前属性组合下允许的最小宽度时，宽度仍为设置值，此时按钮文本信息会自动换行，以保证安全控件显示的完整性。 174 LocationButton({ 175 icon: LocationIconStyle.LINES, 176 text: LocationDescription.CURRENT_LOCATION, 177 buttonType: ButtonType.Capsule 178 }) 179 .fontSize(16) 180 .size({ width: 30, height: 30 }) 181 // 图标、文字、背景都存在，如果设置宽度小于当前属性组合下允许的最小宽度时，宽度仍为设置值，此时按钮文本信息会自动换行，以保证安全控件显示的完整性。 182 LocationButton({ 183 icon: LocationIconStyle.LINES, 184 text: LocationDescription.CURRENT_LOCATION, 185 buttonType: ButtonType.Capsule 186 }) 187 .fontSize(16) 188 .constraintSize({ 189 minWidth: 0, 190 maxWidth: 30, 191 minHeight: 0, 192 maxHeight: 30 193 }) 194 }.width('100%') 195 }.height('100%') 196 } 197} 198``` 199 200 201
